Swagger API Личный кабинет Центр поддержки
  • Languages Русский

Почта России #

Настройка подключения #

Общий процесс получения ключей и токенов доступа описан в спецификации Почты - https://otpravka.pochta.ru/specification#/main

Ключ к API отправки посылок #

img

Ключ необходимо сгенерировать согласно инструкции https://otpravka.pochta.ru/specification#/authorization-key и скопировать его в форму подключения.

Токен к API отправки посылок #

img

API токен высылается на электронную почту, указанную при регистрации на онлайн-сервисе «Отправка» (https://otpravka.pochta.ru). Также токен можно узнать в настройках личного кабинета Почты. Подробнее указано в инструкции - https://otpravka.pochta.ru/specification#/authorization-token

Режим трекинга #

img

Описание режимов трекинга - https://tracking.pochta.ru/specification

Единичный доступ - доступен сразу после регистрации в сервисе трекинга.

Пакетный доступ - требуется дополнительно запрашивать и подключать в личном кабинете трекинга - https://tracking.pochta.ru

Логин и пароль от трекинга #

img

Подробная инструкция по получению доступа доступна на сайте почты - https://tracking.pochta.ru/support/faq/how_to_get_access

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

Режим калькуляции #

img

Сервис калькуляции: tariff.pochta.ru - считает стоимость доставки по публичным тарифам. Не учитывает персональные скидки по вашему договору с Почтой России. Не имеет ограничений на кол-во запросов

Сервис калькуляции: otpravka.pochta.ru - считает стоимость доставки по вашим тарифам с учетом скидки по вашему договору с Почтой России. Имеет ограничений на кол-во запросов (Суточный лимит запросов калькуляции выставляется по умолчанию, у каждого клиента, в размере 1/3 от планируемого количества отправлений в месяц и может быть увеличен по запросу. Точное количество запросов в сутки, по клиенту, можно узнать по запросу. Лимит обновляется раз в сутки.)

Онлайн баланс #

img

Если к договору с Почтой России подключен онлайн-баланс, необходимо активировать эту опцию для корректной работы интеграции.

Режим отображения тарифов до отделений #

img

Возможность выбора в каком формате будут отображаться тарифы “Посылка онлайн”, “Посылка 1-го класса” и “Посылка нестандартная” до отделений Почты России:

  • Отображать как тарифы с доставкой до ПВЗ - в ответе метода расчета тарифов, тарифы будут только в разделе deliveryToPoint.
  • Отображать как тарифы с доставкой до двери - в ответе метода расчета тарифов, тарифы будут только в разделе deliveryToDoor. ApiShip, исходя из адреса отправителя и получателя, определит индекс и привяжет доставку к нужному ПВЗ (Отделению / Почтамату).
  • Отображать как тарифы с доставкой до двери и до ПВЗ (дублировать) - тарифы будут отображаться двумя способами.

Когда приходит два тарифа “Посылка онлайн”, но с разной ценой - это происходит из-за того, что модуль считает тариф 2 раза до Постамата (Почтамата) и до ПВЗ (Отделения). Отображение тарифа “Посылка онлайн” до Постамата всегда будет отображаться как доставка до ПВЗ, вне зависимости от выбранного режима отображения.

Если тариф до Постамата не нужен, можно создать правило в редакторе тарифов, которое отключит доставку в Постаматы Почты России - пример правила.

Тип генерации форм #

img

Генерация пакета документации - при получении накладной (акта приема-передачи), генерирует пакет документов, а именно:

  • Форма Ф103 по заявкам в составе партии, в зависимости от типа и категории отправлений;
  • Комбинация из сопроводительных документов в формате pdf ( формы: f7, f112, f22).

Генерация печатной формы Ф103 - генерирует только форму Ф103, без дополнительных файлов. В зависимости от пункта приема печатается форма Ф103-п.

Тип печати #

img

В зависимости от выбора типа печати может зависеть формат этикетки (наклейки).

Количество запросов в сутки #

Часто возникает ситуация когда расчет стоимости доставки перестает работать в середине дня. Причиной для этой проблемы является ограничение на количество запросов в сутки к API Почты России.

По умолчанию предельное количество запросов на 1 фактическое отправление: 25.

При превышении лимита наш сервис начинает от API Почты России получать следующую ошибку:

1
2
3
4

{
  "status": "ERROR",
  "message": "Token requests limit exceeded"
}

Почему количество запросов к API в сутки ограничено описано в разделе помощи на сайте Почты России.

Для решения проблемы нужно увеличить суточный лимит запросов в Почте России. Для этого необходимо написать в поддержку на адрес support.parcel@russianpost.ru с просьбой увеличить лимит для вашего договора.