stock_reference/sku_updated

Overview

Property	Value
Webhook type	stock_reference/sku_updated
Kafka topic	stock-reference.sku-updated
Direction	Platform → Your endpoint

Description

Fired when the SKU (Stock Keeping Unit) of a stock reference is changed. This is a dedicated event for SKU changes because SKU is a critical identifier used in order lines, integrations, and WMS systems.

Trigger Conditions

• An operator manually updates the SKU on a stock reference
• A product variant SKU is synchronized to its linked stock reference

Message Envelope

{
  "header": {
    "organizationId": "org_xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "messageId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "webhookId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "type": "stock_reference/sku_updated",
    "date": "2024-03-15T10:23:45.000Z"
  },
  "body": { ... }
}

The body field contains the full stock reference with the updated SKU.

Body — Property Table

StockReference Object

Field	Type	Nullable	Description
id	string (uuid)	No	Unique stock reference identifier
organizationId	string (uuid)	No	Organization that owns this stock reference
locationId	string (uuid)	Yes	Warehouse location
productVariantId	string (uuid)	No	Associated product variant
reference	string	No	Internal reference code
sku	string	No	Updated stock keeping unit identifier
status	enum	No	DRAFT, VALID, ON_HOLD, INVALID
model	enum	No	PRODUCT or BUNDLE
physicalQuantity	integer	No	Total physical quantity
usableQuantity	integer	No	Available quantity
reservedQuantity	integer	No	Reserved quantity
criticalThreshold	integer	No	Alert threshold
lastSnapshotAt	string (ISO 8601)	Yes	Timestamp of the last inventory snapshot
lastSnapshotValue	integer	Yes	Quantity at last snapshot
height	float	Yes	Product height
width	float	Yes	Product width
length	float	Yes	Product length
distanceUnit	enum	Yes	Unit for dimensions
weight	float	Yes	Product weight
weightUnit	enum	Yes	Unit for weight
createdAt	string (ISO 8601)	No	Creation timestamp
updatedAt	string (ISO 8601)	No	Last update timestamp

Full JSON Payload Sample

{
  "header": {
    "organizationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "messageId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "webhookId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "type": "stock_reference/sku_updated",
    "date": "2024-03-15T10:23:45.000Z"
  },
  "body": {
    "id": "d4e5f6a7-b8c9-0123-defa-234567890123",
    "organizationId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "locationId": "e5f6a7b8-c9d0-1234-efab-345678901234",
    "productVariantId": "f6a7b8c9-d0e1-2345-fabc-456789012345",
    "reference": "REF-TSHIRT-WHITE-M",
    "sku": "TSHIRT-WHT-M-V2",
    "status": "VALID",
    "model": "PRODUCT",
    "physicalQuantity": 150,
    "usableQuantity": 140,
    "reservedQuantity": 10,
    "criticalThreshold": 5,
    "lastSnapshotAt": "2024-03-15T08:00:00.000Z",
    "lastSnapshotValue": 145,
    "height": 2.0,
    "width": 20.0,
    "length": 30.0,
    "distanceUnit": "CM",
    "weight": 0.25,
    "weightUnit": "KG",
    "createdAt": "2024-03-10T09:00:00.000Z",
    "updatedAt": "2024-03-15T10:23:45.000Z"
  }
}

Related Events

• stock_reference/updated — generic update event also fired on SKU changes
• variant/source_updated — fired when the variant's source/SKU changes

Notes

• The organizationId is read directly from data.organizationId.
• Downstream systems (WMS integrations, 3PLs) should listen to this event to update their SKU mapping tables, as SKU changes may break inbound/outbound matching.
• Both stock_reference/sku_updated and stock_reference/updated may fire for the same SKU change.