We are happy to introduce order Cancellation Codes to the Dsco platform. These codes allow both retailers and suppliers to share exact details on what went wrong with a cancelled order.

In addition, you can customize the Dsco's cancellation codes that you want to use by using the Cancel Code Mapping tool. This article will show you how to use the cancel codes as well as setup your cancel code mapping.

How to Use Cancel Codes - PORTAL

1) Follow the steps in the portal to get to the order's Cancellation page: Cancel a Line Item in Dsco.

2) You should now see a dropdown where you can select the Reason Code behind the cancellation.

How to Use Cancel Codes - FLAT FILE (.XLS, .CSV, .TAB)

Cancel codes can be indicated on any flat file by using the "line_item_cancel_code" field. See this example from a .XLS spreadsheet:

You can reference the Dsco schema and download the cancellation template here: Dsco Data Schema

How to Use Cancel Codes - EDI

The Dsco EDI spec supports cancel codes given on the 870. Specifically, you can indicate this code on the ISR03 segment.

Example:

ISR*IC*20190715*W01

This segment is indicating that the order is cancelled (IC), the date stamp, and the reason code being "out-of-stock" (W01). Please see the list of Support Cancellation codes below, and note that EDI has its own set of ISR03 codes outside of the default Dsco codes. 

For those using the original Kohl's EDI 856 mapping for cancellations, the cancel code should be included on the REF 'ZZ' segment. The ISR03 code should be given on REF02 with 'line_item_cancel_code' on REF03.

Example: 

REF*ZZ*W01*line_item_cancel_code

Updated Kohl's 856 specifications can be accessed here.

How to Use Cancel Codes - API

For API users, please include a "cancelCode" string with the appropriate code to your Order Status updates.

Example:

    "cancelCode": "CXSD",

    "cancelledQuantity": 1,

The "CXSD" code indicates that the quantity cancelled was due to being discontinued. 

For additional information you can reference the API Order Status documentation here.

Supported Cancellation Reasons

Here are the reasons you can assign to a cancellation:

Note: Not all cancellation codes listed here may be available to you. These codes are determined by the retailer via the CANCEL CODE MAPPING page (see below).

EDI users should reference the "EDI ISR03 Code" rather than the "Dsco Cancel Code" (suppliers only).

Initiated by... Cancellation Reason Dsco Cancel Code EDI ISR03 Code
Description
Supplier Out of Stock CXSS
W01
The item(s) ordered are currently out-of-stock.
Supplier
Discontinued CXSD
W08
The item(s) ordered are currently discontinued.
Supplier
Bad Address CXSB
A03
The shipping address on the order is incorrect or invalid.
Supplier
Invalid Ship Instructions CXSI
051
Shipping instructions are invalid.
Supplier
Can't Ship On Time CXST
D50
Supplier cannot ship the item(s) by a required delivery date.
Supplier
Cancelled at Retailer Request CXSC
ABN
Retailer requested the supplier to cancel the item(s).
Supplier
Other CXSO
A13
Any other reason not covered by a cancellation code.
Retailer Customer Regret CXRR
N/A Order cancelled at customer request.
Retailer Fraud
CXRF
N/A Fraudulent purchase.
Retailer Non-compliant
CXRN
N/A Processing delay by the supplier.
Retailer Other CXRO N/A Any other reason not covered by a cancellation code.

Cancel Code Mapping

If you want to use something other than the Dsco default codes to identify the cancellation reasons, go to the Cancel Code Mapping tool by clicking the gear icon on the bottom-left side of the page, select Account Settings, and then select MAPPING SETTINGS. You can then open the Cancel Code Mapping drop down.

From there you can view the list of Reason Codes assigned to each cancellation. Notice that rows highlighted indicate codes enabled by your trading partner.

Click on the Customize box to input your own custom reason code:

Click on Save Changes when finished. You can now send in your own customized code for any order cancellation.

Warning! If you are using EDI to send in cancel codes the Cancel Code Mapper will not apply to you. Instead, please use the ISR03 standard codes listed on the table above. You can also reference the ISR03 codes here.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.