Skip to content
Merchant guide
HTTPS · Signed events

inventory.adjusted — V2 event (envelope + data)

It reaches you on every adjustment, damage, loss or shrinkage movement — with the signed quantity and the before/after difference.

Reviewed against implementation
YOUR INTEGRATION, AT A GLANCE
inventory.adjusted — full payload example
{
  "id": "mwh:inventory-adjusted:9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b:b8c9d0e1-2f3a-4b5c-8d6e-7f8a9b0c1d2e",
  "type": "inventory.adjusted",
  "api_version": "v2",
  "tenant_id": "9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b",
  "data": {
    "movement_id": "b8c9d0e1-2f3a-4b5c-8d6e-7f8a9b0c1d2e",
    "item_type": "VARIANT",
    "item_id": "2c4e6f8a-0b1d-4e2f-8a3b-5c6d7e8f9a0b",
    "item_name": "Cotton T-shirt - Blue / L",
    "movement_type": "DAMAGE",
    "quantity": -2,
    "quantity_before": 62,
    "quantity_after": 60,
    "reason": "Two damaged units from the last shipment",
    "reference_type": "MANUAL",
    "reference_id": null,
    "created_at": "2026-10-20T16:41:37.208461+00:00"
  }
}
See the implementation
On this page

01When does it fire?

  • When an adjustment movement of these types is recorded: ADJUSTMENT_IN, ADJUSTMENT_OUT, DAMAGE or LOSS.
  • The quantity can be negative (a reduction such as damage) or positive (an upward adjustment).

02Full payload example

inventory.adjusted — full payload example
{
  "id": "mwh:inventory-adjusted:9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b:b8c9d0e1-2f3a-4b5c-8d6e-7f8a9b0c1d2e",
  "type": "inventory.adjusted",
  "api_version": "v2",
  "tenant_id": "9e8d7c6b-5a4f-4e3d-2c1b-0a9f8e7d6c5b",
  "data": {
    "movement_id": "b8c9d0e1-2f3a-4b5c-8d6e-7f8a9b0c1d2e",
    "item_type": "VARIANT",
    "item_id": "2c4e6f8a-0b1d-4e2f-8a3b-5c6d7e8f9a0b",
    "item_name": "Cotton T-shirt - Blue / L",
    "movement_type": "DAMAGE",
    "quantity": -2,
    "quantity_before": 62,
    "quantity_after": 60,
    "reason": "Two damaged units from the last shipment",
    "reference_type": "MANUAL",
    "reference_id": null,
    "created_at": "2026-10-20T16:41:37.208461+00:00"
  }
}

03data fields

FieldMeaning
movement_idThe inventory movement id (UUID).
item_type / item_id / item_nameThe item kind, id and name.
movement_typeThe adjustment type: ADJUSTMENT_IN, ADJUSTMENT_OUT, DAMAGE or LOSS.
quantityThe movement quantity — negative on reductions, positive on increases.
quantity_before / quantity_afterThe quantity before and after the movement.
reasonThe free-form adjustment reason (capped at 500 chars).
reference_type / reference_idThe movement reference — e.g. MANUAL for manual adjustments.
created_atThe movement time, ISO 8601.

04Event identity

Pattern: mwh:inventory-adjusted:<tenant_id>:<movement_id> — once per movement.