# Почта России: 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>
```

## Базовые 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>
```

## Нюансы

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

## Сценарии с этим методом

- [Отследить посылку по трек-номеру](https://mcp-everything.ru/integrations/pochta-rossii/scenarios/otsledit-posylku-po-trek-nomeru.md)
- [Проверить, пришли ли деньги наложенного платежа](https://mcp-everything.ru/integrations/pochta-rossii/scenarios/proverit-prishli-li-dengi-nalozhennogo.md)

---

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