Новая Почта

Модуль-мост к Бизнес-кабинету перевозчика. Учёта доставки в бухгалтерском смысле он не ведёт — его работа в том, чтобы экспресс-накладная создавалась прямо из документа, а её статус сам приезжал обратно в систему: «прибыла в отделение», «получена», «вернулась».

Особенность модуля видна уже по составу: из двенадцати регистров одиннадцать — это справочники, загруженные из API Новой Почты. Города, отделения, типы груза, виды упаковок, виды плательщиков — всё это живёт не у вас, и заводить его руками не нужно. Ваша часть — одна запись с ключом доступа и данными отправителя.

Маршрут: от ключа до статуса накладной

НП Настройка (включить модуль, отправитель по умолчанию, валюта, наложенный платёж)
        ↓
Карточка кабинета «Новая Почта»: API-ключ + кто и откуда отправляет
        ↓
Служба загрузки данных → города · отделения · регионы · типы груза · упаковки
        ↓
Документ продажи → создание экспресс-накладной (получатель из документа)
        ↓
Обновление статусов ЭН — служба спрашивает перевозчика, что с посылками

НП Настройка — одно окно на компанию: включает модуль в документах и задаёт то, что не принадлежит отдельному кабинету — кабинет по умолчанию, валюту, способ передавать наложенный платёж.
Новая Почта — карточка кабинета: одна запись = один API-ключ плюс данные отправителя. Здесь заводят себя, а не клиентов.
Новая Почта в «Обслуживании» (не путать с одноимённым регистром) — служба загрузки данных, наполняющая справочники модуля. Пока она не отработала, в полях документов не из чего будет выбирать.
Справочники адреса: города → отделения (с типами), регионы.
Справочники отправления: типы груза, виды упаковок, виды паллет, виды плательщиков и отдельно для обратной доставки — типы груза и плательщики.
Обновление статусов ЭН Новой Почты — служба обходит накладные отгрузок и ТТН и записывает свежий статус в документ.

Что важно понимать

Справочники не заполняют руками. Их привозит служба загрузки, она же обновляет. Самый большой из них — отделения: в демо-базе больше двадцати тысяч записей, они грузятся отдельным потоком, страницами, и это самая долгая часть загрузки. «Нет моего отделения» почти всегда означает устаревшую загрузку, а не ошибку перевозчика.

Карточка кабинета — это вы как отправитель. От чьего имени, из какого города и отделения едут посылки, кто платит за доставку. Получателя система берёт из документа.

Контрагенты приезжают из кабинета, а не из вашей базы. Там лежат получатели и третьи лица — те типы, которые хранит Бизнес-кабинет. Отправители живут отдельно: их тянет кнопка в карточке кабинета.

Разделение ролей между настройкой и карточкой. Карточка отвечает на вопрос «откуда и от кого едет посылка», настройка — «каким кабинетом пользоваться по умолчанию и как считать деньги». Путаница здесь даёт посылки от чужого отправителя.

Статус накладной живёт своей жизнью. Он меняется на стороне перевозчика, и система узнаёт об этом, только когда отработает служба обновления. Её ставят в расписание — иначе в документах будут вчерашние статусы.

Кабинетов может быть несколько. Одна запись — один ключ; так в системе сосуществуют несколько отправителей или несколько юридических лиц.

С чего начать в новой базе

НП Настройка — включить модуль в документах.
Карточка кабинета — API-ключ из Бизнес-кабинета и данные отправителя.
Служба «Новая Почта» — первая загрузка данных, самая долгая; после неё справочники наполнятся.
Создать пробную экспресс-накладную из документа и убедиться, что выбор города и отделения работает.
Поставить Обновление статусов ЭН Новой Почты в расписание.

Частые задачи

Нужно	Куда идти
подключить Бизнес-кабинет	Новая Почта
включить модуль в документах	НП Настройка
обновить города и отделения	Обслуживание → Новая Почта
узнать, где посылка	Обновление статусов ЭН Новой Почты
найти отделение	НП Отделения · НП Города
посмотреть получателей из кабинета	НП Контрагенты
настроить наложенный платёж	НП Настройка · виды плательщиков обратной доставки

Все объекты модуля

Справочники доступа: Новая Почта · НП контрагенты

Справочники адреса: НП города · НП отделения · НП типы отделения · НП регионы

Справочники отправления: НП типы груза · НП виды упаковок · НП виды паллет · НП виды плательщиков · НП типы груза обратной доставки · НП виды плательщиков обратной доставки

Настройки: НП настройка

Служебные операции: Новая Почта (загрузка данных) · обновление статусов ЭН Новой Почты

Куда смотреть дальше

Счета клиентам — получатель и его отделение для доставки Новой Почтой (вкладка «Новая Почта» счёта). Саму экспресс-накладную в Новой Почте создаёт пункт «Создать экспресс накладную (НП)» — в отгрузке или в документе ТТН. Документ ТТН создают пунктом «Создать ТТН» в отгрузке или в счёте-фактуре, выписанном не из заказа и с галочкой «Обновлять склад»; сам этот пункт в Новую Почту ничего не отправляет.
Склад — отгрузка, которая едет к клиенту.
Prom · Розетка — маркетплейсы, заказы которых чаще всего и возят Новой Почтой.