Packaging Data JSON Schemas

Why schemas keyed to index codes

A packaging spec, BoM, or RFQ that carries a PackIndex code on every material line re-prices itself: pull the weekly value from the REST API or MCP server and the whole document updates. Manufacturers use it for cost roll-ups, brands for design-to-cost, traders for index-referenced offers, converters for quote defence.

Multi-layer flexible film specification

Used by brands and converters to hand a pouch or laminate structure to design, costing, and RFQ systems in one machine-readable object. Each layer maps to a live PackIndex code so the spec re-prices itself weekly.

{
  "spec_type": "multi_layer_flexible_film",
  "product": "Stand-up pouch, 250 g coffee",
  "dimensions_mm": { "width": 160, "height": 230, "bottom_gusset": 90 },
  "layers": [
    { "position": 1, "material": "PET",     "thickness_um": 12, "function": "print carrier", "index_code": "PET_RESIN" },
    { "position": 2, "material": "AL_FOIL", "thickness_um": 7,  "function": "barrier",       "index_code": "ALFOIL" },
    { "position": 3, "material": "LDPE",    "thickness_um": 70, "function": "sealant",       "index_code": "LDPE" }
  ],
  "total_thickness_um": 89,
  "barrier_targets": { "otr_cc_m2_day": 0.05, "wvtr_g_m2_day": 0.05 },
  "cost_model": {
    "basis": "PackIndex weekly indices",
    "material_share_pct": 55, "conversion_share_pct": 30, "margin_share_pct": 15
  }
}

Related: FLEX index · Packaging Suite — brief to spec

Packaging Bill of Materials (BoM)

Used by manufacturers and procurement teams to link every packaging component of a SKU to an index code — the foundation for automated cost roll-ups and contract indexation.

{
  "bom_type": "packaging_unit",
  "sku": "SKU-4471 retail carton + shipper",
  "batch_unit": "1000 finished units",
  "lines": [
    { "component": "Corrugated RSC shipper",  "index_code": "CORR", "qty_per_unit_kg": 0.185 },
    { "component": "Flexible BOPP overwrap",  "index_code": "FLEX", "qty_per_unit_kg": 0.004 },
    { "component": "HDPE closure",            "index_code": "CAPS", "qty_per_unit_kg": 0.003 }
  ],
  "pricing": { "source": "PackIndex", "refresh": "weekly", "currency": "USD",
               "endpoint": "https://opnplatform.com/api/indices" }
}

Related: Packaging Suite — cost estimation · API access

Trade Exchange RFQ payload

Used by buyers and traders to issue multi-substrate requests for quotation with index-referenced target pricing — suppliers respond against the same public benchmark.

{
  "rfq_type": "packaging_trade_exchange",
  "buyer": { "company": "Example Foods Inc", "region": "US-Midwest", "verified": true },
  "items": [
    { "material": "Testliner 3, 140 gsm", "index_code": "TSTLNR",
      "quantity": "500 t", "delivery": "FCA Chicago",
      "target_price_basis": "PackIndex TSTLNR minus 3%" },
    { "material": "PP woven sacks, 50 kg", "index_code": "PP",
      "quantity": "200,000 units", "delivery": "DDP Ohio" }
  ],
  "quote_deadline": "2026-08-01",
  "response_channels": { "portal": "https://opnplatform.com/portal?view=exchange",
                         "a2a": "https://opnplatform.com/api/a2a" }
}

Related: Trade Exchange · A2A protocol

Price feed response

The shape every PackIndex API and MCP price answer follows — code, value, unit, week-over-week change, layer, and verification links. Drop it straight into ERP material masters or dashboards.

{
  "code": "CORR",
  "name": "Corrugated RSC Box",
  "value": 0.394, "unit": "$/unit", "currency": "USD",
  "change_wow_pct": 0.8, "layer": "L3",
  "as_of": "2026-07-14", "source": "PackIndex",
  "fx": { "EUR": "live", "GBP": "live", "CAD": "live", "BRL": "live", "MXN": "live" },
  "links": { "page": "https://opnplatform.com/price/corr",
             "api":  "https://opnplatform.com/api/indices/CORR" }
}

Related: REST API · MCP server

EPR eco-modulated fee mapping

Used by compliance teams to map one SKU across multiple EPR jurisdictions — material, weight, scheme, and modulation basis — ready for quarterly reporting automation.

{
  "schema": "epr_eco_modulated_fees",
  "sku": "SKU-4471",
  "jurisdictions": [
    { "market": "UK", "scheme": "pEPR",  "material": "plastic",
      "weight_kg_per_unit": 0.032, "base_fee_per_tonne": "published annually",
      "modulation": "RAM recyclability rating from year 2" },
    { "market": "FR", "scheme": "CITEO", "material": "plastic",
      "weight_kg_per_unit": 0.032,
      "eco_modulation": { "pcr_pct": 50, "adjustment": "bonus" } },
    { "market": "US-OR", "scheme": "Oregon RMA", "material": "plastic", "status": "active" }
  ],
  "reporting_period": "2026-Q3",
  "fee_engine": "https://opnplatform.com/sustainability/epr-cost-estimator"
}

Related: EPR fee reference · EPR cost estimator

Regional price dataset

Used by traders and multi-plant manufacturers to track regional deviation from the blended benchmark — the structure behind local-vs-national quote benchmarking.

{
  "dataset": "regional_corrugated_spot",
  "index_code": "CORR",
  "basis": "PackIndex CORR weekly benchmark, FX live",
  "regions": [
    { "region": "US-PNW",       "deviation_vs_index_pct": 3.5,  "freight_factor": 1.08 },
    { "region": "US-Southeast", "deviation_vs_index_pct": -2.1, "freight_factor": 0.96 },
    { "region": "EU-Central",   "deviation_vs_index_pct": 1.2,  "freight_factor": 1.02 }
  ],
  "history": { "weeks": 12, "endpoint": "https://opnplatform.com/api/indices/CORR" }
}

Related: Corrugated index · Fibre & board prices

Global resin tracking format

Used by polymer buyers to watch resin prices across hubs with their feedstock references attached — so a crude or naphtha move is immediately explainable.

{
  "dataset": "global_resin_tracker",
  "resins": ["PP", "HDPE", "LDPE", "PET_RESIN", "RPET_FOOD"],
  "hubs": ["US Gulf Coast", "NW Europe", "SE Asia"],
  "fields": ["value_usd_t", "change_wow_pct", "feedstock_ref"],
  "feedstock_refs": {
    "PP":   ["NAPHTHA", "BRENT_CRUDE"],
    "HDPE": ["NAPHTHA", "BRENT_CRUDE"]
  },
  "refresh": "weekly",
  "api": "https://opnplatform.com/api/commodities"
}

Related: Polymer prices · PET resin index

Frequently asked