On this page: |
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.
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):
For information on the scenarios are detailed in the Syntax paragraph. |
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:
Onetrail XML:
Edifact:
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:
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> |
UBL XML
The format of the UBL 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: Peppol BIS version 3 - May 2024 Release |
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
For the EDIFACT documentation please refer to: Edifact order response documentation |
For more information about the supported communication methods, please refer to: communication methods |
Please refer to the examples: Order response |
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
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.
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:
Possible values on order header level are:
Possible values on order line level are:
Possible values on order header level are:
Possible values on order line level are:
On header level use the Message function code in the BGM segment for this.
Possible values on order header level are:
On line level use the Action request/notification coded in the LIN segment for this.
Possible values on order line level are:
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.
With one exception, being the MOQ (Minimum Order Quantity) where the order requested might be eleven pieces and scheduled or shipped might be twelve pieces as there are twelve (minimum order quantity or per twelve) in one package. |
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.
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.
For UBL XML it will be always the delivery date, |
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.
Onetrail supports different product codes in the Order Response Message from the Seller:
<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> |
ProductIdentification/PartnerProductIdentification/GlobalPartnerClassificationCode = "Seller" , "Manufacturer", "Ean" or "Buyer".
<PartnerProductIdentification> <GlobalPartnerClassificationCode>Manufacturer</GlobalPartnerClassificationCode> <ProprietaryProductIdentifier>20E2000CMH</ProprietaryProductIdentifier> </PartnerProductIdentification> |
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'
Scenario Examples: |
Please note that the examples/snippets as shown below are copied directly from the UBL XML, Onetrail XML or Edifact messages.
Products can be delivered at the requested delivery date for the given price.
Order header Status = Accept
Order line Status = Accept
<cbc:OrderResponseCode>AP</cbc:OrderResponseCode> |
<cbc:LineStatusCode>5</cbc:LineStatusCode> |
<GlobalPurchaseOrderStatusCode>Accept</GlobalPurchaseOrderStatusCode> <requestedEvent> <TransportationEvent> <DateStamp>20190429T000000</DateStamp> <GlobalTransportEventCode>Ship</GlobalTransportEventCode> </TransportationEvent> </requestedEvent> <scheduledEvent> <TransportationEvent> <DateStamp>20190429T000000</DateStamp> <GlobalTransportEventCode>Ship</GlobalTransportEventCode> </TransportationEvent> </scheduledEvent> |
<GlobalPurchaseOrderStatusCode>Accept</GlobalPurchaseOrderStatusCode> <requestedQuantity> <ProductQuantity>200</ProductQuantity> </requestedQuantity> <scheduledShipQuantity> <ProductQuantity>200</ProductQuantity> </scheduledShipQuantity> <requestedEvent> <TransportationEvent> <DateStamp>20190429T000000</DateStamp> <GlobalTransportEventCode>Ship</GlobalTransportEventCode> </TransportationEvent> </requestedEvent> <scheduledEvent> <TransportationEvent> <DateStamp>20190429T000000</DateStamp> <GlobalTransportEventCode>Ship</GlobalTransportEventCode> </TransportationEvent> </scheduledEvent> <shippedQuantity> <ProductQuantity>0</ProductQuantity> </shippedQuantity> <totalLineItemAmount> <FinancialAmount> <MonetaryAmount>2400.00</MonetaryAmount> </FinancialAmount> </totalLineItemAmount> <unitPrice> <FinancialAmount> <MonetaryAmount>12.00</MonetaryAmount> </FinancialAmount> </unitPrice> |
BGM+231+0420360072+29' |
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' |
Products can't be delivered at the requested delivery date and/or for the requested price.
Order header Status = Change
Order line Status = Change
<cbc:OrderResponseCode>AP</cbc:OrderResponseCode> |
<cbc:LineStatusCode>3</cbc:LineStatusCode> |
<GlobalPurchaseOrderStatusCode>Change</GlobalPurchaseOrderStatusCode> <requestedEvent> <TransportationEvent> <DateStamp>20160930T1500000</DateStamp> </TransportationEvent> </requestedEvent> <scheduledEvent> <TransportationEvent> <DateStamp>20161003T1500000</DateStamp> </TransportationEvent> </scheduledEvent> |
<GlobalPurchaseOrderStatusCode>Change</GlobalPurchaseOrderStatusCode> <requestedQuantity> <ProductQuantity>200</ProductQuantity> </requestedQuantity> <scheduledShipQuantity> <ProductQuantity>200</ProductQuantity> </scheduledShipQuantity> <requestedEvent> <TransportationEvent> <DateStamp>20160930T1500000</DateStamp> </TransportationEvent> </requestedEvent> <scheduledEvent> <TransportationEvent> <DateStamp>20161003T1500000</DateStamp> </TransportationEvent> </scheduledEvent> <shippedQuantity> <ProductQuantity>0</ProductQuantity> </shippedQuantity> <totalLineItemAmount> <FinancialAmount> <MonetaryAmount>2800.00</MonetaryAmount> </FinancialAmount> </totalLineItemAmount> <unitPrice> <FinancialAmount> <MonetaryAmount>14.00</MonetaryAmount> </FinancialAmount> </unitPrice> |
BGM+231+0420360072+4' |
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' |
When there are price differences, delivery date check with manufacturer is needed, sales block on order, credit check is done, stock differences, products are canceled for sales, etc. the order can be On-Hold for a while.
Order header Status = Reject
Order line Status = Reject
<cbc:OrderResponseCode>RE</cbc:OrderResponseCode> |
<cbc:LineStatusCode>7</cbc:LineStatusCode> |
<remarks> <remark context="RejectReason">Finance block</remark> </remarks> <GlobalPurchaseOrderStatusCode>Reject</GlobalPurchaseOrderStatusCode> |
<remarks> <remark context="RejectReason">Finance block</remark> </remarks> <GlobalPurchaseOrderStatusCode>Reject</GlobalPurchaseOrderStatusCode> |
BGM+231+0420360072+27' D+2:20170920:102' D+17:20440404:102' FTX+ZZZ+one or more lines on hold' |
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' |
Instead of the whole Order is put On-Hold, only one or more lines can be On-Hold
Order header Status = Change
Order line Status = Reject
<remarks> |
<remarks> |
The other order lines are still expected to be delivered and/or are placed in back order.
- 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.
When the order isn't accepted (anymore) for Sales reasons or on request of the Buyer the order can be deleted.
Order header Status = Delete
Order line Status = Delete
<remarks> |
<remarks> |
- 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'
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.
Order header Status = Change
Order line Status = Delete
<remarks> |
<remarks> |
The other order lines are still expected to be delivered and/or are placed in back order.
- 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.
An extra product can be added to the Order like a promotional Product or a substitute Product (Deleted Line and new one added).
Order header Status = Change
Order line Status = Add
<GlobalPurchaseOrderStatusCode>Change</GlobalPurchaseOrderStatusCode> |
<buyerLineItem/> |
- 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:'
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:
In case of an unknown delivery date, use the Onetrail defined generic 'Unknown' date 04-04-2044 to indicate an unknown Delivery Date.
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.
Order header Status = Change
Order line Status = Change
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.
<GlobalPurchaseOrderStatusCode>Change</GlobalPurchaseOrderStatusCode> |
<buyerLineItem> |
<buyerLineItem> |
<remarks> |
<buyerLineItem> |
<buyerLineItem> |
<remarks> |
<buyerLineItem> |
<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'.
<buyerLineItem> |
<buyerLineItem> |
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:
In case of an unknown delivery date, use the Onetrail defined generic 'Unknown' date 04-04-2044 to indicate an unknown Delivery Date.
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.
Order header Status = Change
Order line Status = Change
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.
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'
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'
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'
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'.
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'
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’: