Получите токен Openapi (претензия заказным письмом)
Создайте аккаунт Openapi, пополните баланс и выпустите токен со scopes для заказных писем: претензия тем, кто не забрал посылку, уходит заказным письмом прямо из заказа.
Обновлено 3 ноября 2026 г.
С токеном Openapi RoyLead отправляет претензию тем, кто не забрал посылку, итальянским заказным письмом через сервис Ufficio Postale от Openapi: её печатают, кладут в конверт и передают в Poste Italiane. Всё идёт через ваш аккаунт Openapi: письма оплачиваются там, с вашего баланса (примерно от 4 € за письмо, плюс уведомление о вручении, если нужно).
Токен принадлежит команде: его добавляет владелец или админ.
Шаги
-
Зайдите на console.openapi.com и создайте аккаунт (или войдите).
-
Откройте API Library → Postal Service → State. Выполните два требования, Two factor verification и Data processor agreement (договор о конфиденциальности отправляемых данных, его нужно принять), затем нажмите Activate.
-
Пополните баланс аккаунта: каждое письмо списывается оттуда.
-
Откройте Authentication в левом меню и в блоке Production Token List нажмите + New token. Укажите имя (например, «RoyLead») и далёкую дату окончания (Openapi разрешает максимум 1 год: поставьте его и запишите дату, потому что когда токен истекает, письма перестают уходить и нужен новый). Отметьте Postal Service или только эти scopes:
POST:ws.ufficiopostale.com/raccomandateGET:ws.ufficiopostale.com/raccomandatePATCH:ws.ufficiopostale.com/raccomandateGET:ws.ufficiopostale.com/dug
Скопируйте токен (24 символа) кнопкой копирования. Не API Key сверху: он только для Openapi, RoyLead его отклонит.
-
В RoyLead откройте команда → Клиенты → Заказные письма (Openapi), вставьте токен и нажмите Сохранить. RoyLead проверит его в Openapi перед сохранением.
Как отправить
- В заказе создайте претензию как обычно.
- Нажмите Отправить заказным письмом: отправитель и получатель уже заполнены, поправьте при необходимости.
- Подготовить и показать цену: Openapi проверит PDF и назовёт стоимость.
- Отправить письмо: оно уходит. В том же окне потом видны номер письма и последний статус почты.
💡 Токен хранится зашифрованным и больше не показывается (только последние цифры). Если его удалить, письма из RoyLead отправлять нельзя.
⚠️ Отправитель и получатель печатаются на конверте: у каждой строки есть лимит символов. Если поле слишком длинное, окно выделит его красным: сократите (например, «Via Giuseppe Garibaldi» → «Via G. Garibaldi»).
Готовы применить это на практике?
Создайте аккаунт RoyLead и начните за пару минут.