Award

nutrab2b.sourcing.awarded.v2 · Sourcing

Purpose: Award (fully, partially or split across suppliers) or decline a quote.
When to send: Buyer decision.
Sender → receiver: Buyer → Supplier
Expected responses: ACK, CONTRACT, PO
Equivalent standards: -
Scenarios using it: Full order-to-cash · Quote revision supersedes original

Fields and mappings

Field	Type	Req	Description	Code list / format
quote_id	string	yes	Quote
decision	string	yes	awarded \| partially_awarded \| declined	^(awarded\|partially_awarded\|declined)$
lines	array<object>		Awarded quantity per line
line_no	integer	yes	Quote line
quantity	object	yes	Awarded quantity
value	number	yes	Quantity
uom	string	yes	Unit of measure	uom
reason	string		Reason when declined

Business rules

None beyond schema and code lists.

Example

{
  "specversion": "2.0",
  "id": "evt-award-Q-77-1",
  "type": "nutrab2b.sourcing.awarded.v2",
  "source": "urn:gln:0614141000012:erp",
  "subject": "Q-77",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/AWARD.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "AWARD:Q-77:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "quote_id": "Q-77",
    "decision": "awarded",
    "lines": [
      {
        "line_no": 1,
        "quantity": {
          "value": 500,
          "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