Почта России API

Отрасль: Логистика и доставка. Актуально на 2026-10-24.

API отслеживания почтовых отправлений Почты России (единичный доступ). Работает по протоколу SOAP 1.2 и позволяет получить историю операций по регистрируемому почтовому отправлению (РПО) по его трек-номеру, а также операции по наложенному платежу, связанному с отправлением. Логин и пароль выдаются в разделе «Настройки доступа».

Сценарии

Отследить посылку по трек-номеру

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

1. Получи логин и пароль в разделе «Настройки доступа» на сайте Почты России.
2. Отправь SOAP 1.2 запрос getOperationHistory на https://tracking.russianpost.ru/rtm34: в OperationHistoryRequest — Barcode (14 цифр для внутренних отправлений или 13 символов для международных), MessageType = 0 и Language = RUS.
3. Логин и пароль передаются не в HTTP-заголовке, а в элементе AuthorizationHeader внутри тела, обязательно с soapenv:mustUnderstand="1".
4. В ответе — список historyRecord: дата операции, место (индекс и описание), тип и атрибут операции. Последняя запись — текущий статус. Коды операций расшифровываются по справочникам Почты.
5. Чтобы узнать, вручено ли уведомление о вручении, повтори запрос с MessageType = 1.

curl -X POST https://tracking.russianpost.ru/rtm34 \
  -H 'Content-Type: application/soap+xml; charset=utf-8' \
  -d '<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:oper="http://russianpost.org/operationhistory" xmlns:data="http://russianpost.org/operationhistory/data" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header/>
  <soap:Body>
    <oper:getOperationHistory>
      <data:OperationHistoryRequest>
        <data:Barcode>RA644000001RU</data:Barcode>
        <data:MessageType>0</data:MessageType>
        <data:Language>RUS</data:Language>
      </data:OperationHistoryRequest>
      <data:AuthorizationHeader soapenv:mustUnderstand="1">
        <data:login>my_login</data:login>
        <data:password>my_password</data:password>
      </data:AuthorizationHeader>
    </oper:getOperationHistory>
  </soap:Body>
</soap:Envelope>'

Проверить, пришли ли деньги наложенного платежа

Для отправлений с наложенным платежом: узнать, оплатил ли получатель и отправлен ли перевод магазину.

1. Отправь SOAP 1.2 запрос PostalOrderEventsForMail на https://tracking.russianpost.ru/rtm34. Трек-номер здесь передаётся атрибутом Barcode элемента PostalOrderEventsForMailInput, а не вложенным элементом, как в getOperationHistory.
2. Логин и пароль — так же в AuthorizationHeader с soapenv:mustUnderstand="1".
3. В ответе — события почтового перевода: Number, EventDateTime, EventType, EventName, IndexTo, IndexEvent и SumPaymentForward — сумма перевода.
4. Суммы в финансовых параметрах приходят в копейках.

curl -X POST https://tracking.russianpost.ru/rtm34 \
  -H 'Content-Type: application/soap+xml; charset=utf-8' \
  -d '<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:oper="http://russianpost.org/operationhistory" xmlns:data="http://russianpost.org/operationhistory/data" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data1="http://www.russianpost.org/RTM/DataExchangeESPP/Data">
  <soap:Header/>
  <soap:Body>
    <oper:PostalOrderEventsForMail>
      <data:AuthorizationHeader soapenv:mustUnderstand="1">
        <data:login>my_login</data:login>
        <data:password>my_password</data:password>
      </data:AuthorizationHeader>
      <data1:PostalOrderEventsForMailInput Barcode="RA644000001RU" Language="RUS"/>
    </oper:PostalOrderEventsForMail>
  </soap:Body>
</soap:Envelope>'

Базовые URL

• Боевой: https://tracking.russianpost.ru/rtm34
• WSDL: https://tracking.russianpost.ru/rtm34?wsdl

Авторизация

Тип: Другое

Логин и пароль берутся в разделе «Настройки доступа». Они передаются в каждом запросе внутри элемента data:AuthorizationHeader с атрибутом soapenv:mustUnderstand="1".

<data:AuthorizationHeader soapenv:mustUnderstand="1">
<data:login>my_login</data:login>
<data:password>my_password</data:password>
</data:AuthorizationHeader>

Методы

getOperationHistory — История операций по отправлению

Возвращает список операций (historyRecord) по РПО: дату операции, место, тип и атрибут операции, параметры адреса, финансов, отправления и участников.

Параметр	Где	Тип	Обяз.	Описание
Barcode	body	string	да	Трек-номер: 14 цифр для внутренних отправлений или 13 символов для международных (формат S10)
MessageType	body	integer	да	0 — история отправления, 1 — история уведомления о вручении
Language	body	string	нет	Язык ответа: RUS (по умолчанию) или ENG
login	body	string	да	Логин из раздела «Настройки доступа»
password	body	string	да	Пароль из раздела «Настройки доступа»

Пример запроса:

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:oper="http://russianpost.org/operationhistory" xmlns:data="http://russianpost.org/operationhistory/data" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header/>
    <soap:Body>
    <oper:getOperationHistory>
    <data:OperationHistoryRequest>
    <data:Barcode>RA644000001RU</data:Barcode>
    <data:MessageType>0</data:MessageType>
    <data:Language>RUS</data:Language>
    </data:OperationHistoryRequest>
    <data:AuthorizationHeader soapenv:mustUnderstand="1">
    <data:login>my_login</data:login>
    <data:password>my_password</data:password>
    </data:AuthorizationHeader>
    </oper:getOperationHistory>
    </soap:Body>
</soap:Envelope>

PostalOrderEventsForMail — Операции по наложенному платежу

Возвращает операции с почтовым переводом наложенного платежа, связанным с отправлением. В ответе: Number, EventDateTime, EventType, EventName, IndexTo, IndexEvent, SumPaymentForward, CountryEventCode, CountryToCode.

Параметр	Где	Тип	Обяз.	Описание
Barcode	body	string	да	Трек-номер отправления (атрибут PostalOrderEventsForMailInput)
Language	body	string	нет	Язык ответа: RUS или ENG
login	body	string	да	Логин из раздела «Настройки доступа»
password	body	string	да	Пароль из раздела «Настройки доступа»

Пример запроса:

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:oper="http://russianpost.org/operationhistory" xmlns:data="http://russianpost.org/operationhistory/data" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:data1="http://www.russianpost.org/RTM/DataExchangeESPP/Data">
    <soap:Header/>
    <soap:Body>
    <oper:PostalOrderEventsForMail>
    <data:AuthorizationHeader soapenv:mustUnderstand="1">
    <data:login>my_login</data:login>
    <data:password>my_password</data:password>
    </data:AuthorizationHeader>
    <data1:PostalOrderEventsForMailInput Barcode="14102192069353" Language="ENG"/>
    </oper:PostalOrderEventsForMail>
    </soap:Body>
</soap:Envelope>

Нюансы

• API работает только по SOAP 1.2: нужен конверт с пространством имён http://www.w3.org/2003/05/soap-envelope.
• Логин и пароль передаются не в HTTP-заголовке, а в элементе AuthorizationHeader внутри тела запроса, обязательно с soapenv:mustUnderstand="1".
• В getOperationHistory параметры отправления лежат в OperationHistoryRequest, а в PostalOrderEventsForMail — атрибутами элемента PostalOrderEventsForMailInput.
• Суммы в FinanceParameters возвращаются в копейках.
• Коды операций, типов и категорий отправлений, стран — в отдельных справочниках (см. «Источники»).

Ошибки

Код	Описание
AuthorizationFault	Ошибка авторизации при обращении к сервису
OperationHistoryFault	Ошибка получения информации об отправлении
LanguageFault	Неподдерживаемый идентификатор языка

Источники

• Спецификация API отслеживания (единичный доступ)
• Справочник стран
• Справочник кодов операций
• Справочник типов событий
• Справочник видов отправлений
• Справочник категорий отправлений

---

Если этого недостаточно — официальная документация: https://www.pochta.ru/support/business/api JSON: https://mcp-everything.ru/api/integrations/pochta-rossii. MCP: https://mcp-everything.ru/mcp