Implementation guides
Start with the overview guides, then open the guide for each message your role sends or receives. Every message guide lists fields, code lists, EDI/GS1/SAP mappings, rules, an example and a mapping checklist.
Overview
Getting started
What NutraB2B 2.0 is, how partners connect, and the five steps to go live.
Identification: GLN, GTIN, SSCC, LEI
Which identifier goes where, check digits, and how lots and serials are expressed.
Event delivery and security
Envelope, idempotency, ordering, retries, dead-lettering, signatures and replay protection.
Testing and certification
Sandbox, the Test lab, the conformance suite and the certificate.
Versioning and deprecation
Semantic versioning, compatibility rules and the deprecation window.
Mapping from EDI, GS1 and legacy order flows
How X12, EDIFACT, GS1 XML, EPCIS and ERP IDocs map to NutraB2B messages.
Nutraceutical compliance primer
Which regulations the standard encodes and where.
Master data
Party / organization PARTY
Publish or update a trading partner's legal identity, roles, identifiers and tier.
Facility FACILITY
Describe a site (farm, extraction plant, CDMO, warehouse, lab) with its registrations and capabilities.
Product / item specification PRODUCT
The full specification of an ingredient or finished product: identity, botanical source, specs per test, allergens, claims, storage, shelf life.
Price list PRICE_LIST
Tiered prices by quantity break, validity window and Incoterm.
Certificate CERTIFICATE
Issue, renew, suspend or withdraw a certificate (organic, GMP, halal, kosher…) for a party, facility or product.
Sourcing
Request for information RFI
Ask suppliers about capability, certifications and documents before an RFQ.
Request for quotation RFQ
Request prices and lead times for one or more items, quantities and specs.
Quotation QUOTE
Answer an RFQ with price, lead time and validity, line by line. A revision supersedes the previous quote.
Award AWARD
Award (fully, partially or split across suppliers) or decline a quote.
Contract / blanket agreement CONTRACT
Framework agreement: total quantity, price, period, quality agreement reference; orders are released against it.
Sample request SAMPLE_REQUEST
Request pre-shipment, type or reference samples.
Sample result SAMPLE_RESULT
Approve or reject a sample, with the lab's findings.
Ordering
Purchase order PO
Firm order with lines, quantities, prices, ship-to, Incoterm, requested dates and quality requirements.
Purchase order response PO_RESPONSE
Accept, reject or change the order line by line (quantity, date, price, substitution, back-order).
Purchase order change PO_CHANGE
Buyer changes quantity, date, price, ship-to or adds/removes lines. Requires a new PO response.
Purchase order cancellation PO_CANCEL
Cancel a whole PO. Rejected if goods already shipped (cancel race).
Release against blanket RELEASE
Call off a quantity against a blanket contract; becomes an order.
Logistics & customs
Advance ship notice ASN
What shipped, in which pallets/cases (SSCC hierarchy), which lots, with dates, carrier and cold-chain readings.
Receiving advice RECEIPT
What actually arrived: accepted, short, over, damaged, temperature excursions, per lot.
Transport status TRANSPORT_STATUS
Real-time milestones and exceptions from carriers and IoT loggers.
Customs declaration data CUSTOMS
Pre-filled data for import/export filing: HS and national codes, origin, preference, values, licences, prior notice.
Quality & compliance
Certificate of analysis COA
Lot test results against specification, multi-method, signed by QA; includes USP <2232> daily-dose evaluation and allergen declaration.
Supplier qualification SUPPLIER_QUALIFICATION
Status of a supplier/item/site combination in the buyer's approved supplier list.
Audit result AUDIT_RESULT
Outcome and findings of an audit (on-site, remote, third-party).
Non-conformance / CAPA NONCONFORMANCE
Report a quality problem against a lot or shipment and track root cause, corrective and preventive actions to closure.
Deviation request DEVIATION
Request and record approval to ship or use material outside specification, with conditions and expiry.
Hold / release HOLD
Place a lot on hold or release it; blocks shipment while held.
Recall notice RECALL
Recall or withdraw lots; must name every downstream lot derived from the affected lot and every customer that received them.
Stability data STABILITY
Time-point results under ICH conditions supporting shelf life and label claims.
Traceability
Lot genealogy (transformation) LOT_GENEALOGY
Record that input lots were consumed to produce output lots (harvest → extract → blend → finished), with yield for mass balance. FSMA 204 'transformation' key data elements.
EPCIS 2.0 event EPCIS_EVENT
Carry any GS1 EPCIS 2.0 object, aggregation, transformation, transaction or association event natively (JSON-LD), for partners already on EPCIS.
Digital product passport PRODUCT_PASSPORT
Consumer- and regulator-facing passport for a finished lot: origin, genealogy summary, CoA hash, certifications, carbon footprint, resolvable via GS1 Digital Link QR.
Finance
Invoice INVOICE
Commercial invoice with lines, tax and charges; must reconcile with PO and receipt (three-way match).
Credit / debit note CREDIT_NOTE
Adjust an invoice for returns, price differences, short shipment or rebates.
Remittance advice REMITTANCE
Tell the supplier which invoices and notes a payment settles.
Self-billing invoice SELF_BILLING
Buyer issues the invoice on the supplier's behalf from receipts (consignment, toll).
Inventory & planning
Inventory snapshot INVENTORY
Available, allocated, quarantined stock per lot with expiry, by location.
Forecast / collaborative plan FORECAST
Rolling demand forecast with firm, planning and forecast horizons (CPFR).
VMI replenishment VMI_REPLENISH
Supplier-proposed replenishment based on buyer stock and min/max levels.
Control
Functional acknowledgement ACK
Machine acknowledgement of every business event: received, accepted (with warnings) or rejected with error codes and paths.
Error notice ERROR_NOTICE
Report a processing failure that happens after the ACK (e.g. downstream ERP posting failed).
Heartbeat HEARTBEAT
Liveness and last-sequence exchange so partners can detect gaps and request replay.