Release against blanket

nutrab2b.order.released.v2 · Ordering

Purpose: Call off a quantity against a blanket contract; becomes an order.
When to send: Scheduled demand.
Sender → receiver: Buyer → Supplier
Expected responses: PO_RESPONSE, ACK
Equivalent standards: X12: 850 (RL release) / 862 · EDIFACT: DELJIT / ORDERS · SAP: Delivery schedule (ME38)
Scenarios using it: Release against blanket contract

Fields and mappings

Field	Type	Req	Description	Code list / format	EDI / GS1 / SAP mapping
po_number	string	yes	Release order number
contract_id	string	yes	Blanket contract
release_no	integer	yes	Release number
order_date	date	yes	Release date
incoterm	string	yes	Incoterm	incoterm
transport_mode	string	yes	Mode	transport_mode
payment_terms	string	yes	Terms	payment_terms
ship_to	object	yes	Ship-to
gln	string	yes	Location GLN	^\d{13}$	x12: N1 ST/SF N104 edifact: NAD+ST/SF
name	string		Name
address	object		Postal address
lines	array<string>		Street lines
city	string		City
postal_code	string		Postal code
region	string		State / province (ISO 3166-2 subdivision)
country	string	yes	Country	country
lines	array<object>	yes	Order lines
line_no	integer	yes	Line number, unique in document		x12: PO101 edifact: LIN 1082 sap: EBELP
item_id	string	yes	Buyer's or seller's item number		x12: PO107 (BP/VP) edifact: PIA sap: MATNR
gtin	string		GS1 GTIN of the traded item	^(\d{8}\|\d{12,14})$	x12: PO107 (UK) edifact: LIN C212 (SRV) gs1: gtin
ingredient	string		NutraB2B ingredient master code	ingredient
description	string	yes	Item description		x12: PID05 edifact: IMD
hs_code	string	yes	HS 6-digit (or national) classificationNB-R005 NB-R017	^\d{4}(\.\d{2}){1,2}$\|^\d{6,10}$	x12: PO107 (HS) edifact: PIA+5 C212 (HS)
national_code	string		National tariff line for the destination country (8–10 digits)NB-R005	^\d{8,10}$
grade	string		Grade / pharmacopoeia	grade
form	string		Product form	product_form
standardisation	object		Extract standardisation
type	string	yes	Notation	standardisation
marker	string		Marker compound
min_pct	number		Minimum %
max_pct	number		Maximum %
ratio	string		Drug-extract ratio e.g. 10:1	^\d+(\.\d+)?(-\d+(\.\d+)?)?:1$
method	string		Assay method	method
certifications	array<string>		Required certifications
quantity	object	yes	Ordered quantity
value	number	yes	Quantity
uom	string	yes	Unit of measure	uom
unit_price	object	yes	Price per unit of measure
amount	number	yes	Amount in major units, decimals ≤ currency minor unitsNB-R011
currency	string	yes	Currency	currency
requested_delivery	date		Requested delivery dateNB-R015
min_shelf_life_days	integer		Minimum remaining shelf life at deliveryNB-R008
over_ship_tolerance_pct	number		Allowed over-shipment %NB-R002

Business rules

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

Example

{
  "specversion": "2.0",
  "id": "evt-release-REL-BA-2027-01-03-1",
  "type": "nutrab2b.order.released.v2",
  "source": "urn:gln:0614141000012:erp",
  "subject": "REL-BA-2027-01-03",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/RELEASE.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "RELEASE:REL-BA-2027-01-03:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "po_number": "REL-BA-2027-01-03",
    "contract_id": "BA-2027-01",
    "release_no": 3,
    "order_date": "2027-03-01",
    "incoterm": "FCA",
    "transport_mode": "4",
    "payment_terms": "NET60",
    "ship_to": {
      "gln": "0614141000012",
      "address": {
        "country": "US"
      }
    },
    "lines": [
      {
        "line_no": 1,
        "item_id": "ASH-KSM-5",
        "description": "Ashwagandha root extract 5%",
        "hs_code": "1302.19",
        "quantity": {
          "value": 500,
          "uom": "KGM"
        },
        "unit_price": {
          "amount": 56,
          "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