Вебхуки статусов курьерских служб: как это работает
Курьерская служба может отправлять каждое изменение статуса посылки в ваше рабочее пространство в момент, когда оно происходит, не дожидаясь синхронизации раз в полчаса. Каждое сообщение проверяется по секрету, применяется один раз и никогда не отбрасывает посылку на предыдущий этап.
Урок 8 из 12 · Как это работает
Как это работает
В Deliveries → Couriers откройте Status webhook у курьерской службы с API и выберите Create webhook secret. Скопируйте адрес вебхука (и секрет) в кабинет продавца службы.
Каждое сообщение должно доказать, что пришло от курьерской службы: подписью, созданной с помощью секрета, секретом в заголовке или секретным адресом — в зависимости от службы. Всё остальное отклоняется.
Посылка находится по трек-номеру или номеру отправления; затем накладная переходит в статус «передана курьеру», «доставлена» или «возвращена», а собранные наличные фиксируются.
Одно и то же сообщение, отправленное дважды, применяется один раз. Более старое сообщение, пришедшее с опозданием, или шаг назад только записываются в историю посылки.
Rotate secret сразу создаёт новый секрет; немедленно введите его у курьерской службы — старый перестаёт действовать.
Где это найти
- Deliveries & packing → Couriers → Status webhook
/admin/deliveries/couriers
Настройки, которые на это влияют
- Courier account → Webhook check and signature header
/admin/deliveries/couriers
Чек-лист
Прежде чем идти дальше, проверьте, что вы умеете:
- Открыть Deliveries & packing → Couriers → Status webhook
- В Deliveries → Couriers откройте Status webhook у курьерской службы с API и выберите Create webhook secret.
- Каждое сообщение должно доказать, что пришло от курьерской службы: подписью, созданной с помощью секрета,…
- Посылка находится по трек-номеру или номеру отправления; затем накладная переходит в статус передана…
- Одно и то же сообщение, отправленное дважды, применяется один раз.
Советы и частые ошибки
- В блоке видно, когда пришло последнее сообщение и что оно сделало, например что посылки с таким номером нет.
- Синхронизация раз в полчаса продолжает работать, поэтому пропущенное сообщение будет наверстано позже.
- Храните секрет в тайне: при проверке по секретному адресу сам адрес и есть секрет.