Originally written by Former user, last updated Apr 08, 2026, on the Swan Retail knowledge base (SRS).
SRS allows you to use merge fields within document, Email and SMS templates.
These allow you to add placeholder ‘tags’ to templates which are then replaced with the relevant data when the document, Email or SMS is generated.
Merge Fields
Merge fields consist of a ‘tag’ enclosed in double square brackets:
-
[[CustomerName]] would output the Customers name when a document containing this merge fields is created. An example template file and the resultant output document are attached for reference.
Customer Fields
|
Merge field |
Description |
|---|---|
|
[[CustomerAccountNumber]] |
Where an order is linked to a customer account, this will output the account number. |
|
[[Title]] |
The customers title, e.g. Mr, Mrs, Miss |
|
[[CustomerInitials]] |
The customers first name |
|
[[CustomerSurname]] |
The customers last name |
|
[[CustomerName]] |
A combination of Title, CustomerInitials and CustomerSurname |
|
[[CustomerCompany]] |
The Customer Company as detailed in Customer Maintenance > Addresses |
|
[[CustomerAddress1]] |
Customer Address > Address 1 |
|
[[CustomerAddress2]] |
Customer Address > Address 2 |
|
[[CustomerAddress3]] |
Customer Address > Town |
|
[[CustomerAddress4]] |
Customer Address > County |
|
[[CustomerPostcode]] |
Customer Address > Post Code |
|
[[CustomerCountry]] |
Customer Address > Country |
|
[[CustomerTelephone]] |
Customer Address > Telephone |
|
[[CustomerMobile]] |
Customer Address > Mobile |
|
[[CustomerEmail]] |
Customer Address > Email |
|
[[AccountType]] |
Account Type |
|
[[CustomerAccountCode]] |
Customer Account Code |
|
[[ActivationDate]] |
Activation Date |
|
[[VoucherCode]] |
Voucher Code |
|
[[VoucherDescription]] |
Voucher Description |
|
[[ResetPasswordURL]] |
Reset Password URL |
|
[[ViewInBrowser]] |
View In Browser |
|
[[ExpiryDate]] |
Expiry Date |
Sample Files
CustomerFieldsTemplate.odtCustomer Fields Output.odtReceipt Fields
|
Merge field |
Description |
|---|---|
|
[[ReceiptNumber]] |
Receipt Number |
Sales Order Fields
|
Merge field |
Description |
|---|---|
|
[[SalesOrderNumber]] |
The sales order number |
|
[[SalesOrderValue]] |
The total value of the sales order |
|
[[SalesOrderPaymentValue]] |
The total of payments made on the sales order |
|
[[SalesOrderOutstandingValue]] |
The total outstanding on the sales order |
|
[[SalesOrderDeliveryBranchNumber]] |
The delivery branch number for the sales order |
|
[[SalesOrderDate]] |
The date the sales order was created |
|
[[SalesmanName]] |
The name of the salesman attached to the sales order |
Sample Files
Sales Order Fields Template.odtSales Order Fields Output.odtCustomer Incident Fields
|
Merge field |
Description |
|---|---|
|
[[IncidentNumber]] |
The SRS incident number |
|
[[IncidentDate]] |
The date the incident was created in Customer Service |
|
[[IncidentType]] |
The type of incident (e.g. Damaged, complaint, etc.) |
|
[[IncidentOperativeName]] |
The name of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[IncidentOperativeAddress1]] |
Address 1 of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[IncidentOperativeAddress2]] |
Address 1 of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[[[IncidentOperativeAddress3]] |
Town of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[IncidentOperativeAddress4]] |
County of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[IncidentOperativePostCode]] |
Post Code of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[IncidentOperativeTelephone]] |
Telephone of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[IncidentOperativeFax]] |
Fax of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[IncidentOperativeEmail]] |
Email of the Operative as set up in Operative Maintenance and assigned on the Customer Service > Operative tab |
|
[[IncidentResponsibility]] |
The user assigned Responsibility for this incident at creation |
|
[[IncidentResponsibilityEmail]] |
Email of the user assigned under Responsibility as set up in User Maintenance |
|
[[IncidentDescription]] |
The incident description |
|
[[ActionType]] |
Type of the next outstanding Action on the incident |
|
[[ActionDescription]] |
Description of the next outstanding Action on the Incident |
|
[[ActionDate]] |
Date of the latest next outstanding on the Incident |
Sample Files
Incident Fields Template.odtIncident Fields Output.odtPurchase Order Fields
|
Merge field |
Description |
|---|---|
|
[[PurchaseOrderNumber]] |
The SRS Purchase Order Number |
|
[[PoAcknowledgementNumber]] |
Purchase Order Acknowledgement Number |
|
[[PurchaseOrderDate]] |
Purchase Order expected delivery date |
|
[[PurchaseInvoiceNumber]] |
Purchase Invoice number |
|
[[DeliveryNoteNumber]] |
Delivery note number entered during Goods Receiving |
|
[[DateReceived]] |
Date the goods were received |
Sample Files
Purhase Order Fields Output.odtPurchase Order Fields Template.odtSupplier Fields
|
Merge field |
Description |
|---|---|
|
[[SupplierNumber]] |
The SRS Supplier Number as defined in Supplier Maintenance |
|
[[SupplierName]] |
The Supplier name |
|
[[SupplierAddress1]] |
Supplier Maintenance > Addresses > Address 1 |
|
[[SupplierAddress2]] |
Supplier Maintenance > Addresses > Address 2 |
|
[[SupplierAddress3]] |
Supplier Maintenance > Addresses > Address 3 |
|
[[SupplierAddress4]] |
Supplier Maintenance > Addresses > Address 4 |
|
[[SupplierPostCode]] |
Supplier Maintenance > Addresses > Post Code |
|
[[SupplierEmail]] |
Supplier Maintenance > Addresses > Email |
|
[[SupplierFax]] |
Supplier Maintenance > Addresses > Fax |
Sample Files
Supplier Fields Template.odtSupplier Fields Output.odtDelivery Address Fields
|
Merge field |
Description |
|---|---|
|
[[DeliveryCompany]] |
Delivery address company (where applicable) |
|
[[DeliveryAddress1]] |
Delivery address line 1 |
|
[[DeliveryAddress2]] |
Delivery address line 2 |
|
[[DeliveryAddress3]] |
Delivery address line 3 |
|
[[DeliveryAddress4]] |
Delivery address line 4 |
|
[[DeliveryPostCode]] |
Delivery address Post Code |
|
[[DeliveryCountry]] |
Delivery address country |
|
[[DeliveryTimeslot]] |
Delivery time slot |
|
[[DeliveryTelephone]] |
Delivery address telephone number |
Sample Files
Delivery Address Template.odtDelivery Address Output.odtRepeating Fields
The following fields allow for repeating rows of information, for example, multiple sales order lines, to be output on a document. They are intended to be used in tables.
In order to use these fields add a dash and then a number to the end of the merge field name.
For example, to output the item description for sales order lines 1 & 2 you would set it up as follows:
|
Line 1 |
[[StockItemFullDescription-1]] |
|
Line 2 |
[[StockItemFullDescription-2]] |
The table below will not include the numbered suffix so please be sure to add this if you use these merge fields
|
Merge field |
Description |
|---|---|
|
[[StockItemCode]] |
The item code from Item Maintenance |
|
[[StockItemFullDescription]] |
Item description |
|
[[SalesOrderDetailSellingPrice]] |
Selling price as per the sales order |
|
[[SalesOrderDetailQuantity]] |
Quantity sold |
|
[[SalesOrderDetailRequiredByDate]] |
Sales order required by date |
|
[[SalesOrderDetailDeliveryDate]] |
Sales order deliver date |
|
[[SalesOrderDetailDeliveryType]] |
Sales order Delivery type |
|
[[InstoreBrandDescription]] |
Item Instore brand description |
|
[[SupplierBrandDescription]] |
Item Suppliers brand description |
|
[[SupplierReference]] |
The suppliers item reference |
|
[[SalesOrderDetailSalesValue]] |
Sales order sales value |
|
[[SalesOrderDetailCostValue]] |
Sales order cost value |
|
[[SalesOrderDetailIncidentType]] |
Customer incident type |
|
[[SalesOrderDetailSupplierName]] |
Sales order supplier name |
|
[[SalesOrderDetailReasonDescription]] |
|
|
[[GrnDateReceived]] |
Date the line was received from manufacturer by us |
|
[[GrnDeliveryNoteNumber]] |
This is the Purchase Order Delivery Note number if it was purchase ordered |
|
[[DetailSupplierReference]] |
|
|
[[DetailPOAcknowledgmentNumber]] |
The Purchase Order acknowledgement number |
Files from the Confluence page
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article