Originally written by John Hardwick, last updated Mar 26, 2026, on the Swan Retail knowledge base (FRS).
Part of: Process Related Reports
The order acknowledgement is produced when a sales order is accepted, or the print option is chosen from the side menu.
This document has been referred to as a sales invoice, however it relates to the acceptance of a sales order rather than the finalization of the order at the point of delivering goods / services to the customer. When confirming delivery, SwanFRS allocates a delivery reference which is effectively the sales invoice and is documented elsewhere. It is possible to use the sales order acknowledgement as a pro forma invoice by instructing SwanFRS to show VAT values on the output.
There are many options re the configuration of the print. Please ensure the settings on your system have been fully reviewed and are correct for your operation.
There are two main versions of the Sales Order Acknowledgement (SOA)
Banner Format
The Banner format is the most feature rich version of the Order Acknowledgement and the recommended version for installation on new systems.
This document shares control parameters with the Small Logo Format - please ensure you are aware of all control settings for both versions of the document.
Crystal report name Banner SO 23
Example Print
This Report will show the ‘debranded’ catalogue supplier or the debranded supplier name, dependent upon control settings (RPT_SHOW_CAT_SUP Application parameter)
Key Features
-
SKU and stock images
-
Discount reasons display
-
Content sensitive terms and conditions / care instructions
See Terms and Conditions (1213 onwards) for details of configuration and use.
-
The logo is only presented on the first page of the audit.
-
Second and subsequent pages do not show the banner header
-
-
Contact details will show in the header, where set.
-
When printing the order acknowledgement with double-sided printing set at location level, the print will throw a blank page at the end of each order set to ensure page 1 is always on a new sheet.
-
Images are only displayed, where set against the SKU / Stock item
-
Stock images are presented in preference to SKU images.
-
The first web image is used when ImagesURLS is set.
-
The image box will display ‘No Image’ found if the audit cannot find an image linked to a stock / SKU item.
-
-
Original prices are show in red, with discounted prices in blue.
-
When operating with Synchrony finance, the receipt will print an acceptance statement above the Receipt message (where set). The wording is dictated and controlled by Synchrony Finance
Gift Vouchers
If the sales order contains a product with ‘Gift Cert’ or ‘Gift Vouch’ (not case-sensitive) in the SKU description, the customer's copy of the sales acknowledgement will contain a gift certificate page, designed to allow the purchaser to give the sheet to the recipient.
This page will not print if the sales order has a line containing the words ‘gift’ and ‘rede’ in the description. (‘rede’ covers both redeem and redemption). The test is not case-sensitive.
VAT Exempt Form
If one or more items on the sales order has been sold with an exempt VAT rate a VAT exemption declaration form will be produced as part of the acknowledgement.
If a request to print a sales order which has either not been accepted or is being amended a yellow warning will display towards the top of the print advising the order is being ‘built’
Summary version
When viewing the sales order on screen, via the Delivery tab it is possible to instruct the print to produce a summarised version of the print.
Ticking the checkbox instructs the print to show summarised order line details.
It is possible to change the print format when displaying the results to screen
To change click the (?) button, This expands the Parameter Panel, choose the format from the pick list and then click the Apply options to regenerate the output.
Small Logo Format
Crystal report name New Sales Order 32
Please note this version of the print is no longer being actively developed
The order acknowledgement is produced when a sales order is accepted, or the print option is chosen from the side menu.
Example Print
Please note that the acknowledgement produced when the order is first accepted cannot be replicated in the exact format originally produced in that payments received in previous transactions are summed into a single line for future prints and therefore it is important to ensure that printed copies are taken before the screen display of the initial order is closed.
Application Parameter Controls
There are several options and settings that affect the format and content of the order acknowledgement, these are detailed below.
The format is dependent upon settings in the ‘Application Parameters’ section of SwanFRS.
In some instances these controls are not applicable for ‘older’ SOA designs. If your version of the SOA doesn’t support a particular feature it is suggest reviewing the features of the ‘banner’ version with a view to migrating to this version.
|
Parameter Name |
Details |
|
ALWAYS_SHOW_STOCK_ON_SO |
Tick to instruct the SOA to print the Stock ID at line level. Ticking superseded the Consolidate_SO control effectively marking it as unticked. |
|
Consolidate_SO |
Tick to instruct the print to consolidate like products i.e. show one line of 4 chairs as opposed to showing 4 lines. |
|
Retailer_Website |
Where set, this is printed on the SOA |
|
Show_SOA_Text |
Tick to show a text message a the foot of the SOA. Where ticked this instructs the print to include the contents of the SO_TEXTx controls |
|
Show_SOA_VAT |
Tick to instruct the print to include the VAT / Tax element of the line sale. |
|
SHOW_SUPPLIER_INVOICE_ON_SOA |
Tick to show the supplier invoice lines, added for service actions. |
|
Single_Logo |
Where set the audit will show the same logo for all branches. The logo name for this form of printing in Logo.jpg Where not set the audit will show the branch specific location set within Set Up Locations. When setting the logo name for Banner prints the location name should omit the Banner prefix. For Example, the image name is Logo.jpg - the logo for the banner format should be named BannerLogo.jpg and named Logo.jpg in the location record. |
|
SO_ACK_MARKETING_FLAGS |
Tick to include the customer’s choice of ‘direct marketing’ (GDPR) indicators at the foot of the SOA. |
|
SO_ACK_MARKETING_TEXT |
Used where the SO_ACK_MARKETING_FLAGS is ticked, specify the narrative to be used to explain the marketing flags. |
|
SO_HIDE_DEL_DATES |
Tick to hide delivery dates on the SOA. This affects the Not Before and the Delivery Due After fields. |
|
SO_SET_IDENTIFIER |
Optionally specified the narrative to be used when printing a ‘set’ on the SOA. if not set a standard narrative will be used. This narrative is only used if the SO_SET_VIEW is configured. |
|
SO_SET_VIEW |
Tick to instruct the SOA to show sets. |
|
SO_SHOW_SET_DETAIL |
Tick if the SOA is to show the composition of the set on the print (and on screen). |
|
SOA_Copies |
Specify how many copies of the SOA are to be printed. 1 = customer only 2 = customer and store 3 = customer, store and file copy When sending email PDF attachment only the customer copy is generated. |
|
SOA_Exclude_Supplier |
Tick is the print should omit the supplier’s name from the print. When showing the suppliers name the audit will show the debranded catalogue supplier or the debranded supplier name dependent upon control settings (RPT_SHOW_CAT_SUP Application parameter) |
|
SOA_FLOOR_HIDELINES_FOOT_1 to SOA_FLOOR_HIDELINES_FOOT_5 |
This is message line shown at the foot of the sales order acknowledgement (max 255 characters) - It is possible to influence the presentation of the text by prefixing the narrative with [1] for a bullet [2] for a bold bullet [3] for bold text no bullet. [b] for a blank line These features work on the enhanced and banner versions of the sales order acknowledgment only. This set of narratives only displays if the ‘alternative order comments are set and the selling location name contains the word ‘Carpet’ or 'Flooring’. This text is printed after the alternative sales order comments. Ticking the ‘Hide SO Lines’ prompt omits the order lines from the print showing only the comments entered on the order. |
|
SOA_FLOOR_HIDELINES_HEAD_1 to SOA_FLOOR_HIDELINES_HEAD_5 |
as per SOA_FLOOR_HIDELINES_FOOT_ for controls |
|
SOA_Format |
Specify if the SOA is to show the MRP (MSRP) price
|
|
SOA_HIDE_LOGO |
Tick if the SOA is to hide the logo when printing This is used in partnership with pre-printed (headed) stationery. |
|
SOA_HIDE_MODEL_NO |
Tick to omit the supplier’s reference (mode number) when printing the order line. |
|
SOA_INCLUDE_RETURNS |
Tick to include ‘returned’ lines on the print. |
|
SOA_KEEP_OPTIONS |
Tick to keep all options relating to a specific SKU on the same page. I.e., wherever possible avoid allowing the option set for an item to span more than one page. |
|
SOA_Layout |
Specify how the expected delivery date is to be presented. Choose from
|
|
SOA_MARKDOWN_MESSAGE |
Specify narrative to show at the foot of the SOA which is only used if one or more items on the order are sold as ‘marked down’ items. |
|
SOA_MARKDOWN_STK_TXT |
Specify narrative to show at line level to identify a marked down item, perhaps referring them to the SOA_MARKDOWN_MESSAGE printed at the foot of the document. |
|
SOA_PRINT_CAVEATS |
Tick to instruct the SOA to print any applicable caveats relating to sold items / services on the order. |
|
SOA_PRINT_DELIVERY_DUE_DAYS |
Tick to show the expected delivery due date on the SOA. |
|
SOA_Receipt |
Specify how payments received (deposits) are to be represented on the SOA. Choose from
The separate feature is not supported in the Banner version of the SOA. |
|
SOA_REPRINT_CASH_RECEIPT |
Tick to present previous payments in detail on copies of the SOA print. Untick to show a cumulative previous payments value in the payment section of the SOA. |
|
SOA_Shading |
Tick to create a shaded alternative line background when printing the order lines. This feature aids with line identification. |
|
SOA_SHOW_DISC_PERCS |
Tick to show the discount percentage applied to the order line or order total alongside the discount value. |
|
SOA_SHOW_DISCOUNT_REASONS |
Tick to show the reason why a product / service was discounted at point of sale. |
|
SOA_SHOW_IMPERFECT_NOTES |
Tick to include narrative collected at the point of identifying an item as imperfect. This feature will also show, where captured, an image of the item. Imperfect notes are shown in a red box. |
|
SOA_SHOW_LINE_DISCOUNTS |
Tick to show discounts given at order line and order total. |
|
SOA_SHOW_MARKDOWN_REASONS |
Tick to show the mark down reason when set against the stock item |
|
SOA_Show_Outstanding_Finance |
Tick to show the outstanding finance balance in the order totals section of the print. |
|
SOA_SHOW_PARTS |
Tick to instruct the print to include products / services marked as ‘parts'. |
|
SOA_SHOW_REJECTED_UPSELLS |
Tick to include ‘auto-suggested’ SKUs which were declined at time of adding an item to the order. |
|
SOA_Show_Retailer_address |
Tick to show the retailer’s trading address (for the selling location) on the SOA. |
|
SOA_Show_Signature_Text |
Tick to print ‘custom’ signature text on the SOA. Ticking prints the SOA_Signature_Text instead of the default. |
|
SOA_SHOW_THUMBNAILS |
Tick to include images of items on the print. |
|
SOA_SHOW_THUMBNAILS_OPTIONS |
Tick to show ‘option choice’ images (where set) alongside the option |
|
SOA_Signature_Text to SOA_Signature_Text5 |
Optionally specify a series of sentences relating to the customer signature section of the SOA. It is possible to influence the presentation of the text by prefixing the narrative with [1] for a bullet [2] for a bold bullet [3] for bold text no bullet. [b] for a blank line Text influencing features only work on the enhanced and banner versions of the sales order acknowledgment only. |
|
SOA_SOCIAL_MEDIA_IMAGE_PATH |
Optionally specify an image filename (and path) to be printed at the foot of the SOA The ideal image size for this is 680 pixels wide x 35 pixels high. |
|
SOA_Text1 to SOA_Text9 |
Optionally specify a series of narratives to print at the foot of the SOA. This series will only display if the Show_SOA_Text is ticked. It is possible to influence the presentation of the text by prefixing the narrative with [1] for a bullet [2] for a bold bullet [3] for bold text no bullet. [b] for a blank line Text influencing features only work on the enhanced and banner versions of the sales order acknowledgment only. |
|
SOA_TITLE |
Specify the name given to the SOA print. |
|
SOA_TOTAL_MSG |
Specify a narrative to show alongside the total message. For example, A thank you for purchasing. |
|
USE_DELIVERY_DAYS |
Tick to show the standard delivery day(s) to the customers delivery address as set within Set Up Postcode Links to Deliveries. |
The SOA will include Instructions specified against the Customer Record. Comments do not print.
Emailed Sales Order Acknowledgement
Whether using the standard or the enhanced sales order acknowledgment it is important to understand how SwanFRS works when the customer email acknowledgement feature is used.
If the customer has an email address and the system is configured to send emails, at the point of ‘accepting’ the sales order the system offers an accept and send (resend / send options if already accepted) on the side panel.
This option generates the sales order acknowledgement and emails it as a PDF to the customer’s email address.
The PDF attachment is the ‘customer copy’ of the sales order acknowledgment and will contain the detail of any payment made in the preceding transaction. (If configured to do so)
It is important to remember that this process DOES NOT generate a branch copy therefore if you wish to obtain a copy it is important to use the print side panel option having ‘sent’ the original to the customer. (Recommended to ensure you obtain a customer’s signature to confirm the order)
Second and subsequent copies of the order acknowledgement do NOT show payments in detail. Acknowledgement reprints show the cumulative payment to date rather than individual payments. This feature replicates the paper print in that detailed order payments are only provided on first prints, reprints show order payments in summary.
Carpet / Flooring Comments
If the sales order is linked to a branch with the word Floor or Carpet in the description, the summary notes have been entered and hide lines set, the sales order acknowledgement will show the Sales Order Comments Section as shown below.
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