Почта России. Описание API. Сервиса расчета тарифови контрольных сроков (Версия 2.17)

Информация о документе:

Наименование

документа

Номер версии

2.17

Документ подготовил

Гурская А.В.

Дата создания версии

08.02.2024

Связанные документы:

№

Наименование

Наименование файла

вер.

документа

1.0

РТМ-2

Руководящий технический материал. Коды и атрибуты отправлений и

операций над ними

2.0

РТМ-55

Руководящий технический материал. Структура и формат обмена

данными об объектах почтовой связи

2.0

ISO 4217

Стандарт Международной организации по стандартизации (ISO). Коды

для представления валют и фондов

2.0

ISO 8601

Стандарт Международной организации по стандартизации (ISO).

Форматы дат и времени

2.0

RFC-3986

Спецификация URI

2.10

ISO 639-3

Стандарт Международной организации по стандартизации (ISO).

Названия языков и языковых групп.

Содержание

Введение

Термины и определения

Расчет тарифов и контрольных сроков

1.1. Общее описание

1.2. Формат запроса

1.3. Входные параметры

1.4. Обработка ошибок

1.5. Выходные данные в формате JSON

1.6. Алгоритм получения элементов расчета

Предоставление справочной информации

2.1 Общее описание

2.2 Формат запроса

2.3 Получение данных для категорий объектов расчета

2.3.1 Получение списка категорий объектов расчета

2.3.2 Получение описаний для категорий объектов расчета

2.4 Получение реквизитов объекта расчета

2.5 Получение справочника услуг и идентификаторов элементов расчета

2.6 Получение списка стран доставки

2.7 Получение информации об объекте почтовой связи

Приложение 1. Коды объектов расчета

Приложение 2. Идентификаторы услуг, отметок, разрядов и элементов расчета

Приложение 3. Коды типов упаковки

Приложение 4. Коды магистральных поясов

Приложение 5. Объём перевозимых изданий в месяц

Приложение 6. Вид размещения рекламных материалов

Приложение 7. Вид конверта

Приложение 8. Категория телеграммы

Приложение 9. Доставка на месте вручения телеграммы

Приложение 10. Количество отправлений в месяц

Приложение 11. Расстояние перевозки

Приложение 12. Категория обслуживания

Приложение 13. Коды ошибок

Приложение 14. Виды услуг

Приложение 15. Коды международных продуктов

Введение

В документе описан программный интерфейс сервиса расчета ИС «Тарификатор» и ИС «Контрольные

сроки доставки» (далее - сервис) версии 2.8, приводится перечень входных и выходных данных, коды ошибок.

Также описан программный интерфейс ИС «Сервис предоставления справочной информации».

Сервис предназначен для:

 расчета стоимости оказания почтовых услуг или стоимости пересылки почтовых отправлений;

 расчета контрольных (нормативных) сроков доставки почтовых отправлений;

 контроля допустимых РТМ-2 комбинаций входных параметров для отправлений;

 предоставления различных справочных данных, используемых в расчетах.

Термины и определения

ИС - информационная система.

КС - контрольные (нормативные) сроки доставки.

НП - наложенный платеж.

Объект расчета - услуга или вид почтового отправления, для которых необходимо рассчитать

стоимость пересылки и/или контрольные сроки доставки. Например: «Письмо простое», «Внутрироссийский

перевод». Полный список объектов расчета см. в Приложении 1.

Параметр расчета - параметр, который необходимо указывать в запросе на сервер для получения

конкретного расчета, см. раздел 1.1.

Тариф - ставка оплаты за пересылку почтового отправления или оказания почтовой услуги.

Стоимость услуги- выраженная в деньгах величина - результат умножения количества услуг на их

тариф.

ОПС - отделение почтовой связи.

ОЦ - оценочная стоимость.

ПО - программное обеспечение.

СР - Сервис расчета тарифов и контрольных сроков.

ГИС ПА - геоинформационная система почтовых адресов.

HTTP - протокол прикладного уровня передачи данных, основой которого является технология

«клиент-сервер» (клиентское приложение формирует запрос и отправляет его на сервер, после чего сервер

обрабатывает данный запрос, формирует ответ и передает его обратно клиенту).

HTTPS - расширение протокола HTTP для поддержки шифрования в целях повышения безопасности.

Данные в протоколе HTTPS передаются поверх криптографических протоколов SSL или TLS.

GET - метод HTTP (HTTPS), предназначенный для запроса содержимого ресурса.

REST, REST-запрос - метод взаимодействия компонентов распределенного приложения в сети

Интернет, при котором вызов удаленной процедуры представляет собой обычный HTTP (HTTPS) запрос, а

необходимые данные передаются в качестве параметров запроса.

HTML - стандартный язык разметки документов в сети Интернет. Язык HTML интерпретируется веб-

браузерами; полученный в результате интерпретации форматированный текст отображается на экране.

JSON - универсальный текстовый формат обмена данными, представляющий собой набор пар - ключ:

значение, разделенных запятой.

Расчет тарифов и контрольных сроков

1.1. Общее описание

Сервис расчета представляет собой распределенное клиент-серверное приложение.

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

При получении запроса сервис анализирует входные параметры и производит расчеты. В запросе

можно указать несколько видов расчетов. Для всех видов расчетов используются общие входные параметры.

Если возникает ошибка при анализе входных параметров, происходит отмена всех расчетов. Появление

ошибки при проведении одного вида расчета не влияет на проведение другого вида расчета, указанного в

запросе.

В ответе сервис предоставляет промежуточные и окончательные результаты всех видов расчетов, а

также, при наличии, список возникших ошибок в процессе расчетов. Данные в ответе могут быть представлены

в следующих форматах:

 JSON;

 HTML;

 неформатированный текст.

При использовании сервиса автоматизированными системами необходимо использовать только

формат JSON. По данному формату обеспечивается обратная совместимость в рамках одной и той же версии

API. Описание формата JSON приведено в разделе 1.5.

Форматы HTML и неформатированный текст служат только для восприятия человеком,

совместимость по этим форматам не обеспечивается.

В случае успешного проведения всех видов расчетов, сервис возвращает код ответа из диапазона 200-

299.

Если возникает ошибка при анализе входных параметров, сервис может возвращать код ответа как из

диапазона 400-499, так и из диапазона 200-299 (определяется одним из входных параметров, см. раздел 1.4).

В случае недоступности сервиса или иных причин, не позволяющих сервису выполнять свои функции,

возвращается код ответа из диапазона 500-599.

1.2. Формат запроса

Формат запроса соответствует RFC-3986. Для запроса используется метод GET. Запрос состоит из

префикса протокола «https://», адреса и входных параметров.

Адрес запроса содержит следующие данные в указанном порядке:

 адрес сервиса

 версия API;

 признак расчета;

 указатели на виды расчетов, которые необходимо провести.

В качестве версии API используется строка v2.

В качестве признака расчета используется строка calculate.

В качестве указателей на виды расчетов, которые необходимо провести, используются следующие

значения:

 tariff - признак расчета тарифа за услуги;

 delivery - признак расчета контрольного срока доставки;

 check - признак проверки комбинаций входных значений по РТМ-2.

Порядок указания видов расчета может быть любой.

После адреса запроса указывается символ «?», после которого указываются входные параметры,

требуемые для всех видов расчетов, которые указаны в адресе запроса. Параметры разделены между собой

символом «&». Каждый параметр обозначается его именем. Для большинства параметров после имени

должен быть указан символ «=», после которого должно быть указано его значение.

Состав входных параметров определяется видами производимых расчетов и объектом расчета, также

указанным во входных параметрах.

Примеры запросов (по состоянию на 23.10.2020):

https://tariff.pochta.ru/v2/calculate/tariff?object=2000&weight=20&from=101000&to=190005 - расчет тарифа

доставки простого письма.

https://tariff.pochta.ru/v2/calculate/tariff/delivery?object=2000&weight=20&from=101000&to=190005 - расчет

тарифа и контрольного срока доставки простого письма.

1.3. Входные параметры

Таблица 1.1 Входные параметры

Использование при предмете

Тип

Параметр

Описание

расчета¹

значения

tariff

delivery

text

Строка

Указание на формат данных в ответе.

Опционально. Если не

html

json - ответ в формате JSON (см. п. 1.5);

указано, принимается равным

htmlfull

jsontext - ответ в формате JSON (см. п. 1.5) с

json

переносом строк и отступами;

jsontext

html - ответ в формате html;

htmlfull - вывод результатов в виде полной

страницы html;

text - вывод результатов в виде

неформатированного текста

errorcode

0 или 1

Если указано значение 1, при ошибке расчета

Опционально. Если не

возвращается HTTPS-код ответа в диапазоне

указано, принимается равным

400-499. Иначе - возвращается код 200.

Подробнее см. п. 1.4

object

Целое

Код объекта расчета, см. Приложение 1

Обязательно при отсутствии

число

параметров mailtype, mailctg,

directctrg

mailtype

Целое

Вид отправления, согласно РТМ-2.

Обязательно при отсутствии

число

Используется только для объекта вида

параметра object

«отправление». Если параметр object указан,

то значение параметра mailtype игнорируется

mailctg

Целое

Категория отправления, согласно РТМ-2.

Обязательно при отсутствии

число

Используется только для объекта вида

параметра object

«отправление». Если параметр object указан,

то значение параметра mailctg игнорируется

directctg

Целое

Направление доставки отправления:

Обязательно при отсутствии

число

1 - внутреннее (РТМ-2);

параметра object

2 - исходящее международное (РТМ-2);

3 - входящее международное;

4 - транзитное международное.

Используется только для объекта вида

«отправление». Если параметр object указан,

то значение параметра directctg игнорируется

date

Целое

Дата тарификации и дата расчета

Опционально. Если не

число

контрольных сроков в виде YYYYMMDD, где

указана, принимается

YYYY - год, MM - месяц, DD - день

значение текущей даты

time

Целое

Время начала отсчета контрольных сроков

Нет

Опционально.

число

доставки в виде HHNNSS, где HH - часы, NN -

Если не

минуты, SS - секунды (опционально). Секунды

указано, то

не учитываются.

принимается

Время необходимо указывать местное

равным

230000

closed

0 или 1

Игнорирование запрета доставки на дату

Опционально. Если не

расчета. Указывает на возможность (при 1)

указано, принимается равным

или невозможность (при 0) расчета во

временно закрытый для доставки период или

временно закрытое место приема. Если

closed=0 и на дату расчета закрыта доставка

и/или место приема, выводится сообщение

об ошибке. Если closed=1, расчет

производится в любом случае.

from

Целое

Почтовый индекс места отправления

Обязательно для внутренних

число

(приема)

и исходящих международных

отправлений

Целое

Почтовый индекс места назначения

Обязательно для внутренних

число

(адресования). При возврате индекс должен

и входящих международных

соответствовать тому, который

отправлений

использовался при тарификации в момент

приема.

return

Целое

Почтовый индекс места назначения

Опционально, используется

число

(адресования) возврата

при расчете возвратного

тарифа. Поддерживается не

для всех отправлений.

country-to

Целое

Страна назначения для международных

Обязательно для исходящих

число

исходящих отправлений, код по РТМ-2

международных отправлений

country-from

Целое

Страна приема для международных

Обязательно для входящих

число

входящих отправлений, код по РТМ-2

международных отправлений

region

Целое

Код региона по Конституции РФ для

Обязательно

Нет

число

тарификации услуг. При тарификации

для

отправления параметр игнорируется

региональных

услуг

weight

Целое

Вес отправления. Указывается в граммах

Обязательно

Нет

число

для

отправлений

weightall

Целое

Вес партии отправления. Указывается в

Обязательно

Нет

число

граммах

для

отдельных

продуктов и

услуг

weightpay

Целое

Платный вес. Указывается в граммах

Опционально

Нет

число

sumoc

Целое

Сумма объявленной ценности в копейках

Обязательно

Нет

число

для 2 и 4

категорий

отправления,

см. РТМ-2

sumnp

Целое

Сумма наложенного платежа в копейках.

Обязательно

Нет

число

Используется при тарификации переводов

для 4 (РТМ-

наложенного платежа и отправлений с

2), категории

наложенным платежом.

отправления

при

отсутствии

sumnpc

Дробное

Сумма наложенного платежа в валюте.

Опционально

Нет

число

Используется при тарификации

международных исходящих отправлений с

наложенным платежом. Игнорируется при

наличии sumnp.

sumnpt

Строка

Код валюты наложенного платежа согласно

Обязательно

Нет

ISO 4217. Используется при тарификации

при наличии

международных исходящих отправлений с

sumnpc

наложенным платежом. Игнорируется при

наличии sumnp.

sumgs

Целое

Сумма гарантии отправления в копейках

Опционально

Нет

число

sum

Целое

Сумма в копейках

Обязательно

Нет

число

для

sumin

Целое

Сумма платежа или вложения в копейках

отдельных

число

продуктов и

sum_month

Целое

Объем платежей в месяц в копейках

услуг, см.

число

Приложение 1

month

Целое

Период в месяцах страхования /

число

абонирования ячейки для соответствующих

услуг страхования и абонирования ячейки

size

Строка

Размер отправления в сантиметрах.

Указывается как три целых числа,

разделенные знаком “x”, например,

100x50x25

count

Целое

Количество: штук, слов, материалов, дней

число

или размещений, в зависимости от объекта

расчета, см. Приложение 1

pack

Целое

Код типа упаковки. Возможные значения см.

число

в Приложении 3

countinpack

Целое

Количество отправлений в группе.

число

Значение параметра зависит от объекта

расчета, см. Приложение 1

dogovor

Строка

Договор между корпоративным клиентом и

Обязательно при расчете для

АО «Почта России». Для внутренних и

корпоративных клиентов для

исходящих международных отправлений

внутренних отправлений

строка состоит из ИНН предприятия - 10- или

12-значного с ведущими нулями и номера

Необязательно для отдельных

договора. ИНН и номер разделены дефисом:

продуктов входящих

«-».

международных отправлений

Для входящих международных отправлений

используется только номер договора.

В составе номера договора возможны

символы:

 цифры 0-9

 литеры кириллицы: а«я, А«Я

 латинские литеры: a«z, A«Z

Другие символы допустимы, но игнорируются

при поиске договора; регистр литер не

учитывается при поиске договора

transtype

Целое

Способ доставки² по РТМ-2. Если указано,

Опционально. Если не

число

параметр isavia игнорируется. Параметр

указано, способ доставки для

действует только на продукты, у которых

отдельных продуктов

тарифы и контрольные сроки отличаются для

определяется параметром

разных способов доставки.

isavia.

isavia

Целое

Предпочтительный вариант доставки² для

Опционально. Если не

число

продуктов, имеющих наземную

указано, принимается равным

(неприоритетную) или воздушную

(приоритетную) доставку. Может принимать

следующие значения:

0 - наземная доставка;

1 - предпочтительно воздушная доставка;

2 - строго воздушная доставка

Если указан параметр transtype, параметр

isavia игнорируется.

service

Массив

Указываются модификаторы расчета, т.е.

Опционально. Для различных

целых

коды дополнительных услуг или вариантов

продуктов и услуг действуют

чисел

расчета (см. Приложение 2), которые должны

разные модификаторы. Не

быть разделены запятой.

влияющие на расчет

Если в массиве 2 взаимоисключающие

модификаторы игнорируются

услуги, которые не могут применяться

одновременно, то используется та услуга,

которая указана первой. Например, услуги 9

«Доставка документов» и 10 «Доставка

товаров» - взаимоисключающие. Если в

массиве указано «10, 9», то будет

применяться услуга 10

postmark

Целое

Код суммы отметок внутренних и

Опционально. Для различных

число

международных отправлений, согласно РТМ-

отправлений допустимы

2. Используется только для объекта вида

определенные отметки

«отправление».

(см.РТМ-2)

При наличии параметра, для каждой отметки,

указанной в нем, в параметр service

автоматически добавляется

соответствующий код модификатора

mailrank

Целое

Код разряда почтового отправления,

Опционально. Для различных

число

согласно РТМ-2. Используется только для

отправлений допустимы

объекта вида «отправление».

определенные разряды (см.

При наличии параметра для каждой отметки,

РТМ-2)

указанной в нем, в параметр service

автоматически добавляется

соответствующий код модификатора

client

Целое

Тип клиента. Возможные значения:

Обязательно

Нет

число

1 - физические лица;

для

2 - юридические лица;

отдельных

3 - льготные категории

продуктов и

Целое

Универсальные параметры, используются

услуг, см.

число

для различных объектов расчета. Значения

Приложение 1

зависят от объекта расчета (Приложение 1).

reqid

Строка

Внешний идентификатор запроса.

Опционально

Возможные символы строки:

 цифры 0-9,

 латинские литеры: a«z

 знак подчеркивания

 знак дефиса

Значение параметра передается в ответ, при

этом неподдерживаемые символы

исключаются

group

Целое

Признак тарификации группы отправлений по

Обязательно

Нет

число

общему весу³. Возможные значения:

для

0 - тарификация отдельного отправления;

отдельных

1 - тарификация отправления в составе

продуктов и

группы или емкости;

услуг, см.

2 - тарификация всей группы или емкости;

Приложение 1

3 - тарификация депеш.

export

Целое

Индекс исходящего ММПО

Нет

Опционально.

число

Индекс

входящего

ММПО может

быть

расчетным

или указан в

качестве

отдельного

параметра

«export».

import

Целое

Индекс входящего ММПО

Обязательно

число

для входящих

международн

ых

отправлений

volume

Дробное

Объём

Обязательно

Нет

число

для

duration

Дробное

Длительность

отдельных

число

продуктов и

domestic

Целое

Доместик

услуг

число

date-from

Целое

Дата начала действия

число

date-to

Целое

Дата окончания действия

число

paytype

Целое

Способ платежа. Возможные значения:

число

1 - оплата наличными;

2 - оплата банковской картой.

payer

Целое

Плательщик. Возможные значения:

число

1 - отправитель;

2 - получатель.

int-product

Целое

Международный продукт. Возможные

Обязательно для отдельных

число

значения см. в Приложении 15

продуктов входящих

int-type

Целое

Тип международного тарифа. Возможные

международных отправлений,

число

значения см. в Приложении 16

см. Приложение 1

channel

Целое

Международный канал доставки. Возможные

число

значения см. в Приложении 17

int-client

Целое

Международный клиент. Возможные

число

значения см. в Приложении 18

weightavg

Целое

Средний вес отправления. Указывается в

число

граммах.

weightmax

Целое

Максимальный вес отправления.

число

Указывается в граммах.

sizemax

Целое

Максимальный размер одной из сторон

число

отправления в сантиметрах.

Примечание 1:

При отсутствии значения параметра этот параметр не передается, передавать параметр с пустым

значением недопустимо, это приводит к ошибке анализа входных параметров.

Примечание 2:

Если параметр transtype указан, параметр isavia игнорируется. Если доставка способом, указанном в

transtype, невозможна, выводится сообщение об ошибке, иначе производится расчет тарифа и/или

контрольного срока.

Если параметр transtype не указан и если isavia=0

(или параметр isavia не указан), тариф

рассчитывается следующим образом:

1. Осуществляется попытка рассчитать наземный тариф и/или контрольный срок.

2. Если расчет выполнен успешно, возвращается наземный тариф и/или контрольный срок (при этом в

ответе указывается transtype: 1).

3. В случае неудачи осуществляется попытка рассчитать воздушный тариф и/или контрольный срок.

4. Если расчет выполнен успешно, возвращается воздушный тариф и/или контрольный срок (при этом в

ответе указывается transtype: 2, несмотря на то, что isavia=0). В случае неудачи возвращаются

ошибки, возникшие при расчете наземного тарифа и/или контрольного срока.

Если параметр transtype не указан и если isavia=1:

1. Осуществляется попытка рассчитать воздушный тариф и/или контрольный срок.

2. Если расчет выполнен успешно, возвращается воздушный тариф и/или контрольный срок (при этом в

ответе указывается transtype: 2).

3. В случае неудачи осуществляется попытка рассчитать наземный тариф и/или контрольный срок.

4. Если расчет выполнен успешно, возвращается наземный тариф и/или контрольный срок (при этом в

ответе указывается transtype: 1. В случае неудачи возвращаются ошибки, возникшие при расчете

воздушного тарифа и/или контрольного срока.

Если параметр transtype не указан и если isavia=2, то осуществляется попытка рассчитать

воздушный тариф и/или контрольный срок. В случае неудачи сразу выводится ошибка, без второй попытки

расчета.

В случае комбинированной доставки, вышеуказанные действия выполняются только для той части

маршрута, где нет ограничений. Например, при отправке из Москвы в Лешуконское через Архангельск,

вышеуказанный алгоритм действует только для расчета части маршрута - из Москвы в Архангельск. Другая

часть маршрута, попадающая под ограничения (в данном случае

- из Архангельска в Лешуконское),

тарифицируется независимо от параметра isavia по правилам и тарифам, действующим на местах и

заложенным в ограничение (воздушная часть, наземная часть или их комбинация).

Примечание 3:

Если group=0 (или параметр group не указан), то рассчитываются тариф за доставку по весу

отправления, сбор за ОЦ, тарифы за дополнительные услуги (в т.ч. отметки) и надбавки на единичное

отправление. При этом необходимо передавать вес отправления, сумму ОЦ (если отправления с ОЦ) и

дополнительные услуги/отметки (при их наличии).

Если group=1, то рассчитываются сбор за ОЦ, тарифы за дополнительные услуги (в т.ч. отметки) и

надбавки на отправление. При этом необходимо передавать сумму ОЦ

(если отправления с ОЦ) и

дополнительные услуги/отметки (при их наличии). Также необходимо передавать вес отправления, т.к.

возможно начисление надбавки за тяжеловесное отправление. При этом тариф за доставку не

рассчитывается.

Если group=2, то рассчитываются тариф за доставку группы отправления по общему весу и надбавки

на группу отправлений. При этом необходимо указывать общий вес всей группы. Сбор за ОЦ и дополнительные

услуги/отметки не рассчитываются, сумма ОЦ и дополнительные услуги не обязательны и игнорируются.

1.4. Обработка ошибок

В процессе обработки запроса, анализа входных параметров и проведения расчетов, сервис

использует все возможности для проведения максимально возможных расчетов.

При возникновении ошибок в ответе возвращается их список. При этом, в ответе могут

присутствовать другие параметры, описанные в разделе 1.5. Присутствие в ответе с ошибкой

параметров, для которых в разделе 1.5 указано «обязательно», не гарантируется.

Вид сообщения об ошибках зависит от формата запрашиваемых данных, указанного во

входных параметрах. При ответе в формате JSON список возвращается в параметре errors в виде

массива объектов. Каждый объект содержит одно сообщение об ошибке и параметры, указанные в

Таблице 1.2.

Таблица 1.2 Сообщение об ошибке (элемент массива errors).

Тип

Параметр

Значение

JSON

msg

Строка

Описание ошибки. Обязательно

code

Целое

Код ошибки, см. Приложение 13

число

type

Целое

Тип ошибки. Обязательно для каждой возвращаемой ошибки в массиве.

число

Возможные значения:

0 - внутренняя системная ошибка сервиса;

1 - ошибка, произошедшая при расчете тарифа;

2 - ошибка, произошедшая при расчете контрольного срока;

3 - ошибка, не относящаяся к конкретному расчету (например, неверный формат

входного запроса).

При наличии в массиве хотя бы одной ошибки “type”: 0, сервис возвращает HTTP-код ответа

в диапазоне 500-599.

Иначе, при наличии во входных параметрах errorcode=0, возвращается HTTP-код ответа,

всегда равный 200.

Иначе, при наличии во входных параметрах errorcode=1, возвращается HTTP-код ответа в

диапазоне 400-499.

1.5. Выходные данные в формате JSON

Таблица 1.3. Выходные данные.

Возвращается

Тип

Параметр

Значение

при расчете

JSON

тарифа¹

срока доставки¹

version_api

Целое

Версия API, равно 2.

Обязательно

число

version

Строка

Версия сервиса

Обязательно

caption

Строка

Наименование сервиса

Обязательно

errors

Массив

Массив сообщений об ошибке (Таблица

Обязательно при наличии хотя бы

объектов

1.2)

одной ошибки

Целое

Код объекта расчета

Обязательно

число

name

Строка

Наименование объекта расчета

Обязательно

Возвращается

Тип

Параметр

Значение

при расчете

JSON

тарифа¹

срока доставки¹

date

Целое

Дата расчета в виде YYYYMMDD, где

Обязательно

число

YYYY - год, MM - месяц, DD - день

time

Целое

Время начала отсчета контрольных сроков

Опционально

Обязательно

число

доставки в виде HHNNSS, где HH - часы,

NN - минуты, SS - секунды

mailtype

Целое

Вид отправления, согласно РТМ-2

Обязательно для объекта вида

число

«отправление»

mailctg

Целое

Категория отправления, согласно РТМ-2

Обязательно для объекта вида

число

«отправление»

directctg

Целое

Направление доставки отправления:

Обязательно для объекта вида

число

1 - внутреннее (РТМ-2);

«отправление»

2 - исходящее международное (РТМ-2);

3 - входящее международное;

4 - транзитное международное;

5 - внутреннее возвратное.

date-first

Целое

Дата начала действия тарифа, в виде

Обязательно

Нет

число

YYYYMMDD, где YYYY - год, MM - месяц,

DD - день

date-last

Целое

Дата окончания действия тарифа,

Опционально

Нет

число

включительно, в виде YYYYMMDD, где

YYYY - год, MM - месяц, DD - день. Если

параметр не возвращается, дата

окончания действия не определена

delivery-date-

Целое

Дата начала действия контрольных

Нет

Обязательно

first

число

сроков, в виде YYYYMMDD, где YYYY -

год, MM - месяц, DD - день

delivery-date-

Целое

Дата окончания действия контрольных

Нет

Опционально

last

число

сроков, включительно, в виде

YYYYMMDD, где YYYY - год, MM - месяц,

DD - день. Если параметр не

возвращается, дата окончания действия

не определена

items

Массив

Список составных элементов расчета.

Обязательно

объектов

(Таблица 1.4). Алгоритм идентификации

отдельных элементов расчета описан в

разделе 1.6.

postoffice

Массив

Список почтовых объектов, принимающих

Присутствует, если при расчете

объектов

участие в расчете (Таблица 1.5)

использовались почтовые объекты

transtype

Целое

Способ доставки по РТМ-2, параметр

Обязательно при

Опционально

число

TransType

объекте вида

«отправление»

delivery-to

Целое

Cпособ доставки отправлений, сдаваемых

Опционально

число

интернет-магазинами по РТМ-2, параметр

DeliveryMethod

reqid

Строка

Идентификатор запроса, передаваемый

Обязательно при наличии во входных

во входных параметрах (Таблица 1.1)

параметрах

from

Целое

Почтовый индекс места отправления

Присутствует, если использовался

число

при расчете

Целое

Почтовый индекс места назначения

Присутствует, если использовался

число

при расчете

return

Целое

Почтовый индекс места возврата

Присутствует, если использовался

число

при расчете

country-to

Целое

Страна назначения для международных

Присутствует, если использовался

число

исходящих отправлений, код по РТМ-2

при расчете

country-from

Целое

Страна приема для международных

Присутствует, если использовался

число

входящих отправлений, код по РТМ-2

при расчете

country

Объект

Информация о стране назначения или о

Обязательно для международных

стране приема (Таблица 1.6)

отправлений

Возвращается

Тип

Параметр

Значение

при расчете

JSON

тарифа¹

срока доставки¹

isavia

Объект

Предпочтительный вариант доставки,

Опционально

запрошенный при расчете (Таблица 1.1,

параметр isavia) (Таблица 1.10).

isservice

Массив

Список кодов дополнительных услуг и

Опционально

целых

вариантов расчета. Список, запрошенный

чисел

при расчете (Таблица 1.1, параметр

service) может быть дополнен новыми

рассчитанными кодами.

delivery-

Целое

Вариант расчета контрольного срока

Нет

Опционально

variant

число

ship-day

Целое

Дата отправки с учетом смещения

Нет

Опционально

число

относительно даты приема отправления, в

виде YYYYMMDD, где YYYY - год, MM -

месяц, DD - день

issize

Целое

Признак варианта расчета:

Опционально

Нет

число

0 - по весу;

1 - по габаритам.

isgroup

Целое

Признак возможности тарификации группы

Опционально. При отсутствии

число

отправлений:

параметра принимается isgroup=0.

0 - запрещено;

1 - разрешено.

isdogovor

Целое

Признак использования при расчете

Опционально. При отсутствии

число

индивидуальных справочников договора:

параметра принимается isdogovor

0 - не используются;

=0.

1 - используются.

dogovor

Строка

Договор (Таблица 1.1)

Присутствует, если использовался

при расчете

group

Объект

Признак тарификации группы отправлений

Опционально

(Таблица 1.10)

currency

Строка

Трехзначное обозначение валюты расчета

Обязательно для

Нет

согласно ISO 4217

тарифов, у

которых валюта

расчета отлична

от рубля

packid

Целое

Код упаковки (Приложение 3)

Опционально

Нет

число

weight

Целое

Вес в граммах

Опционально

Нет

число

weightall

Целое

Вес партии в граммах

Опционально

Нет

число

sumoc

Целое

Сумма объявленной ценности в копейках

Обязательно для

Нет

число

2 и 4 категорий

отправления, см.

РТМ-2

sumocsdr

Целое

Сумма объявленной ценности в СПЗ

Обязательно для

Нет

число

2 и 4 категорий

международных

отправлений, см.

РТМ-2

sumnp

Целое

Сумма наложенного платежа в копейках.

Опционально

Нет

число

sumnpc

Дробное

Сумма наложенного платежа в валюте.

Опционально

Нет

число

sumnpt

Строка

Код валюты наложенного платежа

Опционально

Нет

согласно ISO 4217

sumgs

Целое

Сумма гарантии отправления в копейках

Опционально

Нет

число

sum

Целое

Страховая сумма / Сумма перевода в

Опционально

Нет

число

копейках. Указывается для услуг

страхования и денежных переводов

Возвращается

Тип

Параметр

Значение

при расчете

JSON

тарифа¹

срока доставки¹

sumin

Целое

Сумма платежа или вложения в копейках

Опционально

Нет

число

sum_month

Целое

Объем платежей в месяц в копейках

Опционально

Нет

число

month

Целое

Период в месяцах для отдельных услуг

Опционально

Нет

число

size

Объект

Размер отправления в сантиметрах.

Опционально

Нет

Указывается как объект, состоящий из

трех целых чисел (Пример: {«x»:100,

«y»:100, «z»:100})

count

Целое

Количество: штук, слов, материалов или

Опционально

Нет

число

размещений, в зависимости от объекта

расчета (Приложение 1)

countinpack

Целое

Количество отправлений в группе.

Опционально

Нет

число

Значение параметра зависит от объекта

расчета (Приложение 1)

client

Объект

Тип клиента (Таблица 1.10)

Опционально

Нет

region

Объект

Регион (Таблица 1.10)

Опционально

Нет

Объект

Универсальные параметры (Таблица

Опционально

Нет

1.10). Используются для различных

объектов расчета. Значения зависят от

объекта расчета (Приложение 1)

ground

Объект

Итоговая сумма за почтовый сбор

Опционально

Нет

(Таблица 1.7)

avia

Объект

Итоговая сумма за авиасбор (Таблица 1.7)

Опционально

Нет

cover

Объект

Итоговая страховка за объявленную

Опционально

Нет

ценность (Таблица 1.7)

service

Объект

Тариф за дополнительную услугу

Опционально

Нет

(Таблица 1.7)

delivery

Объект

Контрольные сроки доставки (Таблица 1.8)

Нет

Обязательно

pay

Целое

Итоговая сумма платы без НДС в копейках

Обязательно

Нет

число

(в валюте расчета)

nds

Целое

Сумма НДС в копейках (в валюте расчета)

Опционально

Нет

число

paynds

Целое

Итоговая сумма платы с НДС в копейках (в

Обязательно

Нет

число

валюте расчета)

ndsrate

Целое

Ставка НДС в процентах

Опционально

Нет

число

paymark

Целое

Итоговая сумма при оплате почтовыми

Опционально

Нет

число

марками в копейках (всегда кратна рублю)

paysdr

Целое

Итоговая сумма при оплате в СПЗ

Опционально

Нет

число

sdr

Целое

Курс СПЗ

Опционально

Нет

число

paymoney

Целое

Итоговая сумма платы за дополнительные

Опционально

Нет

число

услуги без НДС в копейках (в валюте

расчета)

paymoneynd

Целое

Итоговая сумма платы за дополнительные

Опционально

Нет

число

услуги с НДС в копейках (в валюте

расчета)

volume

Дробное

Объём

Опционально

Нет

число

duration

Дробное

Длительность

Опционально

Нет

число

domestic

Целое

Доместик

Опционально

Нет

число

Возвращается

Тип

Параметр

Значение

при расчете

JSON

тарифа¹

срока доставки¹

date-from

Целое

Дата начала действия

Опционально

Нет

число

date-to

Целое

Дата окончания действия

Опционально

Нет

число

paytype

Целое

Способ платежа. Возможные значения:

Опционально

Нет

число

1 - оплата наличными;

2 - оплата банковской картой.

payer

Целое

Плательщик. Возможные значения:

Опционально

Нет

число

1 - отправитель;

2 - получатель.

int-product

Целое

Международный продукт

Присутствует, если использовался

число

при расчете

int-type

Целое

Тип международного тарифа

число

channel

Целое

Международный канал доставки

число

int-client

Целое

Международный клиент

число

date-begin

Целое

Дата начала предоставления услуги, в

Опционально

Нет

число

виде YYYYMMDD, где YYYY - год, MM -

месяц, DD - день

date-end

Целое

Дата начала окончания предоставления

Опционально

Нет

число

услуги, в виде YYYYMMDD, где YYYY -

год, MM - месяц, DD - день

weightavg

Целое

Средний вес отправления в граммах.

Присутствует,

Нет

число

если

weightmax

Целое

Максимальный вес отправления в

использовался

число

граммах.

при расчете

sizemax

Целое

Максимальный размер одной из сторон

число

отправления в сантиметрах.

cons-mmo

Целое

Признак «ОПС доступно для вручения

Опционально

Нет

число

многоместных отправлений с признаком

консолидации («Только группой»)».

Расчетное значение.

0 - объект не доступен для вручения

многоместных отправлений с признаком

консолидации («Только группой»)

(значение при отсутствии параметра);

1 - объект доступен для вручения

многоместных отправлений с признаком

консолидации («Только группой»)

weightvolume

Целое

Объемный вес

Опционально

Нет

число

weight-vol-

Число

Коэффициент использования объемного

Опционально

Нет

ratio

веса

weightpay

Целое

Платный вес

Опционально

Нет

число

Примечание 1:

При возникновении ошибки расчета (т.е. при наличии параметра errors), обязательность присутствия

выходного параметра с отметкой «Обязательно» не гарантируется.

Таблица 1.4 Элемент расчета (элемент массива items).

Тип

Параметр

Значение

JSON

Строка

Код элемента расчета. Не является постоянной величиной, изменяется со

временем у одного и того же объекта. Обязательно

name

Строка

Наименование элемента расчета. Обязательно

Тип

Параметр

Значение

JSON

from

Целое

Индекс места отправления. Опционально

число

Целое

Индекс места назначения. Опционально

число

serviceon

Массив

Список кодов идентификации элемента расчета. Коды указаны в Приложении 2.

целых

Используется для идентификации элемента расчета (см. Раздел 1.6).

чисел

Обязательно.

serviceoff

Массив

Коды услуг, применение которых отменяет элемент расчета. Коды указаны в

целых

Приложении 2. Опционально

чисел

steps

Массив

Массив дополнительной информации о элементе расчета (Таблица 1.9).

объектов

Опционально

tariff

Объект

Тариф на шаге расчета (Таблица 1.7). Обязательно, если элемент применяется

при расчете тарифа.

delivery

Объект

Контрольные сроки доставки (Таблица 1.8). Обязательно, если элемент

применяется при расчете контрольных сроков. Все внутренние параметры

опциональны.

Таблица 1.5 Почтовый объект (элемент массива postoffice).

Тип

Параметр

Значение

JSON

index

Целое

Почтовый индекс объекта. Обязательно

число

Целое

Назначение объекта в расчете (обязательно при расчете тарифа или контрольного

число

срока):

1 - место приема;

2 - место назначения;

3 - место международного почтового обмена исходящего отправления;

4 - место международного почтового обмена входящего отправления;

5 - место перегрузки;

0 - прочее.

parent

Целое

Индекс вышестоящего объекта. Опционально

число

name

Строка

Наименование объекта. Обязательно

type

Целое

Тип объекта ПС по РТМ-55. Опционально

число

typei

Целое

Тип индекса по РТМ-55. Опционально

число

root

Целое

Индекс филиала. Опционально

число

regionid

Целое

Код региона по Конституции РФ. Обязательно

число

regiono

Целое

Логистический код региона. Опционально

число

areaid

Целое

Код района. Опционально

число

areao

Целое

Логистический код района. Опционально

число

placeid

Целое

Код населенного пункта. Опционально

число

placeo

Целое

Логистический код населенного пункта. Опционально

число

region-main

Целое

Признак нахождения объекта в региональном центре. Опционально

число

area-main

Целое

Признак нахождения объекта в районном центре. Опционально

число

cutoff

Целое

Cut-off объекта в формате HHNNSS, где HH - часы, NN - минуты, SS - секунды.

число

Опционально

hard

Целое

Признак «Труднодоступный» (опционально):

число

0 - не труднодоступный (значение при отсутствии параметра);

1 - труднодоступный

combo

Целое

Признак наличия ограничений по наземной пересылке на дату расчета

число

(опционально):

0 - ограничений нет (значение при отсутствии параметра);

1 - ограничения есть

closed

Целое

Признак наличия ограничения по доставке на дату расчета (опционально):

число

0 - доставка возможна (значение при отсутствии параметра);

1 - доставка запрещена

item-check-

Целое

Признак «Возможность примерки» (опционально):

men

число

0 - возможности нет (значение при отсутствии параметра);

1 - возможности есть

item-check-

Целое

Признак «Возможность проверки вложений» (опционально):

view

число

0 - возможности нет (значение при отсутствии параметра);

1 - возможности есть

item-out-path

Целое

Признак «Частичная выдача» (опционально):

число

0 - частичной выдачи нет (значение при отсутствии параметра);

1 - частичная выдача есть

item-check-

Целое

Признак «Проверка работоспособности» (опционально):

work

число

0 - проверки нет (значение при отсутствии параметра);

1 - проверка есть

move

Целое

Признак «Является доставочным» (опционально):

число

0 - объект не является доставочным (значение при отсутствии параметра);

1 - объект является доставочным

pack-max

Целое

Максимально возможный поддерживаемый размер упаковки (см. Приложение 3).

число

Опционально

pay-card

Целое

Признак «Оплата картой» (опционально):

число

0 - оплата картой невозможна (значение при отсутствии параметра);

1 - возможна оплата картой

pay-money

Целое

Признак «Оплата наличными» (опционально):

число

0 - оплата наличными невозможна (значение при отсутствии параметра);

1 - возможна оплата наличными

aviaport

Массив

Список кодов обслуживающих авиаузлов. Опционально

целых

чисел

partner

Целое

Признак «Партнерский» (опционально):

число

0 - объект не является партнерским (значение при отсутствии параметра);

1 - объект является партнерским

weight-max

Целое

Максимальный вес

число

pvz

Целое

Признак «Пункт выдачи заказов» (ПВЗ) (опционально):

число

0 - объект не является ПВЗ (значение при отсутствии параметра);

1 - объект является ПВЗ

cons-mmo

Целое

Признак «ОПС доступно для вручения многоместных отправлений с признаком

число

консолидации («Только группой»)». Данные из ИСС «Паспорт ОПС».

0 - объект не доступен для вручения многоместных отправлений с признаком

консолидации («Только группой») (значение при отсутствии параметра);

1 - объект доступен для вручения многоместных отправлений с признаком

консолидации («Только группой»)

Таблица 1.6 Информация о стране.

Параметр

Тип JSON

Значение

Примечание

Целое

Код страны по РТМ-2

Обязательно

число

name

Строка

Название страны

Обязательно

letter

Объект

Реквизиты для письменной корреспонденции

Указывается,

parcel

Объект

Реквизиты для посылок

если

ems

Объект

Реквизиты для EMS отправлений

использовалось

для расчета

group

Строка

Группа, которую использует текущий тип отправления.

Указывается

Возможные значения: letter, parcel, ems.

только при

расчете тарифа

Параметр

Тип JSON

Значение

Примечание

altnames

Массив

Альтернативные названия страны

Опционально при

объектов

получении

note

Строка

Дополнительное описание/примечание

информации о

item-stop

Строка

Запрещенные к ввозу предметы

стране (раздел

item-warning

Строка

Условно допущенные к ввозу предметы

2.7).

Объект элемента массива altnames

type

Целое

Тип названия:

Обязательно

число



1 - русскоязычный синоним;

типы 2 и 3,



2 - код страны альфа 2 символа;

опционально



3 - код страны альфа 3 символа;

остальные



4 - название на английском языке;



5 - название на французском языке.

name

Строка

Русскоязычное название

Обязательно

Объекты реквизитов letter, parcel, ems, avia

avia

Объект

Значения реквизитов при авиа-доставке. В объекте

При наличии

присутствуют только те параметры, в которых значения при

отличающихся

авиа-доставке отличаются от значений при наземной

значений

доставке.

block

Целое

Возможность доставки:

Обязательно

число



0 - доставка разрешена



1 - доставка запрещена



19 - доставка временно запрещена по COVID-19

wmax

Целое

Предельная масса в граммах.

Опционально

число

sizemax

Массив

Предельные размеры в сантиметрах.

объектов

linemax

Целое

Длина по наибольшей окружности в сантиметрах.

число

Целое

При 1 разрешены отправления с объявленной ценностью.

число (0/1)

oc-rate

Дробное

Ставка объявленной ценности в %

Опционально

число

oc-note

Строка

Дополнительная информация по объявленной ценности

oc-max

Целое

Максимальная сумма объявленной ценности в копейках

число

oc-max-sdr

Дробное

Максимальная сумма объявленной ценности в СПЗ

число

Целое

При 1 разрешены отправления с наложенным платежом

число (0/1)

np-max

Целое

Максимальная сумма наложенного платежа в копейках

число

np-max-sdr

Дробное

Максимальная сумма наложенного платежа в СПЗ

число

np-currency

Целое

Валюта суммы наложенного платежа по ISO 4217

число

np-blank

Целое

Тип бланка почтового перевода. Возможные значения:

число



1 - 112ЭП,



2 - CN29ter,



3 - МР1бис

return

Целое

При 1 отправление может возвращается оператору подачи.

Выводится, если

число (0/1)

услуга может

crush

Целое

При 1 отправление повреждено

быть в принципе

число (0/1)

оказана в

legal

Целое

При 1 отправление обрабатывается в соответствии с

соответствующей

число (0/1)

законодательством страны доставляющего оператора

группе (для

courier

Целое

При 1 возможна доставка нарочным

letter, parcel,

число (0/1)

ems) или если

notification

Целое

При 1 возможно уведомление о получении

отличается от

число (0/1)

наземной

warning

Целое

При 1 возможна отметка «Хрупкая»

доставки (для

число (0/1)

avia)

Параметр

Тип JSON

Значение

Примечание

bigsize

Целое

При 1 возможна отметка «Громоздкая»

число (0/1)

personally

Целое

При 1 доступно вручение «лично»

число (0/1)

addrcorrect

Целое

При 1 возможно изменение или исправление адреса

число (0/1)

declaration

Целое

Количество таможенных деклараций

Опционально

число

declaration-

Массив

Языки таможенных деклараций. Коды языков по ISO 639-3.

lang

строк

isdogovor

Целое

При 1 возможны индивидуальные тарифы

число (0/1)

Объект элемента массива sizemax

Целое

Опционально

Длина одной из сторон (см)

число

Целое

Опционально

Длина одной из сторон (см)

число

Целое

Опционально

Длина одной из сторон (см)

число

Таблица 1.7 Значение тарифа.

Тип

Параметр

Значение

JSON

val

Целое

Значение тарифа без НДС в копейках. Обязательно.

число

valnds

Целое

Значение тарифа с НДС в копейках. Обязательно.

число

valmark

Целое

Значение тарифа при оплате почтовыми марками. Опционально

число

valsdr

Целое

Значение тарифа при оплате СПЗ. Опционально - для международных

число

отправлений

Таблица 1.8 Значение контрольного срока.

Тип

Параметр

Значение

JSON

min

Целое

Минимальное нормативное количество дней доставки отправления. Обязательно в

число

delivery. Опционально в элементе массива items.delivery.

max

Целое

Максимальное нормативное количество дней доставки отправления. Обязательно

число

в delivery. Опционально в элементе массива items.delivery.

deadline

Строка

Крайний срок доставки отправления в формате ISO 8601. Опционально.

Таблица 1.9 Информация о шаге расчета (элемент массива steps).

Тип

Параметр

Значение

JSON

name

Строка

Информационное сообщение

Таблица 1.10 Значение справочника.

Тип

Параметр

Значение

JSON

Целое

Код значения. Обязательно

число

name

Строка

Название значения. Опционально

1.6. Алгоритм получения элементов расчета

Для получения отдельных частей общего тарифа, необходимо их выделить из общего массива

элементов расчета, используя фиксированные идентификаторы из Приложения 2. Для этого, необходимо

найти все элементы в items (Таблица 1.3), у которых в параметре serviceon (Таблица 1.4) присутствует

требуемый идентификатор, и осуществить суммирование значений в параметрах tariff и/или delivery (Таблица

1.4) найденных элементов.

В запросах для извлечения частей тарифа параметр id элемента не должен использоваться, поскольку

значение этого параметра не фиксировано и и может быть изменено в дальнейшем (при изменениях

алгоритмов расчётов). Коды в serviceon являются фиксированными и неизменными. Значение

поддерживаемых кодов приведено в Приложении 2. Также список поддерживаемых кодов, их привязка к

параметрам РТМ-2 PostMark, MailRank, PayType, ServiceType и другим, можно получить по API (см. Раздел

2.5).

Примеры применения алгоритма:

 для получения полной суммы тарифов необходимо просуммировать значения в параметре tariff для

всех элементов, у которых в serviceon присутствует код 110;

 для получения суммы тарифов за дополнительные услуги необходимо просуммировать значения в

параметре tariff для всех элементов, у которых в serviceon присутствует код 118;

 для получения страхового сбора, необходимо просуммировать значения в параметре tariff для всех

элементов, у которых в serviceon присутствует код 13;

 для получения тарифа за доставку необходимо просуммировать значения в параметре tariff для всех

элементов, у которых в serviceon присутствует код 11;

 для получения тарифа авиаперевозчика

(входит в состав тарифа за доставку) необходимо

просуммировать значения в параметре tariff для всех элементов, у которых в serviceon присутствует

код 122;

 для получения надбавки за негабарит, связанной с негабаритом по размеру и/или весу, необходимо

просуммировать значения в параметре tariff для всех элементов, у которых в serviceon присутствует

код 12;

 для получения надбавки за негабарит, связанной с негабаритом по весу, необходимо просуммировать

значения в параметре tariff для всех элементов, у которых в serviceon присутствует код 124;

 для получения платы за заказ необходимо просуммировать значения в параметре tariff для всех

элементов, у которых в serviceon присутствует код 17;

 для получения контрольных сроков необходимо просуммировать значения в параметре delivery для

всех элементов, у которых в serviceon присутствует код 111.

2. Предоставление справочной информации

2.1

Общее описание

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

В ответе сервис предоставляет различную справочную информацию:

В качестве указателей на виды предоставляемой информации используются следующие значения:

 список категорий объектов расчета;

 реквизиты конкретного объекта расчета;

 список объектов расчета;

 список дополнительных услуг и вариантов расчета;

 список стран;

 справочники параметров.

Данные в ответе могут быть представлены в следующих форматах:

 JSON;

 HTML;

 неформатированный текст.

При использовании сервиса автоматизированными системами необходимо использовать только

формат JSON. По данному формату обеспечивается обратная совместимость в рамках одной и той же версии

API. Описание формата JSON приведено в разделе 2.3.

Форматы HTML и неформатированный текст служат только для восприятия человеком,

совместимость по этим форматам не обеспечивается.

В случае успешного предоставления справочной информации, сервис возвращает код ответа из

диапазона 200-299.

В случае возникновения ошибки при анализе входных параметров, сервис возвращает код ответа из

диапазона 400-499.

В случае недоступности сервиса или иных причин, не позволяющих сервису выполнять свои функции,

возвращается код ответа из диапазона 500-599.

2.2

Формат запроса

Формат запроса соответствует RFC-3986. Для запроса используется метод GET. Запрос состоит из

префикса протокола «https://», адреса и входных параметров.

Адрес запроса содержит следующие данные в указанном порядке:

 адрес сервиса;

 версия API;

 признак предоставления справочной информации;

 вид предоставляемой информации;

 указатели на виды расчетов (для отдельных видов информации).

В качестве версии API используется строка v2.

В качестве признака предоставления справочной информации используется строка dictionary.

В качестве типа справочника используется строка, описанная в следующих подразделах раздела 2.

В качестве указателя на виды расчетов используется значения, указанные в разделе 1.2.

После адреса запроса указывается символ «?», после которого указываются входные параметры,

требуемые для предоставления указанного вида информации. Параметры разделены между собой символом

«&». Каждый параметр обозначается его именем. Для большинства параметров после имени должен быть

указан символ «=», после которого должно быть указано его значение.

Состав входных параметров определяется видом предоставляемой информации. Вид

предоставляемой информации также указан во входных параметрах.

2.3

Получение данных для категорий объектов расчета

2.3.1 Получение списка категорий объектов расчета

URL запроса: /v2/dictionary/category

Таблица 2.1 Входные данные запроса

Параметр

Тип JSON

Значение

json

Строка

Форма ответа. При отсутствии ответ предоставляется в json.

jsontext

text

html

htmlfull

Таблица 2.2 Выходные данные запроса

Параметр

Тип JSON

Значение

Общие параметры

version_api

Целое число

Версия API, равно 2.

version

Строка

Версия сервиса

category

Массив

Список категорий объектов расчета

Массив, описывающий категории объектов расчета (элемент списка категорий)

Целое число

Код категории объекта расчета

name

Строка

Наименование категории объекта расчета

desc

Строка

Описание категории объекта расчета

2.4

Получение реквизитов объекта расчета

URL запроса: /v2/dictionary/object/tariff/delivery?id={код категории}

Таблица 2.5 Входные данные запроса

Параметр

Тип JSON

Значение

Общие параметры

json

Строка

Форма ответа. При отсутствии ответ предоставляется в json.

jsontext

text

html

htmlfull

Целое число

Код категории объекта расчета

date

Дата

Дата получения справочной информации в виде

YYYYMMDD, где YYYY - год, MM - месяц, DD - день.

Если дата не указана, принимается значение текущей даты

Таблица 2.6 Выходные данные запроса

Параметр

Тип JSON

Значение

Общие параметры

version_api

Целое число

Версия API, равно 2.

version

Строка

Версия сервиса

Целое число

Код категории объекта расчета

date

Дата

Дата получения справочной информации

name

Строка

Наименование категории объекта расчета

desc

Строка

Описание категории объекта расчета

productname

Строка

Наименование вариантов объектов в категории

object

Массив

Список объектов расчета

Объект расчета (элемент списка объектов расчета)

Целое число

Код объекта расчета

mailtype

Целое число

Только для отправлений: вид отправления, согласно РТМ-2.

mailctg

Целое число

Только для отправлений: категория отправления, согласно РТМ-2

directctg

Целое число

Только для отправлений: направление доставки:

1 - внутреннее (РТМ-2);

2 - исходящее международное (РТМ-2);

3 - входящее международное;

4 - транзитное международное;

5 - внутреннее возвратное.

name

Строка

Наименование объекта расчета

date-first

Дата

Дата начала действия тарифа

date-last

Дата

Дата окончания действия тарифа. Если дата окончания не известна

(тариф самый последний), то параметр не возвращается.

country-group

Строка

При наличии указывается код группы ограничений страны:

 correspondence - группа для письменной корреспонденции

 parcel - группа для посылок

 ems группа для EMS отпралений

params

Массив

Массив входных параметров для тарификации объекта

transfer

Логический

Признак наличия доставки отправления

Элемент массива params для расчета

Строка

Уникальный идентификатор параметра

name

Строка

Русскоязычное наименование параметра

param

Строка

Имя параметра в URL при запросе расчета тарифа

datatype

Целое число

Тип данных:



1 - целое число;



2 - строка;



3 - вещественное число;



4 - дата;



5 - логический [0,1];



13 - сумма в копейках;



17 - месяц [1..12];



29 - вес в граммах;



33 - индекс;



41 - справочник



52 - массив чисел

min

Целое число

Минимальное значение данных для типов [1,4,13,17,29]

max

Целое число

Максимальное значение данных для типов [1,4,13,17,29]

seq

Целое число

Очередность для пользовательского интерфейса (элементы массива

params расположены согласно этой очередности)

unit

Массив

Массив наименований единиц измерения (именительный, родительный

падеж и множественное число). В массиве может содержаться один

элемент, если это сокращение.

list

Массив или

Список возможных значений. Если параметр list - массив, то элементы

строка

этого массива являются элементами списка значений параметра (см.

описание массива элементов списков).

Если параметр list - строка, то для получения значений списка требуется

отдельный запрос с значением этого параметра. Например, если "list":

"country", то для получения списка требуется отдельно запросить этот

список: https://{имя сервиса}/v2/dictionary/country?date=20200101

Элементы возвращаемого массива являются элементами списка

значений параметра (см. описание массива элементов списков).

Элемент массива list

Целое число

Код элемента справочника

name

Строка

Наименование элемента справочника

Для некоторых списков возможно возвращение дополнительных параметров (см. разделы 2.5, 2.6, 2.7)

2.5

Получение справочника услуг и идентификаторов элементов

расчета

URL запроса: /v2/dictionary/service

Таблица 2.7 Входные данные запроса

Параметр

Тип JSON

Значение

json

Строка

Форма ответа. При отсутствии ответ предоставляется в json.

jsontext

text

html

htmlfull

Список

Возврат услуг по списку кодов (не более 10 элементов, разделены

целых чисел

запятой). При отсутствии параметра производится возврат списка всех

услуг. Значение кодов приведены в Приложении 2.

Таблица 2.8 Выходные данные запроса

Параметр

Тип JSON

Значение

Общие параметры

version_api

Целое число

Версия API, равно 2.

version

Строка

Версия сервиса

Массив

Список запрашиваемых кодов услуг

целых чисел

service

Массив

Список услуг (кодов и наименований)

Элемент массива списка услуг (service)

Целое число

Код услуги

name

Строка

Наименование услуги

code

Целое число

Код отметки по РТМ-2 в виде степени двойки

rank

Целое число

Код разряда отправления по РТМ-2

paytype

Целое число

Код типа платежа по РТМ-2 в виде степени двойки

servicetype

Целое число

Код услуги по РТМ-2 в виде степени двойки

2.6

Получение списка стран доставки

URL запросов:



/v2/dictionary/country



/v2/dictionary/country/[код страны]

Таблица 2.9 Входные данные запроса

Параметр

Тип JSON

Значение

json

Строка

Форма ответа. При отсутствии ответ предоставляется в json.

jsontext

text

html

htmlfull

Список

Возврат стран по списку кодов (не более 10 элементов, разделены

целых

запятой). При отсутствии параметра производится возврат списка всех

чисел

стран. Коды стран соответствуют РТМ-2. При использовании этого

параметра, код страны в запросе /v2/dictionary/country/[код страны]

игнорируется.

date

Дата

Дата получения справочной информации в виде

YYYYMMDD, где YYYY - год, MM - месяц, DD - день.

Если дата не указана, принимается значение текущей даты

Таблица 2.7 Выходные данные запроса

Параметр

Тип JSON

Значение

Примечание

Общие параметры

version_api

Целое число

Версия API, равно 2.

Обязательно

version

Строка

Версия сервиса

Обязательно

date

Дата

Дата получения справочной информации

Обязательно

Массив целых чисел

Список запрашиваемых кодов стран

Опционально

country

Массив объектов

Список стран. Каждый элемент списка

Обязательно

описан в Таблице 1.6.

2.7

Получение информации об объекте почтовой связи

URL запросов:



/v2/dictionary/postoffice



/v2/dictionary/postoffice/[индекс ОПС]

Таблица 2.9 Входные данные запроса

Параметр

Тип JSON

Значение

json

Строка

Форма ответа. При отсутствии ответ предоставляется в json.

jsontext

text

html

htmlfull

Список

Обязательно при отсутствии индекса ОПС в URL запроса. Список

целых

индексов объектов почтовой связи (не более 10 элементов, разделены

чисел

запятой). При использовании этого параметра, индекс ОПС в запросе

/v2/dictionary/postoffice/[индекс ОПС] игнорируется.

date

Дата

Дата получения справочной информации в виде

YYYYMMDD, где YYYY - год, MM - месяц, DD - день.

Если дата не указана, принимается значение текущей даты

Таблица 2.8 Выходные данные запроса

Параметр

Тип JSON

Значение

Примечание

Общие параметры

version_api

Целое число

Версия API, равно 2.

Обязательно

version

Строка

Версия сервиса

Обязательно

date

Дата

Дата получения справочной информации

Обязательно

Массив целых чисел

Список запрашиваемых индексов объектов

Обязательно

почтовой связи

postoffice

Массив объектов

Список почтовых объектов. Каждый

Обязательно

элемент списка описан в Таблице 1.5.

Приложение 1. Коды объектов расчета

Код

Объект расчета

объекта

Входные параметры*

расчета

ВНУТРЕННИЕ ОТПРАВЛЕНИЯ

Письмо

Письмо простое

text / html/ htmlfull / json / jsontext/ easy;

object; weight; date; from; to;

2000

service - для данного объекта расчета доступна услуга

«Межоператорское».

Письмо заказное

text / html / htmlfull / json/ jsontext / easy;

object; weight; date; from; to;

service - для данного объекта расчета доступны услуги:



«Межоператорское»;

2010



«Простое уведомление о вручении» или «Заказное

уведомление о вручении»;



«СМС-уведомление о прибытии в отделение»; «СМС-

уведомление о вручении».

Письмо с объявленной

text / html / htmlfull / json/ jsontext / easy;

2020

ценностью

object; from; to; weight; date; sumoc;

Письмо с объявленной

service - для данных объектов расчета доступны услуги:

ценностью и наложенным



«Межоператорское»;

платежом



«Простое уведомление о вручении» или «Заказное

уведомление о вручении»;

2040



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении»;



«Проверка соответствия вложения описи» или «Составление

описи вложения».

Письмо 1 класса заказное

text / html / htmlfull / json/ jsontext / easy;

15010

object; from; to; weight; date;

Код

Объект расчета

объекта

Входные параметры*

расчета

service - для данного объекта расчета доступны услуги:



«Простое уведомление о вручении» или

«Заказное

уведомление о вручении»;



«СМС-уведомление о прибытии в отделение».

Письмо 1 класса с

text / html / htmlfull / json/ jsontext / easy;

15020

объявленной ценностью

object; from; to; weight; date; sumoc;

Письмо 1 класса с

service - для данных объектов расчета доступны услуги:

объявленной ценностью и



«Простое уведомление о вручении 1 класса» или «Заказное

наложенным платежом

уведомление о вручении 1 класса»;

15040



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении»;



«Проверка соответствия вложения описи» или «Составление

описи вложения».

Письмо простое 2.0

text / html / htmlfull / json/ jsontext / easy;

11000

object; from; to; weight; date.

Внутригородское почтовое

text / html / htmlfull / json/ jsontext / easy;

отправление (ВГПО) 1

46000

object; from; to; weight; date;

класса - простое

dogovor - договор, ИНН или регион.

Внутригородское почтовое

text / html / htmlfull / json/ jsontext / easy;

отправление (ВГПО) 1

46010

object; from; to; weight; date;

класса - заказное

dogovor - договор, ИНН или регион.

Письмо заказное 2.0

text / html / htmlfull / json/ jsontext / easy;

object; from; to; weight; date;

sumgs - сумма гарантии отправления (указывается в коп.);

11010

service - для данного объекта расчета доступны услуги:



«Заверительный пакет»;



«Гарантия сохранности».

Письмо экспресс заказное

32010

text / html / htmlfull / json/ jsontext / easy;

Письмо курьерское

object; from; to; weight; date;

заказное

service - для данных объектов расчета доступны услуги:

33010



«Заверительный пакет»;



«Гарантия сохранности».

Трек-открытка

text / html / htmlfull / json/ jsontext / easy;

36000

object; from; to; date.

Трек-письмо

text / html / htmlfull / json/ jsontext / easy;

37000

object; from; to; weight; date.

Почтовая карточка

Почтовая карточка простая

6000

text / html / htmlfull / json/ jsontext / easy;

object; from; to; date;

service - для данного объекта расчета

доступна услуга «Межоператорское».

Почтовая карточка

6010

text / html / htmlfull / json/ jsontext / easy;

заказная

object; from; to; date;

service - для данного объекта расчета доступны услуги:



«Межоператорское»;



«Простое уведомление о вручении» или

«Заказное

уведомление о вручении»;



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении».

Секограмма

8010

text / html / htmlfull / json/ jsontext / easy;

object; from; to; weight; date;

service - для данного объекта расчета доступны услуги:



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении».

Бандероль

Бандероль простая

text / html / htmlfull / json/ jsontext / easy;

3000

object; from; to; weight; date;

service - для данного объекта расчета

Код

Объект расчета

объекта

Входные параметры*

расчета

доступна услуга «Межоператорское».

Бандероль заказная

text / html / htmlfull / json/ jsontext / easy;

object; from; to; weight; date;

service - для данного объекта расчета доступны услуги:



«Межоператорское»;

3010



«Простое уведомление о вручении» или

«Заказное

уведомление о вручении»;



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении».

Бандероль с объявленной

text / html / htmlfull / json/ jsontext / easy;

3020

ценностью

object; from; to; weight; sumoc; transtype; isavia; date; closed;

Бандероль с объявленной

service - для данных объектов расчета доступны услуги:

ценностью и наложенным



«Межоператорское»;

платежом



«Простое уведомление о вручении» или

«Заказное

уведомление о вручении»;

3040



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении»;



«Проверка соответствия вложения описи» или «Составление

описи вложения».

Бандероль 1 класса

text / html / htmlfull / json/ jsontext / easy;

заказная

object; from; to; weight; date;

service - для данного объекта расчета доступны услуги:

16010



«Простое уведомление о вручении» или

«Заказное

уведомление о вручении»;



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении».

Бандероль 1 класса с

text / html / htmlfull / json/ jsontext / easy;

16020

объявленной ценностью

object; from; to; weight; sumoc; date;

Бандероль 1 класса с

service - для данных объектов расчета доступны услуги:

объявленной ценностью и



«Простое уведомление о вручении» или

«Заказное

наложенным платежом

уведомление о вручении»;

16040



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении»;



«Проверка соответствия вложения описи» или «Составление

описи вложения».

Электронные письма

Электронное простое

text / html / htmlfull / json/ jsontext / easy;

письмо

object; dogovor; date.

303000

service - дополнительные услуги/условия:



«Служебное отправление»;

Электронное заказное

text / html / htmlfull / json/ jsontext / easy;

письмо

object; dogovor; to; date.

303010

service - дополнительные услуги/условия:



«Служебное отправление»;



«Электронное уведомление о вручении»

Международное

text / html / htmlfull / json/ jsontext / easy;

электронное заказное

303011

object; dogovor; date.

письмо

Посылка (частное лицо или предприятие)

Посылка стандарт

text / html / htmlfull / json/ jsontext / easy;

object; from; to; return; weight; date;

pack - упаковка, возможные значения см. в Приложении 3;

service - для данного объекта расчета доступны услуги:

27030



«Пакет SMS уведомлений отправителю при единичном

приеме»;



«Пакет SMS уведомлений получателю при единичном

приеме»;

Код

Объект расчета

объекта

Входные параметры*

расчета



«Пакет SMS уведомлений отправителю при партионном

приеме»;



«Пакет SMS уведомлений получателю при партионном

приеме»

(услуги для партионного и единичного

приема

являются взаимоисключающими).

Посылка стандарт с

Аналогично объекту расчета «Посылка стандарт».

27020

объявленной ценностью

Указывается также параметр sumoc

Посылка стандарт с

объявленной ценностью и

27040

наложенным платежом

Посылка экспресс

29030

Аналогично объекту расчета «Посылка стандарт»

Посылка экспресс с

Аналогично объекту расчета «Посылка стандарт».

объявленной

29020

Указывается также параметр sumoc

ценностью

Посылка экспресс с

объявленной

29040

ценностью и наложенным

платежом

Посылка курьер EMS

28030

Аналогично объекту расчета «Посылка стандарт».

Посылка курьер EMS с

Аналогично объекту расчета «Посылка стандарт».

28020

объявленной ценностью

Указывается также параметр sumoc

Посылка курьер EMS с

объявленной ценностью и

28040

наложенным платежом

Посылка нестандартная

text / html / htmlfull / json/ jsontext / easy;

object; from; to; return; weight; date;

service - для данного объекта расчета доступны услуги:



«Негабарит»;



«Отметка 'Осторожно'»;



«Простое уведомление о вручении»;



«Заказное уведомление о вручении»;



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении»;

4030



«Пакет SMS уведомлений отправителю при единичном

приеме»;



«Пакет SMS уведомлений получателю при единичном

приеме»;



«Пакет SMS уведомлений отправителю при партионном

приеме»;



«Пакет SMS уведомлений получателю при партионном

приеме».

Услуги для единичного и партионного приема являются

взаимоисключающими.

Посылка нестандартная с

Аналогично объекту расчета

«Посылка нестандартная».

4020

объявленной ценностью

Дополнительно указывается параметр sumoc.

Посылка нестандартная с

объявленной ценностью и

4040

наложенным платежом

Посылка нестандартная с

Аналогично объекту расчета

«Посылка нестандартная с

объявленной ценностью и

4060

объявленной ценностью».

обязательным платежом

Посылка 1 класса

text / html / htmlfull / json/ jsontext / easy;

object; from; to; return; weight; date;

service - для данного объекта расчета доступны услуги:

47030



«Простое уведомление о вручении»;



«Заказное уведомление о вручении»;



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении».

Код

Объект расчета

объекта

Входные параметры*

расчета

Посылка 1 класса с

Аналогично объекту расчета «Посылка 1 класса». Дополнительно

47020

объявленной ценностью

указывается параметр sumoc. Доступны следующие услуги:

Посылка 1 класса с



«Простое уведомление о вручении»;

объявленной ценностью и



«Заказное уведомление о вручении»;

наложенным платежом



«СМС-уведомление о прибытии в отделение»;

47040



«СМС-уведомление о вручении»;



«Проверка соответствия вложения описи»;



«Составление описи вложения».

Посылка 1 класса с

Аналогично объекту расчета «Посылка 1 класса с объявленной

объявленной ценностью и

47060

ценностью».

обязательным платежом

Посылка (корпоративный клиент)¹

Посылка онлайн

text / html / htmlfull / json/ jsontext / easy;

обыкновенная

object; from (индекс места отправления выбирается из списка);

to; return; weight; date;

service - для данного объекта расчета доступны услуги:



«Пакет SMS уведомлений отправителю при единичном

приеме»;



«Пакет SMS уведомлений получателю при единичном

23030

приеме»;



«Пакет SMS уведомлений отправителю при партионном

приеме»;



«Пакет SMS уведомлений получателю при партионном

приеме».

Услуги для единичного и партионного приема

взаимоисключающие.

Посылка онлайн с

Аналогично объекту расчета «Посылка онлайн обыкновенная».

23020

объявленной ценностью

Дополнительно указывается параметр sumoc.

Посылка онлайн с

объявленной ценностью и

23040

наложенным платежом

Посылка онлайн с

Аналогично объекту расчета «Посылка онлайн с объявленной

объявленной ценностью и

23060

ценностью»

обязательным платежом

Посылка онлайн

text / html / htmlfull / json/ jsontext / easy;

обыкновенная

object; from (индекс места отправления выбирается из списка);

комбинированная

to; weight; date; group;

service - для данного объекта расчета доступны услуги:



«Пакет SMS уведомлений отправителю при единичном

приеме»;



«Пакет SMS уведомлений получателю при единичном

23080

приеме»;



«Пакет SMS уведомлений отправителю при партионном

приеме»;



«Пакет SMS уведомлений получателю при партионном

приеме».

Услуги для единичного и партионного приема являются

взаимоисключающими.

Посылка онлайн

Аналогично объекту расчета «Посылка онлайн обыкновенная».

комбинированная с

23090

Дополнительно указывается параметр sumoc

объявленной ценностью

Посылка онлайн

комбинированная с

23100

объявленной ценностью и

наложенным платежом

¹ В данную категорию входят также посылки нестандартные: объекты расчета 4030, 4020, 4020, см. категорию

“Посылка (частное лицо или предприятие)”.

Код

Объект расчета

объекта

Входные параметры*

расчета

Посылка “Легкий возврат”

Аналогично объекту расчета «Посылка онлайн обыкновенная».

51030

обыкновенная

Посылка “Легкий возврат” с

Аналогично объекту расчета «Посылка онлайн обыкновенная».

51020

объявленной ценностью

Дополнительно указывается параметр sumoc.

Курьер онлайн

text / html / htmlfull / json/ jsontext / easy;

обыкновенный

object; from; to; return; weight; date; group;

service - для данного объекта расчета доступны услуги:



«Пакет SMS уведомлений отправителю при единичном

приеме»;



«Пакет SMS уведомлений получателю при единичном

приеме»;

24030



«Пакет SMS уведомлений отправителю при партионном

приеме»;



«Пакет SMS уведомлений получателю при партионном

приеме»;



«Проверка комплектности».

Услуги для единичного и партионного приема являются

взаимоисключающими.

Курьер онлайн с

Аналогично объекту расчета «Курьер онлайн обыкновенный».

24020

объявленной ценностью

Дополнительно указывается параметр sumoc.

Курьер онлайн с

объявленной ценностью и

24040

наложенным платежом

Курьер онлайн с

Аналогично объекту расчета

«Курьер онлайн с объявленной

объявленной ценностью и

24060

ценностью»

обязательным платежом

Бизнес курьер

text / html / htmlfull / json/ jsontext / easy;

30030

object; from; to; return; weight; date.

Бизнес курьер с

Аналогично объекту расчета «Бизнес курьер». Дополнительно

30020

объявленной ценностью

указывается параметр sumoc.

Бизнес курьер экспресс

31030

Аналогично объекту расчета «Бизнес курьер».

Бизнес курьер экспресс с

Аналогично объекту расчета «Бизнес курьер». Дополнительно

31020

объявленной ценностью

указывается параметр sumoc.

text / html / htmlfull / json/ jsontext / easy;

КПО-стандарт

39000

object; from; to; date;

weight - вес отправления (грамм).

text / html / htmlfull / json/ jsontext / easy;

object; from; to; date;

weight - вес отправления (грамм);

КПО-эконом

40000

weightall - вес партии (грамм);

size - размер отправления (см). Возможные значения: 1-1000.

Указывается 3 целочисленных значения, разделенные знаком

“x”, например, size=100x50x25;

ЕКОМ обыкновенный

53030

text / html / htmlfull / json/ jsontext / easy;

object; from; to; date;

weight - вес отправления (грамм);

pack - упаковка, возможные значения:



10 - коробка S;



20 - коробка M;



30 - коробка L;



40 - коробка XL;

ЕКОМ с обязательным

53070



99 - нестандартный размер.

платежом

sumin - сумма вложений (коп.);

service - для данного объекта расчета доступны услуги:

 Пакет СМС уведомлений;

 Простая проверка вложения;

 Проверка вложения примеркой;

 Проверка вложения на работоспособность;

 Возврат частичный.

Код

Объект расчета

объекта

Входные параметры*

расчета

text / html / htmlfull / json/ jsontext / easy;

ЕКОМ Маркетплейс с

54020

object; from; to; return; sumoc; date;

объявленной ценностью

weight - вес отправления (грамм).

ЕКОМ Маркетплейс с

объявленной ценностью и

Аналогично объекту расчета «ЕКОМ Маркетплейс с объявленной

обязательным платежом

54060

ценностью»

EMS-отправления

EMS

7030

text / html / htmlfull / json/ jsontext / easy;

object; from; to; return; weight; date;

service - для данного объекта расчета доступны услуги:

 Пакет SMS уведомлений отправителю при единичном приеме;

 Пакет SMS уведомлений получателю при единичном приеме;

 Пакет SMS уведомлений отправителю при партионном

приеме;

 Пакет SMS уведомлений получателю при партионном приеме

(услуги для единичного и партионного приема являются

взаимоисключающими).

EMS с объявленной

Аналогично объекту расчета «EMS». Дополнительно указывается

ценностью

параметр sumoc. Список дополнительных услуг (service) для

данного объекта расчета:



«Страхование от повреждения или утери»;



«Пакет SMS уведомлений отправителю при единичном

приеме»;

7020



«Пакет SMS уведомлений получателю при единичном

приеме»;



«Пакет SMS уведомлений отправителю при партионном

приеме»;



«Пакет SMS уведомлений получателю при партионном

приеме»

(услуги для единичного и партионного приема

являются взаимоисключающими).

EMS с объявленной

Аналогично объекту расчета «EMS». Дополнительно указываются

ценностью и наложенным

параметры sumoc и sumnp.

платежом

Список дополнительных услуг (service) для данного объекта

расчета:



«Оплата наложенного платежа отправителем EMS»;



«Страхование от повреждения или утери»;



«Пакет SMS уведомлений отправителю при единичном

7040

приеме»;



«Пакет SMS уведомлений получателю при единичном

приеме»;



«Пакет SMS уведомлений отправителю при партионном

приеме»;



«Пакет SMS уведомлений получателю при партионном

приеме»

(услуги для единичного и партионного приема

являются взаимоисключающими).

EMS с объявленной

ценностью и обязательным

7060

Аналогично объекту расчета «EMS с объявленной ценностью»

платежом

EMS оптимальное

text / html / htmlfull / json/ jsontext / easy;

object; from; to; weight; date;

service - для данного объекта расчета доступны услуги:



«Наличие договора на оказание услуг почтовой связи»;

34030



«Доставка курьером»;



«Упаковка 'Почта России'»;



«Пакет SMS уведомлений отправителю при единичном

приеме»;

Код

Объект расчета

объекта

Входные параметры*

расчета



«Пакет SMS уведомлений получателю при единичном

приеме»;



«Пакет SMS уведомлений отправителю при партионном

приеме»;



«Пакет SMS уведомлений получателю при партионном

приеме»

(услуги для единичного и партионного приема

являются взаимоисключающими).

EMS оптимальное с

Аналогично

объекту

расчета

«EMS оптимальное».

34020

объявленной ценностью

Дополнительно указывается параметр sumoc.

EMS оптимальное с

объявленной ценностью и

34040

наложенным платежом

EMS оптимальное с

Аналогично объекту расчета «EMS оптимальное с объявленной

объявленной ценностью и

34060

ценностью»

обязательным платежом

Оплата наложенного

text / html / htmlfull / json/ jsontext / easy;

7000

платежа получателем EMS

object; from; to; sumnp; date.

EMS РТ

text / html / htmlfull / json/ jsontext / easy;

41030

object; from; to; return; weight; date; group;

countinpack -количество отправлений в пакете (шт.).

EMS РТ с объявленной

Аналогично объекту расчета «EMS РТ». Дополнительно

41020

ценностью

указывается параметр sumoc.

EMS РТ с объявленной

ценностью и наложенным

41040

платежом

EMS Тендер обыкновенное

text / html / htmlfull / json/ jsontext / easy;

52030

object; from; to; return; weight; date; group;

dogovor - договор, ИНН или регион.

EMS Тендер с

Аналогично объекту расчета

«EMS Тендер обыкновенное».

52020

объявленной ценностью

Дополнительно указывается параметр sumoc.

EMS Тендер с

Аналогично объекту расчета

«EMS Тендер с объявленной

объявленной ценностью и

52060

ценностью»

обязательным платежом

ОВПО

ОВПО письмо простое

19000

text / html / htmlfull / json/ jsontext / easy;

object; from; to; weight; date.

ОВПО письмо заказное

19010

text / html / htmlfull / json/ jsontext / easy;

object; from; to; weight; date;

service - для данного объекта расчета доступны услуги:



«Простое уведомление о вручении» или

«Заказное

уведомление о вручении»;



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении».

ОВПО карточка простая

text / html / htmlfull / json/ jsontext / easy;

22000

object; from; to; weight; date.

ОВПО карточка заказная

text / html / htmlfull / json/ jsontext / easy;

object; from; to; weight; date;

service - для данного объекта расчета доступны услуги:

22010



«Простое уведомление о вручении» или

«Заказное

уведомление о вручении»;



«СМС-уведомление о прибытии в отделение»;



«СМС-уведомление о вручении».

МЕЖДУНАРОДНЫЕ ОТПРАВЛЕНИЯ ИСХОДЯЩИЕ (ЭКСПОРТ)

Письменная корреспонденция

Письмо простое исходящее

text / html / htmlfull / json/ jsontext / easy; transtype;

isavia; object; from; country-to; weight; date;

2001

service - для данного объекта расчета доступны услуги:



«Доставка нарочным»;



«Вручить в собственные руки»;

Код

Объект расчета

объекта

Входные параметры*

расчета



«Заявление о возврате, изменении или исправлении адреса».

Письмо заказное

text / html / htmlfull / json/ jsontext / easy; transtype;

исходящее

isavia; object; from; country-to; weight; date;

service

- для данного объекта расчета доступны услуги

(в

зависимости от страны назначения и указания параметра isavia):

2011



«Доставка нарочным»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении адреса»;



«Международное уведомление о вручении» (услуга действует

только при указанном параметре: isavia =1 или isavia =2).

Письмо с объявленной

text / html / htmlfull / json/ jsontext / easy; transtype;

2021

ценностью исходящее

isavia; object; from; country-to; weight; sumoc; date;

Письмо с объявленной

service

- для данного объекта расчета доступны услуги

(в

ценностью и наложенным

зависимости от страны назначения и указания параметра isavia):

платежом исходящее



«Доставка нарочным»;



«Вручить в собственные руки»;

2041



«Заявление о возврате, изменении или исправлении адреса»;



«Международное уведомление о вручении»,

«Проверка

соответствия вложения описи»,

«Составление описи

вложения»

(услуги действуют только при указанном

параметре: isavia =1 или isavia =2).

Почтовая карточка простая

text / html / htmlfull / json/ jsontext / easy;

исходящая

isavia; object; from; country-to; date;

service - для данного объекта расчета доступны услуги:

6001



«Доставка нарочным»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении адреса».

Почтовая карточка

Аналогично объекту расчета

«Почтовая карточка простая».

заказная исходящая

Дополнительно указывается параметр country-to.

Для данного объекта расчета доступны следующие услуги (в

зависимости от страны назначения и указания параметра isavia):

6011



«Международное уведомление о вручении»;



«Доставка нарочным»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении

адреса».

Секограмма исходящая

text / html / htmlfull / json/ jsontext / easy; transtype;

isavia; object; from; country-to; weight; date;

8011

service

- для данного объекта расчета доступна услуга

«Заявление о возврате, изменении или исправлении адреса».

Бандероль простая

text / html / htmlfull / json/ jsontext / easy; transtype;

исходящая

isavia; object; from; country-to; weight; date;

service - для данного объекта расчета доступны услуги:

3001



«Доставка нарочным»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении адреса».

Бандероль заказная

text / html / htmlfull / json/ jsontext / easy; transtype;

исходящая

isavia; object; from; country-to; weight; date;

service

- для данного объекта расчета доступны услуги

(в

зависимости от страны назначения и указания параметра isavia):

3011



«Международное уведомление о вручении»;



«Доставка нарочным»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении адреса».

СПЗ

text / html / htmlfull / json/ jsontext / easy;

305200

sum - сумма (в копейках) для конвертации в СПЗ; date.

Отправления с товарными вложениями

Посылка обыкновенная

4031

text / html / htmlfull / json/ jsontext / easy; transtype;

исходящая

isavia; object; from; country-to; weight; date;

Код

Объект расчета

объекта

Входные параметры*

расчета

service

- для данного объекта расчета доступны услуги

(в

зависимости от страны назначения и указания параметра isavia):



«Громоздкая посылка»;



«Отметка 'Хрупкая'»;



«Предъявление на таможенный досмотр»;



«Международное уведомление о вручении»;



«Доставка нарочным»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении адреса».

Посылка с объявленной

text / html / htmlfull / json/ jsontext / easy; transtype;

4021

ценностью исходящая

isavia; object; from; country-to; weight; sumoc; date;

Посылка с объявленной

service

- для данного объекта расчета доступны услуги

(в

ценностью и наложенным

зависимости от страны назначения и указания параметра isavia):

платежом исходящая



«Громоздкая посылка»;



«Отметка 'Хрупкая'»;



«Предъявление на таможенный досмотр»;

4041



«Международное уведомление о вручении»;



«Доставка нарочным»;



«Проверка соответствия вложения описи»;



«Составление описи вложения»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении адреса».

EMS обыкновенное

7031

text / html / htmlfull / json/ jsontext / easy;

исходящее

object; weight; from; country-to; date;

service - для данного объекта расчета доступны услуги:



«Доставка товаров»;



«Доставка документов».

Мелкий пакет простой

5001

text / html / htmlfull / json/ jsontext / easy; transtype;

исходящий

isavia; object; from; country-to; weight; date;

service - для данного объекта расчета доступны услуги:



«Предъявление на таможенный досмотр»;



«Доставка нарочным»;



«Вручить в собственные руки».

Мелкий пакет заказной

5011

text / html / htmlfull / json/ jsontext / easy; transtype;

исходящий

isavia; object; from; country-to; weight; date;

service

- для данного объекта расчета доступны услуги

(в

зависимости от страны назначения и указания параметра isavia):



«Предъявление на таможенный досмотр»;



«Международное уведомление о вручении»;



«Доставка нарочным»;



«Вручить в собственные руки».

Мешок М простой

9001

text / html / htmlfull / json/ jsontext / easy; transtype;

исходящий

isavia; object; from; country-to; weight; date;

service - для данного объекта расчета доступны услуги:



«Доставка нарочным»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении адреса».

Мешок М заказной

9011

text / html / htmlfull / json/ jsontext / easy; transtype;

исходящий

isavia; object; from; country-to; weight; date;

service - для данного объекта расчета доступны услуги:



«Международное уведомление о вручении»;



«Доставка нарочным»;



«Вручить в собственные руки»;



«Заявление о возврате, изменении или исправлении адреса».

МЕЖДУНАРОДНЫЕ ОТПРАВЛЕНИЯ ВХОДЯЩИЕ (ИМПОРТ)

Отправления с товарными вложениями

Посылка обыкновенная

4032

text / html / htmlfull / json/ jsontext / easy; transtype;

входящая

weight; date; to - используется всегда;

object или mailtype; mailctg; directctg=3;

Код

Объект расчета

объекта

Входные параметры*

расчета

group (0-единичное отправление, 2-емкость, 3-депеша);

countinpack - используется при тарификации депеш/емкостей;

dogovor; int-product; int-type - если используется тарификация

по номеру договора;

int-product; int-type; channel; int-client; country-from - если

используется тарификация без номера договора;

count, weightavg- если при тарификации используется скидка за

объем;

service- для данного объекта расчета доступны услуги:



«Отметка «Опасный груз»



«Предпочтовая подготовка»



«Доставка и вручение почтальонами мелких пакетов на

дому»



«Штраф за качество доставки»



«Бонус за качество доставки»



«Уточнение данных»



«SMS-информирование»



«Предоставление POD»

Посылка с объявленной

4022

text / html / htmlfull / json/ jsontext / easy; transtype;

ценностью входящая

weight; sumoc; date; to - используется всегда;

Посылка с объявленной

4042

object или mailtype; mailctg; directctg=3;

ценностью и наложенным

group (0-единичное отправление, 2-емкость, 3-депеша);

платежом входящая

countinpack - используется при тарификации депеш/емкостей;

dogovor; int-product; int-type - если используется тарификация

по номеру договора;

int-product; int-type; channel; int-client; country-from - если

используется тарификация без номера договора;

count, weightavg- если при тарификации используется скидка;

service- для данного объекта расчета доступны услуги:



«Отметка «Опасный груз»



«Предпочтовая подготовка»



«Доставка и вручение почтальонами мелких пакетов на

дому»



«Уточнение данных»



«SMS-информирование»



«Предоставление POD»

EMS обыкновенное

7032

text / html / htmlfull / json/ jsontext / easy;

входящее

weight; date; to - используется всегда;

object или mailtype; mailctg; directctg=3;

group (0-единичное отправление, 2-емкость, 3-депеша);

dogovor; int-product; int-type - если используется тарификация

по номеру договора;

int-product; int-type; channel; int-client; country-from - если

используется тарификация без номера договора

count, weightavg- если при тарификации используется скидка за

объем;

service- для данного объекта расчета доступны услуги:



«Отметка «Опасный груз»



«Предпочтовая подготовка»



«Доставка и вручение почтальонами мелких пакетов на

дому»



«Штраф за качество доставки»



«Бонус за качество доставки»



«Уточнение данных»



«SMS-информирование»



«Предоставление POD»

EMS с объявленной

7022

text / html / htmlfull / json/ jsontext / easy;

ценностью входящее

weight; sumoc; date; to - используется всегда;

Код

Объект расчета

объекта

Входные параметры*

расчета

EMS с объявленной

7042

object или mailtype; mailctg; directctg=3;

ценностью и наложенным

group (0-единичное отправление, 2-емкость, 3-депеша);

платежом входящее

dogovor; int-product; int-type - если используется тарификация

по номеру договора;

int-product; int-type; channel; int-client; country-from - если

используется тарификация без номера договора

count, weightavg- если при тарификации используется скидка за

объем;

service- для данного объекта расчета доступны услуги:



«Отметка «Опасный груз»



«Предпочтовая подготовка»



«Доставка и вручение почтальонами мелких пакетов на

дому»



«Уточнение данных»



«SMS-информирование»



«Предоставление POD»

Мелкий пакет простой

5002

text / html / htmlfull / json/ jsontext / easy; transtype;

входящий

int-product; int-type; channel; int-client; country-from; weight;

weight; date; to - используется всегда;

object или mailtype; mailctg; directctg=3;

group (0-единичное отправление, 2-емкость, 3-депеша);

count, weightavg- если при тарификации используется скидка за

объем;

service - для данного объекта расчета доступны услуги:



«Отметка «Опасный груз»



«Доставка и вручение почтальонами мелких пакетов на

дому»



«Предпочтовая подготовка»



«SMS-информирование»



«Штраф за качество доставки»



«Бонус за качество доставки»

Мелкий пакет заказной

5012

text / html / htmlfull / json/ jsontext / easy; transtype;

входящий

weight; date; to - используется всегда;

object или mailtype; mailctg; directctg=3;

group (0-единичное отправление, 2-емкость, 3-депеша);

dogovor; int-product; int-type - если используется тарификация

по номеру договора;

int-product; int-type; channel; int-client; country-from - если

используется тарификация без номера договора;

count, weightavg- если при тарификации используется скидка за

объем;

service- для данного объекта расчета доступны услуги:



«Отметка «Опасный груз»



«Предпочтовая подготовка»



«Доставка и вручение почтальонами мелких пакетов на

дому»



«Штраф за качество доставки»



«Бонус за качество доставки»



«Уточнение данных»



«SMS-информирование»



«Предоставление POD»

ДЕНЕЖНЫЕ ПЕРЕВОДЫ

Почтовый перевод

Внутрироссийский перевод

1000

text / html / htmlfull / json/ jsontext / easy;

object; from; sum - сумма перевода (коп); date;

p1 - вид тарифа (возможные значения: 1 - Корпоративный тариф

1, 2 - Корпоративный тариф 2, 3 - Корпоративный тариф 3)

service - для данного объекта расчета доступны услуги:



«Социальные выплаты»

Код

Объект расчета

объекта

Входные параметры*

расчета



«Доставка почтового перевода на дом»;



«Уведомление о вручении почтового перевода».

Доставка почтового

text / html / htmlfull / json/ jsontext / easy;

перевода на дом

1290

object; from; date;

sum - сумма перевода (коп).

Приём почтового перевода

text / html / htmlfull / json/ jsontext / easy;

на дому

356000

object; region; client; date;

Уведомление о вручении

text / html / htmlfull / json/ jsontext / easy;

почтового перевода в

object; region; client; date;

рамках оказания услуги

357000

"Почтовый перевод

денежных средств"

Форсаж

Форсаж адресный

1010

text / html / htmlfull / json/ jsontext / easy;

Форсаж безадресный

1020

object; date;

sum - сумма перевода (коп);

service - для данного объекта расчета доступна услуга «Доставка

почтового перевода на дом».

Форсаж международный

text / html / htmlfull / json/ jsontext / easy;

1021

object; country-to; date.

sum - сумма перевода (коп).

Доставка перевода Форсаж

text / html / htmlfull / json/ jsontext / easy;

на дом

1300

object; date;

sum - сумма перевода (коп).

Unistream

1051

text / html / htmlfull / json/ jsontext / easy;

object; country-to; date;

sum - сумма перевода (коп).

Дополнительные услуги к переводам

Доставка почтового

1290

text / html / htmlfull / json/ jsontext / easy;

перевода получателю на

object; region; date;

дом

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

Ручное заполнение бланка

329000

text / html / htmlfull / json/ jsontext / easy;

почтового перевода

object; region; date.

денежных средств

client - категория отправителя (возможные значения: 1 -

оператором ОПС

физические лица, 2 - юридические лица).

(ф.112ЭП)

Прием перевода на дому

356000

text / html / htmlfull / json/ jsontext / easy;

object; region; date;

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

Уведомление о вручении

357000

text / html / htmlfull / json/ jsontext / easy;

почтового перевода в

object; region; date.

рамках оказания услуги

client - категория отправителя (возможные значения: 1 -

«Почтовый перевод

физические лица, 2 - юридические лица).

денежных средств»

ДОПОЛНИТЕЛЬНЫЕ УСЛУГИ

Абонирование ячейки

text / html / htmlfull / json/ jsontext / easy;

абонементного почтового

object; to; date;

шкафа в ОПС

client - категория клиента, возможные значения:



1 - физические лица;

312010



2 - юридические лица;



3 - льготные категории граждан (ветераны ВОВ, инвалиды и

пенсионеры).

date_begin - Дата начала предоставления услуги;

date_end - Дата окончания предоставления услуги;

Код

Объект расчета

объекта

Входные параметры*

расчета

service - дополнительные услуги/условия:



«Пролонгация договора»;



«Именная ячейка»;



«Акция».

Абонирование ячейки

text / html / htmlfull / json/ jsontext / easy;

ААПС вне ОПС

object; to; date;

p1 - размер ячейки (возможные значения: 1 - малая ячейка, 2 -

большая ячейка);

312011

date_begin - Дата начала предоставления услуги;

date_end - Дата окончания предоставления услуги;

service - дополнительные услуги/условия:



«Именная ячейка»;



«Вложение РПО через ячейку ААПС».

Марки и ГЗПО

Маркированные почтовые

307110

text / html / htmlfull / json/ jsontext / easy;

конверты

object; date;

p1 - вид конверта, возможные значения см. в Приложении 7.

Маркированные почтовые

307120

text / html / htmlfull / json/ jsontext / easy;

карточки

object; date;

p1 - вид почтовой карточки, возможные значения:



1 - без рисунка «B» 105х148 мм;



2 - художественная «B» 105х148 мм;



3 - художественная «B» с оригинальной маркой 105х148 мм;



4 - художественная «B» 103х195 мм.

Телеграммы

Прием телеграммы

305700

text / html / htmlfull / json/ jsontext / easy;

object; from; country-to; date;

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

p1 - категория телеграммы, возможные значения см. в

Приложении 8.

p3 - доставка на месте вручения телеграммы, возможные

значения см. в Приложении 9.

p2 - бланк в месте вручения, возможные значения:



0 - Без бланка;



1 - Люкс;



2 - Люкс/В;



6 - Делюкс.

сount - количество слов телеграммы;

service - для данного объекта расчета доступны услуги:

 Обыкновенное телеграфное уведомление о вручении;

 Срочное телеграфное уведомление о вручении;

 Подбор текста поздравительной телеграммы;

 Заверительная надпись;

 Написание оператором телеграммы при приеме;

 Отметка вручения к определенной дате.

Запрос на статус доставки

305710

text / html / htmlfull / json/ jsontext / easy;

(Получение подтверждения

object; from; country-to; date;

о вручении телеграммы

client - категория отправителя (возможные значения: 1 -

адресату)

физические лица, 2 - юридические лица).

p1 - категория запроса, возможные значения:



1 - Обыкновенный;



2 - Срочный.

сount - количество слов запроса;

сount-ret - количество слов ответа.

Выдача справки об адресе

305711

text / html / htmlfull / json/ jsontext / easy;

отправителя телеграммы

object; from; country-to; date;

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

Код

Объект расчета

объекта

Входные параметры*

расчета

p1 - категория запроса, возможные значения:



1 - Обыкновенный;



2 - Срочный.

сount - количество слов запроса;

сount-ret - количество слов ответа.

Повторение ранее

305712

text / html / htmlfull / json/ jsontext / easy;

полученной телеграммы

object; from; country-to; date;

(Повторение ранее

client - категория отправителя (возможные значения: 1 -

полученной телеграммы по

физические лица, 2 - юридические лица).

запросу

p1 - категория запроса, возможные значения:

телекоммуникационной



1 - Обыкновенный;

компании);



2 - Срочный.

сount - количество слов запроса;

сount-ret - количество слов ответа.

Аннулирование

305713

text / html / htmlfull / json/ jsontext / easy;

переданной внутренней

object; from; country-to; date;

телеграммы

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

service - для данного объекта расчета доступны услуги:

 Обыкновенное телеграфное уведомление о вручении;

Досылка и доставка

305720

text / html / htmlfull / json/ jsontext / easy;

телеграммы (Досылка и

object; from; date;

доставка телеграммы по

client - категория отправителя (возможные значения: 1 -

другому указанному

физические лица, 2 - юридические лица).

адресатом адресу письмом

p4 - способ доставки, возможные значения:

"почтой заказное")



1 - Письмо;



2 - Телеграф.

сount - количество слов телеграммы.

Доставка телеграммы до

305721

text / html / htmlfull / json/ jsontext / easy;

востребования (Доставка

object; from; date;

телеграммы до

client - категория отправителя (возможные значения: 1 -

востребования по

физические лица, 2 - юридические лица).

указанному адресатом

сount - количество слов телеграммы.

полному адресу)

Хранение телеграммы до

305722

text / html / htmlfull / json/ jsontext / easy;

востребования

object; from; date;

(Сохранение телеграммы

client - категория отправителя (возможные значения: 1 -

до востребования в

физические лица, 2 - юридические лица).

течение 2 месяцев сверх

month - количество месяцев хранения.

установленного срока)

Выдача

305723

text / html / htmlfull / json/ jsontext / easy;

засвидетельствованной

object; from; date;

копии телеграммы (Выдача

client - категория отправителя (возможные значения: 1 -

копии телеграммы,

физические лица, 2 - юридические лица).

засвидетельствованной

сount - количество слов телеграммы.

оператором (в течение 30

countinpack - количество копий телеграммы.

дней));

Регистрация сокращенного

305729

text / html / htmlfull / json/ jsontext / easy;

адреса доставки

object; from; date;

(Регистрация и

client - категория отправителя (возможные значения: 2 -

перерегистрация условного

юридические лица).

или сокращенного адреса

юридического лица для

доставки телеграмм)

Телеграмма «переговор».

305709

text / html / htmlfull / json/ jsontext / easy;

object; from; date;

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

p1 - категория телеграммы, возможные значения:



1 - Обыкновенная;

Код

Объект расчета

объекта

Входные параметры*

расчета



2 - Срочная.

Предпочтовый сервис

Составление списка ф.103

text / html / htmlfull / json/ jsontext / easy;

на партионные почтовые

object; region; date;

отправления за 1 почтовое

p1 - объем, возможные значения:

отправление (строку)



1 - до 500;



2 - от 501 до 2000;

311000



3 - более 5000;



4 - дооформление неполного списка ф. 130 (не зависит от

количества отправлений)



5 - от 2001 до 5000;

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

Наклеивание марок на

text / html / htmlfull / json/ jsontext / easy;

письменную

object; region; date;

корреспонденцию

client - категория отправителя (возможные значения: 1 -

сотрудником ОПС (за 1

физические лица, 2 - юридические лица);

332000

почтовое отправление)

p2 - тип договора, возможные значения:



1 - региональный клиент;



2 - федеральный клиент;



3 - суды.

Конвертование письменной

text / html / htmlfull / json/ jsontext / easy;

корреспонденции при

object; region; date;

партионном приеме (без

client - категория отправителя (возможные значения: 1 -

стоимости конверта)

физические лица, 2 - юридические лица);

333000

p1 - параметр конвертирования, возможные значения:



1 - ручное конвертирование;



2 - автоматизированное конвертирование;



3 - коэффициент последующих листов.

Упаковка письменной

text / html / htmlfull / json/ jsontext / easy;

корреспонденции при

object; region; date;

приеме партионной почты

client - категория отправителя (возможные значения: 2 -

оператором ОПС (за 1

335000

юридические лица).

почтовое отправление без

стоимости упаковочного

материала)

Наклейка стикера

text / html / htmlfull / json/ jsontext / easy;

адресного или с оттиском

object;

ГЗПО при приеме

region; date;

партионной почты

client - категория отправителя (возможные значения: 2 -

оператором ОПС на 1

юридические лица);

почтовое отправление

p1 - объем, возможные значения:

(кроме посылок)



1 - до 1000;

338000



2 - до 10 000;



3 - до 100 000;



4 - более 100 000;

p2 - тип договора, возможные значения:



1 - региональный клиент;



2 - федеральный клиент;



3 - суды.

Расфальцовка

354000

text / html / htmlfull / json/ jsontext / easy;

Фальцовка

object; region; date;

355000

client - категория отправителя (возможные значения: 2 -

юридические лица).

Комплексный сервис 3-в-1

text / html / htmlfull / json/ jsontext / easy;

object; region; date;

369000

client - категория отправителя (возможные значения: 2 -

юридические лица);

p1 - категория, возможные значения см. в Приложении 12.

Код

Объект расчета

объекта

Входные параметры*

расчета

РЕКЛАМНАЯ ДЕЯТЕЛЬНОСТЬ

Внутренние адресные рекламные рассылки

Директ-мейл Стандарт

text / html / htmlfull / json/ jsontext / easy;

object; date;

countinpack - количество отправлений в пакете.

weight - вес одного отправления (грамм);

25000

service - дополнительные услуги/условия: «Отчёт о

недоставленных отправлениях».

Директ-мейл Региональный

text / html / htmlfull / json/ jsontext / easy;

object; region; date;

25020

weight - вес одного отправления (грамм);

service - дополнительные услуги/условия: «Формирование

упаковок с отправлениями».

Директ-мейл B2B

text / html / htmlfull / json/ jsontext / easy;

object; date;

countinpack - количество отправлений в пакете;

25030

weight - вес одного отправления (грамм);

p1 - количество отправлений в месяц, возможные значения см. в

Приложении 10.

Директ-мейл плюс

text / html / htmlfull / json/ jsontext / easy;

object; date;

countinpack - количество отправлений в пакете;

25040

weight - вес одного отправления (грамм);

service - дополнительные услуги/условия: «Отчёт о

недоставленных отправлениях», «Вручение в ОПС».

Предпочтовая подготовка

text / html / htmlfull / json/ jsontext / easy;

Директ-мейл

object; region; date;

countinpack - количество отправлений в пакете (шт.);

service - дополнительные услуги/условия:

25290



«Отчёт о недоставленных отправлениях»;



«Нанесение ШК»;



«Упаковка вложений»;



«Нанесение стикера».

Перевозка и сдача Директ-

text / html / htmlfull / json/ jsontext / easy;

мейл

25280

object; region; date;

weight - вес партии отправлений (кг).

Возврат отправлений

text / html / htmlfull / json/ jsontext / easy;

Директ-мейл

25900

object; date;

weight - вес одного отправления (грамм).

Безадресное

text / html / htmlfull / json/ jsontext / easy;

распространение

object; from; date;

рекламно-

301000

p1 - вид материала, возможные значения:

информационных



5 - листовка формата A5 и меньше;

материалов



4 - листовка формата A4 и до A5;



3 - листовка формата A3 и до A4;

Код

Объект расчета

объекта

Входные параметры*

расчета



1 - печатные материалы.

p2 - условия заказчика, возможные значения:



2 - без условий заказчика;



1 - по условиям заказчика;

weight - вес одного экземпляра (грамм);

count - количество материалов (шт.);

Выдача рекламно-

text / html / htmlfull / json/ jsontext / easy;

информационных

object; from; date;

материалов в ОПС

301100

weight - вес экземпляра (грамм);

count - количество слов (шт.);

countinpack - объем в месяц (шт.);

Размещение рекламы

Размещение рекламы в

text / html / htmlfull / json/ jsontext / easy;

301120

журнале «Почта России»

object; date;

Размещение рекламы в

p1 - вид размещения, возможные значения см. в Приложении 6;

301130

газете «Почтовые вести»

count - количество размещений (шт.).

Электронные рассылки

Email рассылка

text / html / htmlfull / json/ jsontext / easy;

301200

object; date;

SMS рассылка

text / html / htmlfull / json/ jsontext / easy;

301210

object; date;

count - количество символов в сообщении (шт.).

ПЕРИОДИЧЕСКИЕ ПЕЧАТНЫЕ ИЗДАНИЯ

Прием заказов на подписку

text / html / htmlfull / json/ jsontext / easy;

и доставку

object; region; date;

p1 - вид доставки, возможные значения:



1 - по карточной системе на дом;



2 - по карточной системе до востребования;

304150



3 - по карточной системе до а/я;



4 - по адресной системе.

p2 - выходов в полугодие, возможные значения:



1 - менее 110 экземпляров;



2 - 110 экземпляров и более.

weight - вес экземпляра (грамм).

Региональная перевозка

text / html / htmlfull / json/ jsontext / easy;

ППИ

object; region; date;

client - категория отправителя (возможные значения: 2 -

100843

юридические лица);

p2 - расстояние перевозки, возможные значения см. в

Приложении 11.

Переадресация подписки

text / html / htmlfull / json/ jsontext / easy;

304160

по инициативе подписчика

object; region; date.

Аннулирование подписки

304170

по инициативе подписчика

Доставка, сортировка, хранение

Хранение газетных пачек

text / html / htmlfull / json/ jsontext / easy;

за 1 газетную пачку. В

object; region; date;

343000

ОПС, начиная с первого

client - категория отправителя (возможные значения: 2 -

дня хранения

юридические лица).

Погрузка и разгрузка

375000

газетных пачек

СПЕЦИАЛЬНЫЕ ПРОДУКТЫ И УСЛУГИ

Услуги к отправлениям

Курьерский сбор

text / html / htmlfull / json/ jsontext / easy;

305000

object; date;

countinpack - количество отправлений, шт.

SMS-уведомление о

text / html / htmlfull / json/ jsontext / easy;

316000

поступлении внутреннего

object; region; date;

Код

Объект расчета

объекта

Входные параметры*

расчета

РПО в ОПС / о вручении

client - категория отправителя (возможные значения: 1 -

внутреннего РПО адресату

физические лица, 2 - юридические лица).

Оформление

text / html / htmlfull / json/ jsontext / easy;

переадресации письменной

object; region; date;

корреспонденции по

client - категория отправителя (возможные значения: 1 -

другому адресу и другому

377000

физические лица, 2 - юридические лица).

лицу/по тому же адресу и

другому лицу (по

заявлению/ распоряжению)

Предоставление

text / html / htmlfull / json/ jsontext / easy;

документов,

object; region; date;

подтверждающих выплаты

client - категория отправителя (возможные значения: 1 -

за указанный период

физические лица, 2 - юридические лица);

383000

p1 - период, возможные значения:



1 - 1 месяц;



2 - квартал;



3 - полгода;



4 - год.

Хранение и получение в

text / html / htmlfull / json/ jsontext / easy;

ОПС почтовых

object; region; date;

отправлений и ППИ (в

405000

client - категория отправителя (возможные значения: 1 -

соответствии с заявлением

физические лица, 2 - юридические лица).

/распоряжением)

Прием на хранение

text / html / htmlfull / json/ jsontext / easy;

долгосрочных

object; region; date;

доверенностей

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица);

100813

p1 - тариф на 1 доверенность, возможные значения:



1 - в течении 1 месяца;



2 - в течении 3 месяцев;



3 - в течении 6 месяцев;



4 - в течении 12 месяцев.

Прием обязательного

text / html / htmlfull / json/ jsontext / easy;

платежа

object; region; date;

sumin - Сумма платежа (руб.);

305010

paytype - Способ платежа, возможные значения:



1 - наличные;



2 - банковская карта.

Доставка от отправителя в

text / html / htmlfull / json/ jsontext / easy;

ОПС

object; p1; weight; date;

p1- код доставщика, возможные значения:

305300



1- Почтальон;



2- Гиперкурьер;



3- Водитель-курьер;



4- Курьер-партнер.

Доставка получателю из

text / html / htmlfull / json/ jsontext / easy;

ОПС

object; p1; weight; date;

p1- код доставщика, возможные значения:

305305



1- Почтальон;



2- Гиперкурьер;



3- Водитель-курьер;

4- Курьер-партнер.

Услуги для населения

Вручение регистрируемой

text / html / htmlfull / json/ jsontext / easy;

письменной

object; region; date;

корреспонденции с

314000

client - категория отправителя (возможные значения: 2 -

контролируемым ответом

юридические лица).

оператором ОПC

Нанесение адреса на

text / html / htmlfull / json/ jsontext / easy;

325000

письменной

object; region; date;

Код

Объект расчета

объекта

Входные параметры*

расчета

корреспонденции при

client - категория отправителя (возможные значения: 2 -

приеме партионной почты

юридические лица).

оператором ОПС (за 1

почтовое отправление)

Прием платежа по месту

text / html / htmlfull / json/ jsontext / easy;

расположения

object; region; date;

(проживания) клиента с

client - категория отправителя (возможные значения: 1 -

350000

применением переносного

физические лица, 2 - юридические лица);

кассового терминала (за

один принятый платеж)

Информационно-

text / html / htmlfull / json/ jsontext / easy;

техническая поддержка

object; region; date;

372000

онлайн платежей в

client - категория отправителя (возможные значения: 1 -

бюджетной системе РФ

физические лица).

Оформление возврата

text / html / htmlfull / json/ jsontext / easy;

неврученной письменной

object; region; date;

корреспонденции до

378000

client - категория отправителя (возможные значения: 1 -

истечения срока

физические лица, 2 - юридические лица).

хранения/вручения

Выдача невостребованного

text / html / htmlfull / json/ jsontext / easy;

почтового отправления по

object; region; date;

384000

заявлению (распоряжению)

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

Ксерокопирование за 1

text / html / htmlfull / json/ jsontext / easy;

страницу формата "АХ"

object; region; date;

p1 - вид ксерокопирования, возможные значения:



1 - собственное;



2 - агентское;

p2 - тип печати, возможные значения:



1 - односторонняя;

404000



2 - двухсторонняя;



3 - автоматическая;

p3 - формат страниц, возможные значения:



3 - А3;



4 - А4;

client - категория отправителя (возможные значения: 1 -

физические лица, 2 - юридические лица).

Прием миграционного

text / html / htmlfull / json/ jsontext / easy;

302000

уведомления о прибытии

object; date.

Прием миграционного

302010

уведомления о проживании

Проверка миграционного

уведомления о трудовой

302020

деятельности

Уведомление о двойном

302030

гражданстве

Прием миграционного

text / html / htmlfull / json/ jsontext / easy;

302040

уведомления об убытии

object; date.

Оформление бланков к

text / html / htmlfull / json/ jsontext / easy;

письменной

object; region; date;

корреспонденции, включая

331000

client - категория отправителя (возможные значения: 2 -

бланки уведомлений о

юридические лица).

вручении (за 1 бланк)

Услуги для организаций

Бокс-сервис: выезды по

text / html / htmlfull / json/ jsontext / easy;

графику

348001

object; from; date.

count - количество выездов в неделю (шт.).

Бокс-сервис: выезды в

text / html / htmlfull / json/ jsontext / easy;

дополнительное ОПС

348002

object; from; date.

count - количество выездов в неделю (шт.);

Код

Объект расчета

объекта

Входные параметры*

расчета

countinpack - количество дополнительных ОПС (шт.).

Бокс-сервис: разовые

text / html / htmlfull / json/ jsontext / easy;

выезды

object; from; date.

count - количество дополнительных выездов (шт.);

348003

p1 - тип выезда, возможные значения:



1 - без графика с односторонним обменом;



2 - без графика с двухсторонним обменом;



9 - сверх графика;

Бокс-сервис: единичный

text / html / htmlfull / json/ jsontext / easy;

перевес

348004

object; from; date.

weight - перевес (грамм).

Проведение опроса в

text / html / htmlfull / json/ jsontext / easy;

электронном виде

object; region; date.

305210

countinpack - количество вопросов (шт.);

count - количество опрашиваемых (шт.);

Проведение опроса в

text / html / htmlfull / json/ jsontext / easy;

бумажном виде

object; region; date.

305220

countinpack - количество вопросов (шт.);

count - количество опрашиваемых (шт.);

Автоматизированная

text / html / htmlfull / json/ jsontext / easy;

верификация данных

305601

object; from; date.

count - количество адресов (шт.).

Верификация данных на

text / html / htmlfull / json/ jsontext / easy;

местности

object; from; date.

305602

count - количество адресов (шт.).

service

- дополнительные услуги/условия:

«Расширенная

верификация адреса».

Оцифровка

Сканирование отправлений

text / html / htmlfull / json/ jsontext / easy;

object; from; date.

count - количество страниц (шт.).

p1 - способ сканирования, возможные значения:

305401



1 - ручное на проекционном сканере;



2 - автоматическое на поточном сканере;

p2 - вид сканирования, возможные значения:



1 - первичное сканирование;



2 - повторное сканирование;

Оцифровка отправлений

text / html / htmlfull / json/ jsontext / easy;

object; from; date.

p1 - способ сканирования, возможные значения:



2 - письмо;

305402



3 - бандероль;



6 - почтовая карточка;



15 - письмо 1 класса;



16 - бандероль 1 класса;

Передача документа

text / html / htmlfull / json/ jsontext / easy;

object; from; date.

305403

p1 - способ сканирования, возможные значения:



1 - ручное внесение в СЭД;

Временное хранение

text / html / htmlfull / json/ jsontext / easy;

документа

object; from; date.

month - количество месяцев хранения (месяц).

305404

p1 - способ сканирования, возможные значения:



1 - электронное хранение;



2 - физическое хранение.

Утилизация документов

text / html / htmlfull / json/ jsontext / easy;

305405

object; from; date.

count - количество листов (шт.).

Сканирование для

text / html / htmlfull / json/ jsontext / easy;

305406

физических лиц в ОПС

object; from; date.

Код

Объект расчета

объекта

Входные параметры*

расчета

client - категория отправителя (возможные значения:1 -

физические лица).

count - количество листов (шт.).

p1 - формат листа, возможные значения:



4 - А4;

Печать для физических лиц

text / html / htmlfull / json/ jsontext / easy;

в ОПС

object; from; date.

client - категория отправителя (возможные значения:1 -

физические лица).

305407

count - количество листов (шт.).

p1 - формат листа, возможные значения:



4 - А4;

p2 - тип печати, возможные значения:



1 - одностороняя;

Франкировальные машины

Франкирование

text / html / htmlfull / json/ jsontext / easy;

письменной

object; region; date;

корреспонденции с

p1 - объем, возможные значения:

нанесением оттиска ГЗПО



1 - до 1000;

на 1 почтовое отправление



2 - до 10 000;

или стикер



3 - до 100 000;

337000



4 - от 100 000;

p2 - тип договора, возможные значения:



1 - региональный клиент;



2 - федеральный клиент;



3 - суды;

client - категория отправителя (возможные значения: 2 -

юридические лица).

Счета/извещения

Доставка

text / html / htmlfull / json/ jsontext / easy;

неконвертованных

object; from; dogovor, date;

счетов/извещений

305100

peoplecnt - численность населения (чел.).

countinpack - количество счетов для одного получателя (шт.).

count - количество получателей (чел.).

Доставка

text / html / htmlfull / json/ jsontext / easy;

железнодорожным

object; date;

305110

транспортом емкостей со

p1 - магистральный пояс, возможные значения см. в

счетами/ извещениями

Приложении 4.

Доставка авиатранспортом

емкостей со

305120

счетами/извещениями

Услуги экспедирования

Экспедирование CargoXL

text / html / htmlfull / json/ jsontext / easy;

object; dogovor; from; to; sumoc; date;

weight - вес груза;

delivery-from

- тип места отправления

(может принимать

значение: 3 - От двери; 5 - От терминала);

delivery-to - тип места назначения (может принимать значение: 3

- До двери; 5 - До терминала);

volume - объём груза;

306120

service - дополнительные услуги/условия:

 «Страхование отправления»;

 «Возврат сопроводительных документов»;

 «СМС-уведомление о передачи отправления курьеру для

доставки»;

 «Доставка в согласованное время»;

 «Проверка комплектности»;

 «Обрешетка груза».

Услуга при экспедировании

text / html / htmlfull / json/ jsontext / easy;

306190

CargoXL

object; dogovor; weight; date;

Код

Объект расчета

объекта

Входные параметры*

расчета

p1 - вид услуги, возможные значения см. в Приложении 14.

count - Количество (шт.).

Экспедирование FTL

text / html / htmlfull / json/ jsontext / easy;

object; dogovor; from; to; date;

p1 - тип транспорта, возможные значения:

 1 - Автомобиль 9м3, 1.5т;

 2 - Автомобиль 16м3, 3т;

 3 - Автомобиль 45м3, 10т;

 4 - Автомобиль 82м3, 20т.

p2 - тип кузова, возможные значения:

 1 - Тентованный;

 2 - Изотермический;

 3 - Рефрижератор.

306140

count - длительность (час);

- количество дополнительных остановок,

возможные

значения:

 0 - нет;

 1;

 2;

 3;

 4;

 5;

 6;

service - дополнительные услуги/условия:

 «Погрузочно-разгрузочные работы»

Крупногабаритное отправление

КПО-стандарт

text / html / htmlfull / json/ jsontext / easy;

object; dogovor; from; to; date;

weight - вес (грамм);

39030

weightall - вес партии (грамм);

service - дополнительные услуги/условия:



«Предпочтовая подготовка».

КПО-эконом

text / html / htmlfull / json/ jsontext / easy;

object; dogovor; from; to; date;

weight - вес (грамм);

40030

weightall - вес партии (грамм);

size - размер (см).

service - дополнительные услуги/условия:

«Предпочтовая подготовка».

_________________

* Описание входных параметров см. в разделе 1.2. Входные данные. В данной колонке:

 приводится список всех входных параметров для объекта расчета;

 приводится описание дополнительных входных параметров, которые не включены в список основных

входных параметров в разделе 1.2. Входные данные (дополнительные параметры используются только

для данного объекта расчета или для некоторых объектов).

Приложение 2. Идентификаторы услуг, отметок, разрядов и элементов

расчета.

ККод

РТМ-2

Наименование услуги или

Разряд

Отметка

Оплата

Сервис

элемента

MailRank

PostMark

PayType

ServiceType

Простое уведомление о вручении

Заказное уведомление о вручении

Отметка «Осторожно/Хрупкая»

Отметка «Опасный груз»

Громоздкая посылка

Доставка нарочным

Вручение лично в руки

Доставка документов

Доставка товаров

Доставка

Нестандартный размер (негабарит)

Плата за ОЦ

Страхование отправления

Доставка в труднодоступное ОПС

Прием в труднодоступном ОПС

Плата за заказ

Отметка '18+'

Оплата получателем

SMS-уведомление о прибытии в отделение

SMS-уведомление о вручении

Проверка соответствия вложения описи

Составление описи вложения

Оплата наложенного платежа

отправителем

Таможенный сбор

Доставка курьером

Упаковка «Почта России»

Корпоративный клиент «Почта России»

Доставка почтового перевода на дом

Уведомление о вручении почтового

перевода

Заверительный пакет

Гарантия сохранности

Отчёт о недоставленных отправлениях

Нанесение ШК

Упаковка вложений

Нанесение стикера

Перевозка и сдача

Проверка комплектности

Заявление о возврате, изменении или

исправлении адреса

Доставка в населённый пункт, не имеющий

телеграфной и факсимильной связи

Пакет SMS уведомлений отправителю при

единичном приеме

Пакет SMS уведомлений получателю при

единичном приеме

Пакет SMS уведомлений отправителю при

партионном приеме

Пакет SMS уведомлений получателю при

партионном приеме

Пролонгация договора (например, для

услуг абонирования ячейки)

Оплата в момент доставки (COD)

Наклеивание марок

ККод

РТМ-2

Наименование услуги или

Разряд

Отметка

Оплата

Сервис

элемента

MailRank

PostMark

PayType

ServiceType

Административное

Выборное

Возвратный тариф

Правительственное

Воинское

Служебное

Судебное

Президентское

Кредитное

Межоператорское

Вручение в ОПС

Предпочтовая подготовка

Агентские функции третьим лицам

Доставка по звонку

Электронное уведомление о вручении

Обслуживание консолидаторов

Пакет SMS-сервис

Курьерский сбор

Возврат сопроводительных документов

Выдача через АПС

Доставка и вручение почтальонами мелких

пакетов на дому

Забор возврата курьером по адресу

получателя

Наличие индивидуального договора с

предприятием почтовой связи

СМС-уведомление об истечении срока

хранения

СМС-уведомление о продлении срока

хранения

СМС-уведомление об истечении второго

срока хранения

СМС-уведомление о возврате отправления

СМС-уведомление о поступлении

отправления в курьерскую службу

СМС-уведомление о передачи отправления

курьеру для доставки

СМС-уведомление о неудачной попытке

доставки отправления адресату

СМС-уведомление о второй неудачной

попытке доставки отправления адресату

Надбавка за стоимость вложения

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

Простая проверка вложения

Проверка вложения примеркой

Проверка вложения на работоспособность

Доставка в согласованное время

Возврат после проверки полный

Возврат после проверки частичный

Возврат ранее полученного товара

Предоплаченное

Предзаполненное

Продление срока хранения

Переадресация

Прием на территории отправителя

Доставка возврата отправителю

Виджет пунктов выдачи

Бесплатное хранение до 7 дней

ККод

РТМ-2

Наименование услуги или

Разряд

Отметка

Оплата

Сервис

элемента

MailRank

PostMark

PayType

ServiceType

Время работы ПВЗ и почтаматов в

вечернее время

Доставка до ОПС и партнерских ПВЗ и

почтаматов

Доставка и выдача в выходные дни

Погрузка/разгрузка отправлений при сборе

со склада

Получение информации о движении

100

отправления в реальном времени

Уведомление отправителя

101

Управление доставкой

102

Идентификация получателя по ПИН-коду

103

Прием через мобильное приложение

104

Упрощенный прием

105

Тарификация

110

Расчет контрольных сроков

111

Проверка входных параметров

112

Признак «Дополнительная услуга»

118

Надбавка за место вручения

120

Перегрузка

121

Тариф авиаперевозчика

122

Почтовый сбор

123

Надбавка за перевес

124

Комбинированная доставка

125

Нормативный срок доставки внутри страны

130

Нормативный срок доставки

131

международной части

Срок с учетом расписания работы

132

Штраф за качество доставки

133

Бонус за качество доставки

134

Без вскрытия

135

Алкогольная продукция

136

Именная ячейка

137

Вложение регистрируемых отправлений

138

Обрешетка груза

139

Заполнение и печать таможенной

140

декларации

Доставка ровером

141

Расширенная верификация адреса

142

Отметка «Срочно»

143

Отметка вручения к определенной дате

144

Художественный бланк

145

Заверительная надпись

146

Написание оператором при приеме

147

Подбор текста

148

Выдача справки об адресе

149

Телеграфный сбор

150

Обыкновенное телеграфное уведомление о

151

вручении

Срочное телеграфное уведомление о

152

вручении

Уточнение данных

153

Предоставление POD

154

Социальные выплаты

155

Надбавка за наложенный платеж

156

Надбавка за объемный вес

157

Топливный сбор

158

Акция

159

Приложение 3. Коды типов упаковки

Наименование типа

Код

Коробка «S»

Пакет полиэтиленовый «S»

Конверт с воздушно-пузырчатой пленкой «S»

Коробка «М»

Пакет полиэтиленовый «М»

Конверт с воздушно-пузырчатой пленкой «М»

Коробка «L»

Пакет полиэтиленовый «L»

Коробка «ХL»

Пакет полиэтиленовый «ХL»

Нестандартная упаковка

Приложение 4. Коды магистральных поясов

Код

Магистральный пояс

пояс 1, до 600 км включительно

пояс 2, свыше 600 до 2000 км включительно

пояс 3, свыше 2000 до 3000 км включительно

пояс 4, свыше 3000 до 4000 км включительно

пояс 5, свыше 4000 до 5000 км включительно

пояс 6, свыше 5000 до 6000 км включительно

пояс 7, свыше 6000 до 7000 км включительно

пояс 8, свыше 7000 км

Приложение 5. Объɺм перевозимых изданий в месяц

Код

Объём в месяц

до 10 тонн/мес. включительно

свыше 10 до 20 тонн/мес. включительно

свыше 20 до 40 тонн/мес. включительно

свыше 40 до 60 тонн/мес. включительно

свыше 60 до 80 тонн/мес. включительно

140

свыше 80 до 140 тонн/мес. включительно

999

свыше 140 тонн/мес.

Приложение 6. Вид размещения рекламных материалов

Код

Вид размещения

Модуль 1/1 на 2-ой обложке издания

Модуль 1/1 на 3-ой обложке издания

Модуль 1/1 на 4-ой обложке издания

Модуль 1/1 в первой половине издания

Модуль 1/2 в первой половине издания

Модуль 1/3 в первой половине издания

Модуль 1/4 в первой половине издания

Модуль 1/1 во второй половине издания

Модуль 1/2 во второй половине издания

Модуль 1/3 во второй половине издания

Модуль 1/4 во второй половине издания

Модуль 1/1 на 4-ой обложке издания

Модуль 1/2 на 4-ой обложке издания

Модуль 1/1 на внутренних полосах газеты

Модуль 1/2 на внутренних полосах газеты

Модуль 1/4 на внутренних полосах газеты

Модуль 1/8 на внутренних полосах газеты

Модуль 1/16 на внутренних полосах газеты

Приложение 7. Вид конверта

Код

Вид конверта

Литера «А» 114х162 мм

Литера «А» 110х220 мм

Литера «А» 162х229 мм

Литера «А» с окном 110х220 мм

Литера 'А' 'Воинская

корреспонденция' 162х114 мм

Литера 'А' 'Президентское' 229х162

мм

Литера «D» 110х220 мм

Литера «D» 162х229 мм

Литера «D» с окном 110х220 мм

Литера 'K' весом 0.5 кг

Литера 'K' весом 1 кг

Литера 'K' весом 2 кг

Приложение 8. Категория телеграммы

Код

Параметры

Обыкновенная

Срочная

«Правительственная»

«Высшая правительственная»

«Президент РФ»

«Председатель Правительства Российской Федерации»

Приложение 9. Доставка на месте вручения телеграммы

Код

Категория телеграммы

Стандартная

Почтой заказное

в А/Я

До востребования

Приложение 10. Количество отправлений в месяц

Код

Количество

Свыше 1 000 000

От 500 001 до 1 000 000

От 200 001 до 500 000

От 100 001 до 200 000

До 100 000

Приложение 11. Расстояние перевозки

Код

Расстояние

До 30 км

30 - 100 км

100 - 300 км

300 - 450 км

Свыше 450 км

Приложение 12. Категория обслуживания

Код

Расстояние

1 выезд

2 выезда

3 выезда

4 выезда

5 выездов

6 выездов

7 выездов

За 1 выезд вне графика

За каждые последующие 40 кг

Разовый выезд

До 100 отправлений

От 101 до 500 отправлений

От 501 до 5000 отправлений

От 5001 и более

Приложение 13. Коды ошибок

Код

Наименование ошибки

1000

Невозможно получить справочники

1101

Не указан элемент фиксированного выбора

1200

Указано не верное значение

1201

Не указано значение

1202

Услуга не осуществляется

1203

В параметрах date или time неверное значение

1204

Услуга не осуществляется на конкретную дату (после конкретной даты/ на историческую дату)

1205

Не верный код объекта тарификации

1207

Индекс почтового объекта не существует

1209

Невозможно рассчитать маршрут следования отправления

1210

Неподдерживаемый код страны

1211

Нет кода валюты/ нет курса на дату

1222

Не указан вид расчета

1302

Неподдерживаемый атрибут

1304

Объект недоступен

1304

Должна быть не меньше

1305

Расчет недоступен после «

1332

В страну запрещено доставлять отправления с объявленной ценностью

1333

В страну запрещено доставлять отправления с объявленной ценностью и наложенным платежом

1334

Не указана страна назначения для международной доставки

1340

Использование страны допустимо только при международной доставке

1340

Использование региона отправления возможно только при указании индекса отправителя

1340

Использование региона получателя возможно только при указании индекса получателя

1340

Использование региона возможно только при его указании

1342

Не указан индекс места назначения/отправления + /маршрутизация

1343

Невозможно получить значение для маршрутизации

1366

Параметр имеет нечисловое значение

1367

Не определен

1370

Авиа /Наземная доставка невозможна

1371

Авиа /Наземная доставка невозможна при комбинированном способе

1372

Не осуществляется (маршрут)

1372

Не осуществляется при комбинациях маршрутов

1373

Не осуществляется (тариф)

1374

Фиксированные значения « не могут быть использованы для расчета

1375

Доставка не осуществляется

1376

Услуга не оказывается при входном (ых) значениях «

1377

Параметр « не может быть меньше

1378

Параметр « не может быть больше

1379

Услуга не оказывается при ... равным

1380

Внутренняя ошибка. Прочее

1387

Внутренняя ошибка. Неподдерживаемый код группы разрешений страны

1450

Запрет доставки в определенную точку

2001

Тарификация по общему весу не разрешена

2002

Отправление нельзя доставить из места приема в место получения

2003

Неверный вес отправления

2004

Отправление нельзя принять в месте приема

2005

Отправление нельзя доставить в место вручения

2006

Доставка в тип объекта не осуществляется

2007

Доставка курьером не осуществляется

2008

Доставка выбранным способом не осуществляется

2009

Доставка полностью запрещена

2010

Услуга не оказывается

2011

Неверная сумма

5000-

Внутренняя ошибка тарификатора

5999

_________________

* Список кодов ошибок не является окончательным, может быть дополнен новыми значениями в следующих

версиях.

Приложение 14. Виды услуг

Код

Вид услуги

Установка посудомоечной машины на готовые коммуникации

Установка посудомоечной машины при отсутствии готовых коммуникаций

Установка стиральной машины на готовые коммуникации

Установка стиральной машины при отсутствии готовых коммуникаций

Установка сушильной машины на готовые коммуникации

Установка сушильной машины при отсутствии готовых коммуникаций

Установка вытяжки

Установка отдельностоящего холодильника

Установка встраиваемого холодильника

Подключение холодильника SBS

Перенавеска дверей холодильника

Перенавеска дверей холодильника с электронным дисплеем

Установка электрической плиты

Установка электрической варочной панели

Установка газовой варочной панели

Установка электрического шкафа

Установка зависимых варочной панели и электрического шкафа

Сборка 1 категории (S, до 0.5 часа)

Сборка 2 категории (M, до 1 часа)

Сборка 3 категории (L, до 2 часов)

Сборка 4 категории (XL, до 4 часов)

Подъем груза без лифта на этаж

Подъем груза на лифте на этаж

Демонтаж

Приложение 15. Коды международных продуктов *

Код

Продукт

NRM

RDnR

RDnR air

cPacket

RMH

SRM

RDC

Parcel

SmParcel

_________________

* Список кодов международных продуктов не является окончательным, может быть дополнен новыми

значениями в следующих версиях. Полный список доступен в сервисе Администрирования тарифов и контрольных

сроков (АТиКС)

Приложение 16. Коды типов международных тарифов *

Код

Тип тарифа

Branch rate

Clientside logistics rate

DO rate

Clients rate

Intercompany TD rate

TD rate

Intrasystem rate

Service provider logistics rate

_________________

* Список кодов международных продуктов не является окончательным, может быть дополнен новыми

значениями в следующих версиях. Полный список доступен в сервисе Администрирования тарифов и контрольных

сроков (АТиКС)

Приложение 17. Коды международных каналов доставки *

Код

Канал

Германия

Великобритания

Финляндия

Китай

_________________

* Список кодов международных каналов доставки не является окончательным, может быть дополнен новыми

значениями в следующих версиях. Полный список доступен в сервисе Администрирования тарифов и контрольных

сроков (АТиКС)

Приложение 18. Коды международных клиентов *

Код

Клиент

Cainiao

A3+GO B.V.

Clevy CO., LIMITED

GVS

Joom Logistics Limited

Latvijas Pasts

Posti LTD

Shenzhen S.F. International Logistics Co., Ltd.

_________________

* Список кодов международных клиентов не является окончательным, может быть дополнен новыми

значениями в следующих версиях. Полный список доступен в сервисе Администрирования тарифов и контрольных

сроков (АТиКС)

Приложение 19. Информация о версиях документа

Дата

№

Кем создана

создания

Краткое описание изменений документа

вер.

версия

версии

2.0

28.08.2020

Гурский А.А.

Описана версия API 2.0.

2.0

31.08.2020

Гаврилова

Добавлен п. 2. Обновлен раздел “Связанные документы”

К.С.

2.1

23.10.2020

Гаврилова

В Приложении 1 название параметра country заменено на country-to;

К.С.

внесены исправления в колонке “Входные параметры”.

В Приложение 2 добавлено описание услуг с кодами 47, 112, 133, 134.

2.2

29.10.2020

Гурский А.А.

Изменено описание выходных параметров p1-p5, client, добавлены

выходные параметры id, region, удален выходной параметр object.

Дата

№

Кем создана

создания

Краткое описание изменений документа

вер.

версия

версии

В Приложении 1 добавлен параметр group.

2.2

03.11.2020

Гаврилова

В Приложение 2 добавлено описание услуг с кодами 84, 135. Добавлено

К.С.

Приложение 14

2.3

10.11.2020

Гурский А.А.

Изменено наименование выходных параметров regionido, distrid,

distrido, placeido на regiono, areaid, areao, placeo соответственно.

Изменен тип данных и описание параметров regionid, areaid, placeid.

2.4

24.04.2021

Гурский А.А.

Добавлен параметр isdogovor. Добавлены коды 3-5 в параметр

postoffice.tp.

2.5

17.05.2021

Гурский А.А.

В объект postoffice добавлено описание параметров name, root,

postoffice, region-main, area-main. Удален параметр regid как

дублирующий.

2.6

24.08.2021

Гурский А.А.

В выходные данные (Таблица 1.3) добавлен параметр isavia. Дополнено

описание параметра isservice.

2.7

01.09.2021

Гурский А.А.

Изменено название Приложения 2. В это же приложение добавлены

колонки «Разряд» и «Отметки». В это же приложение добавлены коды

124,137,138. Код 135 изменен на 139.

В Таблицу 1 добавлено описание параметров volume, duration,

domestic, date-from, date-to, paytype, payer, import, export.

В Таблицу 3 добавлено описание параметров volume, duration,

domestic, date-from, date-to, paytype, payer.

2.8

23.09.2021

Акамсина

В Таблицу 1 добавлено описание параметров int-product, int-type,

И.А.

channel, int-client, discount; внесены изменения в описание параметра

dogovor.

В Таблицу 3 добавлено описание параметров int-product, int-type,

channel, int-client, discount.

В Приложение 1 добавлены коды объектов расчета по международным

входящим отправлениям 4032, 4022, 4042, 7032, 7022, 7042, 5002, 5012.

Добавлены Приложения 15, 16, 17, 18

2.8

27.09.2021

Гурский А.А.

Дополнено описание обязательности параметров min и max в таблице

1.8.

2.9

06.10.2021

Евангелеева

В Таблице 1.1 внесены изменения в описании параметра export в части

А.С.

delivery.

В Таблицу 1.3 добавлен параметр ship-day.

2.10

08.11.2021

Гурская А.В.

В Приложение 2 добавлен признак «Дополнительная услуга» (код 118).

В Таблицу 1.1 добавлен параметр return.

В Таблицу 1.3 добавлены параметры return, paysdr, sdr, sumocsdr,

paymoney, paymoneynds.

В Таблицу 1.7 добавлен параметр valsdr.

2.10

15.12.2021

Гурская А.В.

В Таблицу 1.1 добавлен параметр weightall.

В Таблицу 1.3 добавлен параметр weightall.

2.10

19.01.2021

Гурский А.А.

Из Таблицы 1.6 удалены параметры k, p, group и добавлены параметры

altnames, letter, parcel, ems, note, items_stop, items_warning и др.

Переработан раздел 2.

В Таблицу 1.3 добавлены параметры для КС: “delivery-date-first" и

delivery-date-last.

2.10

21.03.2022

Колтайс

В Приложение 1 добавлены коды объектов расчета по Электронным

А.С.

рассылкам 301200, 301210.

В Приложение 1 добавлены коды объектов расчета по Услугам для

организаций 348001, 348002, 348003, 348004, 305210, 305220, 305601,

305601.

В Приложение 2 добавлен объект «Расширенная верификация адреса»

2.10

25.03.2022

Гурский А.А.

В Таблицу 1.6 добавлен параметр group и изменено примечание

параметров altnames, note, item-stop, item-warning.

В разделы 2.7 и 2.8 добавлены дополнительные URL запроса. В

таблицы 2.8 и 2.9 дополнено описание параметра id

2.11

19.04.2022

Гурский А.А.

В Таблицу 1.6 добавлен параметр oc-max-sdr, удалены параметры oc-

currency и np-type, изменен тип данных и описание у параметров block

и np-blank.

Дата

№

Кем создана

создания

Краткое описание изменений документа

вер.

версия

версии

2.11

26.05.2022

Гурская А.В.

В Приложение 13 добавлено описание ошибок 2001-2011, 2099

2.12

25.08.2022

Акамсина

В Таблицу 1.1 добавлен параметр aweight, удален параметр discount.

И.А.

В Таблицу 1.3 добавлен параметр aweight, удален параметр discount.

В Приложении 1 для кодов 5002, 5012, 7032, 7022, 7042, 4032, 4022, 4042

обновлены списки доступных услуг

2.12

31.08.2022

Гурская А.В.

В Приложение 1 добавлены коды объектов 305300, 305305

2.13

07.09.2022

Гурская А.В.

В Приложение 13 добавлено описание ошибок ошибок 2001-2005

2.14

16.09.2022

Колтайс

В Приложение 1 добавлены коды объектов 1051, 306120, 306190, 306140,

А.С.

312010, 312011, 329000, 356000, 357000.

В Приложение 2 добавлено описание услуг с кодами: 141, 143-163.

В Приложение 14 добавлено описание видов услуг: 80, 81.

В Приложении 1 для кодов: 1000, 301000 обновлен список параметров и

доступных услуг.

В Приложении 1 удалены коды объектов: 1001, 1320, 1031, 200010,

200020, 200030, 200040, 201010, 201020, 201030, 201040, 201050, 312000,

308000, 394000, 395000, 396000, 401000, 387000, 418000, 388000, 389000,

390000, 392000, 414000, 415000, 393000, 307100, 304100, 304110, 304140.

2.14

04.10.2022

Гурский А.А.

В Таблицу 1.1 и Таблицу 1.3 добавлены параметры weightmax, sizemax

и coupon.

В Таблицу 1.3 добавлен параметр bonus. Добавлена Таблица 1.11.

Изменено название параметра awеigth на weightavg в Таблице 1.1 и

Таблице 1.3

Дополнено примечание 3 к таблице 1.1.

Добавлено примечание 1 к таблице 1.4.

2.14

13.10.2022

Гурский А.А.

В Таблице 1.1 дополнено описание параметров from, to, return.

2.14

17.11.2022

Гурский А.А.

В Таблице 1.1 в описании параметра service убрано упоминание про

услугу 70 как устаревшее.

2.15

16.01.2023

Колтайс

В Приложение 1 добавлены коды объектов 305401, 305402, 305403,

А.С.

305404, 305405, 305406, 305700, 305710,305712, 305713, 305720, 305721,

305722, 305723, 305729, 305709, 39030, 40030.

В Приложении 1 для кодов: 311000, 305100 обновлен список параметров.

В Приложение 8 и 9 обновлены списки параметров.

В Приложении 1 удалены коды объектов: 328000, 329000.

2.15

13.04.2023

Гурский А.А.

В Таблице 1.1 изменено описание параметра to.

2.15

29.06.2023

Гурский А.А.

В Таблице 1.3 дополнено описание параметра items.

В Таблице 1.4 дополнено описание параметра id и serviceon.

Создан Раздел 1.6.

Разделы 2.6, 2.7, 2.8 перенумерованы в Разделы 2.5, 2.6, 2.7

соответственно.

В Приложение 2 добавлены столбцы PayType и ServiceType и указаны их

значения для отдельных элементов списка.

Приложение 2 дополнено элементами.

2.16

24.10.2023

Гурская А.В.

В Таблицу 1.3 добавлен параметр cons-mmo.

2.16

06.12.2024

Гурский А.А.

В Таблицу 1.1 добавлено описание параметра transtype.

В Таблице 1.1 изменено описание параметра isavia.

В Таблице 1.1 изменено описание параметра closed.

Дополнено примечание 2 к Таблице 1.1.

В Приложение 1 для ряда объектов расчета добавлен параметр

transtype.

2.17

08.12.2024

Гурский А.А.

В Таблице 1.1 дополнено описание параметра group.

Гурская А.В.

В Приложении 1 международные отправления разделены на две группы:

исходящие и входящие

В Приложении 1 для международных входящих объектов изменен набор

параметров

2.17

01.03.2024

Гурский А.А.

В Таблице 1.1 и Таблице 1.3 добавлено описание параметров sumnpc и

sumnpt, дополнено описание параметра sumnp.

В Таблице 0.8 добавлено описание параметров code, rank, paytype,

servicetype.