Данный документ описывает реализацию обмена информацией между 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 Онлайн-сервиса «Отправка» необходимо располагать:
- токеном авторизации приложения;
- ключом авторизации пользователя.
Для работы с данным сервисом и получения токена необходим договор с Почтой России!
Далее это способ не рассматривается.
