Русский
EnglishПочта России #
Настройка подключения #
Общий процесс получения ключей и токенов доступа описан в спецификации Почты - https://otpravka.pochta.ru/specification#/main
Ключ к API отправки посылок #
Ключ необходимо сгенерировать согласно инструкции https://otpravka.pochta.ru/specification#/authorization-key и скопировать его в форму подключения.
Токен к API отправки посылок #
API токен высылается на электронную почту, указанную при регистрации на онлайн-сервисе «Отправка» (https://otpravka.pochta.ru). Также токен можно узнать в настройках личного кабинета Почты. Подробнее указано в инструкции - https://otpravka.pochta.ru/specification#/authorization-token
Режим трекинга #
Описание режимов трекинга - https://tracking.pochta.ru/specification
Единичный доступ - доступен сразу после регистрации в сервисе трекинга.
Пакетный доступ - требуется дополнительно запрашивать и подключать в личном кабинете трекинга - https://tracking.pochta.ru
Логин и пароль от трекинга #
Подробная инструкция по получению доступа доступна на сайте почты - https://tracking.pochta.ru/support/faq/how_to_get_access
Полученный логин и пароль после выполнения всех пунктов инструкции необходимо указать в настройках подключения с Почтой России.
Режим калькуляции #
Сервис калькуляции: tariff.pochta.ru - считает стоимость доставки по публичным тарифам. Не учитывает персональные скидки по вашему договору с Почтой России. Не имеет ограничений на кол-во запросов
Сервис калькуляции: otpravka.pochta.ru - считает стоимость доставки по вашим тарифам с учетом скидки по вашему договору с Почтой России. Имеет ограничений на кол-во запросов (Суточный лимит запросов калькуляции выставляется по умолчанию, у каждого клиента, в размере 1/3 от планируемого количества отправлений в месяц и может быть увеличен по запросу. Точное количество запросов в сутки, по клиенту, можно узнать по запросу. Лимит обновляется раз в сутки.)
Онлайн баланс #
Если к договору с Почтой России подключен онлайн-баланс, необходимо активировать эту опцию для корректной работы интеграции.
Режим отображения тарифов до отделений #
Возможность выбора в каком формате будут отображаться тарифы “Посылка онлайн”, “Посылка 1-го класса” и “Посылка нестандартная” до отделений Почты России:
- Отображать как тарифы с доставкой до ПВЗ - в ответе метода расчета тарифов, тарифы будут только в разделе deliveryToPoint.
- Отображать как тарифы с доставкой до двери - в ответе метода расчета тарифов, тарифы будут только в разделе deliveryToDoor. ApiShip, исходя из адреса отправителя и получателя, определит индекс и привяжет доставку к нужному ПВЗ (Отделению / Почтамату).
- Отображать как тарифы с доставкой до двери и до ПВЗ (дублировать) - тарифы будут отображаться двумя способами.
Когда приходит два тарифа “Посылка онлайн”, но с разной ценой - это происходит из-за того, что модуль считает тариф 2 раза до Постамата (Почтамата) и до ПВЗ (Отделения). Отображение тарифа “Посылка онлайн” до Постамата всегда будет отображаться как доставка до ПВЗ, вне зависимости от выбранного режима отображения.
Если тариф до Постамата не нужен, можно создать правило в редакторе тарифов, которое отключит доставку в Постаматы Почты России - пример правила.
Количество запросов в сутки #
Часто возникает ситуация когда расчет стоимости доставки перестает работать в середине дня. Причиной для этой проблемы является ограничение на количество запросов в сутки к API Почты России.
По умолчанию предельное количество запросов на 1 фактическое отправление: 25.
При превышении лимита наш сервис начинает от API Почты России получать следующую ошибку:
| |
Почему количество запросов к API в сутки ограничено описано в разделе помощи на сайте Почты России.
Для решения проблемы нужно увеличить суточный лимит запросов в Почте России. Для этого необходимо написать в поддержку на адрес support.parcel@russianpost.ru с просьбой увеличить лимит для вашего договора.