Purchase order change

nutrab2b.order.changed.v2 · Ordering

Purpose: Buyer changes quantity, date, price, ship-to or adds/removes lines. Requires a new PO response.
When to send: Demand change before shipment.
Sender → receiver: Buyer → Supplier
Expected responses: PO_RESPONSE, ACK
Equivalent standards: X12: 860 · EDIFACT: ORDCHG · SAP: ORDCHG IDoc
Scenarios using it: Quantity change after acknowledgement

Fields and mappings

Field	Type	Req	Description	Code list / format
po_number	string	yes	PO changed
change_no	integer	yes	Change sequence
changes	array<object>	yes	Changes
line_no	integer	yes	PO lineNB-R014
reason	string	yes	Change type	change_reason
new_quantity	object		New quantity
value	number	yes	Quantity
uom	string	yes	Unit of measure	uom
new_date	date		New date
new_price	object		New price
amount	number	yes	Amount in major units, decimals ≤ currency minor unitsNB-R011
currency	string	yes	Currency	currency

Business rules

NB-R014 Line reference unknown, response, ship notice or invoice line refers to a PO line that does not exist.

Example

{
  "specversion": "2.0",
  "id": "evt-po_change-PO-55012-1",
  "type": "nutrab2b.order.changed.v2",
  "source": "urn:gln:0614141000012:erp",
  "subject": "PO-55012",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/PO_CHANGE.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "PO_CHANGE:PO-55012:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "po_number": "PO-55012",
    "change_no": 1,
    "changes": [
      {
        "line_no": 1,
        "reason": "QTY",
        "new_quantity": {
          "value": 600,
          "uom": "KGM"
        }
      }
    ]
  }
}

Mapping checklist

Every required field populated from your system of record
Coded fields mapped to the Bodylia OpenB2B code lists
GLN, GTIN and SSCC check digits validated
Rules above pass in the validator
Idempotency key and per-subject sequence generated
Expected responses, including rejections, handled