Lapaygroup russianpost tariff calculation

Данный документ описывает реализацию обмена информацией между Falcon Space и почтой РФ.

Общие входные данные:

  • Город отправления (Флаг – от двери);
  • Город получения (Флаг – до двери);
  • Длина, см;
  • Ширина, см;
  • Высота, см;
  • Вес, г.
  • Формирование текста запроса с параметрами
  • Отправка запроса
  • Получение ответа на запрос
  • Парсинг ответа,  получение данных.

Документация для программиста

Для интеграции с интернет-магазинами представлен API Почтового калькулятора Postprice. ru, позволяющий получить все расчеты стоимости внутренних и международных отправлений Почты России.

Ответ сервер возвращает в формате JSON.

API расчета внутренних отправлений Почты России

API расчета международных отправлений Почты России

При большем числе запросов стоимость использования платного API-ключа составляет 0,02 р. / запрос. Если баланс недостаточен, то используется бесплатный суточный лимит запросов.

Получить API-ключ можно в личном кабинете.

Международные отправления

ПараметрОписание
countryСтрана получателя из списка
massМасса отправления, в граммах (значения от 0 до 20000)
valuationОбъявленная ценность, в рублях
vatНДС 20% (1 — с НДС, 0 — без НДС)
apikeyAPI-ключ

Обязательные параметры запроса: country.

Пример JSON-ответа сервера:

ПараметрОписание
codeВнутренний код ответа
locality_toНазвание страны получателя
simple_letterСтоимость простого письма, в рублях
reg_letterСтоимость заказного письма, в рублях
val_letterСтоимость ценного письма, в рублях
simple_letter_aviaСтоимость простого письма (авиа), в рублях
reg_letter_aviaСтоимость заказного письма (авиа), в рублях
val_letter_aviaСтоимость ценного письма (авиа), в рублях
simple_parcelСтоимость простой бандероли, в рублях
reg_parcelСтоимость заказной бандероли, в рублях
simple_parcel_aviaСтоимость простой бандероли (авиа), в рублях
reg_parcel_aviaСтоимость заказной бандероли (авиа), в рублях
simple_pocketmСтоимость мешка «М», в рублях
reg_pocketmСтоимость заказного мешка «М», в рублях
simple_pocketm_aviaСтоимость мешка «М» (авиа), в рублях
reg_pocketm_aviaСтоимость заказного мешка «М» (авиа), в рублях
simple_smallpackageСтоимость простого мелкого пакета, в рублях
reg_smallpackageСтоимость заказного мелкого пакета, в рублях
simple_smallpackage_aviaСтоимость простого мелкого пакета (авиа), в рублях
reg_smallpackage_aviaСтоимость заказного мелкого пакета (авиа), в рублях
pkgСтоимость посылки, в рублях
pkg_aviaСтоимость посылки (авиа), в рублях

Внутренние коды ответа:

КодОписание
100Расчет завершен успешно
101Некорректное значение массы отправления
103Некорректная страна-получатель
105Исчерпан лимит запросов

Пример на PHP для разработчиков:

Внутренние отправления

ПараметрОписание
fromПочтовый индекс отправителя (6 цифр)
toПочтовый индекс получателя (6 цифр)
massМасса отправления, в граммах (значения от 0 до 20000)
valuationОбъявленная ценность, в рублях
vatНДС 20% (1 — с НДС, 0 — без НДС)
oversizedНегабаритная посылка (1 — негабаритная, 0 — обычная)
monthМесяц отправки (от 1 до 12)
dayДень месяца отправки (от 1 до 31)
apikeyAPI-ключ

Обязательные параметры запроса: from, to.

ПараметрОписание
codeВнутренний код ответа
locality_fromНаименование ОПС отправителя
locality_toНаименование ОПС получателя
city_fromГород отправителя
city_toГород получателя
region_fromРегион отправителя
region_toРегион получателя
simple_letterСтоимость простого письма, в рублях
reg_letterСтоимость заказного письма, в рублях
val_letterСтоимость ценного письма, в рублях
simple_parcelСтоимость простой бандероли, в рублях
reg_parcelСтоимость заказной бандероли, в рублях
val_parcelСтоимость ценной бандероли, в рублях
pkgСтоимость посылки, в рублях
letter_reg_1classСтоимость заказного письма 1 класса, в рублях
letter_val_1classСтоимость ценного письма 1 класса, в рублях
reg_parcel1classСтоимость заказной бандероли 1 класса, в рублях
val_parcel1classСтоимость ценной бандероли 1 класса, в рублях
pkg_1classСтоимость заказной посылки 1 класса, в рублях
pkg_val_1classСтоимость ценной посылки 1 класса, в рублях
codСумма наложенного платежа, в рублях

КодОписание
100Расчет завершен успешно
101Некорректное значение массы отправления
102Некорректный индекс отправителя
103Некорректный индекс получателя
104Отправка в данное ОПС невозможна
105Исчерпан лимит запросов

Почта РФ без авторизации

Если у Вас нет договора и доступа к api используйте эти два сервиса от Почты России.

Почта РФ тарифы – Стоимость – PROCEDURE [api_ruPostTariff_request]

Автоматический расчет стоимости почтовых отправлений и услуг с помощью сервиса тарификации

Для получения расчета клиент отправляет на сервер REST-запрос методом GET

  • Метод запроса: GET
  • Формат на выходе: JSON
  • 101000 – МОСКВА
  • 344000 – Ростов
  • 163000- Архангельск
  • 690000 – Владивосток

Замечание 1. В зависимости от Кода объекта тарификации набор входных параметров может меняться.

Пример текста запроса – request.

Примечание. Фактически в этом запросе передается только URL. Тела запроса body – нет, SELECT2 не используется.

Пример текста ответа – response.

Результат запроса может быть как сообщение с информацией, так и сообщение с ошибкой.

Список возможных сообщение об ошибка.

Пример текста ответа – response – с ошибкой.

Если ошибок в ответе не обнаружено, из ответа выбираться такие данные:

  • Итого сумма без НДС
  • Итого сумма с НДС
  • Ставка НДС %
  • Сумма НДС
  • Название операции
  • Дата и Время выполнения

Пример текста – результат: “Операция: Посылка 1 класса Итого сумма без НДС: 144. 71 руб. Итого НДС ( Ставка 20% ):28. 38 руб. Итого сумма с НДС: 173. 00 руб

Почта РФ – Сроки Доставки – PROCEDURE [api_ruPostDelivery_request]

Автоматический расчет нормативных сроков доставки почтовых отправлений.

  • Метод запроса: GET
  • Формат на выходе: JSON

Пример текста запроса – request.

Примечание. Фактически в этом запросе передается только URL. Тела запроса body – нет, SELECT2 не используется.

Пример текста ответа – response.

Список возможных сообщение об ошибках.

  • Минимальное нормативное количество дней доставки отправления
  • Максимальное нормативное количество дней доставки отправления
  • Название операции
  • Дата и Время выполнения

Пример текста – результат: “Операция: Посылка 1 класса Срок доставки: от 2 до 4 дней

Falcon Space – функциональная веб-платформа разработки на узком стеке MS SQL/Bootstrap. Вводная по Falcon Space

Насколько полезной была статья?

Google поиск по нашей документации

Взаимодействие посредством REST запросов.

Запросы и ответы сервиса используют JSON текстовый формат.

Для интеграции с API Онлайн-сервиса «Отправка» необходимо располагать:

  • токеном авторизации приложения;
  • ключом авторизации пользователя.

Для работы с данным сервисом и получения токена необходим договор с Почтой России!

Далее это способ не рассматривается.

Понравилась статья? Поделиться с друзьями:
sdo.russianpost.ru
Добавить комментарий

Adblock
detector