Price list

nutrab2b.master.price_list_published.v2 · Master data

Purpose: Tiered prices by quantity break, validity window and Incoterm.
When to send: New price period.
Sender → receiver: Supplier → Buyer
Expected responses: ACK
Equivalent standards: X12: 832 / 879 · EDIFACT: PRICAT · SAP: Condition records (KONP)
Scenarios using it: -

Fields and mappings

Field	Type	Req	Description	Code list / format
price_list_id	string	yes	Price list id
valid_from	date	yes	Valid fromNB-R015
valid_to	date	yes	Valid toNB-R015
incoterm	string	yes	Incoterm	incoterm
items	array<object>	yes	Prices
item_id	string	yes	Item
hs_code	string	yes	HS code	^\d{4}(\.\d{2}){1,2}$\|^\d{6,10}$
uom	string	yes	Unit	uom
breaks	array<object>	yes	Quantity breaks
min_qty	number	yes	From quantity
price	object	yes	Price
amount	number	yes	Amount in major units, decimals ≤ currency minor unitsNB-R011
currency	string	yes	Currency	currency

Business rules

NB-R011 Currency precision, amount has more decimals than the currency's ISO 4217 minor units.

Example

{
  "specversion": "2.0",
  "id": "evt-price_list-PRICE_LIST-1",
  "type": "nutrab2b.master.price_list_published.v2",
  "source": "urn:gln:4012345000009:erp",
  "subject": "PRICE_LIST",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/PRICE_LIST.json",
  "sender": {
    "gln": "4012345000009"
  },
  "receiver": {
    "gln": "0614141000012"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "PRICE_LIST:PRICE_LIST:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "price_list_id": "PL-2027-H1",
    "valid_from": "2027-01-01",
    "valid_to": "2027-06-30",
    "incoterm": "FCA",
    "items": [
      {
        "item_id": "ASH-KSM-5",
        "hs_code": "1302.19",
        "uom": "KGM",
        "breaks": [
          {
            "min_qty": 25,
            "price": {
              "amount": 64.5,
              "currency": "USD"
            }
          },
          {
            "min_qty": 500,
            "price": {
              "amount": 58,
              "currency": "USD"
            }
          }
        ]
      }
    ]
  }
}

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