Remittance advice

nutrab2b.finance.remitted.v2 · Finance

Purpose: Tell the supplier which invoices and notes a payment settles.
When to send: Payment run.
Sender → receiver: Buyer → Supplier
Expected responses: ACK
Equivalent standards: X12: 820 · EDIFACT: REMADV · SAP: REMADV IDoc
Scenarios using it: Full order-to-cash · Short receipt settled with credit note

Fields and mappings

Field	Type	Req	Description	Code list / format
payment_id	string	yes	Payment id
value_date	date	yes	Value date
currency	string	yes	Currency	currency
items	array<object>	yes	Settled documents
doc_number	string	yes	Invoice / note
amount	number	yes	Amount settled
discount_taken	number		Early-payment discount
total	number	yes	Payment totalNB-R001

Business rules

NB-R001 Totals mismatch, line totals, tax and charges do not add up to document total.
NB-R011 Currency precision, amount has more decimals than the currency's ISO 4217 minor units.

Example

{
  "specversion": "2.0",
  "id": "evt-remittance-REMITTANCE-1",
  "type": "nutrab2b.finance.remitted.v2",
  "source": "urn:gln:0614141000012:erp",
  "subject": "REMITTANCE",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/REMITTANCE.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "REMITTANCE:REMITTANCE:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "payment_id": "PAY-7781",
    "value_date": "2027-01-02",
    "currency": "USD",
    "items": [
      {
        "doc_number": "INV-9001",
        "amount": 30250
      },
      {
        "doc_number": "CN-120",
        "amount": -580
      }
    ],
    "total": 29670
  }
}

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