Содержание статьи
На этой странице — примеры того, как выглядит тело вебхука. Пригодятся для отладки интеграции. Значения приведены для наглядности; персональные данные покупателя в примерах опущены или обезличены.
Изменение статуса заказа (statusChanged)
Отправляется при изменении статуса заказа целиком.
Заказ подтверждён (Confirmed):
{
"type": "statusChanged",
"trackingId": "117391950",
"sequenceNumber": 2,
"data": {
"id": "CZ117391950",
"status": "Confirmed",
"paymentMethod": "COD",
"fullSum": "12000.00",
"deliveryPrice": "250.00",
"currency": "rub",
"createdAt": "2025-01-20",
"updatedAt": "2025-01-20 10:30:15",
"dates": { "confirmed": "2025-01-20 10:30:00" },
"items": [
{
"id": 7598,
"status": "Confirmed",
"sku": "SELLERSKU104",
"size": "42",
"description": "Кроссовки",
"paidPrice": 12000.00,
"totalDiscount": "0.00"
}
],
"deliveryMethod": {
"deliveryDate": "2025-01-22",
"deliveryIntervalFrom": "15:00",
"deliveryIntervalTo": "18:00",
"shippingMethodCode": "lamoda",
"cutOff": "2025-01-21 03:00:00"
}
}
}
Заказ доставлен (Delivered):
{
"type": "statusChanged",
"trackingId": "117391950",
"sequenceNumber": 5,
"data": {
"id": "CZ117391950",
"status": "Delivered",
"paymentMethod": "COD",
"fullSum": "12000.00",
"currency": "rub",
"createdAt": "2025-01-20",
"updatedAt": "2025-01-22 17:48:00",
"dates": {
"confirmed": "2025-01-20 10:30:00",
"shipped": "2025-01-21 08:15:00",
"delivered": "2025-01-22 17:48:00"
},
"items": [
{
"id": 7598,
"status": "Delivered",
"finalERPStatus": "sold",
"sku": "SELLERSKU104",
"size": "42",
"paidPrice": 12000.00
}
]
}
}
Изменение статуса товара (itemStatusChanged)
Отправляется при изменении статуса отдельного товара в заказе. Оболочка та же (type, trackingId, sequenceNumber, data); ключевое — статус в items[].status.
{
"type": "itemStatusChanged",
"trackingId": "117391950",
"sequenceNumber": 7,
"data": {
"id": "CZ117391950",
"status": "Delivered",
"items": [
{
"id": 7598,
"status": "Returned",
"sku": "SELLERSKU104",
"size": "42"
}
]
}
}
| ℹ️ ПЕРЕД ОБРАБОТКОЙ — СВЕРЬТЕСЬ Вебхук ускоряет реакцию, но не гарантирует доставку и порядок. Получив событие, подтвердите состояние запросом GET /v2/orders/{orderId} (в путь подставляется поле id из списка заказов, не групповой trackingId) и обрабатывайте идемпотентно — по ключу «id заказа + статус». |
См. также
Помогла эта информация?
Спасибо за отзыв
0/1000
Отправить