Перейти к содержимому
14 дней бесплатно, без карты9 языков176 типов бизнеса · 50 приложений
RU· USD
Попробовать живое демоПопробовать бесплатно

Вебхуки статусов курьерских служб: как это работает

Курьерская служба может отправлять каждое изменение статуса посылки в ваше рабочее пространство в момент, когда оно происходит, не дожидаясь синхронизации раз в полчаса. Каждое сообщение проверяется по секрету, применяется один раз и никогда не отбрасывает посылку на предыдущий этап.

Урок 8 из 12 · Как это работает

  • около 3 мин
  • Deliveries & packing → Couriers → Status webhook

Как это работает

  1. В Deliveries → Couriers откройте Status webhook у курьерской службы с API и выберите Create webhook secret. Скопируйте адрес вебхука (и секрет) в кабинет продавца службы.

  2. Каждое сообщение должно доказать, что пришло от курьерской службы: подписью, созданной с помощью секрета, секретом в заголовке или секретным адресом — в зависимости от службы. Всё остальное отклоняется.

  3. Посылка находится по трек-номеру или номеру отправления; затем накладная переходит в статус «передана курьеру», «доставлена» или «возвращена», а собранные наличные фиксируются.

  4. Одно и то же сообщение, отправленное дважды, применяется один раз. Более старое сообщение, пришедшее с опозданием, или шаг назад только записываются в историю посылки.

  5. Rotate secret сразу создаёт новый секрет; немедленно введите его у курьерской службы — старый перестаёт действовать.

Где это найти

Настройки, которые на это влияют

Чек-лист

Прежде чем идти дальше, проверьте, что вы умеете:

  • Открыть Deliveries & packing → Couriers → Status webhook
  • В Deliveries → Couriers откройте Status webhook у курьерской службы с API и выберите Create webhook secret.
  • Каждое сообщение должно доказать, что пришло от курьерской службы: подписью, созданной с помощью секрета,…
  • Посылка находится по трек-номеру или номеру отправления; затем накладная переходит в статус передана…
  • Одно и то же сообщение, отправленное дважды, применяется один раз.

Советы и частые ошибки

  • В блоке видно, когда пришло последнее сообщение и что оно сделало, например что посылки с таким номером нет.
  • Синхронизация раз в полчаса продолжает работать, поэтому пропущенное сообщение будет наверстано позже.
  • Храните секрет в тайне: при проверке по секретному адресу сам адрес и есть секрет.