Webhook

При смене статуса вашего отправления Starex автоматически отправляет уведомление на ваш сервер.

1. Общее

При смене статуса отправления Starex отправляет HTTP POST запрос на указанный вами URL. В запросе передаются штрих-код отправления, новый код статуса и время статуса.

Для подключения вы передаёте Starex свой webhook URL (например https://ваш-домен.uz/starex/webhook) — после этого уведомления приходят только по вашим отправлениям.

2. Запрос

POST {ВАШ_WEBHOOK_URL}
Content-Type: application/json

{
  "barcode": "AB123456789UZ",
  "state": 9,
  "statetime": "2026-06-15 14:30:00"
  "description": "Заказ принят"
}

Поле	Тип	Описание
`barcode`	string	Штрих-код отправления (тот же `order_code`, что вернулся при создании заказа)
`state`	integer	Код нового статуса
`statetime`	string	Дата и время смены статуса, `YYYY-MM-DD HH:MM:SS`
`description`	string\|null	Дополнительный комментарий к статусу

Расшифровка кодов state — в справочнике статусов (GET /api/v2/dictionaries/states). Дополнительная информация по отправлению доступна через запрос trace по barcode.

3. Ответ

Чтобы подтвердить приём, верните HTTP 200. Тело ответа не важно.

Ваш ответ	Результат
`200`	Считается доставленным
Любой другой код (`2xx`, `3xx`, `4xx`, `5xx`)	Неуспех — будет отправлено повторно
Ответ не пришёл за 5 секунд	Неуспех — будет отправлено повторно

Таймаут запроса — 5 секунд.
При неудаче отправка повторяется до 5 раз, после чего уведомление больше не отправляется.
Из-за повторов один и тот же статус может прийти несколько раз; дубликат определяется по barcode + state + statetime.