Перейти к содержанию

Новая Почта

Чтобы система могла сама создавать экспресс-накладные, ей нужен доступ к вашему Бизнес-кабинету Новой Почты. Этот реестр и есть такой доступ: одна запись — один API-ключ плюс данные отправителя, которые будут подставляться в каждую накладную.

Где искать: Модули → Новая Почта → Регистры → Новая Почта

Здесь заводят не получателей и не клиентов, а себя как отправителя: от чьего имени, из какого города и отделения едут посылки, кто платит за доставку. Получателя система возьмёт из документа, а всё остальное — отсюда.

Меню: Модули → Новая Почта → Регистры → Новая Почта.

Разбор на примере

Карточка кабинета Новой Почты

В демо заведён один кабинет: Код 1 (проставляет система), Название «Кабинет Новой Почты», Api Ключ и Api Ключ срок — до 31.12.2027.

Дальше — блок отправителя: Отправитель «Инструмент-Сервис, ООО», Город «Київ», Отделение 1, а справа от номера система сама подставила его описание — «Відділення №1: вул. Пирогівський шлях, 135». Поля с пометкой «(ссылка)» хранят внутренние идентификаторы Новой Почты — заполняются автоматически, руками их не трогают.

Ниже — параметры отправления по умолчанию: Тип груза Cargo, Описание груза «Ручной и электроинструмент», Плательщик «Відправник», Страховая стоимость 500,00, Тип груза обратной доставки «Грошовий переказ», Плательщик2 «Одержувач». Последние два — про деньги, которые едут назад: наложенный платёж и кто платит за его пересылку.

Вкладка Контрагенты — контактные лица отправителя с телефонами и почтой. Именно из этого списка выбирается поле «Отправитель»: в накладной должен стоять живой человек с телефоном, потому что Новая Почта звонит именно ему.

Где взять ключ

Ключ создают в Бизнес-кабинете Новой Почты: Настройки → Безопасность → Мои ключи API.

Ключи API в Бизнес-кабинете Новой Почты

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

При сохранении карточки с новым, только что набранным ключом система обращается к Новой Почте и проверяет его. Если Новая Почта ключ не принимает — он неверный, просроченный или отозванный, — запись не сохранится: вы увидите «Недействительный ключ API!». Сбой связи или другой отказ Новой Почты сохранение не останавливает, а уже сохранённый ключ при следующих сохранениях не проверяется.

Кнопка «Получить данные контрагента»

В меню записи (кнопка с полосками рядом с «Печать») есть пункт Получить данные контрагента. Он работает только на сохранённой записи с ключом и делает сразу несколько вещей:

  • спрашивает у Новой Почты список ваших контрагентов-отправителей и берёт первого из них;
  • подтягивает его контактных лиц во вкладку «Контрагенты»;
  • заполняет Название, Отправит.(ссылка), Отправителя (это первое контактное лицо из списка) и Город.

Два следствия, о которых стоит знать заранее. Во-первых, кнопка перезаписывает эти поля — если вы что-то вписали руками, оно исчезнет. Во-вторых, город приходит в русском написании, потому что так его отдаёт Новая Почта; если для этого города у неё такого названия нет, поле останется пустым и город придётся выбрать самому.

Откуда берутся данные

  • Город выбирается из справочника НП Города, Отделение — из НП Отделения, причём список отделений уже отфильтрован по выбранному городу.
  • Тип груза хранится кодом Новой Почты (Cargo, Parcel, Documents, Pallet, TiresWheels) — поэтому в поле видна латиница. А Плательщик и Тип груза обратной доставки хранятся названием («Відправник», «Грошовий переказ»).
  • Сами справочники наполняет служба загрузки данных — пока она не отработала, в полях не будет из чего выбирать.

Поля

Поле Описание
Код Номер карточки, проставляет система
Название Название кабинета; кнопка «Получить данные контрагента» перезаписывает его названием контрагента из НП
Api Ключ Ключ из Бизнес-кабинета НП (Настройки → Безопасность)
Api Ключ срок Дата, до которой ключ действует. Справочное поле — система за ним не следит
Отправит.(ссылка), Город(ссылка) Внутренние идентификаторы НП, заполняются автоматически
Отправитель Контактное лицо-отправитель; выбирается из вкладки «Контрагенты»
Город Город отправления
Отделение Номер отделения; описание рядом подставляется само
Тип груза Груз, посылка, документы, паллеты, шины-диски
Описание груза Текст, который попадает в накладную как описание содержимого
Плательщик Кто платит за доставку: отправитель, получатель или третье лицо
Страховая стоимость Оценочная стоимость по умолчанию
Тип груза обратной доставки Что едет назад: денежный перевод или документы
Плательщик2 Кто платит за обратную доставку
Вкладка «Контрагенты» Контактные лица: фамилия, имя, отчество, телефон, email

Типичные ситуации

  • Накладная не создаётся, система просит заполнить поля. Для работы нужны все шесть: Город, Отделение, Тип груза, Плательщик, Тип груза обратной доставки, Плательщик2. Пустое поле остановит создание экспресс-накладной, даже если ключ правильный.
  • Ключ просрочен. Просроченный ключ карточка не примет — «Недействительный ключ API!». Если же срок истёк уже после сохранения, карточка по-прежнему сохраняется (сохранённый ключ не проверяется), а споткнётесь позже: кнопка «Получить данные контрагента», служба загрузки справочников и создание накладной получат от Новой Почты отказ. Создайте новый ключ в кабинете НП и замените его в карточке.
  • Кабинетов несколько. Записей в реестре может быть сколько угодно, но служба загрузки справочников берёт ключ из первой записи. Держите рабочий кабинет первым — иначе справочники будут обновляться под чужим ключом.
  • Несколько компаний в одной базе. Карточка принадлежит компании: у каждой свой ключ и свой отправитель. Данные одной компании в другой не видны.

Список кабинетов

Ключ — «только для записи», как пароль: после сохранения его не показывают ни окно (там только маска «••••••••»: ключ задан; набранный новый ключ заменит старый, а стёртая маска — удалит его), ни список (там код, название и отправитель), ни печать, ни MCP; в базе он зашифрован. Доступ к реестру всё равно стоит давать не всем: кто может изменить ключ или отправителя, тот решает, от чьего имени едут посылки.

Рядом

Переменные печати

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

Поля заголовка:

Переменная Что подставляется
NovaPoshta_Code Код
NovaPoshta_Name Название
NovaPoshta_ApiKeyTerm Api Ключ срок
NovaPoshta_SenderLink Отправит.(ссылка)
NovaPoshta_Sender Отправитель
NovaPoshta_CityRef Город(ссылка)
NPCtDesc Город (название)
NPCargTypRef Тип груза (код)
NPCargTypDesc Тип груза (название)
NPPayType_Ref Плательщик (код)
NPPayType_Desc Плательщик (название)
NovaPoshta_InsuredValue Страховая стоимость
NPBDCT_Ref Тип груза обратной доставки (код)
NPBDCT_Desc Тип груза обратной доставки (название)
NPPayType_Ref2 Плательщик2 (код)
NPPayType_Desc2 Плательщик2 (название)
NovaPoshta_ApiKey Api Ключ

Поля строк:

Переменная Что подставляется
MNo Номер позиции строки
MLastName Фамилия
MFirstName Имя
MMiddleName Отчество
MPhones Телефон
MEmail Email

Записи, на которые документ ссылается полями формы (склад, клиент, валюта…), дают в шаблон и остальные свои переменные — код и название уже названы в таблицах выше, остальное описано в статье справочника: