Receiving order changes via EDI (ORDCHG)

With an ORDCHG, you receive cancellations, changed quantities and date changes of an existing order via EDI instead of by email. ORDCHG is optional.

Need help
Automation
EDI with bol
Receiving order changes via EDI (ORDCHG)

ORDCHG has to be activated by bol

New EDI suppliers agree on this during onboarding. Already connected via EDI? Email edi@bol.com. As long as ORDCHG is switched off, you receive changes by email.

In short

  • You receive cancellations, changed quantities and date changes as an EDI message, so your system processes them automatically instead of someone copying them from emails.
  • You link the message to the order using the bol order number in RFF+ON.
  • You do not need to send anything back.

What is ORDCHG?

If bol changes the quantity or the delivery date of an order line, or cancels an order line or the entire order, you receive this by email by default. The message always contains the full order, with per line whether it changed. With ORDCHG, the change arrives as an EDI message via Transus. Your system then processes it automatically, without anyone having to copy it from an email. You still receive a new order as ORDERS.

Having ORDCHG activated

  • New EDI supplier? Mention it during onboarding. Bol activates ORDCHG when you go live. Processing the changes is your responsibility.
  • Already connected via EDI? Email edi@bol.com with your supplier number.
  • Once bol activates ORDCHG, you receive changes only via EDI and no longer by email.

Types of changes

Change
In the message
What you do
Quantity reduced (part cancelled)
Action code 3 in LIN. QTY+18 = original quantity, QTY+21 = new quantity, QTY+182 = cancelled quantity
Deliver and invoice only the new quantity (QTY+21).
Order line cancelled
Action code 3 in LIN, QTY+21 is 0, QTY+182 = the full quantity
Do not deliver or invoice this line.
Entire order cancelled
All lines with action code 3 and QTY+21 is 0
Do not deliver or invoice the order.
Delivery date changed
The new requested delivery date in DTM+2
Plan the delivery on the new date in DTM+2.
Unchanged lines
Action code 4 in LIN, QTY+21 equal to QTY+18, QTY+182 is 0
Nothing changes for these lines.

Per line, QTY+21 (new quantity) plus QTY+182 (cancelled quantity) always equals QTY+18 (original quantity). You can use either the new quantity or the cancelled quantity; both give the same result. The message contains all lines of the order, also the unchanged ones. The requested delivery date is in DTM+2 on every line: always plan on that date. Your DESADV and INVOIC follow the changed order.

Key technical details

Data
EDIFACT
Explanation
Message type
BGM+230
Order change. The number is the bol order number.
Bol order number
RFF+ON
Equal to BGM+220 in the ORDERS.
Original order date
DTM+171
The date of the original order.
Order line and action
LIN with EN
The EAN from the order. Action code 3 = quantity changed (partly or fully cancelled), 4 = unchanged.
Quantity
QTY+21
The quantity after the change. 0 for a cancellation.
Original quantity
QTY+18
The quantity in the original order.
Cancelled quantity
QTY+182
The cancelled quantity. 0 if nothing is cancelled.
Delivery date
DTM+2
The requested delivery date.
Net price
PRI+AAA
The price per unit from the order.

Example of an order change

Fragment with fictitious values, not a complete EDIFACT message. Line 1 is unchanged (4), line 2 is partly cancelled (3), line 3 is fully cancelled (3).

BGM+230+8123456+9'
DTM+137:20261030:102'
RFF+ON:8123456'
DTM+171:20261020:102'
NAD+BY+8712423020597::9'
NAD+SU+8700000000007::9'
NAD+DP+8712423020603::9'
LIN+1+4+8712345678906:EN'
QTY+18:12'
QTY+21:12'
QTY+182:0'
DTM+2:20261112:102'
PRI+AAA:18.50'
LIN+2+3+8712345678913:EN'
QTY+18:4'
QTY+21:3'
QTY+182:1'
DTM+2:20261112:102'
PRI+AAA:24.00'
LIN+3+3+8712345678920:EN'
QTY+18:6'
QTY+21:0'
QTY+182:6'
DTM+2:20261112:102'
PRI+AAA:9.95'
UNS+S'
CNT+2:3'

Documentation and support

Onboarding, message scope, functional setup or activating ORDCHGedi@bol.com
Questions about a change to an ordersupplierorder@bol.com
Technical connection (AS2, certificates, sending or receiving messages, technical validation)support@transus.nl

Further reading

Back to EDI onboarding | View ORDERS | View ORDRSP