Certificate

nutrab2b.master.certificate_issued.v2 · Master data

Purpose: Issue, renew, suspend or withdraw a certificate (organic, GMP, halal, kosher…) for a party, facility or product.
When to send: Certification body decision.
Sender → receiver: Certificate holder or certification body → Buyers
Expected responses: ACK
Equivalent standards: GS1: GDSN certification module
Scenarios using it: Full order-to-cash · Organic certificate expired before shipment

Fields and mappings

Field	Type	Req	Description	Code list / format
certificate_id	string	yes	Certificate number
holder_gln	string	yes	Holder GLN	^\d{13}$
scheme	string	yes	Certification or quality-scheme code
issuer	string	yes	Certification body
valid_from	date	yes	Valid from
valid_to	date	yes	Valid toNB-R004 NB-R015
status	string	yes	active \| suspended \| withdrawn \| expired	^(active\|suspended\|withdrawn\|expired)$
scope_items	array<string>		Items covered

Business rules

NB-R004 Certificate not valid, a required certificate is expired or not yet valid on the ship date.

Example

{
  "specversion": "2.0",
  "id": "evt-certificate-CERTIFICATE-1",
  "type": "nutrab2b.master.certificate_issued.v2",
  "source": "urn:gln:0614141000012:erp",
  "subject": "CERTIFICATE",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/CERTIFICATE.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "CERTIFICATE:CERTIFICATE:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "certificate_id": "NOP-IN-2026-0441",
    "holder_gln": "4012345000009",
    "scheme": "ORGANIC_USDA",
    "issuer": "Control Union",
    "valid_from": "2026-03-01",
    "valid_to": "2027-02-28",
    "status": "active",
    "scope_items": [
      "ASH-KSM-5"
    ]
  }
}

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