Благодаря базовой интеграции с Укрпочтой вы сможете:
Привязать имеющееся отправление по его номеру к заказу в RO App
Настроить автоматическое изменение статуса заказа в соответствии со статусом ТТН
Отслеживать статус ТТН в заказе и таблице заказов (RO App будет обновлять статус отправления каждые 30 минут)
Добавлять номер ТТН в шаблоны документов и уведомлений
Шаг 1. Подключение интеграции с Укрпочтой
1. Перейдите на страницу «Настройки > Интеграции» в раздел «Логистика». Найдите интеграцию с Укрпочтой и нажмите кнопку «Настроить».
2. Поставьте галочку «Интеграция включена».
3. В центре интеграции нужно добавить аккаунт, нажав на кнопку «+ Аккаунт», заполнить обязательные поля и выбрать локацию. Можно подключить только один аккаунт.
Название — произвольное название интеграции, которое используется для удобной идентификации подключения в системе, особенно если интеграций несколько.
Локация — локация, к которой будет привязана интеграция с Укрпочтой и для которой будут использоваться данные отправлений и отслеживания.
Следующие поля вы заполняете данными, которые получаете на электронную почту после подписания договора с Укрпочтой как ФЛП или физическое лицо:
Authorisation bearer — токен пользователя, от имени которого выполняется подключение и взаимодействие с API Укрпочты.
User Token — уникальный токен доступа, используемый для авторизации запросов к сервисам Укрпочты и обмена данными.
Status Tracking Token — токен, который применяется для получения и автоматического обновления статусов почтовых отправлений.
Нажмите Загрузить данные, чтобы добавить аккаунт к интеграции.
Шаг 2. Заполнение данных отправителя для создания ТТН
В настройках интеграции вы можете задать параметры, по которым будет формироваться ТТН. При создании ТТН в заказе данные в этих полях можно будет изменить.
Необходимо заполнить следующие поля:
Тип отправителя — выберите: физическое лицо, индивидуальный предприниматель или юридическое лицо.
В зависимости от выбранного типа отправителя необходимо указать:
Для физического лица — ФИО и номер телефона.
Для индивидуального предпринимателя — название индивидуального предпринимателя в качестве отправителя, номер телефона и IBAN.
Для юридического лица — название юридического лица в качестве отправителя, номер телефона, ЕГРПОУ и IBAN.
Тип доставки — выберите способ доставки в соответствии с доступными вариантами (например, из отделения в отделение, из отделения по адресу, с адреса в отделение, с адреса по адресу).
Город — укажите населенный пункт, в который будет осуществляться доставка. В строке поиска необходимо ввести не менее 3 символов, чтобы отобразились доступные населенные пункты для выбора.
Отделение — выберите отделение Укрпочты, из которого будет осуществляться отправка.
Оплачивающий доставку — определите, кто оплачивает доставку: отправитель или получатель.
Тип отправки — выберите тип отправки (например, стандартная, экспресс или документ).
Невостребованные отправления — укажите, что делать с посылкой в случае, если получатель ее не заберет (вернуть отправителю через 7 дней или в течение 14 дней или утилизировать).
Наложенный платеж — отметьте, если нужно, чтобы получатель оплатил стоимость товара при получении или оплата осуществляется предварительно.
Тип дополнительной информации — выберите тип дополнительных данных,
которые необходимо передать вместе с отправлением (при необходимости).
Хрупкость — отметьте, является ли отправление хрупким, если оно содержит хрупкие предметы, требующие осторожной транспортировки.
Декларированная стоимость — укажите, как будет оцениваться стоимость отправления: по стоимости товара или по фиксированной сумме (если выбран этот вариант, необходимо указать фиксированную стоимость).
После заполнения всех полей нажмите «Сохранить», созданная учетная запись будет добавлена в интеграцию.
Если вы хотите изменить данные отправителя в созданной учетной записи, откройте её, внесите изменения и нажмите Сохранить.
Чтобы изменить аккаунт, используемый в интеграции с Укрпочтой, сначала необходимо удалить текущий. Перед удалением аккаунта необходимо удалить все накладные, привязанные к заказам, которые были созданы или связаны с этим аккаунтом в интеграции. Только после очистки заказов от таких накладных аккаунт можно удалить. После этого перейдите в настройки интеграции, дважды нажмите на нужный аккаунт, в его профиле выберите кнопку Удалить и подтвердите действие. После удаления вы сможете добавить новый аккаунт для интеграции.
Шаг 3. Настройка автоматического изменения статусов заказов в соответствии со статусами ТТН
Перейдите в окно настройки интеграции с Укрпочтой. В поле «Статус отправления» выберите нужный статус ТТН.
В поле «Статус заказа» выберите соответствующий статус для заказа в RO App. Напоминаем, что вы можете создать новые статусы на странице «Настройки > Статусы > Заказ».
Обратите внимание, что для одного статуса ТТН можно установить только один статус заказа.
Важно: если вы настроили автоматическое изменение статусов, то во время такого изменения будут игнорироваться возможные настройки статусов, например, обязательное создание комментария/платежа или правила перехода между статусами.
Автоматическое изменение статусов заказов поддерживается только для ТТН по Украине. Для международных отправлений доступна только привязка накладной к заказу, при этом в накладной отображается ограниченный набор информации без автоматического обновления статусов.
Шаг 4. Сохранение интеграции
После добавления аккаунта и настройки статусов проверьте, что активирован чекбокс «Интеграция включена», после чего обязательно нажмите кнопку Сохранить.
После сохранения настроек интеграция будет активирована и полностью готова к использованию в работе.
С помощью интеграции вы можете привязать накладные к заказу с автоматическим обновлением статусов, а также добавлять ТТН в шаблоны документов группы «Заказ» и уведомления.