Party / organization

nutrab2b.master.party_upserted.v2 · Master data

Purpose: Publish or update a trading partner's legal identity, roles, identifiers and tier.
When to send: Onboarding, or any change to legal data.
Sender → receiver: Any party → Network hub and partners
Expected responses: ACK
Equivalent standards: GS1: GS1 GDSN Party · SAP: Business Partner (BUT000) · EDIFACT: PARTIN
Scenarios using it: -

Fields and mappings

Field	Type	Req	Description	Code list / format
gln	string	yes	Party GLN	^\d{13}$
legal_name	string	yes	Registered legal name
lei	string		LEI
duns	string		DUNS
tier	string	yes	Supply-chain tier	org_tier
roles	array<string>		Party role codes (party_role list)
address	object	yes	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
identifiers	array<object>		Other identifiers
scheme	string	yes	Scheme	id_scheme
value	string	yes	Value
contact	object		Primary contact
name	string		Name
email	string		Email	^[^@\s]+@[^@\s]+\.[^@\s]+$
phone	string		E.164 phone

Business rules

None beyond schema and code lists.

Example

{
  "specversion": "2.0",
  "id": "evt-party-PARTY-1",
  "type": "nutrab2b.master.party_upserted.v2",
  "source": "urn:gln:0614141000012:erp",
  "subject": "PARTY",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/PARTY.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "PARTY:PARTY:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "gln": "4012345000009",
    "legal_name": "Himalaya Botanicals Pvt Ltd",
    "tier": "processor",
    "roles": [
      "SE",
      "MF",
      "EXP"
    ],
    "address": {
      "lines": [
        "Plot 14, KIADB"
      ],
      "city": "Bengaluru",
      "postal_code": "562114",
      "region": "IN-KA",
      "country": "IN"
    },
    "identifiers": [
      {
        "scheme": "IEC",
        "value": "0712345678"
      },
      {
        "scheme": "FDA_FFR",
        "value": "17654321098"
      }
    ],
    "contact": {
      "name": "Priya Rao",
      "email": "qa@himalaya-botanicals.example",
      "phone": "+918041234567"
    }
  }
}

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