Интеграция с Новой Почтой
Пошаговая инструкция для менеджера: как подключить API Новой Почты в CatPro, сохранить параметры отправителя, создавать ТТН из заказов и контролировать статусы доставки.
1) Где находится интеграция
- Откройте Мой Бизнес → Интеграции.
- Найдите блок Новая Почта.
- В этом блоке хранится API key, настраивается отправитель и есть тестовый инструмент для проверки городов/отделений и создания ТТН.
2) Подключение API (первый запуск)
- Вставьте API Key Новой Почты в поле API Key (Новая Почта).
- Нажмите Сохранить.
- Нажмите Тест подключения.
- Если всё правильно — CatPro покажет сообщение об успешном подключении.
Если тест не проходит — проверьте, что ключ сохранён и активен (корректные права в НП).
3) Поиск городов и отделений (проверка API)
- В блоке Поиск городов и отделений введите название города.
- Выберите город из списка.
- Нажмите Найти возле поля отделений (или Enter).
- Выберите отделение/почтомат из списка.
Этот блок помогает проверить, что API key работает и данные НП подтягиваются корректно.
4) Сохранение отправителя (обязательно перед ТТН)
Без сохранённого отправителя создание ТТН из заказов работать не будет.
- Отправитель (Counterparty) — загружается кнопкой Обновить.
- Контактное лицо НП (Ref) — загружается кнопкой Загрузить.
- Город / Отделение отправителя — выбираются в блоке поиска.
- Контакт и Телефон отправителя.
После заполнения нажмите Сохранить отправителя.
5) Тестовое создание ТТН в разделе Интеграции
- Заполните данные получателя (ФИО, телефон, город, отделение).
- Заполните параметры отправления (вес, стоимость, места, описание).
- Нажмите Создать ТТН (тест).
- CatPro покажет номер ТТН, Ref и ответ API.
Внимание
- Это реальный API-запрос. Если данные реальные — ТТН может быть создана в НП.
6) Создание ТТН из заказа (рекомендуется)
- Перейдите в Мой Бизнес → Заказы.
- В строке заказа нажмите кнопку 🚚 (Новая Почта ТТН).
- Проверьте автоматически подставленные данные получателя.
- Проверьте/выберите город и отделение получателя.
- Нажмите Создать ТТН.
После успешного создания ТТН сохраняется локально в заказе и отображается в таблице заказов.
7) Автоподбор города и отделения получателя
- CatPro пытается найти город по shipping_address_city.
- Затем подбирает отделение по тексту адреса shipping_address_street.
- После автоподбора можно вручную выбрать другой вариант из списка.
Автоподбор экономит время, но перед созданием ТТН убедитесь, что выбрано правильное отделение.
8) Статусы ТТН в заказах
- В таблице заказов есть столбец ТТН.
- Отображается: номер, статус, дата доставки (если есть) и стоимость НП (если есть).
Цвета статусов:
зелёный — доставлено / вручено;
синий — в пути / транзит;
жёлтый — создано / оформлено;
красный — проблема / возврат.
зелёный — доставлено / вручено;
синий — в пути / транзит;
жёлтый — создано / оформлено;
красный — проблема / возврат.
9) Быстрые действия с ТТН
- Скопировать ТТН — копирует номер в буфер.
- Трекинг НП — открывает страницу отслеживания.
- Обновить статус — запрашивает актуальный статус через API.
10) Типовые причины ошибок и что проверить
Наиболее частые причины
- Не задан API key — сохраните ключ в Интеграциях.
- Не сохранён отправитель — Counterparty, Contact Ref, город, отделение, телефон.
- Ошибка API при создании — проверьте город/отделение, телефон, параметры груза.
- Неверный автоподбор — выберите отделение вручную.
Совет: сначала проверьте API key и сохраните отправителя, и только потом переходите к ТТН в заказах.