Скилл Почты России в Aizor: как подключить и автоматизировать отправку
Содержание
Коротко. Скилл Почты России подключает ИИ-агента Aizor к API: расчёт тарифа, создание заказов и партий, печать форм и отслеживание по трек-номеру. Для отправки нужны два секрета из онлайн-сервиса «Отправка»: токен приложения и ключ пользователя (логин и пароль API в кодировке base64). Для трекинга нужны логин и пароль из раздела «Настройки доступа». Подключить API можно только у зарегистрированного пользователя.
Что даёт скилл Почты России в Aizor
По описанию команды Aizor, скилл помогает:
- рассчитывать тариф;
- создавать заказы и партии отправлений;
- печатать формы;
- отслеживать отправления по трек-номеру.
Он подойдёт небольшим магазинам и самозанятым, которые отправляют посылки Почтой России и устали вручную заполнять формы. Что за приложение Aizor, описано на странице «Что такое Aizor».
Что понадобится
- Регистрация в онлайн-сервисе «Отправка» (otpravka.pochta.ru) и включённый доступ к API.
- Для отслеживания: зарегистрированный пользователь с подключённым доступом к API сервиса отслеживания.
- Приложение Aizor для macOS или Windows.
В документации Почты России есть два отдельных API. Первый, «Отправка», работает по REST с обменом в формате JSON. Второй, сервис отслеживания, построен на SOAP. У них разные данные доступа.
Нужен аккаунт Aizor? Скачивание бесплатное, промокод kalsin5 даёт −5% на каждое пополнение.
Открыть Aizor ↗Как получить ключ API: по шагам
Для отправки (REST API «Отправка»)
- Зарегистрируйтесь в онлайн-сервисе «Отправка» и активируйте доступ к API.
- Получите токен авторизации приложения. По документации, после активации он приходит на электронную почту, указанную при регистрации. Его также можно посмотреть в настройках личного кабинета.
- Подготовьте логин и пароль для API, выданные сервисом passport.pochta.ru.
- Ключ пользователя получают так: логин и пароль через двоеточие кодируют в base64. На странице спецификации есть форма для генерации ключа.
Токен передаётся в заголовке Authorization с префиксом AccessToken, ключ пользователя в заголовке X-User-Authorization с префиксом Basic. В Aizor это делать вручную не нужно. Токен можно обновить в настройках личного кабинета по ссылке «Обновить токен», после чего придёт уведомление на почту.
Для отслеживания (SOAP)
- Войдите как зарегистрированный пользователь, у которого подключён доступ к API.
- Откройте раздел «Настройки доступа» и скопируйте логин и пароль для API сервиса отслеживания.
Затем установите скилл Почты России из каталога скиллов в Aizor и вставьте данные в его настройки.
Проверка: первые запросы агенту
- «Покажи историю операций по отправлению с трек-номером ...» (только чтение)
- «Сколько запросов к API мне осталось на сегодня?» (только чтение)
- «Рассчитай стоимость пересылки посылки весом 1 кг из Уфы в Москву.» (только расчёт)
- «Подготовь заказ по этим данным, но не создавай, пока я не подтвержу.»
Попробовать на своём кабинете. Aizor скачивается бесплатно, есть тариф со своими API-ключами. Промокод kalsin5 даёт скидку 5% на пополнение баланса.
Сценарии автоматизации
Трекинг посылок по расписанию
Планировщик Aizor запускает агента, он проверяет операции по списку трек-номеров и присылает короткий отчёт о том, где посылки. В ответе сервиса указаны дата, место и название каждой операции.
Расчёт тарифа для покупателя
Вы называете индекс и вес, агент считает стоимость пересылки. Сервис возвращает сумму в копейках, агент переводит её в рубли.
Подготовка заказов и партий
Агент собирает данные получателей из таблицы, например из Google Таблиц, и готовит заказы и партию. Включите ручное подтверждение: заказ создаётся только после вашего «да».
Печать форм
Агент запрашивает печатные формы и документы партии. В списке методов документации есть, например, формы Ф7п, Ф112ЭК и Ф103.
Частые ошибки
| Что видите | Причина | Что делать |
|---|---|---|
Ошибка авторизации (AuthorizationFault в трекинге) | Неверные логин и пароль API | Сверьте данные в разделе «Настройки доступа» |
| Отказ в доступе к «Отправке» | Неверный токен приложения или ключ пользователя | Проверьте токен в настройках кабинета и перекодируйте логин с паролем в base64 |
Ошибка языка (LanguageFault) | Указан недопустимый язык запроса | Допустимы RUS и ENG |
Ошибка по отправлению (OperationHistoryFault) | Не удалось получить сведения по отправлению | Проверьте трек-номер: 14 цифр или 13 символов международного формата |
| Пустая история операций | По отправлению пока нет зарегистрированных операций | Проверьте позже |
О лимитах: токен приложения определяет квоты на использование сервиса. Сколько запросов в сутки разрешено и сколько осталось, показывает метод «Текущее количество запросов по API».
Безопасность
- Документация Почты России прямо предупреждает: не храните пароль к API в текстовых файлах и не передавайте токен, ключ, логин и пароль третьим лицам.
- Создание партий и заказов оставьте под ручным подтверждением.
- Для разных задач заведите отдельные доступы, если сервис это позволяет.
- Токен можно заменить через ссылку «Обновить токен» в настройках кабинета.
- Сравните тарифы Aizor на странице тарифов.
Инструкция написана по официальной документации Почты России (otpravka.pochta.ru/specification и tracking.pochta.ru/specification), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.
