RussianPostCalc.ru
Онлайн сервис. Печать бланков, расчет
доставки, отслеживание отправлений. Автоматизация интернет магазина. API.
Главная — Автоматизация. API

Перечень методов API

  • 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

Вызов методов осуществляется посредством GET или POST HTTP - запросов (на Ваш выбор) к API URL. Для запроса используйте кодировку UTF-8. В GET или POST запросах передаются аргументы с именами:

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

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

[in]apikeyAPI ключ Вашего аккаунта. Обязательный аргумент.
[in]methodвызываемый метод. Обязательный аргумент.
[in]...набор переменных, зависящих от конкретного метода.
[in]hashобязательный параметр если метод требует аутентификацию по API паролю.

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

[out]msgСообщение о выполнении действия в виде массива с ключами.
  • 'type' - тип сообщения (error - ошибка, done - успешно).
  • 'text' - текстовое сообщение.
[out]...набор переменных, зависящих от конкретного метода.



API. Метод calc. Расчет стоимости отправки Почтового отправления

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

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

[in]apikeyAPI ключ Вашего аккаунта.
[in]methodcalc
[in]from_indexПочтовый индекс отправителя
[in]to_indexПочтовый индекс получателя
[in]weightВес, в кг. Например, 1.34
[in]ob_cennost_rubОбъявленная ценность отправления, руб
[in]hashОбязательный аргумент, если аутентификация по методу API ключ + API пароль

Аргументы ответа

[out]msgСообщение о выполнении действия в виде массива с ключами.
  • 'type' - тип сообщения (error - ошибка, done - успешно).
  • 'text' - текстовое сообщение.
[out]calcМассив. Ключи каждого элемента массива:
  • 'type' - тип отправления (rp_1class - Почта России 1 Класс, rp_main - Ценная Посылка, обычное отправление Почтой России).
  • 'cost' - сумма доставки в рублях.
  • 'days' - контрольный (максимальный) срок доставки.
[out]info Сообщение о выполнении действия в виде массива с ключами.
  • 'from_index' - индекс отправителя.
  • 'from_city' - город отправителя.
  • 'from_state' - область, регион отправителя.
  • 'to_index' - индекс получателя.
  • 'to_city' - город получателя.
  • 'to_state' - область, регион получателя.
  • 'weight' - вес отправления.
  • 'ob_cennost_rub' - объявленная ценность отправления.

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

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




API. Метод print_f7p. Печать бланка адресного ярлыка

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

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

[in]apikeyAPI ключ Вашего аккаунта.
[in]methodprint_f7p
[in]print0Значение 1 или 0. Если 1, то нулевая объявленная ценность и наложенный платеж печатается как 0 руб., иначе остается пустое место
[in]printnalogkareqЗначение 1 или 0. Если 1, то печатаются реквизиты для наложенного платежа (также требуется значение nalogka_ur_lico_cb=1 в конкретном отправлении), иначе не печатаются
[in]listМассив данных о почтовых отправлениях закодированный JSON. Данные параметры печатаются без проверки. Что введено, то будет напечатано. Указывайте телефонный номер для отправления уведомлений по СМС, по факту прихода отправления в почтовое отделение (в разработке)
  • 'parcel_type' - тип отправления. Значения: 'rp' - посылка, 'rp_1class' - отправление 1 класса, 'banderol' - бандероль.
  • 'from_country' - страна места отправления
  • 'from_index' - почтовый индекс места отправления
  • 'from_state' - область/регион
  • 'from_city' - город/населенный пункт
  • 'from_addr' - обратный адрес отправителя (улица, дом, квартира/офис)
  • 'from_fio' - ФИО или наименование организации отправителя
  • 'to_country' - страна места получения
  • 'to_index' - почтовый индекс получателя
  • 'to_state' - область/регион
  • 'to_city' - город/населенный пункт
  • 'to_addr' - адрес получателя (улица, дом, квартира/офис)
  • 'to_fio' - ФИО или наименование организации получателя
  • 'nalogka_ur_lico_cb' - значение '1' - печатать реквизиты наложенного платежа на бланке. Значение '0' - нет
  • 'from_inn' - ИНН получателя (ООО или ИП)
  • 'from_bik' - БИК Банка, в котором открыт счет
  • 'from_bank' - наименование банка
  • 'from_ks' - корреспондентский счет
  • 'from_rs' - расчетный счет
  • 'to_tel' - телефонный номер получателя (формат: +7XXXXXXXXXX, 8XXXXXXXXXX, 7XXXXXXXXXX)
  • 'order_id' - номер заказа (в Вашей системе учета)
  • 'ob_cennost_rub' - сумма объявленной ценности
  • 'nalogka_rub' - сумма наложенного платежа
[in]hashОбязательный аргумент

Аргументы ответа

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

[out]msgСообщение о выполнении действия в виде массива с ключами.
  • 'type' - тип сообщения (error - ошибка, done - успешно).
  • 'text' - текстовое сообщение.
[out]linkСсылка на PDF файл.

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

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




API. Метод print_f116. Печать сопроводительного бланка ф.116

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

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

[in]apikeyAPI ключ Вашего аккаунта.
[in]methodprint_f116
[in]f116_onepageЗначение 1 или 0. Если 1, то форма 116 печатается на 1 листе А4, иначе на двух листах А5
[in]print0Значение 1 или 0. Если 1, то нулевая объявленная ценность и наложенный платеж печатается как 0 руб., иначе остается пустое место
[in]listМассив данных о почтовых отправлениях закодированный JSON. Данные параметры печатаются без проверки. Что введено, то будет напечатано. Указывайте телефонный номер для отправления уведомлений по СМС, по факту прихода отправления в почтовое отделение (в разработке)
  • 'from_country' - страна места отправления
  • 'from_index' - почтовый индекс места отправления
  • 'from_state' - область/регион
  • 'from_city' - город/населенный пункт
  • 'from_addr' - обратный адрес отправителя (улица, дом, квартира/офис)
  • 'from_fio' - ФИО или наименование организации отправителя
  • 'p_seriya' - серия паспорта
  • 'p_nomer' - номер паспорта
  • 'p_vidan' - дата выдачи (формат: ДД.ММ.ГГГГ)
  • 'p_vidal' - наименования учреждения выдавшего паспорт
  • 'to_country' - страна места получения
  • 'to_index' - почтовый индекс получателя
  • 'to_state' - область/регион
  • 'to_city' - город/населенный пункт
  • 'to_addr' - адрес получателя (улица, дом, квартира/офис)
  • 'to_fio' - ФИО или наименование организации получателя
  • 'to_tel' - телефонный номер получателя (формат: +7XXXXXXXXXX, 8XXXXXXXXXX, 7XXXXXXXXXX)
  • 'order_id' - номер заказа (в Вашей системе учета)
  • 'ob_cennost_rub' - сумма объявленной ценности
  • 'nalogka_rub' - сумма наложенного платежа
[in]hashОбязательный аргумент

Аргументы ответа

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

[out]msgСообщение о выполнении действия в виде массива с ключами.
  • 'type' - тип сообщения (error - ошибка, done - успешно).
  • 'text' - текстовое сообщение.
[out]linkСсылка на PDF файл.

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

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




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

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

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

[in]apikeyAPI ключ Вашего аккаунта.
[in]methodprint_f112
[in]f113_oborotЗначение 1 или 0. Если 1, тогда оборотная сторона бланка ф.112 печатается, иначе - нет
[in]nalogka_ur_lico_cbЗначение 1 или 0. Если 1, тогда заполняются поля для перевода на банковский счет, иначе - нет
[in]listМассив данных о почтовых отправлениях закодированный JSON. Данные параметры печатаются без проверки. Что введено, то будет напечатано. Указывайте телефонный номер для отправления уведомлений по СМС, по факту прихода отправления в почтовое отделение (в разработке)
  • 'from_country' - страна места отправления
  • 'from_index' - почтовый индекс места отправления
  • 'from_state' - область/регион
  • 'from_city' - город/населенный пункт
  • 'from_addr' - обратный адрес отправителя (улица, дом, квартира/офис)
  • 'from_fio' - ФИО или наименование организации отправителя
  • 'from_inn' - ИНН получателя (ООО или ИП)
  • 'from_bik' - БИК Банка, в котором открыт счет
  • 'from_bank' - наименование банка
  • 'from_ks' - корреспондентский счет
  • 'from_rs' - расчетный счет
  • 'to_country' - страна места получения
  • 'to_index' - почтовый индекс получателя
  • 'to_state' - область/регион
  • 'to_city' - город/населенный пункт
  • 'to_addr' - адрес получателя (улица, дом, квартира/офис)
  • 'to_fio' - ФИО или наименование организации получателя
  • 'to_tel' - телефонный номер получателя (формат: +7XXXXXXXXXX, 8XXXXXXXXXX, 7XXXXXXXXXX)
  • 'order_id' - номер заказа (в Вашей системе учета)
  • 'ob_cennost_rub' - сумма объявленной ценности
  • 'nalogka_rub' - сумма наложенного платежа
[in]hashОбязательный аргумент

Аргументы ответа

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

[out]msgСообщение о выполнении действия в виде массива с ключами.
  • 'type' - тип сообщения (error - ошибка, done - успешно).
  • 'text' - текстовое сообщение.
[out]linkСсылка на PDF файл.

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

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




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

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

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

[in]apikeyAPI ключ Вашего аккаунта.
[in]methodprint_f113
[in]f113_oborotЗначение 1 или 0. Если 1, тогда оборотная сторона бланка ф.113 печатается, иначе - нет
[in]nalogka_ur_lico_cbЗначение 1 или 0. Если 1, тогда заполняются поля для перевода на банковский счет, иначе - нет
[in]listМассив данных о почтовых отправлениях закодированный JSON. Данные параметры печатаются без проверки. Что введено, то будет напечатано. Указывайте телефонный номер для отправления уведомлений по СМС, по факту прихода отправления в почтовое отделение (в разработке)
  • 'from_country' - страна места отправления
  • 'from_index' - почтовый индекс места отправления
  • 'from_state' - область/регион
  • 'from_city' - город/населенный пункт
  • 'from_addr' - обратный адрес отправителя (улица, дом, квартира/офис)
  • 'from_fio' - ФИО или наименование организации отправителя
  • 'from_inn' - ИНН получателя (ООО или ИП)
  • 'from_bik' - БИК Банка, в котором открыт счет
  • 'from_bank' - наименование банка
  • 'from_ks' - корреспондентский счет
  • 'from_rs' - расчетный счет
  • 'to_country' - страна места получения
  • 'to_index' - почтовый индекс получателя
  • 'to_state' - область/регион
  • 'to_city' - город/населенный пункт
  • 'to_addr' - адрес получателя (улица, дом, квартира/офис)
  • 'to_fio' - ФИО или наименование организации получателя
  • 'to_tel' - телефонный номер получателя (формат: +7XXXXXXXXXX, 8XXXXXXXXXX, 7XXXXXXXXXX)
  • 'order_id' - номер заказа (в Вашей системе учета)
  • 'ob_cennost_rub' - сумма объявленной ценности
  • 'nalogka_rub' - сумма наложенного платежа
[in]hashОбязательный аргумент

Аргументы ответа

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

[out]msgСообщение о выполнении действия в виде массива с ключами.
  • 'type' - тип сообщения (error - ошибка, done - успешно).
  • 'text' - текстовое сообщение.
[out]linkСсылка на PDF файл.

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

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




API. Метод parcel. Отслеживание отправление по коду РПО

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

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

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

[in]apikeyAPI ключ Вашего аккаунта.
[in]methodparcel
[in]rpoИдентификатор отправления (РПО). Обязательный параметр.
[in]from_countryстрана места отправления
[in]from_indexпочтовый индекс места отправления
[in]from_stateобласть/регион
[in]from_cityгород/населенный пункт
[in]from_addrобратный адрес отправителя (улица, дом, квартира/офис)
[in]from_fioФИО или наименование организации отправителя
[in]p_seriyaсерия паспорта
[in]p_nomerномер паспорта
[in]p_vidanдата выдачи (формат: ДД.ММ.ГГГГ)
[in]p_vidalнаименования учреждения выдавшего паспорт
[in]nalogka_ur_lico_cbЗначение 1 или 0. Если 1, тогда заполняются поля для перевода на банковский счет, иначе - нет
[in]from_innИНН получателя (ООО или ИП)
[in]from_bikБИК Банка, в котором открыт счет
[in]from_bankнаименование банка
[in]from_ksкорреспондентский счет
[in]from_rsрасчетный счет
[in]to_countryстрана места получения
[in]to_indexпочтовый индекс получателя
[in]to_stateобласть/регион
[in]to_cityгород/населенный пункт
[in]to_addrадрес получателя (улица, дом, квартира/офис)
[in]to_fioФИО или наименование организации получателя
[in]to_telтелефонный номер получателя (формат: +7XXXXXXXXXX, 8XXXXXXXXXX, 7XXXXXXXXXX)
[in]order_idномер заказа (в Вашей системе учета)
[in]ob_cennost_rubсумма объявленной ценности
[in]nalogka_rubсумма наложенного платежа
[in]rpo_send_smsУведомление по СМС (сервис в разработке). Значения:
  • 'noone' - не уведомлять
  • 'to' - уведомлять только получателя (по номеру телефона to_tel)
  • 'from' - уведомлять только отправителя (по номеру телефона из личного кабинета)
  • 'tofrom' - уведомлять и получателя и отправителя
[in]hashОбязательный аргумент

Аргументы ответа

[out]msgСообщение о выполнении действия в виде массива с ключами.
  • 'type' - тип сообщения (error - ошибка, done - успешно).
  • 'text' - текстовое сообщение.
[out]rpoИдентификатор посылки РПО
[out]status0Текущий статус посылки часть 1
[out]status1Текущий статус посылки часть 2
[out]indexТекущий индекс места обработки
[out]placeНазвание текущего места обработки
[out]dateВремя текущего статуса в формате ДД.ММ.ГГГГ
[out]date_numВремя текущего статуса в формате UNIX TIME STAMP
[out]rpo_status_errorНакапливаемая ошибка обновления. Накапливается в случае, если вы ввели номер которого нет в базе Почты России и через некоторое время отслеживание данного РПО прекращается
[out]rpo_send_smsКому отправляются уведомления по СМС
[out]log_jsonИстория прохождения отправления. Треклист. Массив закодирован в строку JSON и состоит из элементов:
  • 'status0' - Статус посылки часть 1
  • 'status1' - Статус посылки часть 2
  • 'index' - Индекс места обработки
  • 'place' - Название места обработки
  • 'date' - Время статуса в формате ДД.ММ.ГГГГ
  • 'date_num' - Время статуса в формате UNIX TIME STAMP
[out]rpoИдентификатор посылки РПО

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

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




API. Метод print_f103. Печать списка почтовых отправлений ф.103

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

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

[in]apikeyAPI ключ Вашего аккаунта.
[in]methodprint_f103
[in]listМассив данных о почтовых отправлениях закодированный JSON.
  • 'to_country' - страна места получения
  • 'to_index' - почтовый индекс получателя
  • 'to_state' - область/регион
  • 'to_city' - город/населенный пункт
  • 'to_addr' - адрес получателя (улица, дом, квартира/офис)
  • 'to_fio' - ФИО или наименование организации получателя
  • 'ob_cennost_rub' - сумма объявленной ценности
  • 'nalogka_rub' - сумма наложенного платежа
[in]vid_rpoПоле на первой странице бланка: "Вид и категория РПО"
[in]otpravitelПоле на первой странице бланка: "Отправитель"
[in]mesto_priemaПоле на первой странице бланка: "Наименование и индекс места приема"
[in]hashОбязательный аргумент

Аргументы ответа

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

[out]msgСообщение о выполнении действия в виде массива с ключами.
  • 'type' - тип сообщения (error - ошибка, done - успешно).
  • 'text' - текстовое сообщение.
[out]linkСсылка на PDF файл.

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

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

     
01.09.2014 Новый бланк ф.112эп

Новый бланк почтового перевода и наложенного платежа. Если у Вас в отделении не принимают бланк ф.113, печатайте бланк ф.112

     
01.08.2014 Крым и Севастополь

Обновлена база данных по индексам РФ. В том числе добавлена Республика Крым и Севастополь

     
14.01.2014 Новые Тарифы

Всвязи с изменениями в тарифах Почты России, обновлен калькулятор.

     
22.11.2013 API

Реализован API расчета стоимости и контрольного срока пересылки почтового отправления, а также сопроводительных бланков по формам 116, 112, 113 и адресного ярлыка ф.7

     
19.11.2013 ф.103

Доступен к печати список партионных отправлений по форме ф.103

16.10.2013 Новый сервис!

Запущен сервис печати бланков почтовых отправлений. Доступные бланки: ф.7-п, ф.116, ф.113эн

     
18.02.2013 Новые Тарифы

Всвязи с изменениями в тарифах Почты России, обновлен калькулятор.