Originally written by John Hardwick, last updated May 20, 2024, on the Swan Retail knowledge base (FRS).
This document is based on SwanFRS version 1209
Overview
The sales order header is a term applied to the data relating to the sales order rather than the products or services linked to it.There are two methods of operation, one offering a greater degree of control re changes.
Prior to SwanFRS release version 1209 anyone was able to amend order header data. With 1209 enhanced controls were made available to protect this information.
Sales order header data relates to the information displayed in the red box in the screen below.
Configuration
Application Parameters
Menu Location: System > Administration > Set Up Application Parameters
This first step in protecting the order header is to inform SwanFRS that protection is required. This is done by turning OFF the automatic amendment save feature for sales order header changes.
|
Parameter |
Value |
|---|---|
|
SO_AUTO_SAVE_HEADER |
Ticking saves the information in the sales order header area when the operator leaves the page. Unticking increases control re amending order header information, turning on the EDIT and SAVE buttons and generating messages if the operator leaves the page without saving. It is recommended that this feature be set to its ‘unticked’ state, which improves the ability to control who can amend header information once the sale has been accepted for the first time, and also reduces ‘changes’ being lost. |
Roles
Menu Location: System > Security > Set Up Roles
See Set Up Roles
When using the controlled order header amendment feature, SwanFRS uses the following role privileges.
|
Parameter |
Value |
|---|---|
|
SO_EDIT_HEADER |
When the SO_AUTO_SAVE_HEADER application parameter is turned off. This privilege will allow operators to edit restricted data within the sales order header section once the sales order has been accepted (for the first) time up to the point of order completion).
|
|
SO_EDIT_HEADER_COMPLETE |
Used when the SO_AUTO_SAVE_HEADER application parameter is turned off, operators with this privilege have access to the order header data irrespective of order status. |
Operation
Unprotected Operation
When operating with the SO_AUTO_SAVE_HEADER application parameter ticked, specific fields within the sales order header are amendable at any point once the sales order has been created.
There are no restrictions on who can make changes, and changes are recorded once the operator changes to another page or view.
Changes can be applied even after the sales order has been completed.
Protected Operation
When operating with the SO_AUTO_SAVE_HEADER application parameter unticked, only empowered operators are allowed to make changes to the order header.
Where the sales order has been previously accepted, and the operator does not possess either of the SO_EDIT_ privileges, it will not be possible to amended sales order header information.
This block applies to all tabs (order, delivery & contact tabs).
Where the operator has one of these role privilege the EDIT button is visible on the top line of the display, as shown below.
Clicking EDIT opens the header for amendment.
Changes are now possible for restricted data elements in the Order, Delivery and Contact tabs.
During amendment, the EDIT button is replaced with SAVE HEADER and CANCEL HEADER buttons.
The SO_EDIT_HEADER privilege allows amendment of header information until the sales order reaches the COMPLETE status. Once an order is completed, no further changed are possible to the sales order header unless the operator possesses the SO_EDIT_HEADER_COMPLETE privilege.
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