Amending Sales Order 'Headers'

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

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.

image-20240520-094618.png

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

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

  • There are no restrictions on the ON HOLD order to the point of first acceptance.

  • Once the sales order has been ACCEPTED once, and irrespective of state thereafter, only users with the SO_EDIT_HEADER privilege will be able to amend header data.

  • Once the sales order has COMPLETED only operators with the SO_EDIT_HEADER_COMPLETE privilege will be able to amend the header data.

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.

image-20240520-102345.png

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.

image-20240520-111732.png

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.

image-20240520-112144.png

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.

image-20240520-120439.png

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

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