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

Нова Пошта

Модуль-міст до Бізнес-кабінету перевізника. Він не веде обліку доставки в бухгалтерському сенсі — його робота в тому, щоб експрес-накладна створювалася прямо з документа, а її статус сам приїжджав назад у систему: «прибула у відділення», «отримана», «повернулась».

Особливість модуля видно вже за складом: з дванадцяти реєстрів одинадцять — це довідники, завантажені з API Нової Пошти. Міста, відділення, типи вантажу, види упаковок, види платників — усе це живе не у вас, і заводити його руками не треба. Ваша частина — один запис із ключем доступу й даними відправника.

Маршрут: від ключа до статусу накладної

НП Налаштування (увімкнути модуль, відправник за замовчуванням, валюта, накладений платіж)
        ↓
Картка кабінету «Нова Пошта»: API-ключ + хто і звідки відправляє
        ↓
Служба завантаження даних → міста · відділення · регіони · типи вантажу · упаковки
        ↓
Документ продажу → створення експрес-накладної (одержувач із документа)
        ↓
Оновлення статусів ЕН — служба питає перевізника, що з посилками
  1. НП Налаштування — одне вікно на компанію: вмикає модуль у документах і задає те, що не належить окремому кабінету — кабінет за замовчуванням, валюту, спосіб передавати накладений платіж.
  2. Нова Пошта — картка кабінету: один запис = один API-ключ плюс дані відправника. Тут заводять себе, а не клієнтів.
  3. Нова Пошта у «Службах» (не плутати з однойменним регістром) — служба завантаження даних, що наповнює довідники модуля. Поки вона не відпрацювала, у полях документів не буде з чого вибирати.
  4. Довідники адреси: міста → відділення (з типами), регіони.
  5. Довідники відправлення: типи вантажу, види упаковок, види палет, види платників і окремо для зворотної доставки — типи вантажу та платники.
  6. Оновлення статусів ЕН Нової Пошти — служба обходить накладні відвантажень і ТТН і записує свіжий статус у документ.

Що важливо розуміти

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

Картка кабінету — це ви як відправник. Від чийого імені, з якого міста й відділення їдуть посилки, хто платить за доставку. Одержувача система бере з документа.

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

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

Статус накладної живе своїм життям. Він змінюється на боці перевізника, і система дізнається про це лише коли відпрацює служба оновлення. Її ставлять у розклад — інакше в документах будуть учорашні статуси.

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

З чого почати в новій базі

  1. НП Налаштування — увімкнути модуль у документах.
  2. Картка кабінету — API-ключ із Бізнес-кабінету й дані відправника.
  3. Служба «Нова Пошта» — перше завантаження даних, найдовше; після нього довідники наповняться.
  4. Створити пробну експрес-накладну з документа й переконатися, що вибір міста й відділення працює.
  5. Поставити Оновлення статусів ЕН Нової Пошти у розклад.

Часті задачі

Треба Куди йти
підключити Бізнес-кабінет Нова Пошта
увімкнути модуль у документах НП Налаштування
оновити міста й відділення Служби → Нова Пошта
дізнатися, де посилка Оновлення статусів ЕН Нової Пошти
знайти відділення НП Відділення · НП Міста
подивитися одержувачів із кабінету НП Контрагенти
налаштувати накладений платіж НП Налаштування · види платників зворотної доставки

Усі об'єкти модуля

Довідники доступу: Нова Пошта · НП контрагенти

Довідники адреси: НП міста · НП відділення · НП типи відділення · НП регіони

Довідники відправлення: НП типи вантажу · НП види упаковок · НП види палет · НП види платників · НП типи вантажу зворотної доставки · НП види платників зворотної доставки

Налаштування: НП налаштування

Службові операції: Нова Пошта (завантаження даних) · оновлення статусів ЕН Нової Пошти

Куди дивитися далі

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