Description of the order
Introduction
The Order Response Status (hereinafter called Order Response) is sent from a Seller to a Buyer, to inform the Buyer about the latest status of the related purchase order.
Process
The Order Response is submitted by the Seller to Onetrail TPN. Onetrail TPN processes the Order Response and submits it to the Buyer in their requested format.
The time between Orders and Order Status (Update) varies per Seller and depends on when the Order Status (Update) Messages are delivered to Onetrail by the Seller.
For examples about the supported order response scenarios we refer to: order response examples
Order Status scenarios
Onetrail TPN supports the following Order Status scenarios (or combinations):
- Scenario 1: Order Confirmed without changes;
- Scenario 2: Order Confirmed with changes;
- Scenario 3: Order on-hold;
- Scenario 4: Order-line on-hold;
- Scenario 5: Order Deleted;
- Scenario 6: Order Line(s) Deleted;
- Scenario 7: Order-line is added;
- Scenario 8: Order-line is split;
For information on the scenarios are detailed in the Syntax paragraph.
Content
The Global Location Numbers (formerly known as EAN address codes) is used to refer to companies and addresses in order messages. These codes can be supplied by Onetrail unless a Trading Partner already has GLNs. The following GLNs are relevant to the Order Response Message (OrdRsp):
UBL XML:
- To identify the Seller: SellerSupplierParty
- To identify the Buyer: BuyerCustomerParty
- Where the goods are shipped to in case of warehouse shipment: DeliveryLocation
Onetrail XML:
- To identify the Seller: fromRole
- To identify the Buyer: toRole
- Where the goods are shipped to in case of warehouse shipment: ShipTo
Edifact:
- To identify the Buyer: UNB020, S002, 0004
- To identify the Seller: UNB020, S002, 0004
- Where the goods are shipped to in case of Warehouse Shipment: NAD+ST
The planned shipment date is available in the order response messages. The planned shipment date can be "provided" and / or "calculated" in the order response.
The provided shipment date is mandatory, while the calculated shipment date is optional in the order response.
Several scheduled events are available. The following options are supported:
- Ship
- Ship Calculated
- Delivery
- Delivery Calculated
for UBL, only Delivery dates are supported
UBL XML:
<cac:Delivery> <cac:PromisedDeliveryPeriod> <cbc:StartDate>2024-12-06</cbc:StartDate> <cbc:EndDate>2024-12-06</cbc:EndDate> </cac:PromisedDeliveryPeriod> </cac:Delivery>
Onetrail XML:
<tns:scheduledEvent> <tns:TransportationEvent> <tns:DateStamp>20140307T000000</tns:DateStamp> <tns:GlobalTransportEventCode>Ship</tns:GlobalTransportEventCode> </tns:TransportationEvent> </tns:scheduledEvent> <tns:scheduledEvent> <tns:TransportationEvent> <tns:DateStamp>201403010T000000</tns:DateStamp> <tns:GlobalTransportEventCode>Delivery</tns:GlobalTransportEventCode> </tns:TransportationEvent> </tns:scheduledEvent>
Format & Syntax
UBL XML
The format of the UBL XML messages is XML version 1.0. The encoding must be UTF-8.
Onetrail XML
The format of the Onetrail XML messages is XML version 1.0. The encoding must be UTF-8.
For more information about the syntax of the order response please refer to: technical documentation order response
EDIFACT
Besides UBL and Onetrail XML, Onetrail also supports a standard Edifact D97A ORDRSP besides a lot of other industry standards. For more information about supported standards we refer to: Available Industry Standards
Communication
For more information about the supported communication methods, please refer to: communication methods
Examples
Please refer to the examples: Order response
Supported processes by Onetrail TPN in the Order Response Message
In this section we describe the various supported processes in the Order Response Message. The availability of each individual Onetrail TPN supported process for each Seller may vary depending on their capabilities as shown in the table Overview Supported Processes Order Response Message. Each process is described in the subsections below. For more information about which Seller supports which process types in the Order Response Message, please contact our TPN Delivery Team by phone at +31 30 697 32 88 or by e-mail TPN.Delivery@Onetrail.com
Time between Order and Order Status Updates
The time between Orders and Order Status (Update) varies per Seller and depends on when the Order Status (Update) Messages are delivered to Onetrail by the Seller.
Status updates with the Order Response Process
A status update for the entire Order (on header level) and/or for each order line can be provided by the Seller.
It will give an insight of the current status of the Order at the Seller.
UBL XML usage:
Possible values on order header level are:
- AB: Message acknowledgement
- AP: Accepted
- RE: Rejected
- CA: Conditionally accepted
Possible values on order line level are:
- 1: Order line is added
- 3: Changed
- 5: Accepted without amendment.
- 7: Not accepted
- 42: Already delivered
Onetrail XML usage:
Possible values on order header level are:
- 'Accept' (Order is accepted by the seller)
- 'Reject' (Order is on hold)
- 'Change' (Order is accepted with modifications)
- 'Delete' (Order is deleted)
Possible values on order line level are:
- 'Accept' (Line is accepted without changes)
- 'Change' (Line is modified by Seller)
- 'Add' (Line is added by Seller)
- 'Reject' (Line is on hold)
- 'Delete' (Line is deleted)
EDIFACT usage:
On header level use the Message function code in the BGM segment for this.
Possible values on order header level are:
- '29' (Order is Accepted without amendment by the Seller)
- '27' (Order is Not Accepted/on hold)
- '4' (Order is Changed/accepted with modifications)
- '3' (Order is Deleted)
On line level use the Action request/notification coded in the LIN segment for this.
Possible values on order line level are:
- '5' (Line is accepted without changes)
- '6' (Line is accepted with changes)
- '3' (Line is modified by Seller)
- '1' (Line is added by Seller)
- '7' (Line is not accepted/on hold)
- '2' (Line is deleted)
The usage for these status codes are described further below. As a general response rule, the quantities reported in the and elements combined must be the same value as the ordered quantity.
Onetrail checks on actual changes in the Order Status Updates
Some Sellers are not able to inform the Buyer about only the changes on order line level of the purchase order.
Or there are Sellers who send out an update as long as an order is not delivered completely.
Due to this the Buyer is receiving a lot of updates about the purchase order, without any significant changes.
Onetrail is able to check if there are changes on the Order Line Level in the received Order Status Update from the Seller.
When there is a change Onetrail will send an Order Status Update to the Buyer. If not: Onetrail will block the outbound message to the Buyer.
Ship Date or ETA
Sellers use different dates in their Order Status Messages.
Onetrail you will inform the Buyer about which Seller is sending which dates in the Order Status Messages.
For instance, the ship date is a mandatory requirement, while the Seller can optionally add a delivery date, such as an estimated time of arrival (ETA), to the Order Status Message.
Use of purchase order line numbers
When the Seller is able to add the purchase order line number in their ERP on the received Orders and they can send it back in the Order Response Message, The Buyer can use 'their' purchase order line number on the Order Response Message to match the used line numbers in the Purchase Order.
This is mostly supported when Orders are placed electronically (via Onetrail TPN).
Be aware that not all Sellers are able to store the Purchase Order line numbers in their ERP system, in such a case, Onetrail will try to align the Order Response with the Purchase Order and add the purchase order line number to the Order Response.
Supported product codes in the Order Response Message
Onetrail supports different product codes in the Order Response Message from the Seller:
- Seller Product Codes: Stock Keeping Unit number (SKU).
- Manufacturers / Vendor Product Codes: Manufacturer Part Number (MFPN) / Vendor Part Number (VPN).
- GTIN / EAN Product Codes: Global Trade Item Number (GTIN) / European Article Number (EAN) (a.k.a. International Article Number) a unique product code supplied by GS1.
- Buyer Product Codes: own product code for Buyers.
UBL XML usage:
<cac:Item> <cbc:Name>Canon 719 - Black - original - toner cartridge - for i-SENSYS LBP251, LBP252, LBP253, LBP6310, MF411, MF416, MF418, MF419, MF6140, MF6180</cbc:Name> <cac:SellersItemIdentification> <cbc:ID>SKUB002</cbc:ID> </cac:SellersItemIdentification> <cac:ManufacturersItemIdentification> <cbc:ID>3479B002</cbc:ID> </cac:ManufacturersItemIdentification> <cac:StandardItemIdentification> <cbc:ID schemeID="0160">4960999650289</cbc:ID> </cac:StandardItemIdentification> </cac:Item>
Onetrail XML usage:
ProductIdentification/PartnerProductIdentification/GlobalPartnerClassificationCode = "Seller" , "Manufacturer", "Ean" or "Buyer".
<PartnerProductIdentification> <GlobalPartnerClassificationCode>Manufacturer</GlobalPartnerClassificationCode> <ProprietaryProductIdentifier>20E2000CMH</ProprietaryProductIdentifier> </PartnerProductIdentification>
EDIFACT usage:
Include:
On line level use Segment 26: LIN
Item number type coded: SA
Example: LIN+1+5+BDPS3700B:SA'
Include:
On line level use Segment 26: PIA
Item number type coded: MF
Item number type coded: EN
Item number type coded: BP
Example:
PIA+1+6655443322:MF'
PIA+1+4548736013568:EN'
PIA+1+123456:BP'
Important Scenario examples and date usage
Please note that the examples/snippets as shown below are copied directly from the UBL XML, Onetrail XML or Edifact messages.
Scenario 1: Order Confirmed without changes
Products can be delivered at the requested delivery date for the given price.
- Result:
Order header Status = Accept
Order line Status = Accept
XML usage:
- Header
<GlobalPurchaseOrderStatusCode>Accept</GlobalPurchaseOrderStatusCode> |
- Order Line 1
<GlobalPurchaseOrderStatusCode>Accept</GlobalPurchaseOrderStatusCode> |
EDIFACT usage:
- Header
BGM+231+0420360072+29'
- Order Line 1
LIN+1+5+BDPS3700B:SA'
QTY+21:5:EA'
QTY+187:5:EA'
D+2:20170920:102'
D+76:20170920:102'
MOA+146:81.90'
MOA+203:409.50'
PRI+AAA:81.9'
Scenario 2: Order Confirmed with changes
Products can't be delivered at the requested delivery date for the given price.
- Result:
Order header Status = Change
Order line Status = Change
XML usage:
- Header
<GlobalPurchaseOrderStatusCode>Change</GlobalPurchaseOrderStatusCode> |
- Order Line 1
<GlobalPurchaseOrderStatusCode>Change</GlobalPurchaseOrderStatusCode> |
EDIFACT usage:
- Header
BGM+231+0420360072+4'
- Order Line 1
LIN+1+6+BDPS3700B:SA'
QTY+21:5:EA'
QTY+187:5:EA' or QTY+83:5:EA'
D+2:20170920:102'
D+76:20170921:102'
MOA+146:81.90'
MOA+203:409.50'
PRI+AAA:81.9'
Scenario 3: Order on-hold
When there are price differences, delivery date check with manufacturer is needed, sales block on order, credit check is done, stock availability in warehouse needs extra checking because of physical difference vs ERP, products are stopped for sale (technical issue), etc. the order can be On-Hold.
- Result:
Order header Status = Reject
Order line Status = Reject
XML usage:
- Header
<remarks> |
- Order Line 1
<remarks> |
EDIFACT usage:
- Header
BGM+231+0420360072+27'
D+2:20170920:102'
D+17:20440404:102'
FTX+ZZZ+one or more lines on hold'
- Order Line 1
LIN+1+7+BDPS3700B:SA'
QTY+21:5:EA'
QTY+187:5:EA'
D+2:20170920:102'
D+76:20440404:102'
MOA+146:81.90'
MOA+203:409.50'
FTX+ZZZ+line on hold-finance block'
PRI+AAA:81.9'
Scenario 4: Order-line on-hold
Instead of the whole Order is put On-Hold, only one or more lines can be On-Hold
- Result:
Order header Status = Change
Order line Status = Reject
XML usage:
- Header
<remarks> |
- Order Line 1
<remarks> |
The other order lines are still expected to be delivered and/or are placed in back order.
EDIFACT usage:
- Header
BGM+231+0420360072+4'
D+2:20170920:102'
D+17:20170920:102'
FTX+ZZZ+one or more lines on hold'
- Order Line 1
LIN+1+7+BDPS3700B:SA'
QTY+21:5:EA'
QTY+187:5:EA'
D+2:20170920:102'
D+76:20440404:102'
MOA+146:81.90'
MOA+203:409.50'
FTX+ZZZ+line on hold-CS delivery block'
PRI+AAA:81.9'
The other order LIN segments are still expected to be delivered and/or are placed in back order.
Scenario 5: Order Deleted
When the order isn't accepted (anymore) for Sales reasons or on request of the Buyer the order can be deleted.
- Result:
Order header Status = Delete
Order line Status = Delete
XML usage:
- Header
<remarks> |
- Order Line 1
<remarks> |
EDIFACT usage:
- Header
BGM+231+0420360072+3'
D+2:20170920:102'
D+17:20440404:102'
FTX+ZZZ+order deleted'
- Order Line 1
LIN+1+2+BDPS3700B:SA'
QTY+21:5:EA'
QTY+182:5:EA'
D+2:20170920:102'
D+76:20440404:102'
MOA+146:81.90'
MOA+203:409.50'
FTX+ZZZ+line deleted-canceled by customer'
PRI+AAA:81.9'
Scenario 6: Order Line(s) Deleted
When an Order Line isn't accepted (anymore) for Sales reasons or on request of the Buyer one or more Order Line(s) can be deleted.
- Result:
Order header Status = Change
Order line Status = Delete
XML usage:
- Header
<remarks> |
- Order Line 1
<remarks> |
The other order lines are still expected to be delivered and/or are placed in back order.
EDIFACT usage:
- Header
BGM+231+0420360072+4'
D+2:20170920:102'
D+17:20170920:102'
FTX+ZZZ+one or more lines canceled'
- Order Line 1
LIN+1+2+BDPS3700B:SA'
QTY+21:5:EA'
QTY+182:5:EA'
D+2:20170920:102'
D+76:20440404:102'
MOA+146:81.90'
MOA+203:409.50'
FTX+ZZZ+line deleted-Product EOL'
PRI+AAA:81.9'
The other order LIN segments are still expected to be delivered and/or are placed in back order.
Scenario 7: Order-line is added
An extra product can be added to the Order like a promotional Product or a substitute Product (Deleted Line and new one added).
- Result:
Order header Status = Change
Order line Status = Add
XML usage:
- Header
<GlobalPurchaseOrderStatusCode>Change</GlobalPurchaseOrderStatusCode> |
- Order Line 1
<buyerLineItem/> |
EDIFACT usage:
- Header
BGM+231+0420360072+4'
D+2:20170920:102'
D+17:20170920:102'
- Order Line 1
LIN+1+1+BDPS3700B:SA'
QTY+21:0:EA'
QTY+187:5:EA'
D+2:20170920:102'
D+76:20170920:102'
MOA+146:81.90'
MOA+203:409.50'
PRI+AAA:81.9'
RFF+LI:'
Scenario 8: Order-line is split
XML usage:
When the Order will be partially delivered, the quantity which is available for delivery will be shipped immediately and the quantity which is not available will be put in back-order.
The Seller reports back to the Buyer if the remaining quantity can be delivered for the same price, same date or even at all.
In this case the Seller Order Response contains a split Buyer order line scenario for the original ordered goods.
The first part of the Buyer order line gets status Change.
The quantity which can be delivered (less then ordered) needs to be put into scheduledShipQuantity.
The second part of the Buyer order line will either get status Change, Reject or Delete depending on the split reason:
- Use Change only if the price(s) and/or delivery date(s) deviates from the first split order line.
In case of an unknown delivery date, use the Onetrail defined generic 'Unknown' date 04-04-2044 to indicate an unknown Delivery Date.
- Use status Reject (On Hold) instead in case there is a technical, financial or stock issue with the delivery of the remaining quantity;
- Use Delete if the remaining quantity will not be delivered;
For every possible scenario, the remaining quantity which is not equal to the ordered quantity, must be specified in the ScheduledShipQuantity. The total of all ScheduledShipQuantity mentioned in each split line, must be equal to the original OrderedQuantity when added up together.
- Result:
Order header Status = Change
Order line Status = Change
XML usage 8a Split line Change/Backorder
Remark: Use the Onetrail defined generic 'Unknown' date 04-04-2044 to indicate unknown Delivery Date. As soon as a Delivery Date is available, send through the new Delivery Date with the same status Change, in the next OrdRsp message.
- Header
<GlobalPurchaseOrderStatusCode>Change</GlobalPurchaseOrderStatusCode> |
- Order Line 1
<buyerLineItem> |
- Order Line 2
<buyerLineItem> |
XML usage 8b Split line Reject/On-Hold
- Header
<remarks> |
- Order Line 1
<buyerLineItem> |
- Order Line 2
<buyerLineItem> |
XML usage 8c Split line Delete/End Of Life(EOL)
- Header
<remarks> |
- Order Line 1
<buyerLineItem> |
- Order Line 2
<buyerLineItem> |
Remark: In this scenario, if the Deleted quantity of 50 is communicated after the first quantity of 150 is already shipped, the first of the split lines in the second Order Response can also provide the quantity of 150 as already delivered, by moving it from 'scheduledShipQuantity' to the 'shippedQuantity'.
- Order Line 1
<buyerLineItem> |
- Order Line 2
<buyerLineItem> |
EDIFACT usage:
When the Order will be partially delivered, the quantity which is available for delivery will be shipped immediately and the quantity which is not available will be put in back-order.
The Seller reports back to the Buyer if the remaining quantity can be delivered for the same price, same date or even at all.
In this case the Seller Order Response contains a split Buyer order line scenario for the original ordered goods.
The first part of the Buyer order line gets status Change.
The quantity which can be delivered (less then ordered) needs to be put into Quantity scheduled (QTY+187).
The second part of the Buyer order line will either get status Changed (3), Not Accepted (7) or Deleted (2) depending on the split reason:
- Use Changed (3) only if the price(s) and/or delivery date(s) deviates from the first split order line.
In case of an unknown delivery date, use the Onetrail defined generic 'Unknown' date 04-04-2044 to indicate an unknown Delivery Date.
- Use status Not Accepted/On-Hold (7) instead in case there is a technical, financial or stock issue with the delivery of the remaining quantity;
- Use Deleted (2) if the remaining quantity will not be delivered;
For every possible scenario, the remaining quantity which is not equal to the ordered quantity, must be specified in the Quantity scheduled (QTY+187) or Backorder Quantity (QTY+83). The total of all Quantity scheduled (QTY+187) and Backorder Quantity (QTY+83) and Canceled Quantity (QTY+182) and Supplied Quantity (QTY+169) mentioned in each split line, must be equal to the original Ordered Quantity (QTY+21) when added up together.
- Result:
Order header Status = Change
Order line Status = Change
Edifact usage 8a Split line Change/Backorder
Remark: Use the Onetrail defined generic 'Unknown' date 04-04-2044 to indicate unknown Delivery Date. As soon as a Delivery Date is available, send through the new Delivery Date with the same status Change, in the next OrdRsp message.
- Header
BGM+231+0420360072+4'
D+2:20170920:102'
D+17:20170920:102'
- Order Line 1
LIN+1+3+BDPS3700B:SA'
QTY+21:10:EA'
QTY+187:6:EA'
D+2:20170920:102'
D+76:20170920:102'
MOA+146:62.89'
MOA+203:377.34'
PRI+AAA:62.89'
RFF+VN:11223344:001'
RFF+LI:1'
- Order Line 2
LIN+2+3+BDPS3700B:SA'
QTY+21:10:EA'
QTY+83:4:EA'
D+2:20170920:102'
D+76:20171012:102'
MOA+146:62.89'
MOA+203:251.56'
PRI+AAA:62.89'
RFF+VN:11223344:001'
RFF+LI:1'
Edifact usage 8b Split line Reject/On-Hold
- Header
BGM+231+0420360072+4'
D+2:20170920:102'
D+17:20170920:102'
FTX+ZZZ+Order line blocked-CS block'
- Order Line 1
LIN+1+3+BDPS3700B:SA'
QTY+21:10:EA'
QTY+187:6:EA'
D+2:20170920:102'
D+76:20170920:102'
MOA+146:62.89'
MOA+203:377.34'
PRI+AAA:62.89'
RFF+VN:11223344:001'
RFF+LI:1'
- Order Line 2
LIN+2+7+BDPS3700B:SA'
QTY+21:10:EA'
QTY+187:4:EA'
D+2:20170920:102'
D+76:20440404:102'
MOA+146:62.89'
MOA+203:251.56'
FTX+ZZZ+Order line blocked-CS block'
PRI+AAA:62.89'
RFF+VN:11223344:001'
RFF+LI:1'
Edifact usage 8c Split line Delete/End Of Life(EOL)
- Header
BGM+231+0420360072+4'
D+2:20170920:102'
D+17:20170920:102'
FTX+ZZZ+One or more lines canceled'
- Order Line 1
LIN+1+3+BDPS3700B:SA'
QTY+21:10:EA'
QTY+187:6:EA'
D+2:20170920:102'
D+76:20170920:102'
MOA+146:62.89'
MOA+203:377.34'
PRI+AAA:62.89'
RFF+VN:11223344:001'
RFF+LI:1'
- Order Line 2
LIN+2+2+BDPS3700B:SA'
QTY+21:10:EA'
QTY+182:4:EA'
D+2:20170920:102'
D+76:20440404:102'
MOA+146:62.89'
MOA+203:251.56'
FTX+ZZZ+line deleted-Product EOL'
PRI+AAA:62.89'
RFF+VN:11223344:001'
RFF+LI:1'
Remark: In this scenario, if the Canceled/Deleted quantity of 4 is communicated after the first quantity of 6 is already shipped, the first of the split lines in the second Order Response can also provide the quantity of 6 as already delivered, by moving it from 'Quantity scheduled' to the 'Supplied quantity'.
- Header
BGM+231+0420360072+4'
D+2:20170920:102'
D+17:20170920:102'
FTX+ZZZ+One or more lines canceled'
- Order Line 1
LIN+1+3+BDPS3700B:SA'
QTY+21:10:EA'
QTY+169:6:EA'
D+2:20170920:102'
D+76:20170920:102'
MOA+146:62.89'
MOA+203:377.34'
PRI+AAA:62.89'
RFF+VN:11223344:001'
RFF+LI:1'
- Order Line 2
LIN+2+2+BDPS3700B:SA'
QTY+21:10:EA'
QTY+182:4:EA'
D+2:20170920:102'
D+76:20440404:102'
MOA+146:62.89'
MOA+203:251.56'
FTX+ZZZ+line deleted-Product EOL'
PRI+AAA:62.89'
RFF+VN:11223344:001'
RFF+LI:1'
Dates: explanation on how to use the different Delivery and Shipment Dates
Within the Onetrail message format, scheduled events with different date types can be provided by the Sellers indicating the different types of events. Sellers can provide the day and time a shipment leaves the Sellers warehouse. An ultimate date of delivery can be indicated by either earliest or latest delivery date. A Seller can use one of the following enumerations for the element ‘GlobalTransportEventCode’ inside the ‘scheduledEventType’:
- 'Ship' (When the goods leave the Seller's warehouse)
- 'EarliestDelivery' (1st day of the delivery period / window at the Buyer’s warehouse)
- 'LatestDelivery' (Last day of the delivery period / window at the Buyer’s warehouse)
