Нова Пошта

Меню Сервіс → Інтеграції → група Доставка → картка Нова Пошта → шестерня → вікно «Підключення Нової Пошти».

Налаштування доступне адміністратору компанії на платних тарифах; переглянути перелік інтеграцій можна на будь-якому тарифі.

Що дає інтеграція

Інтеграція з Новою Поштою потрібна для продажу з накладеною оплатою: покупець платить за товар у відділенні при отриманні, гроші приходять через сервіс NovaPay, і саме в цей момент має бути виданий фіскальний чек. Без інтеграції касир мусив би або фіскалізувати чек наперед (коли грошей ще немає), або пам’ятати про кожну посилку і пробивати чек вручну.

Після підключення:

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

LEX.Торгівля не створює експрес-накладну в Новій Пошті — ТТН ви оформлюєте у бізнес-кабінеті Нової Пошти як зазвичай, а її номер вписуєте в документ реалізації. Ключ API використовується для відстеження статусу посилки.

Як це працює

1. Ви оформлюєте реалізацію і обираєте спосіб оплати з режимом NovaPay, вписуєте номер ТТН і телефон отримувача.
2. LEX.Торгівля через касу Checkbox створює проект чека, прив’язаний до цієї ТТН. Документ лишається неоплаченим.
3. Покупець отримує посилку і платить у відділенні. Checkbox фіскалізує чек і повідомляє про це LEX.Торгівлю через вебхук каси.
4. Оплата з’являється в документі, чек доступний у колонці «Оплата».
5. Якщо покупець відмовився від посилки, система бачить це при черговій перевірці статусу і позначає відправлення як скасоване. Оплата в документі не з’являється.

Що потрібно заздалегідь

• Платний тариф (Trader або E-Commerce).
• Каса ПРРО Checkbox — активна, з налаштованим підключенням і увімкненим вебхуком (див. Каси). Саме через вебхук LEX.Торгівля дізнається, що чек фіскалізовано після отримання посилки.
• Ключ API Нової Пошти з вашого бізнес-кабінету.
• Телефон компанії в картці компанії — його вимагає Checkbox як телефон відправника.
• Валюта обліку — гривня. Документ з накладеною оплатою може бути тільки у гривні.

Крок 1. Отримайте ключ API у Новій Пошті

1. Увійдіть у бізнес-кабінет Нової Пошти (my.novaposhta.ua) під обліковим записом, з якого ви створюєте експрес-накладні.
2. Відкрийте Налаштування → Безпека і створіть новий ключ API.
3. Скопіюйте ключ — це рядок із 32 латинських літер і цифр.

Ключ прив’язаний до вашого облікового запису в Новій Пошті. Якщо його видалити або перевипустити в кабінеті Нової Пошти, у LEX.Торгівлі його потрібно замінити на новий.

Крок 2. Увімкніть інтеграцію в LEX.Торгівлі

1. Відкрийте Сервіс → Інтеграції і знайдіть групу Доставка.
2. На картці Нова Пошта натисніть шестерню .
3. Вставте ключ у поле API ключ, поставте позначку Активність, натисніть Зберегти.
4. Біля назви картки з’явиться зелена позначка .

Крок 3. Вкажіть телефон компанії

Меню Компанія → Карточка компанії, поле Телефон. Без нього чек для накладеної оплати не створиться.

Крок 4. Створіть спосіб оплати для накладеної оплати

Меню Довідники → Способи оплати → Додати:

• Форма оплати — Безготівково.
• Назва — як касир побачить цей спосіб, наприклад «Нова Пошта (післяплата)».
• Фіскалізація — увімкнути. З’явиться поле Каса: оберіть касу ПРРО Checkbox.
• Засіб оплати для фіскального чека — як оплата буде названа в чеку. Виберіть зі списку «Платіж через інтегратора Novapay».
• Очікувати оплату (інтегратор NovaPay) — поставити позначку. Вона з’являється лише для форми «Безготівково» з фіскалізацією і лише коли інтеграція з Новою Поштою активна.
• Доступ для точок продажів — на яких точках цей спосіб пропонувати.

Для такого способу оплати кнопка на Терміналі недоступна: післяплата оформлюється тільки з Реалізації. Один спосіб оплати може обслуговувати одну касу ПРРО; якщо ви відправляєте посилки від кількох ФОП, заведіть окремий спосіб оплати для кожної каси.

Крок 5. Оформіть продаж

1. Продажі → Реалізація товарів та послуг → створіть документ з товарами і клієнтом.
2. Натисніть Оплата і оберіть спосіб «Нова Пошта (післяплата)». У вікні з’являться поля Номер ТТН і Телефон отримувача; телефон підставляється з картки клієнта, його можна змінити.
3. Впишіть номер експрес-накладної і натисніть OK.
4. Система покаже: «Створено проект чека для накладеної оплати. ТТН … Чек фіскалізується, коли покупець отримає посилку.»

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

• У списку реалізації документ отримує значок Нової Пошти з підписом статусу доставки. Клік по значку відкриває вікно «Відправлення Нова Пошта»: номер ТТН, сума, телефон отримувача, статус чека і поточний статус доставки за даними Нової Пошти.
• Над списком є фільтр Нова пошта: Усі, Створені (посилка в дорозі, чека ще немає), Оплачені (покупець забрав посилку, чек фіскалізовано), З відмовою (посилка повернута, очікування скасовано).
• Статуси перевіряються автоматично кожні 15 хвилин. Оновлювати щось вручну не потрібно.
• Коли чек фіскалізовано, оплата з’являється в документі і в звітах так само, як звичайна оплата картою.

Передплата плюс післяплата

Якщо покупець частину суми оплатив наперед, спочатку прийміть передплату зі звичайною фіскалізацією (кнопка «Передплата» у вікні оплати). Потім відкрийте документ, оберіть Створити на підставі → Післяплату і вкажіть спосіб оплати Нової Пошти. Сума післяплати має точно дорівнювати залишку до сплати, а передплата має бути фіскалізована — інакше система не дасть створити відправлення.

Приклад налаштування

ФОП Іваненко продає косметику через Instagram і відправляє замовлення Новою Поштою з післяплатою. У LEX.Торгівлі вже є каса ПРРО «Каса Checkbox №1» з увімкненим вебхуком, тариф — Trader.

1. Нова Пошта. У бізнес-кабінеті Нової Пошти: Налаштування → Безпека → створити ключ. Отримано ключ виду 7a1f…c9e2.
2. LEX.Торгівля, Сервіс → Інтеграції → Доставка → Нова Пошта. API ключ — вставлено, Активність — увімкнено, Зберегти. На картці з’явилась зелена позначка.
3. Компанія → Карточка компанії. Телефон — +380671234567.
4. Довідники → Способи оплати → Додати. Форма оплати — Безготівково; Назва — «Нова Пошта (післяплата)»; Фіскалізація — так; Каса — «Каса Checkbox №1»; Засіб оплати для фіскального чека — «Платіж через інтегратора Novapay»; Очікувати оплату (інтегратор NovaPay) — так; точки продажу — всі. Зберегти. Заповнене вікно виглядає так, як на скріншоті у кроці 4.
5. Замовлення. Клієнтка Марія замовила набір на 1 250,00 грн. У кабінеті Нової Пошти оформлено ТТН 20450000000001 з післяплатою 1 250,00 грн.
6. Продажі → Реалізація → Додати. Товари додано, клієнт — Марія (телефон у картці +380501112233). Оплата → «Нова Пошта (післяплата)»: Номер ТТН — 20450000000001, Телефон отримувача підставився з картки. OK.
7. Система показує «Створено проект чека для накладеної оплати. ТТН 20450000000001». У списку документ має значок Нової Пошти зі статусом «Відправлення у місті …», у фільтрі «Нова пошта» він у групі Створені. Сума в колонці «Оплата» — 0,00, документ неоплачений.
8. Через два дні Марія отримала посилку і заплатила у відділенні. Checkbox фіскалізував чек, LEX.Торгівля отримала повідомлення: у документі з’явилась оплата 1 250,00 грн способом «Нова Пошта (післяплата)», чек відкривається значком у колонці «Оплата», документ перейшов у групу Оплачені.

Якби Марія не забрала посилку, після повернення відправлення документ потрапив би у групу З відмовою, оплата не з’явилась би, а товар можна було б оприбуткувати назад поверненням від покупця або видалити документ.

Повідомлення системи і що з ними робити

• «Інтеграція з Новою Поштою не підключена або вимкнена (Сервіс → Інтеграції → Доставка)» — увімкніть «Активність» у вікні підключення Нової Пошти.
• «API ключ не заповнено» — при збереженні з увімкненою «Активністю» поле ключа порожнє.
• «Вкажіть номер ТТН», «Вкажіть телефон отримувача» — заповніть поля у вікні оплати; телефон береться з картки клієнта або вводиться вручну.
• «Вкажіть телефон відправника в картці компанії (Налаштування → Компанія)» — заповніть поле «Телефон» у картці компанії.
• «Для способу оплати «…» необхідна фіскалізація» — у способі оплати увімкніть «Фіскалізація» і оберіть касу ПРРО.
• «Спосіб оплати «…» неможливо поєднати з готівкою» — накладена оплата покриває всю суму документа; приберіть готівкову частину.
• «Для оплати через Нову Пошту валютою документа може бути тільки Гривня» — створіть документ у гривні.
• «Документ уже очікує оплату Нової Пошти (ТТН …)» — для документа вже створено відправлення; друге створити не можна, поки перше не оплачене або не скасоване.
• «Передоплата за документом не була фіскалізована — післяплата через Нову Пошту неможлива», «Сума післяплати повинна дорівнювати залишку до сплати» — див. розділ «Передплата плюс післяплата».
• Позначки «Очікувати оплату (інтегратор NovaPay)» немає у способі оплати — перевірте, що форма оплати «Безготівково», фіскалізація увімкнена, а інтеграція з Новою Поштою активна.

Важливо

Активна каса Checkbox з вебхуком — обов’язкова умова: без вебхука LEX.Торгівля не дізнається, що чек фіскалізовано, і оплата в документі не з’явиться. Налаштування доступне лише на платних тарифах; на Free сторінка «Інтеграції» показує картку, але замість шестерні стоїть замок. Налаштування доступне лише на платних тарифах; на Free сторінка «Інтеграції» показує картку, але замість шестерні стоїть замок. Після натискання «Від’єднати» автоматична перевірка статусів посилок зупиняється, а режим NovaPay у способах оплати стає недоступним. Документ, для якого створено проект чека, не редагується до оплати або скасування відправлення.

Вікно «Підключення Нової Пошти»:

• Активність — увімкнути підключення. Без позначки ключ зберігається, але інтеграція не працює: режим NovaPay у способах оплати недоступний, статуси не перевіряються.
• API ключ — ключ із бізнес-кабінету Нової Пошти (Налаштування → Безпека). Обов’язковий при увімкненій «Активності».

Кнопки: Зберегти — зберегти і закрити; Скасувати — закрити без змін; Від’єднати — очистити ключ і вимкнути підключення.

Пов’язані поля в інших розділах:

• Довідники → Способи оплати: позначка Очікувати оплату (інтегратор NovaPay) — для форми «Безготівково» з фіскалізацією.
• Продажі → Реалізація → Оплата: Номер ТТН, Телефон отримувача — з’являються при виборі способу оплати з режимом NovaPay.
• Компанія → Карточка компанії: Телефон — телефон відправника для чека.