InventoryAdjustedData

Reusable InventoryAdjustedData schema.

Type: object

Fields

Field	Type	Constraints	Meaning	Example
seller_idrequired	integer	None	Routing target: the Seller that owns the inbound API key (STABLE).	0 (generated)
linesrequired	array of object	minimum items: 1	All of one Order's adjustment lines: one event, one `event_id`, per sale (STABLE).	[ { "sku_id": 0, "external_ref": "string", "delta": 0 } ] (generated)
lines[].sku_idrequired	integer	None	Canonical TCGplayer sku id, the same id the listing push uses (STABLE).	0 (generated)
lines[].external_refrequired	string or null	None	Echo of the Seller's opaque listing ref, untouched, so the delta applies against the Platform's own product id; null if the Listing carried none (STABLE).	string (generated)
lines[].deltarequired	integer	None	Signed unit adjustment: negative commits units (a sale), positive releases them (a cancellation/refund). Apply idempotently as `on_hand += delta` (STABLE).	0 (generated)
reason	string	allowed values: sale, cancellation, refund, correction	Why the stock moved; attribution only, not required to apply the delta. The enum may gain values, so branch leniently (PROVISIONAL).	sale (generated)
order_ref	string	None	Opaque Order attribution for support/debugging; a pure POS can ignore it (PROVISIONAL).	string (generated)

Examples

Generated Schema example: Generated InventoryAdjustedData

{
  "seller_id": 0,
  "lines": [
    {
      "sku_id": 0,
      "external_ref": "string",
      "delta": 0
    }
  ]
}