Создание реестра (или накладной) — это обязательный этап для юридических лиц и ИП, отправляющих почтовые отправления через «Почту России» по договору. Реестр передает информацию об отправлениях в автоматизированную систему оператора, формирует уникальные трек-номера и служит основой для расчетов по оплате услуг. В этой статье мы подробно разберем все способы создания реестра: через веб-интерфейс сервиса «Отправка», через API и с помощью интеграторов.
Содержание
- Подготовительный этап: договор, доступы и настройки
- Способ 1: Создание реестра в личном кабинете «Отправка» (Веб-интерфейс)
- Способ 2: Автоматизация через API «Отправка»
- Способ 3: Использование сторонних интеграторов (на примере ApiShip)
- Структура реестра: обязательные и рекомендуемые поля
- Важные нюансы: тарифы, таможня, баркоды и лимиты
- Частые ошибки и их решение
- Где искать помощь и актуальную документацию
Подготовительный этап: договор, доступы и настройки
Прежде чем создавать первый реестр, убедитесь, что выполнены следующие условия:
- Заключен договор на оказание услуг почтовой связи с ПАО «Почта России» (для бизнеса).
- Подключен онлайн-баланс (рекомендуется) для автоматического списания средств за отправления.
- Регистрация в сервисе «Отправка» по адресу otpravka.pochta.ru. Логин и пароль обычно выдаются менеджером Почты или при самостоятельной регистрации по ИНН организации.
- Настройка профиля отправителя: в личном кабинете (раздел «Настройки» -> «Отправители») должны быть заведены адреса отправления. Внимание: реальные адреса, фамилии контактных лиц и телефоны в тестовых данных лучше маскировать (например, г. , ул. , д. , тел. +7 () —).
Получение ключей для API (если нужна интеграция)
Для работы через API или подключения к CRM/интеграторам (ApiShip, 1С, МойСклад и др.) необходимы два параметра:
- API-ключ (X-User-Authorization) — генерируется в спецификации API (
https://otpravka.pochta.ru/specification#/authorization-key) или в настройках ЛК. - API-токен (Access Token) — высылается на email, указанный при регистрации в «Отправке», либо доступен в настройках личного кабинета.
Важно: Храните эти данные в секрете. При обращении в поддержку или публикации логов маскируйте их частично: Bearer *.
Способ 1: Создание реестра в личном кабинете «Отправка» (Веб-интерфейс)
Этот способ подходит для небольших объемов (до нескольких сотен отправлений в день) или для разовых отправок.
Пошаговая инструкция:
- Авторизуйтесь на otpravka.pochta.ru.
- В левом меню выберите раздел «Создать отправку» -> «Реестр отправлений».
- Выберите тип отправления: Посылка онлайн, Посылка 1-го класса, Письмо 1-го класса, Мелкий пакет, EMS и др.
- Заполните данные отправителя (выберите из сохраненных профилей).
- Добавьте получателей. Доступно три способа:
- Ручной ввод — по одному (удобно для 1-5 шт.).
- Импорт из файла (CSV/XLSX) — основной способ для партий. Скачайте шаблон файла на странице импорта. Обязательные колонки: Индекс получателя, Регион, Город, Улица, Дом, Квартира, ФИО получателя, Телефон, Вес, Оценка, Наложенный платеж (если есть).
- Копирование из буфера обмена — для быстрой вставки табличных данных.
- Проверка данных. Система автоматически валидирует адреса (подсказывает ФИАС/КЛАДР) и вес. Исправьте ошибки, подсвеченные красным.
- Расчет стоимости. Нажмите «Рассчитать». Убедитесь, что тарифы соответствуют вашему договору (с учетом скидок), а не публичным. Сервис калькуляции otpravka.pochta.ru учитывает персональные скидки, в отличие от публичного tariff.pochta.ru.
- Формирование реестра. Нажмите «Создать реестр». Система присвоит внутренний номер реестра (например, № *) и сгенерирует трек-номера для каждого отправления.
- Печать документов. Скачайте:
- Форму 103 (Акт приема-передачи) — основной документ для сдачи в отделение.
- Баркоды/Ярлыки — для наклейки на отправления (формат PDF, ZPL для термопринтеров).
- Таможенные декларации CN23 — для международных отправлений.
Способ 2: Автоматизация через API «Отправка»
Для крупных интернет-магазинов и высоких объемов (тысячи отправлений в день) единственно верный путь — интеграция по API. Спецификация доступна по адресу: https://otpravka.pochta.ru/specification (OpenAPI 3.0 / Swagger).
Основные эндпоинты для работы с реестрами:
POST /1.0/orders— создание заказов (отправлений) и одновременное формирование реестра.POST /1.0/orders/bulk, массовое создание заказов (пакетная загрузка до 1000 шт. за запрос).GET /1.0/orders/{order-id}— получение информации по конкретному заказу/трек-номеру.POST /1.0/forms/pdf— генерация печатных форм (Акт 103, ярлыки) по списку заказов.
Пример минимального JSON-запроса на создание заказа (упрощенно):
{
"mail-type": "POSTAL_PARCEL", // Тип: Посылка онлайн
"sender": {
"name": "ИП *", // Маскированные ФИО/Название
"address": {
"postcode": " ", // Маскированный индекс
"region": "*",
"city": "",
"street": "ул. ",
"house": ""
},
"phone": "+7 () --"
},
"recipient": {
"name": "Иванов И.И.", // В реальных логах маскируем: Ив* И.И.
"address": {
"postcode": "101000",
"region": "г; Москва",
"city": "Москва",
"street": "ул. Примерная",
"house": "1",
"flat": "1"
},
"phone": "+7 (999) *--"
},
"weight": 500, // Вес в граммах
"value": 1000.00, // Оценка (страховая стоимость)
"payment": {
"cash-on-delivery": 0 // Наложенный платеж (0 если нет)
},
"items": [
{
"name": "Товар №1",
"quantity": 1,
"price": 1000.00,
"weight": 500
}
]
}
Особенности API:
- Авторизация: Header
Authorization: AccessToken *иX-User-Authorization: Basic *. - Лимиты калькуляции: Суточный лимит запросов к калькулятору тарифов по API составляет 1/3 от планируемого количества отправлений в месяц. Увеличение лимита — по заявке в поддержку.
- Асинхронность: При больших объемах используйте bulk-методы и отслеживайте статус обработки через вебхуки или поллинг.
- Тестовая среда (Sandbox): Обязательно протестируйте интеграцию на стенде перед запуском в прод. Данные тестового отправителя: ИНН , КПП .
Способ 3: Использование сторонних интеграторов (ApiShip, 1С, МойСклад, KeyCRM и др.)
Если у вас нет ресурсов на разработку своей интеграции, используйте готовые модули. В источнике упоминается ApiShip как пример агрегатора.
Настройка подключения в интеграторе:
- В настройках доставки выберите «Почта России».
- Введите API-ключ и API-токен (полученные на этапе 1).
- Настройте режим отображения тарифов (критично для корректного расчета на витрине):
- До ПВЗ (Отделение/Почтамат) — тарифы в разделе
deliveryToPoint. - До двери (Курьер) — тарифы в разделе
deliveryToDoor. - Дублировать, оба варианта (ApiShip сам определит индекс и привяжет к ПВЗ/Почтамту).
- До ПВЗ (Отделение/Почтамат) — тарифы в разделе
- Активируйте опцию «Онлайн-баланс», если он подключен к договору, для корректного списания средств.
- Настройте передачу габаритов (Д x Ш x В) — обязательно для тарифа «Посылка нестандартная» и расчета объемного веса.
Структура реестра: обязательные и рекомендуемые поля
Независимо от способа создания (Веб, API, CSV), набор данных для одного отправления стандартен.
| Поле | Обязательность | Описание и формат |
|---|---|---|
| Тип отправления (mail-type) | Да | POSTAL_PARCEL (Посылка онлайн), PARCEL_1CLASS, LETTER_1CLASS, SMALL_PACKET, EMS и др. |
| Отправитель (sender) | Да | Название/ФИО, полный адрес (по ФИАС), телефон. Должен совпадать с профилем в договоре. |
| Получатель (recipient) | Да | ФИО (для физлиц) / Название (юрлица), телефон (обязателен для СМС-уведомлений), полный адрес, индекс. |
| Вес (weight) | Да | В граммах. Целое число. Макс. вес зависит от тарифа (обычно до 30-50 кг). |
| Габариты (dimensions) | Рекомендуется | Длина, Ширина, Высота в см. Обязательны для «Посылка нестандартная» и если сумма трех измерений > 90 см. |
| Оценка (value) | Да | Страховая стоимость (в рублях, с копейками). Если 0, отправление нестрахованное. |
| Наложенный платеж (cash-on-delivery) | Нет | Сумма к взысканию с получателя. Требует подключенной услуги «Наложенный платеж» в договоре. |
| Вложение (items) | Да (для таможни/чеков) | Массив товаров: название, кол-во, цена, вес, HS-код (для международки), артикул. |
| Код таможенной декларации (CN23) | Для международки | Автогенерируется при заполнении items для международных типов (EMS, Small Packet Int). |
| Дополнительные услуги | Нет | СМС-уведомление, «Лично в руки», «Частный курьер», «Страховка» (отдельно от оценки). |
Важные нюансы: тарифы, таможня, баркоды и лимиты
Тарификация и калькуляторы
- otpravka.pochta.ru (API/ЛК) — считает по вашим договорным тарифам (со скидками). Имеет суточный лимит запросов (1/3 от планового объема).
- tariff.pochta.ru — публичный калькулятор, не учитывает скидки. Лимитов нет. Используйте только для ориентировочной оценки клиентами на сайте.
Баркоды и печать
- Трек-номера генерируются только после создания реестра (в ЛК) или успешного ответа API
POST /orders. - Печать ярлыков доступна в формате PDF (для офисных принтеров) и ZPL (для термотрансферных принтеров Zebra, TSC, Godex и др.). ZPL дает лучшее качество и скорость.
- Акт приема-передачи (Форма 103) подписывается сотрудником Почты при сдаче партии. Храните экземпляр с печатью Почты для отчетности.
Международные отправления
Для отправок за пределы РФ (ЕАЭС и дальнее зарубежье) обязательно заполнение таможенной декларации CN23 (электронно через API/ЛК). В описании вложений (items) нужно указывать:
- Название на русском и английском.
- Код ТН ВЭД (HS Code) — 6-10 знаков.
- Страну происхождения товара.
- Назначение (личное пользование, продажа и т.д.).
Без корректного CN23 отправление не примут к перевозке или задержат на таможне.
Режимы трекинга (Единичный vs Пакетный)
- Единичный доступ, доступен сразу после регистрации в сервисе трекинга. Подходит для проверки статусов по одному треку.
- Пакетный доступ — требует отдельной заявки и подключения в ЛК трекинга. Необходим для массового экспорта статусов (выгрузка XML/JSON по списку треков). Для интеграций в CRM почти всегда нужен пакетный доступ.
Частые ошибки и их решение
| Ошибка / Код | Причина | Решение |
|---|---|---|
| 401 Unauthorized / 403 Forbidden | Неверный токен, истек срок действия, неверный API-ключ, IP не в белом списке (если настроено). | Проверьте заголовки Authorization и X-User-Authorization. Обновите токен. Проверьте настройки безопасности в ЛК «Отправка». |
| 400 Bad Request: «Invalid address» | Адрес не найден в ФИАС/КЛАДР, неверный индекс, отсутствует обязательное поле (квартира, корпус). | Используйте подсказки DaData/ФИАС при вводе. Проверяйте индексы на сайте Почты. Для API — предварительно валидируйте адрес через /clean/address (если доступно) или DaData. |
| 429 Too Many Requests | Превышен лимит запросов к калькулятору тарифов или к API создания заказов. | Внедрите кэширование тарифов на своей стороне. Запросите увеличение лимита у менеджера Почты. Используйте bulk-методы. |
| «Tariff not available for this route» | Выбранный тариф не действует для пары индексов Отправитель-Получатель (например, EMS нет в этот населенный пункт). | Реализуйте фоллбэк: если тариф недоступен, автоматически предлагайте следующий доступный (Посылка 1-го класса -> Посылка онлайн). |
| Ошибка печати: «Label not found» | Попытка скачать PDF/ЗПЛ до того, как реестр перешел в статус «Создан» / заказам присвоились треки. | Дожидайтесь успешного ответа API с трек-номерами или обновления страницы в ЛК перед запросом форм. |
| Не списываются средства с онлайн-баланса | Опция «Онлайн-баланс» не активирована в настройках интегратора или в ЛК Почты. | Проверьте галочку «Использовать онлайн-баланс» в настройках подключения (в ApiShip, 1С и т.д.) и в ЛК «Отправка» -> «Баланс». |
Где искать помощь и актуальную документацию
Официальные источники информации (актуальны на ):
- База знаний / Справка сервиса «Отправка»:
https://otpravka.pochta.ru/help/— инструкции по веб-интерфейсу, описание кодов ошибок, шаблоны CSV. - Спецификация API (Swagger/OpenAPI):
https://otpravka.pochta.ru/specification— полное описание методов, схем JSON, кодов ответов. Основной документ для разработчиков. - Портал поддержки бизнеса:
https://www.pochta.ru/support/business/api(доступ может требовать отключения VPN/прокси, ошибка 417). - Документация интегратора ApiShip:
https://docs.apiship.ru/docs/delivery-services/list-delivery-services/rupost/— хороший пример описания процесса получения ключей и настройки тарифов.
Контакты поддержки (для срочных вопросов):
- Телефон горячей линии бизнеса: 8-800— (бесплатно по РФ).
- Чат в личном кабинете «Отправка» (правый нижний угол) — самый быстрый способ для технических вопросов по API.
- Email поддержки API: api-support@*.ru (уточняйте в актуальной справке).
Резюме
Создание реестра в «Почте России» — процесс стандартизированный, но требующий внимания к деталям: корректность адресов (ФИАС), соответствие тарифов договору, своевременная печать акта 103 и ярлыков.
- Для малого бизнеса/старта: Веб-интерфейс otpravka.pochta.ru + импорт CSV.
- Для масштабирования: API интеграция (собственная или через интеграторов типа ApiShip/1С) с использованием bulk-методов и кэширования тарифов.
- Ключ к успеху: Тестирование на Sandbox, мониторинг лимитов калькулятора и актуальность данных отправителя/получателя.
Примечание: Все чувствительные данные в примерах (ИНН, телефоны, адреса, токены, номера реестров) частично замаскированы символами * в соответствии с политикой безопасности. Актуальные параметры вашего договора (скидки, лимиты, доступные тарифы) уточняйте у вашего менеджера в ПАО «Почта России».