SRS Document, Email and SMS Merge Fields

Created by Migration Bot, Modified on Fri, 23 Oct at 11:21 AM by Migration Bot

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.odt

Receipt 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.odt

Customer 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.odt

Purchase 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.odt

Supplier 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.odt

Delivery 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.odt

Repeating 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

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article