Як підключити акаунт Нової Пошти, створити експрес-накладну з відвантаження, надрукувати її й отримати оплату за накладеним платежем в обліку автоматично.

Що це і навіщо

Інтеграція з Новою Поштою дозволяє створювати експрес-накладні (ЕН, ТТН) прямо з картки відвантаження: дані отримувача, вагу й вартість система підставляє сама, ви лише обираєте відділення чи адресу. Далі можна друкувати накладну й наліпку, відстежувати статус, а якщо клієнт платить накладеним платежем — автоматично оформити оплату в обліку, коли Нова Пошта виплатить гроші.

Де знайти

Підключення й налаштування: Налаштування → Інтеграції → Нова Пошта, адреса /settings/integrations/novaposhta. Плитка так і підписана: «Створення ТТН, відстеження та розрахунок вартості доставки».
Робота з накладними: картка відвантаження (Відвантаження), режим зв'язків, блок «Нова Пошта».

Крок 1. Додати акаунт Нової Пошти

Підключення — це акаунт вашої компанії в Новій Пошті. Таких акаунтів може бути кілька (наприклад, різні юрособи чи склади).

У кабінеті Нової Пошти створіть API-ключ: Налаштування → Безпека (це підказка з самого вікна).
У Silium на сторінці «Нова Пошта» натисніть «Додати акаунт». Поки акаунтів немає, сторінка каже «Немає підключених акаунтів Нової Пошти».
У вікні «Додати акаунт Нової Пошти» заповніть:
- Назва акаунта — будь-яка ваша назва, для зручності;
- API-ключ — обов'язково («Вкажіть ключ»).
Натисніть «Зберегти». Система перевіряє ключ у Новій Пошті; неправильний ключ — «Невалідний API-ключ Нової Пошти». Успіх — тост «Акаунт додано».

У таблиці акаунтів: Назва, API-ключ (замаскований), Відправник (місто й відділення або жовтий напис «не налаштовано»), Створено. Кнопка «Налаштувати» відкриває налаштування акаунта, значок кошика видаляє акаунт (питання «Видалити акаунт Нової Пошти?», тост «Акаунт видалено»).

Крок 2. Налаштувати акаунт

Без цього кроку накладну створити не вдасться. Натисніть «Налаштувати» біля акаунта — відкриється вікно «Налаштування: назва».

Відправник за замовчуванням

Поле	Що вибрати
Контрагент-відправник	Ваша організація або ФОП із кабінету Нової Пошти (список підтягується з НП).
Контактна особа	Хто від вашого імені передає посилку. Обрана особа підставляє свій телефон.
Місто відправника	Пошук міста за назвою.
Відділення відправника	Відділення, звідки ви відправляєте. Спершу оберіть місто.
Телефон відправника	Телефон для накладної.

Якщо відправник не налаштований повністю, при створенні ЕН система скаже: «Спершу налаштуйте відправника за замовчуванням у налаштуваннях акаунта НП».

Контроль оплати (COD)

Каса для зарахування переказу (UAH) — каса Silium, на яку буде проведено оплату, коли Нова Пошта виплатить вам накладений платіж. Без неї при виплаті буде помилка «у акаунті НП не задана каса для зарахування». Каса має бути в гривні.

Дефолти вантажу

Значення, які підставляються у форму накладної. Змінити їх можна в кожній накладній окремо: Тип вантажу (Посилка, Вантаж, Документи, Шини-диски, Палети), Вага, кг, Місць, Ширина / Висота / Довжина, см, Платник за доставку (Отримувач або Відправник) і Форма оплати (Готівка або Безготівка). Після «Зберегти» — тост «Налаштування збережено».

Крок 3. Створити накладну (ЕН)

Відкрийте картку відвантаження і перейдіть до зв'язків. Блок «Нова Пошта» має кнопку «Створити ЕН» (+). Якщо акаунтів немає, вікно підкаже: «Спершу додайте акаунт Нової Пошти у Налаштування → Інтеграції → Нова Пошта».
Відкриється вікно «Створити ЕН (Нова Пошта)». Дані отримувача (ім'я, телефон), вартість і вага підставляються з відвантаження та рахунка.
Заповніть або перевірте поля (розділ нижче), за потреби натисніть «Розрахувати вартість» і збережіть.
Тост «ЕН створено: номер накладної». Накладна з'явиться у таблиці блоку.

Поля вікна

Секція / поле	Що це
Акаунт	З'являється, лише якщо у вас кілька акаунтів.
Отримувач: Телефон	Обов'язково. Кнопка «Знайти» шукає людину за телефоном у вашій базі й у самій Новій Пошті; клік по знайденому підставляє ім'я та збережені адреси доставки.
Прізвище, Імʼя	Прізвище обов'язкове, якщо отримувача не вибрано із Нової Пошти.
Збережені адреси	Якщо відомі раніше використані адреси отримувача, вони показані кнопками «місто: відділення». Клік підставляє її.
Доставка	Перемикач: Відділення, Поштомат або Курʼєр (адреса).
Місто	Пошук міста Нової Пошти.
Відділення / Поштомат	Вибір з переліку міста. Для кур'єра замість цього — Вулиця, Будинок, Квартира.
Тип, Вага, кг, Місць, Оцінка, грн	Вантаж. «Оцінка» — оголошена вартість, обов'язкова. Вага обов'язкова.
Опис відправлення	Типово «Товари».
Габарити місця	Ширина, Висота, Довжина (см) і Вага місця (кг). Для поштомата габарити обов'язкові.
Платник за доставку, Форма оплати	Хто платить за перевезення та готівкою чи безготівково.
Накладений платіж (грошовий переказ)	Галочка. Якщо ввімкнена, з'являються Сума, грн і Платник комісії (Отримувач/Відправник). Це гроші, які одержувач заплатить на пошті, а Нова Пошта переведе вам.
Розрахувати вартість	Показує «Доставка: X грн · до дата» без створення накладної.

Повідомлення перевірки

«Оберіть акаунт Нової Пошти», «Вкажіть телефон отримувача», «Вкажіть прізвище отримувача», «Оберіть місто», «Оберіть відділення/поштомат», «Вкажіть вулицю та будинок», «Вкажіть вагу», «Вкажіть оголошену вартість», «Для поштомата вкажіть габарити». Помилки самої Нової Пошти показуються як є (наприклад, «Отримувач НП: …»).

Робота з накладними в картці відвантаження

Таблиця блоку «Нова Пошта»: ТТН, Статус, Отримувач, COD (сума накладеного платежу, галочка ✓ після проведення оплати). Порожньо: «Немає накладних Нової Пошти».

Клік по номеру ТТН копіює його («Номер скопійовано»).
Значок принтера — «Друк ЕН» (PDF накладної), штрихкод — «Друк маркування» (наліпка 100×100).
Значок стрілок — «Оновити статус». Статус автоматично не оновлюється, його треба перепитувати цією кнопкою.
✕ — видалити накладну (питання «Видалити накладну в Новій Пошті?», тост «ЕН видалено»). Накладна видаляється і в самій Новій Пошті, тому це можливо лише до приймання посилки. Якщо по накладній вже проведено оплату — «ЕН має проведений платіж — видалення заборонено».

Що відбувається в обліку

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

Виняток — накладений платіж (COD). Коли ви натискаєте «Оновити статус» і Нова Пошта повідомляє, що «грошовий переказ виплачено» (код статусу 11), Silium автоматично створює платіж на суму, фактично виплачену Новою Поштою:

Гроші надходять на касу, обрану в налаштуваннях акаунта («Каса для зарахування переказу»).
Платіж проводиться за рахунком відвантаження й закриває борг клієнта. Проводка стандартна для оплати: Дт 311 (каса) — Кт 361 (розрахунки з покупцями), категорія платежу — «702».
Платіж має назву «НП номер-накладної» й опис «Контроль оплати Нова Пошта, ЕН …».
Тост «Статус оновлено, оплату проведено», у колонці COD з'являється ✓.

Приклад: рахунок на 2 400,00 грн, відправлено з накладеним платежем 2 400,00 грн. Клієнт заплатив на пошті, НП перерахувала гроші й змінила статус. Ви натискаєте «Оновити статус» — у касі +2 400,00 грн, а борг клієнта за рахунком закрито. Повторне натискання платіж не дублює.

Комісія Нової Пошти при цьому автоматично не списується — її, за потреби, внесіть окремо як витрату (Операції).

Якщо оплату створити не вдалося, ви побачите «Статус оновлено, але оплату не проведено: …», наприклад «COD: у акаунті НП не задана каса для зарахування» або пояснення від бізнес-правил (закритий період, каса іншої юрособи). Виправте причину й натисніть «Оновити статус» ще раз.

Права доступу

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

Типові питання

«Спершу налаштуйте відправника…» — заповніть усі поля відправника в налаштуваннях акаунта (контрагент, контакт, місто, відділення, телефон).
Не вдається знайти місто чи відділення. Пошук починається після введення щонайменше двох символів; спробуйте початок назви.
Оплату за COD не проведено. Перевірте, що статус Нової Пошти — «виплачено», що в акаунті вказана каса й що натиснуто «Оновити статус».
Реєстри відправлень. У поточному інтерфейсі окремого екрана реєстрів немає.

Нова Пошта: накладні та накладений платіж