Forecast / collaborative plan

nutrab2b.planning.forecast_shared.v2 · Inventory & planning

Purpose: Rolling demand forecast with firm, planning and forecast horizons (CPFR).
When to send: Planning cycle.
Sender → receiver: Buyer → Supplier
Expected responses: FORECAST_COMMIT via ACK
Equivalent standards: X12: 830 · EDIFACT: DELFOR
Scenarios using it: -

Fields and mappings

Field	Type	Req	Description	Code list / format
forecast_id	string	yes	Forecast id
bucket	string	yes	Bucket	forecast_bucket
lines	array<object>	yes	Lines
item_id	string	yes	Item
period_start	date	yes	Period start
quantity	object	yes	Quantity
value	number	yes	Quantity
uom	string	yes	Unit of measure	uom
firmness	string	yes	Firmness	forecast_firmness

Business rules

None beyond schema and code lists.

Example

{
  "specversion": "2.0",
  "id": "evt-forecast-FORECAST-1",
  "type": "nutrab2b.planning.forecast_shared.v2",
  "source": "urn:gln:0614141000012:erp",
  "subject": "FORECAST",
  "time": "2026-11-02T09:00:00Z",
  "datacontenttype": "application/json",
  "dataschema": "https://nutrab2b.org/schemas/2.0/FORECAST.json",
  "sender": {
    "gln": "0614141000012"
  },
  "receiver": {
    "gln": "4012345000009"
  },
  "correlationid": "CONV-RFQ-1001",
  "idempotencykey": "FORECAST:FORECAST:1",
  "sequence": 1,
  "env": "test",
  "data": {
    "forecast_id": "FC-2027-W01",
    "bucket": "MONTH",
    "lines": [
      {
        "item_id": "ASH-KSM-5",
        "period_start": "2027-01-01",
        "quantity": {
          "value": 500,
          "uom": "KGM"
        },
        "firmness": "FIRM"
      },
      {
        "item_id": "ASH-KSM-5",
        "period_start": "2027-02-01",
        "quantity": {
          "value": 600,
          "uom": "KGM"
        },
        "firmness": "PLANNING"
      }
    ]
  }
}

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