Sales Order Acknowledgements (1214 onwards)

Created by Migration Bot, Modified on Fri, 23 Oct at 2:30 PM by Migration Bot

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

image-20250917-100454.png

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

image-20250616-142832.png
  • 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.

image-20250616-143002.png

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’

image-20241219-105544.png

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.

image-20250917-100626.png

Ticking the checkbox instructs the print to show summarised order line details.

image-20250917-100731.pngimage-20250917-100803.png

It is possible to change the print format when displaying the results to screen

image-20250917-101458.png

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

  • All - show price

  • None - hide 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

  • None - exact date

  • Range 1 - a 1 week date range (x to X+7) where x is the expected delivery date.

  • Range 2 - show a 2 week expected delivery date range (x to X+14) where x is the expected delivery date.

  • Range 3 - give a 3 week window (x to X+21) where x is the expected delivery date.

  • Delivery Date Range - (x to X+EXP_DELIVERY_RANGE_DAYS) where x is the expected delivery date. EXP_DELIVERY_RANGE_DAYS is application parameter in days.

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

  • Include - Include as part of the SOA document

  • Exclude - Exclude payments from the SOA print

  • Separate - Show as a separate document

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

image-20240408-084906.png

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

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