Purchase order

nutrab2b.order.created.v2 · Ordering

Purpose

Firm order with lines, quantities, prices, ship-to, Incoterm, requested dates and quality requirements.

When to send

Buyer commits to buy.

Sender → receiver

Buyer → Supplier

Expected responses

PO_RESPONSE, ACK

Equivalent standards

X12: 850 · EDIFACT: ORDERS · GS1: Order (GS1 XML 3.x) · SAP: ORDERS05 IDoc / ME21N

Scenarios using it

Full order-to-cash · PO rejected below MOQ · Partial acceptance with back-order · PO response must answer every line · Quantity change after acknowledgement · Cancel race after shipment · Split shipment, two lots · Over-shipment beyond tolerance · Multi-pallet, multi-lot SSCC hierarchy · Failed CoA blocks shipment · Out-of-spec lot ships under deviation · Hold blocks shipment until release · Organic certificate expired before shipment · Remaining shelf life too short · Cold-chain excursion · HS 2028: supplements move to 2107.10 · Incoterm vs transport mode conflict · Duplicate delivery (idempotency) · Out-of-order events are parked and released · Dropped event, gap detected, replay · Tampered, mis-signed and replayed messages · Schema version mismatch · Poison message to dead-letter queue · Three-way match failures · Short receipt settled with credit note

Fields and mappings

Business rules

• NB-R005 HS / national code mismatch, national tariff code does not start with the HS code, or is not a national line for the destination.
• NB-R006 Incoterm vs transport mode, sea-only Incoterm (FAS/FOB/CFR/CIF) used with non-sea mode.
• NB-R011 Currency precision, amount has more decimals than the currency's ISO 4217 minor units.
• NB-R015 Date order, dates are in the wrong order (e.g. delivery before order).
• NB-R017 HS 2028 reclassification, from 2028-01-01, dietary supplements in measured doses classify in 2107.10, not 2106.90.

Example

{
  "specversion": "2.0",
  "id": "evt-po-PO-55012-1",
  "type": "nutrab2b.order.created.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.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "PO:PO-55012:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "po_number": "PO-55012",
    "order_date": "2026-11-02",
    "quote_id": "Q-77",
    "incoterm": "FCA",
    "incoterm_place": "Bengaluru airport",
    "transport_mode": "4",
    "payment_terms": "NET30",
    "ship_to": {
      "gln": "0614141000012",
      "name": "NutraBrand DC Reno",
      "address": {
        "city": "Reno",
        "region": "US-NV",
        "country": "US"
      }
    },
    "lines": [
      {
        "line_no": 1,
        "item_id": "ASH-KSM-5",
        "ingredient": "ASHWAGANDHA",
        "description": "Ashwagandha root extract 5%",
        "hs_code": "1302.19",
        "national_code": "1302194000",
        "grade": "USP_DSC",
        "form": "EXTRACT_DRY",
        "quantity": {
          "value": 500,
          "uom": "KGM"
        },
        "unit_price": {
          "amount": 58,
          "currency": "USD"
        },
        "requested_delivery": "2026-12-10",
        "min_shelf_life_days": 540,
        "over_ship_tolerance_pct": 2
      }
    ],
    "required_docs": [
      "COA",
      "COO",
      "ORGANIC_TC"
    ]
  }
}

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