Перейти до змісту

Нова Пошта

Щоб система могла сама створювати експрес-накладні, їй потрібен доступ до вашого Бізнес-кабінету Нової Пошти. Цей регістр і є таким доступом: один запис — один 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

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