К основному содержимому

Как настроить и подключить интеграцию с Укрпочтой?

Узнайте, как подключить и настроить интеграцию с Укрпочтой в RO App для привязки накладных, отслеживания отправлений и управления доставками

Xenia avatar
Автор: Xenia
Обновлено более 2 нед. назад

Благодаря базовой интеграции с Укрпочтой вы сможете:

  • Привязать имеющееся отправление по его номеру к заказу в RO App

  • Настроить автоматическое изменение статуса заказа в соответствии со статусом ТТН

  • Отслеживать статус ТТН в заказе и таблице заказов (RO App будет обновлять статус отправления каждые 30 минут)

  • Добавлять номер ТТН в шаблоны документов и уведомлений

Шаг 1. Как настроить интеграцию с Укрпочтой?

1. Перейдите на страницу «Настройки > Интеграции» в раздел «Логистика». Найдите интеграцию с Укрпочтой и нажмите кнопку «Настроить».

2. Поставьте галочку «Интеграция включена».

3. В центре интеграции нужно добавить аккаунт, нажав на кнопку «+ Аккаунт», заполнить обязательные поля и выбрать локацию. Можно подключить только один аккаунт.

Название — произвольное название интеграции, которое используется для удобной идентификации подключения в системе, особенно если интеграций несколько.

Локация — локация, к которой будет привязана интеграция с Укрпочтой и для которой будут использоваться данные отправлений и отслеживания.

Следующие поля вы заполняете данными, которые получаете на электронную почту после подписания договора с Укрпочтой как ФЛП или физическое лицо:

Authorisation bearer — токен пользователя, от имени которого выполняется подключение и взаимодействие с API Укрпочты.

User Token — уникальный токен доступа, используемый для авторизации запросов к сервисам Укрпочты и обмена данными.

Status Tracking Token — токен, который применяется для получения и автоматического обновления статусов почтовых отправлений.

Нажмите Загрузить данные, чтобы добавить аккаунт к интеграции.

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

После этого перейдите в настройки интеграции, дважды нажмите на нужный аккаунт, в его профиле выберите кнопку Удалить и подтвердите действие. После удаления вы сможете добавить новый аккаунт для интеграции.

Шаг 2. Настройка автоматического изменения статусов заказов в соответствии со статусами ТТН

Перейдите в окно настройки интеграции с Укрпочтой. В поле «Статус отправления» выберите нужный статус ТТН.

В поле «Статус заказа» выберите соответствующий статус для заказа в RO App. Напоминаем, что вы можете создать новые статусы на странице «Настройки > Статусы > Заказ».

Обратите внимание, что для одного статуса ТТН можно установить только один статус заказа.

Важно: если вы настроили автоматическое изменение статусов, то во время такого изменения будут игнорироваться возможные настройки статусов, например, обязательное создание комментария/платежа или правила перехода между статусами.

Автоматическое изменение статусов заказов поддерживается только для ТТН по Украине. Для международных отправлений доступна только привязка накладной к заказу, при этом в накладной отображается ограниченный набор информации без автоматического обновления статусов.

Шаг 3. Сохранение интеграции

После добавления аккаунта и настройки статусов проверьте, что активирован чекбокс «Интеграция включена», после чего обязательно нажмите кнопку Сохранить.

После сохранения настроек интеграция будет активирована и полностью готова к использованию в работе.

С помощью интеграции вы можете привязать накладные к заказу с автоматическим обновлением статусов, а также добавлять ТТН в шаблоны документов группы «Заказ» и уведомления.

Нашли ответ на свой вопрос?