Подключение серверного клиента RouteDesk
Версия 2.7
Подготовка организации
Проверьте, что администратор подтвердил почту, добавил склад и указал адрес возврата. Для выпуска реальной этикетки потребуются активный тариф и заполненный адрес отправителя. Подключение организации само по себе не создаёт оплаченный заказ. До начала интеграции назначьте ответственных за доступы, обработку событий и расхождения по отправлениям. В небольшой команде эти роли может выполнять один сотрудник.
Первый запрос
В тестовом кабинете создайте демонстрационное отправление и сохраните его номер в вашей системе. Создайте ключ в «Настройки → Интеграции». Для чтения статуса применяйте область `shipments:read`, для создания нужна `shipments:write`. Передавайте ключ на стороне сервера в заголовке Authorization как Bearer. Для первой проверки чтения используйте уже известный тестовый номер. Так вы сможете независимо проверить авторизацию и сопоставление отправления.
Проверка маршрута от заказа до события
Зафиксируйте локальный номер заказа, номер отправления RouteDesk и время запроса. Проверьте, что отправление видно в кабинете той же среды, затем проследите, как ваша система принимает webhook и обновляет собственное представление статуса. Кабинет помогает отделить проблему создания от задержки обработки уведомления. Если этикетка зарегистрирована, но перевозчик её не сканировал, статус «Создано» ожидаем.
Переход в рабочую среду
Создайте рабочий ключ отдельно от тестового и выберите рабочие настройки клиента. Убедитесь, что обработчик доставки событий использует рабочий секрет webhook и рабочее хранилище для дедупликации. Сверьте выбранный склад, адрес отправителя и тариф перед первым реальным запуском. Начните с небольшой контролируемой партии, для которой команда сможет вручную проверить статусы и операции по балансу.
Что считать готовностью интеграции
Оператор должен суметь найти отправление по локальному заказу, а инженер должен увидеть итог вызова в журнале без чтения секрета или адреса получателя. Проверьте работу в обе стороны: ответ на создание связывает заказ с номером RouteDesk, входящее уведомление обновляет ту же запись. Проверьте повтор сообщения и временную недоступность обработчика. Сохраните результаты и список диагностических идентификаторов вместе с инструкцией запуска.
Согласование с операторами
Подготовьте контрольный заказ на складе, который участвует в запуске. Попросите оператора пройти привычный путь от принятия заказа до проверки этикетки и назвать данные, которые он ожидает увидеть. Если связь между кабинетами проверяет только инженер, команда может пропустить ошибку отображения склада или отсутствие номера отправления в карточке магазина.
Остановка первого выпуска
Заранее определите, как приостановить новые запросы на создание, если контрольная партия не сошлась. Убедитесь, что дежурный может прочитать состояние уже отправленных задач. Сохраните снимки запросов с неизвестным итогом. После исправления продолжайте работу с подтверждёнными связями и отдельно разбирайте те заказы, для которых не удалось установить результат.