Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

this doc is in progress. process to be reviewed and doco to be simplified (where possible....!)

How it works

...


Warning

ENABLING THIS FEATURE WITHOUT CONSULTATION WILL PREVENT YOUR CUSTOMERS FROM ORDERING

This mode requires that we add an 'Order Limit' field to your Advanced User Maintenance screen for your orders to process correctly (no charge).  Please contact us prior to changing any settings.

With the 'Order Limit' field set, you will be able to begin configuring this mode.


Overview


Multiexcerpt
MultiExcerptNameFeature Overview
Order Approvals allows Customer accounts to add an approval process for its users' orders when their order limits have been reached.



The process goes something like this:

...

  1. A user places an order which is over their $ limit, and therefore requires approval.
  2. An approver (or group of approvers) will approve or reject the order (or individual lines) on the order.
  3. If approved, the order is submitted and integrates to the ERP.

Image Removed

 

Approval modes

There are 3 modes to choose from, each with increasing complexity:

...

Image Added


Panel

On this page:

Table of Contents



User Experience

Ordering User Experience 


1. When Order Approvals is enabled for a Customer account, during Checkout, a popup message alerts the ordering user that approval is required as the order is over their order limit:

Image Added  

2. Depending on the Approval Type mode used and the number of eligible approvers, either an approver is automatically assigned or the user selects one from a dropdown list during Checkout. The order cannot continue without the completion of this step. Note - the User is alerted with a message if no Approver is available.

Image Added

3. Once the order has been submitted, the confirmation page reaffirms that the order has been flagged as requiring approval:

Image Added

4. The user can view their 'pending approval' orders as well as any that have been rejected in Order History (DashboardOrder History). Note - approved orders will move to the next stage of the usual order processing procedure.    
Image Added

Approver Experience

An approver is another user on the Customer account who has been assigned to the user who submitted the order (mode 0), has a set approval limit high enough for the order total (mode 1) or has been added in an Approver Group (in the Advanced Approval by User and Account mode). When an approver has been assigned an order to approve, they will receive a notification email. See Order Approver Functions.


Order Approval Modes

There are three Order Approval modes that can be set:

  1. Approval By User - a very simple 1-to-1 relationship

...

  1. set at the User level. User A's orders are approved by

...

  1. User B if they exceed User A's order limit.

  2. Approval By User and Account

...

  1. - the most widely-used mode. User A's orders can be approved by any user on the same account

...

  1. who has the required

...

  1. Approval Limit

  2. Advanced Approval By User and Account

...

  1. - for organisations with complex approval hierarchies and approval groups. This mode offers advanced options

...

  1. , e.g., multi-person

...

 

Mode 2 (Approval by User and Account) meets the approval needs of most organisations, however businesses with approval hierarchies may require mode 3.

 

Implementation

Approval By User

This is a simple order approval process. An order limit is set for the user, as well as the nominated approver. Any orders over the limit will require approval. When the user submits an order, an email is sent to the Approver containing information about the order and a link to the order approvals page. The Approver clicks the link, logs into the website and reviews the order. After either approving or rejecting the order, an email notification is sent to the original user. 

...

  1. approvals and the option to allow the order submitter to cancel 'pending approval' orders and re-assign approvers. 


Set up Order Approvals

Info
titleEnable Approval by Email


For all modes, to enable the approver to approve or reject directly through the email notification, the setting must be enabled for the Customer account. 

Image Added

To enable this feature:

  1. Go to Customer Maintenance in the CMS or on your website.
  2. Use the Search tool to find the customer account.
    Image Added

  3. Select the customer account.
  4. Click the Customer Details tab.
  5. Tick Enable Email Approval
  6. If you want the approver to add a rejection reason, tick Required Comments on Email Order Rejection.
    Image Added

  7. Click OK.


1. Approval By User

This is the simplest order approval process. A dollar limit is set for the user, and a specific Approver (using their email address) is entered during set up. Any order over the user's limit will require this Approver's Approve or Reject decision. You can set the option of sending an email notification  to the Approver, and allow them to quickly approve or reject the order via links in the email. 

1. Configure system settings:

  1. In the CMS, navigate to

...

  1. Settings

...

  1. Settings

...

  1. .
  2. Select the

...

  1. Orders

...

  1.  tab.
  2. Select the

...

  1. Restrictions and Charges

...

  1.  sub-tab.

...

  1. Find the checkbox labelled Use Advanced Order Approval

...

  1.  and ensure it's unticked.

...

  1. Image Added

    If

...

Once the system-wide setting has been updated, the User's approval settings can be updated:

...

  1. you see a dropdown list instead, set it to Approval By User
    Image Added

  2. To save this setting, click the Update button.

2. Update the user order limits: 

  1. (optional) If you're in the CMS, log into your website in the Administrator role.
  2. Navigate to UsersUser Maintenance.
  3. Search for and select the ordering user.
  4. On the User tab, click Modify.
  5. Update the Order Limit field to the dollar value at which approval will be triggered.
  6. In the Orders Approved By field, enter the email address/user ID of the

...

  1. approving user.

    Image Added
  2. Click

...

  1. OK

...

  1. to save

...

  1. .

TIP - If you have many users to update, you can do it in bulk. See the help page on Data Import for more information


2. Approval By User and Account

Tip

This mode will meet the needs of most organisations. If you'd like more than one user per account to be able to approve orders but don't have complex hierarchies for approval permissions, this is the mode to use.

With this mode, users are given order limits for

...

each order

...

function. For example,

...

User A may have a

...

Requisition Limit

...

 of $999,999.00, and an

...

Order Limit

...

of $200.00. This

...

means User A can submit

...

an order up to $200

...

without approval, but any orders $200.01 - $999,999.00 will require approval.

...

If Users B, C, and D on the same

...

account

...

each have an

...

Approval Limit

...

 greater than the order value, any of them will be able to approve the order. 

(If there isn't a user with an appropriate approval limit for the order,

...

a message will be displayed to

...

Multiple users on the same customer account code can be eligible to approve an order, provided they have the correct approval limits.

 

To Set Up Advanced Order Approval:

...

User A before they submit the order.) 

1. Configure system settings:

  1. In the CMS, navigate to Settings → Settings.
  2. Select the Orders tab.
  3. Select the Restrictions and Charges sub-tab.
  4. In Approval Type, select 'Approval By User and Account'

...

Note

If your site is displaying 'Use Advanced Order Approval' as a checkbox, please get in touch with our Support team. We'll update the field to display the appropriate options.

...

Once the system-wide setting has been updated, the User's '$Limits' settings can be updated:

  1. Navigate to 'Accounts' --> 'Advanced User Maintenance' (/UserMaintenance.aspx?mode=admin).
  2. Search for the required User.
  3. Select the User record via radio button.
  4. Click the 'Accounts' tab.
  5. If the user has multiple Customer Codes, select the correct record via radio button.
  6. On the '$Limits' tab, click 'Edit'.
  7. Set the value in the 'Approval Limit' field to the required dollar amount.
  8. Set the value in the 'Order Limit' field to the required dollar amount.
  9. Set the value in the 'Requisition Limit' field to the required dollar amount.
  10. Click the 'Update' button to save changes.
  11. Repeat Steps 2-10 for other users on the account, including users who will have approval authority.

 

 

Info

For more in-depth information on Advanced Approval of varying types, see Advanced Order Approval - Types.

 

 

...

  1. ).
    Image Added

  2. To save this setting, click Update.


2. Update the user order limits:

Info

If you don't see the 'Order Limit' field on this User tab, get in touch and we'll add it for you!

  1. In the CMS, navigate to UsersWebsite Users (or /zUsers.aspx on your website). 
  2. Search for and Edit the required user.
  3. In the Customer Details section, update the dollar amounts for the user's Order Limit, Requisition Limit, and Approval Limit

    Image Added
  4. If the user has access to multiple accounts, you may wish to update the limits for those as well. 
  5. Click Save & Exit
  6. Repeat Steps 2-5 for other users on the account, including users who will have approval authority.

TIP - If you have many users to update, you can do it in bulk. See our help page on Data Import for more information. 


3. Advanced Approval by User and Account


Info

If you want to use Mode 3 approvals, see the help pages on Advanced Order Approval by User and Account and Approval Groups to determine the best set-up for your customers. Due to complexity, you may require some consultation with us to determine the best route.

Feel free to contact us for assistance!


Multiexcerpt
MultiExcerptNameAdditional Info

Advanced options can be implemented by Commerce Vision.


Add/Edit Select Appprover Widget

The Select Approver Widget must be added and active for the Select Approver panel to appear during checkout.

Select Approver panel - Commerce VisionImage Added

If this panel does not display, check the widget is in the Checkout template. Text and labels for prompts displayed in the panel can be edited in the widget.

 Image Added

Configure Email Notifications 

The Order Approvals feature rely on email notifications to alert the ordering user and any approver(s) at various stages of the process. The content for each email is set in widgets in email templates used by this feature. Which templates are used will depend on the Order Approval settings for the Customer and User. You do not have to add any additional widgets but email text can be customised to suit your business needs.  See Related widgets below. 

Optional Settings

Approval by Email

In Mode 1, against the ordering user, you can set 'Approve' or 'Reject' links in the email the approver receives ('Order Approval Email') after the order has been submitted. Clicking the link allows the approver to quickly approve or reject the order. 

Image Added  

To add the 'Approve'/'Reject' links in the notification email for an ordering user,

  1. In the Advanced User menu, find the user. 
  2. Click the User tab.
  3. Find the field Enable Email Approver and tick the checkbox.
    Image Added
  4. To save the setting, click OK.


In Modes 2 and 3, this option is set against the Customer account.  


Multiexcerpt
hiddentrue
MultiExcerptNameFeature Title

Order Approvals



Minimum Version Requirements


Multiexcerpt
MultiExcerptNameMinimum Version Requirements

**.**.**


Prerequisites


Multiexcerpt
MultiExcerptNamePre reqs

--


Self Configurable


Multiexcerpt
MultiExcerptNameSelf Configurable

No


Business Function


Multiexcerpt
MultiExcerptNameBusiness Function

Ordering


BPD Only?


Multiexcerpt
MultiExcerptNameBPD Only

Yes


B2B/B2C/Both


Multiexcerpt
MultiExcerptNameB2B/B2C/Both

B2B


Third Party Costs


Multiexcerpt
MultiExcerptNameThird Party Costs

n/a



Related help

Content by Label
showLabelsfalse
max

...

6
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
excludeCurrenttrue
cqllabel in ("approvals","orders") and type = "page" and space = "KB" and text ~ "\"order approvals\""
labelsapproval order requisition limit

Content by Label
showLabelsfalse
showSpacefalse
titleRelated widgets
excludeCurrenttrue
cqllabel = "widget" and title ~ "order approval"