Sample request

nutrab2b.sourcing.sample_requested.v2 · Sourcing

Purpose: Request pre-shipment, type or reference samples.
When to send: Qualification or pre-shipment approval.
Sender → receiver: Buyer → Supplier
Expected responses: SAMPLE_RESULT, ACK
Equivalent standards: -
Scenarios using it: -

Fields and mappings

Field	Type	Req	Description	Code list / format	EDI / GS1 / SAP mapping
request_id	string	yes	Request id
sample_type	string	yes	Sample type	sample_type
item_id	string	yes	Item
lot_number	string		Lot (for pre-shipment)
quantity	object	yes	Sample size
value	number	yes	Quantity
uom	string	yes	Unit of measure	uom
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

Business rules

None beyond schema and code lists.

Example

{
  "specversion": "2.0",
  "id": "evt-sample_request-ASH-26-118-1",
  "type": "nutrab2b.sourcing.sample_requested.v2",
  "source": "urn:gln:0614141000012:erp",
  "subject": "ASH-26-118",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/SAMPLE_REQUEST.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "SAMPLE_REQUEST:ASH-26-118:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "request_id": "SR-12",
    "sample_type": "PRE_SHIPMENT",
    "item_id": "ASH-KSM-5",
    "lot_number": "ASH-26-118",
    "quantity": {
      "value": 100,
      "uom": "GRM"
    },
    "ship_to": {
      "gln": "8901234000006",
      "address": {
        "country": "US"
      }
    }
  }
}

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