Api russianpost php

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

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

  • Город отправления (Флаг – от двери);
  • Город получения (Флаг – до двери);
  • Длина, см;
  • Ширина, см;
  • Высота, см;
  • Вес, г.
  • Формирование текста запроса с параметрами
  • Отправка запроса
  • Получение ответа на запрос
  • Парсинг ответа,  получение данных.
  • calc – расчет стоимости доставки и контрольного срока прохождения посылок (бандеролей), отправленных Почтой России (1 класс в том числе). Подробнее
  • print_f7p – печать бланка адресного ярлыка (на конверт, пластиковый пакет, коробку) по форме 7-п, 7-а, 7-б. Подробнее
  • print_f116 – печать сопроводительного бланка по форме 116. Подробнее
  • print_f112 – печать бланка почтового перевода по форме 112эф. Подробнее
  • print_f113 – печать бланка наложенного платежа по форме 113эн. Подробнее
  • print_f103 – список для отправки партионных почтовых отправлений по форме 103. Подробнее
  • parcel – отслеживание посылок по РПО (почтовому идентификатору). Подробнее

В нашем API реализованы методы, которые требуют 2 разных метода аутентификации. 1 метод аутентификации – по API ключу и API паролю. 2 метод аутентификации – по API ключу и IP адресу сервера

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

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

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

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

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

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

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

Lapaygroup/russianpost

85 Favers
23740 Downloads

SDK для работы с API Почты России (pochta. ru)

Go to
Download

Appwilio/russianpost-sdk

46 Favers
13495 Downloads

Russian Post (pochta. ru) SDK

Shopexpress/russianpost-blanks

0 Favers
2013 Downloads

Russian Post blank printing library

Cosmologist/russian-post

6 Favers
572 Downloads

Volumnet/raas-cms-russianpost

0 Favers
13 Downloads

Russian post adapter for RAAS4. CMS

Vertx/php-russianpost-tracking

1 Favers
19 Downloads

PHP library of tracking mailing via API Russian Post.

Mukhtonio/yii2-russianpost

0 Favers
10 Downloads

Kilylabs/russianposttracking

0 Favers
62 Downloads

API wrapper for tracking. pochta. ru (forked from voronkovm/russianposttracking)

Gillbeits/russian-post-item-data-service-v1

0 Favers
44 Downloads

Classes for use Item Data Service Russian Post SOAP

Gileson/russianpostcalc

1 Favers
916 Downloads

Интерфейс для работы с russianpostcalc. ru API

Bringer/russian-post-api-client-php

3 Favers
375 Downloads

PHP client for RussianPost API

3mg/russian-post-bundle

1 Favers
34 Downloads

Бандл для работы с сервисом отслеживания Почты России

Russianpost/datamatrixbase256

0 Favers
779 Downloads

Russian Post form generate datamatrix Base256 barcode. Based on tcpdf library

Druidvav/datamatrixbase256

0 Favers
7 Downloads

Andrey-helldar/pochta

3 Favers
1627 Downloads

Package for working with API Russian Post.

API. Метод print_f112. Печать бланка почтового перевода ф. 112эн

Доступ с аутентификацией по API ключу + API паролю. Все аргументы запроса обязательны.

Аргументы запроса

В случае успеха, будет возвращена ссылка на сгенерированный PDF файл печати бланка. Все отправления из массива list будут распечатаны в одном PDF файле. Ссылка действительна 24 часа.

PHP скрипт – пример, вызова метода print_f112

Будет доступен после регистрации.

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

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

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

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

ПараметрОписание
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Исчерпан лимит запросов

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

API. Метод print_f113. Печать бланка почтового перевода ф. 113эф

Доступ с аутентификацией по API ключу + API паролю или доступ по API ключу + IP сервера с которого будет выполнен запрос. Все аргументы запроса обязательны.

PHP скрипт – пример, вызова метода calc

  • API URL – Адрес сервера.
  • API Ключ – уникальный ключ Вашего аккаунта, обязательный параметр для API запросов.
  • API пароль – требуется для проверки подписи.
  • IP – адрес Вашего сайта.

Основные аргументы API запроса

Доступ с аутентификацией по API ключу + API паролю. Обязательный аргумент (помимо основных) – rpo. Остальные параметры – дополнительные,
если Вам понадобится пользоваться нашим личным кабинетом для наглядного отслеживания посылок.

Как работает сервис по отслеживанию? Вы добавляете нужные РПО к отслеживанию вызывая метод parcel с нужным rpo. При вызове метода parcel с номером РПО который не был добавлен к отслеживанию ранее, Вы получите сообщение об успешно выполенной операции
и пустые статусы status0, status1. Ваш номер РПО добавлен в очередь на отслеживание. Сервис обновляет информацию о
каждом отправлении 3 раза в сутки. Первое обновление каждого нового номера РПО будет в интервале от 5 до 30 минут. Через 30 минут вызываете данный метод parcel с номером РПО добавленным ранее и получаете обновленный статус отправления и всю историю прохождения. Если статусы пустые – скорее всего еще не обновилась информация в базе Почты России по данному отправлению.

PHP скрипт – пример, вызова метода parcel (отслеживания почтового отправления)

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

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

ПараметрОписание
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Исчерпан лимит запросов

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

Если у Вас нет договора и доступа к 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