Receiving purchase orders via EDI (ORDERS)

With an ORDERS message, you receive a purchase order from bol. The message contains the order number, the items, the quantities, the prices and the requested delivery date. All messages you send afterwards (ORDRSP, DESADV and INVOIC) refer to this order number.

Need help
Automation
EDI with bol
Receiving purchase orders via EDI (ORDERS)

In short

  • The bol order number is in BGM+220. Send it back exactly as received in RFF+ON in your ORDRSP, DESADV and INVOIC.
  • The price and EAN in the order are fixed. The order is based on the most recently processed offer feed.
  • Confirm the order within two business days with an ORDRSP (if ORDRSP is part of your message combination).

When do you receive an ORDERS?

Every purchase order that bol places with you is received as an ORDERS message via Transus. This applies to every EDI connection. The order is based on the most recently processed offer feed: the price, availability and delivery settings in your offer feed determine the order data. Keep your offer feed up to date.

What it contains

  • The bol order number and the order date.
  • The GLNs of the buyer (bol), the supplier, the bol warehouse where the delivery must go and the invoicee.
  • Per line: the EAN, the ordered quantity, the requested delivery date and the net price per unit.
  • The number of order lines as a check.

What you do with the order

  • Use the bol order number from BGM+220 in all your follow-up messages, in RFF+ON, exactly as received. A missing digit results in “Purchase Order not found”.
  • Deliver to the warehouse in NAD+DP. See the overview of GLNs per warehouse.
  • The price and EAN are fixed. If you cannot deliver at the ordered price, cancel the order line in your ORDRSP. Do not deliver a replacement item.
  • The price in the order is leading for the invoice.
  • Would you like to receive changes and cancellations from bol via EDI instead of by email? This is possible with the optional ORDCHG (Order Change) extension. Bol activates this for you.

Key technical details

Data
EDIFACT
Explanation
Message type and order number
BGM+220
The bol order number. You send this number back in RFF+ON.
Order date
DTM+137
Date on which bol placed the order.
Backorder indication
RFF+ADE
Optional, for example RFF+ADE:BACKORDER-Y.
Buyer
NAD+BY
Bol: 8712423020597, with bol’s VAT number in RFF+VA.
Supplier
NAD+SU
Your own GLN.
Delivery address
NAD+DP
The GLN of the bol warehouse you deliver to.
Invoicee
NAD+IV
Bol: 8712423020597.
Currency
CUX
The currency of the order.
Item
LIN with EN
The ordered EAN.
Ordered quantity
QTY+21
The ordered quantity per line.
Requested delivery date
DTM+2
Per order line.
Net price
PRI+AAA
The net price per unit.
Number of lines
CNT+2
Control total: the number of order lines in the message.

Example of an order

This fragment only shows the key segments and is not a complete EDIFACT message. The values are fictitious.

BGM+220+8123456+9'
DTM+137:20261028:102'
RFF+ADE:BACKORDER-Y'
NAD+BY+8712423020597::9++BOL.COM BV+Postbus 8080+Utrecht++3503 RB+NL'
NAD+SU+8700000000007::9'
NAD+DP+8712423020603::9++BOL.COM BV+Veerweg 16+Waalwijk++5145 NS+NL'
NAD+IV+8712423020597::9++BOL.COM BV+Postbus 8080+Utrecht++3503 RB+NL'
CUX+2:EUR:9'
LIN+1++8712345678906:EN'
QTY+21:12'
DTM+2:20261105:102'
PRI+AAA:18.50'
LIN+2++8712345678913:EN'
QTY+21:6'
DTM+2:20261105:102'
PRI+AAA:24.00'
UNS+S'
CNT+2:2'

Testing and approval

  • During onboarding, bol sends a test order for 3 EANs that are active in your offer feed. This is a real test order that you do not deliver.
  • Use the test indicator in all your test messages. Turn it off as soon as you go live.
  • With the test order, you receive an instruction per EAN (fully accept, fully cancel, partially). Respond to it with your ORDRSP.
Test
Required
Expected result
Test order received
Yes
Your system receives the order and correctly reads the order number, EANs, quantities, prices and delivery date.
Order number sent back
Yes
Your ORDRSP, DESADV and INVOIC contain the order number from BGM+220 in RFF+ON.
Approval criteria
  • The ORDERS arrives in your system via Transus.
  • Your system correctly reads the order number, EANs, quantities, prices and delivery date.
  • Your follow-up messages refer to the correct bol order number.

Check after receipt

  • The order number has been copied correctly.
    The number from BGM+220 is complete in your system, with no missing digits.
  • Price and EAN match your offer feed.
    If something differs, update your offer feed. It does not change in the order.
  • The warehouse is known.
    The GLN in NAD+DP is a bol warehouse from the overview of GLNs per warehouse.
  • The delivery date is feasible.
    If you cannot deliver on DTM+2, send the date on which you can deliver in your ORDRSP: action 6 with the new date in DTM+67, and BGM+4 in the header.

Documentation and support

View the full ORDERS EDIFACT specification →

View the overview of GLNs per warehouse →

Onboarding, message scope, functional setup or activating ORDCHGedi@bol.com
Order content, GTINs, quantities, GLNs, SSCCs, order matching or a rejected messagesupplierorder@bol.com
Technical connection (AS2, certificates, sending or receiving messages, technical validation)support@transus.nl

Further reading

Back to EDI onboarding | View ORDRSP | View DESADV