---
slug: "pochta-rossii"
name: "Почта России"
vendor: "АО «Почта России»"
industry: "logistics"
docsUrl: "https://www.pochta.ru/support/business/api"
version: 2
updatedAt: "2026-10-24"
---
# Почта России
Отрасль: Логистика и доставка. Актуально на 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.
```bash
curl -X POST https://tracking.russianpost.ru/rtm34 \
-H 'Content-Type: application/soap+xml; charset=utf-8' \
-d '
RA644000001RU
0
RUS
my_login
my_password
'
```
### Проверить, пришли ли деньги наложенного платежа
Для отправлений с наложенным платежом: узнать, оплатил ли получатель и отправлен ли перевод магазину.
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. Суммы в финансовых параметрах приходят в копейках.
```bash
curl -X POST https://tracking.russianpost.ru/rtm34 \
-H 'Content-Type: application/soap+xml; charset=utf-8' \
-d '
my_login
my_password
'
```
## Базовые URL
- Боевой: `https://tracking.russianpost.ru/rtm34`
- WSDL: `https://tracking.russianpost.ru/rtm34?wsdl`
## Авторизация
Тип: Другое
Логин и пароль берутся в разделе «Настройки доступа». Они передаются в каждом запросе внутри элемента `data:AuthorizationHeader` с атрибутом `soapenv:mustUnderstand="1"`.
```
my_login
my_password
```
## Методы
### getOperationHistory — История операций по отправлению
Возвращает список операций (`historyRecord`) по РПО: дату операции, место, тип и атрибут операции, параметры адреса, финансов, отправления и участников.
| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `Barcode` | body | string | да | Трек-номер: 14 цифр для внутренних отправлений или 13 символов для международных (формат S10) |
| `MessageType` | body | integer | да | 0 — история отправления, 1 — история уведомления о вручении |
| `Language` | body | string | нет | Язык ответа: RUS (по умолчанию) или ENG |
| `login` | body | string | да | Логин из раздела «Настройки доступа» |
| `password` | body | string | да | Пароль из раздела «Настройки доступа» |
Пример запроса:
```
RA644000001RU
0
RUS
my_login
my_password
```
### 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 | да | Пароль из раздела «Настройки доступа» |
Пример запроса:
```
my_login
my_password
```
## Нюансы
- 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://tracking.pochta.ru/specification)
- [Справочник стран](https://tracking.pochta.ru/support/dictionaries/countries)
- [Справочник кодов операций](https://tracking.pochta.ru/support/dictionaries/operation_codes)
- [Справочник типов событий](https://tracking.pochta.ru/support/dictionaries/event_type)
- [Справочник видов отправлений](https://tracking.pochta.ru/support/dictionaries/mailtype)
- [Справочник категорий отправлений](https://tracking.pochta.ru/support/dictionaries/category_codes)
---
Если этого недостаточно — официальная документация: https://www.pochta.ru/support/business/api
JSON: https://mcp-everything.ru/api/integrations/pochta-rossii. MCP: https://mcp-everything.ru/mcp