{"name":"Почта России","vendor":"АО «Почта России»","industry":"logistics","summary":"API отслеживания почтовых отправлений Почты России (единичный доступ). Работает по протоколу SOAP 1.2 и позволяет получить историю операций по регистрируемому почтовому отправлению (РПО) по его трек-номеру, а также операции по наложенному платежу, связанному с отправлением. Логин и пароль выдаются в разделе «Настройки доступа».","docsUrl":"https://www.pochta.ru/support/business/api","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"otsledit-posylku-po-trek-nomeru","title":"Отследить посылку по трек-номеру","summary":"Показать историю движения отправления: принято, прибыло в сортировочный центр, вручено.","steps":["Получи логин и пароль в разделе «Настройки доступа» на сайте Почты России.","Отправь SOAP 1.2 запрос getOperationHistory на https://tracking.russianpost.ru/rtm34: в OperationHistoryRequest — Barcode (14 цифр для внутренних отправлений или 13 символов для международных), MessageType = 0 и Language = RUS.","Логин и пароль передаются не в HTTP-заголовке, а в элементе AuthorizationHeader внутри тела, обязательно с soapenv:mustUnderstand=\"1\".","В ответе — список historyRecord: дата операции, место (индекс и описание), тип и атрибут операции. Последняя запись — текущий статус. Коды операций расшифровываются по справочникам Почты.","Чтобы узнать, вручено ли уведомление о вручении, повтори запрос с MessageType = 1."],"code":"curl -X POST https://tracking.russianpost.ru/rtm34 \\\n  -H 'Content-Type: application/soap+xml; charset=utf-8' \\\n  -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/\">\n  <soap:Header/>\n  <soap:Body>\n    <oper:getOperationHistory>\n      <data:OperationHistoryRequest>\n        <data:Barcode>RA644000001RU</data:Barcode>\n        <data:MessageType>0</data:MessageType>\n        <data:Language>RUS</data:Language>\n      </data:OperationHistoryRequest>\n      <data:AuthorizationHeader soapenv:mustUnderstand=\"1\">\n        <data:login>my_login</data:login>\n        <data:password>my_password</data:password>\n      </data:AuthorizationHeader>\n    </oper:getOperationHistory>\n  </soap:Body>\n</soap:Envelope>'","language":"bash","methods":["getOperationHistory"]},{"id":"proverit-prishli-li-dengi-nalozhennogo","title":"Проверить, пришли ли деньги наложенного платежа","summary":"Для отправлений с наложенным платежом: узнать, оплатил ли получатель и отправлен ли перевод магазину.","steps":["Отправь SOAP 1.2 запрос PostalOrderEventsForMail на https://tracking.russianpost.ru/rtm34. Трек-номер здесь передаётся атрибутом Barcode элемента PostalOrderEventsForMailInput, а не вложенным элементом, как в getOperationHistory.","Логин и пароль — так же в AuthorizationHeader с soapenv:mustUnderstand=\"1\".","В ответе — события почтового перевода: Number, EventDateTime, EventType, EventName, IndexTo, IndexEvent и SumPaymentForward — сумма перевода.","Суммы в финансовых параметрах приходят в копейках."],"code":"curl -X POST https://tracking.russianpost.ru/rtm34 \\\n  -H 'Content-Type: application/soap+xml; charset=utf-8' \\\n  -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\">\n  <soap:Header/>\n  <soap:Body>\n    <oper:PostalOrderEventsForMail>\n      <data:AuthorizationHeader soapenv:mustUnderstand=\"1\">\n        <data:login>my_login</data:login>\n        <data:password>my_password</data:password>\n      </data:AuthorizationHeader>\n      <data1:PostalOrderEventsForMailInput Barcode=\"RA644000001RU\" Language=\"RUS\"/>\n    </oper:PostalOrderEventsForMail>\n  </soap:Body>\n</soap:Envelope>'","language":"bash","methods":["getOperationHistory","PostalOrderEventsForMail"]}],"baseUrls":[{"label":"Боевой","url":"https://tracking.russianpost.ru/rtm34"},{"label":"WSDL","url":"https://tracking.russianpost.ru/rtm34?wsdl"}],"auth":{"type":"other","description":"Логин и пароль берутся в разделе «Настройки доступа». Они передаются в каждом запросе внутри элемента `data:AuthorizationHeader` с атрибутом `soapenv:mustUnderstand=\"1\"`.","example":"<data:AuthorizationHeader soapenv:mustUnderstand=\"1\">\n<data:login>my_login</data:login>\n<data:password>my_password</data:password>\n</data:AuthorizationHeader>"},"methods":[{"id":"getOperationHistory","title":"История операций по отправлению","httpMethod":"POST","path":"getOperationHistory","description":"Возвращает список операций (`historyRecord`) по РПО: дату операции, место, тип и атрибут операции, параметры адреса, финансов, отправления и участников.","params":[{"name":"Barcode","in":"body","type":"string","required":true,"description":"Трек-номер: 14 цифр для внутренних отправлений или 13 символов для международных (формат S10)"},{"name":"MessageType","in":"body","type":"integer","required":true,"description":"0 — история отправления, 1 — история уведомления о вручении"},{"name":"Language","in":"body","type":"string","required":false,"description":"Язык ответа: RUS (по умолчанию) или ENG"},{"name":"login","in":"body","type":"string","required":true,"description":"Логин из раздела «Настройки доступа»"},{"name":"password","in":"body","type":"string","required":true,"description":"Пароль из раздела «Настройки доступа»"}],"requestExample":"<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/\">\n    <soap:Header/>\n    <soap:Body>\n    <oper:getOperationHistory>\n    <data:OperationHistoryRequest>\n    <data:Barcode>RA644000001RU</data:Barcode>\n    <data:MessageType>0</data:MessageType>\n    <data:Language>RUS</data:Language>\n    </data:OperationHistoryRequest>\n    <data:AuthorizationHeader soapenv:mustUnderstand=\"1\">\n    <data:login>my_login</data:login>\n    <data:password>my_password</data:password>\n    </data:AuthorizationHeader>\n    </oper:getOperationHistory>\n    </soap:Body>\n</soap:Envelope>","responseExample":"","docsUrl":""},{"id":"PostalOrderEventsForMail","title":"Операции по наложенному платежу","httpMethod":"POST","path":"PostalOrderEventsForMail","description":"Возвращает операции с почтовым переводом наложенного платежа, связанным с отправлением. В ответе: Number, EventDateTime, EventType, EventName, IndexTo, IndexEvent, SumPaymentForward, CountryEventCode, CountryToCode.","params":[{"name":"Barcode","in":"body","type":"string","required":true,"description":"Трек-номер отправления (атрибут PostalOrderEventsForMailInput)"},{"name":"Language","in":"body","type":"string","required":false,"description":"Язык ответа: RUS или ENG"},{"name":"login","in":"body","type":"string","required":true,"description":"Логин из раздела «Настройки доступа»"},{"name":"password","in":"body","type":"string","required":true,"description":"Пароль из раздела «Настройки доступа»"}],"requestExample":"<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\">\n    <soap:Header/>\n    <soap:Body>\n    <oper:PostalOrderEventsForMail>\n    <data:AuthorizationHeader soapenv:mustUnderstand=\"1\">\n    <data:login>my_login</data:login>\n    <data:password>my_password</data:password>\n    </data:AuthorizationHeader>\n    <data1:PostalOrderEventsForMailInput Barcode=\"14102192069353\" Language=\"ENG\"/>\n    </oper:PostalOrderEventsForMail>\n    </soap:Body>\n</soap:Envelope>","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"AuthorizationFault","description":"Ошибка авторизации при обращении к сервису"},{"code":"OperationHistoryFault","description":"Ошибка получения информации об отправлении"},{"code":"LanguageFault","description":"Неподдерживаемый идентификатор языка"}],"limits":"","gotchas":["API работает только по SOAP 1.2: нужен конверт с пространством имён `http://www.w3.org/2003/05/soap-envelope`.","Логин и пароль передаются не в HTTP-заголовке, а в элементе `AuthorizationHeader` внутри тела запроса, обязательно с `soapenv:mustUnderstand=\"1\"`.","В `getOperationHistory` параметры отправления лежат в `OperationHistoryRequest`, а в `PostalOrderEventsForMail` — атрибутами элемента `PostalOrderEventsForMailInput`.","Суммы в `FinanceParameters` возвращаются в копейках.","Коды операций, типов и категорий отправлений, стран — в отдельных справочниках (см. «Источники»)."],"slug":"pochta-rossii","version":2,"updatedAt":"2026-10-24T17:05:35.201Z","sources":[{"title":"Спецификация API отслеживания (единичный доступ)","url":"https://tracking.pochta.ru/specification","kind":"research","addedAt":"2026-10-11T18:32:36.440Z"},{"title":"Справочник стран","url":"https://tracking.pochta.ru/support/dictionaries/countries","kind":"research","addedAt":"2026-10-11T18:32:36.440Z"},{"title":"Справочник кодов операций","url":"https://tracking.pochta.ru/support/dictionaries/operation_codes","kind":"research","addedAt":"2026-10-11T18:32:36.440Z"},{"title":"Справочник типов событий","url":"https://tracking.pochta.ru/support/dictionaries/event_type","kind":"research","addedAt":"2026-10-11T18:32:36.440Z"},{"title":"Справочник видов отправлений","url":"https://tracking.pochta.ru/support/dictionaries/mailtype","kind":"research","addedAt":"2026-10-11T18:32:36.440Z"},{"title":"Справочник категорий отправлений","url":"https://tracking.pochta.ru/support/dictionaries/category_codes","kind":"research","addedAt":"2026-10-11T18:32:36.440Z"},{"title":"pochta-rossii.md","url":"","kind":"import","addedAt":"2026-10-11T18:32:36.440Z"},{"title":"scenarios-pochta-rossii.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:26.074Z"}],"logoUrl":null}