Нова Пошта

1Налаштування

Налаштовує адміністратор. Дорога: «Налаштування» → «Інтеграції» → вкладка «Перевізники» → картка «Нова Пошта». Картка одразу відкриває вкладку «Налаштування»; поруч — «Підключення».

1. Ключ. Найпростіше — у «Налаштування» → «Акаунти» (розділ 2): кожен акаунт має свій «API ключ». Ключ береться в особистому кабінеті: my.novaposhta.ua → Налаштування → Безпека. У «Підключенні» є ще загальний «API ключ» картки — він діє, коли акаунтів нема.
2. Перевірка. «Перевірити» (у «Підключенні» або в картці акаунта) читає довідник відправників; успіх — «відправник: <назва>». У картці акаунта перевірка ще й підставляє знайденого відправника в порожні поля.
3. Увімкнення. Блок «Інтеграція» → «Увімкнути інтеграцію»: створювати ТТН і трекати відправлення цієї служби з угод.
4. Зберегти. Унизу липка панель «Скасувати зміни» / «Зберегти»; стан «Є незбережені зміни» / «Змін немає». Зберігати може лише адміністратор. Ключ акаунта зберігається окремо одразу кнопкою «Зберегти ключ».

Ключі зберігаються зашифрованими і назад не показуються — лише «задано (••••ca93)».

2Акаунти відправників і доступи

1. «Акаунти» → «+ Додати акаунт» → «Назва акаунта (як підписати відправника)» → «Додати». Незбережені зміни сторінки перед цим зберігаються.
2. Натисніть рядок акаунта — він розгорнеться: перемикач «Увімкнено», «Перевірити», «Прибрати акаунт».
3. Групи полів акаунта:
   • «Акаунт» — «Назва»: як підписати відправника у списку акаунтів і формі ТТН (можна змінити будь-коли, потім «Зберегти»);
   • «Доступ до API» — «API ключ»;
   • «Відправник» — «Відправник» і «ПІБ відправника» вибираються зі списку кабінету Нової Пошти (список підтягується ключем акаунта сам, кнопка «Оновити список»; обрали ПІБ — «Телефон» підставляється), «Телефон», «Місто» (з довідника Нової Пошти), «Відділення відправки». Поки ключа нема або Нова Пошта не відповідає — поля вписуються вручну, під ними підказка чому;
   • «Відправлення за замовчуванням» — «Метод доставки» (Відділення-Відділення, Відділення-Двері, Двері-Відділення, Двері-Двері), «Тип вантажу», «Платник доставки», «Платник комісії за післяплату», «Опис вантажу», «Номер пакування», «Форма оплати», «Контроль оплати»;
   • «Додаткова інформація» — що писати у внутрішній номер ТТН саме цього відправника: «Як у налаштуваннях картки», «Не заповнювати внутрішній номер відправлення», «Розмістити ID угоди…», «Розмістити назву угоди…», «Розмістити інформацію з поля товару…»;
   • «Розмір і вага відправлення» — довжина, ширина, висота, загальна вага, «Загальний об'єм (м³)» (0 — рахується з габаритів).
4. Доступи. Блок «Доступи · <акаунт>»: після додавання акаунта доступу нема ні в кого. Поставте «Показати» тим, хто створює ТТН цим відправником. Без галочки акаунта не видно у формі ТТН; адміністратор бачить усі. ШІ-співробітники в списку позначені «ШІ».
5. «Прибрати акаунт» — ключі й дефолти форми зникають, угоди лишаються.

У рядку акаунта видно стан: «без ключа», «увімкнено» або «вимкнено».

3Що писати в ТТН: додаткова інформація, місця, габарити

• «Додаткова інформація»: «Без автогенерації», «Назва товару», «Артикул і кількість», «Назва товару і кількість» або «Шаблон» (доступні {deal.title}, {deal.id}, {items}).
• «Внутрішній номер відправлення»: «Не заповнювати», «ID угоди», «Назва угоди» або «Поле товару». Акаунт може мати свій вибір («Додаткова інформація» в акаунті, розділ 2) — він головніший.
• «Супроводжуючі документи»: текст.
• «Тип отримання грошей» за замовчуванням: «Без зворотної доставки» або «У відділенні» (пов'язане поле угоди, розділ 4, головніше).
• «Кількість місць»: «На основі кількості товарів», «Фіксована кількість» або «З поля товару».
• «Вага й габарити з товарів»: галочка «Заповнювати вагу й габарити посилки з товарів угоди» — посилка рахується з товарів угоди й кількості, а не з акаунта (Доставки і ТТН, 3а).
• «Розмір відправлення»: «Загальні параметри відправлення» або «Заповнити кожне місце окремо»; галочки «Увімкнути параметри відправлень для вибору» (у формі ТТН — список збережених габаритів) і «Заповнити контроль оплати, якщо без зворотної доставки».

4Пов'язані поля угоди

Блок «Пов'язані поля»: з яких полів угоди брати «Місто», «Відділення», «Одержувач», «Телефон» у форму ТТН (наприклад, з полів замовлення Prom чи Rozetka). Порожньо — з клієнта й адреси доставки угоди. Якщо в «Місто» чи «Відділення» обрано поле з повною адресою (наприклад, «Адреса доставки (prom)» — «Київ, Відділення №25 (до 30 кг): вул. …»), у форму йдуть розібрані місто й № відділення, а не весь рядок; адреса без номера відділення поле не заповнює. Поле може містити всю адресу маркетплейсу — як «Адреса доставки (prom)»: «м. Черкаси (Черкаська обл.), №7 (до 30 кг на одне місце): вул. Петра Дорошенка, 7». Тоді в «Місто» йде лише місто («Черкаси», з областю для вибору зі списку), у «Відділення» — номер («7»), і шторка одразу вибирає їх зі списку Нової Пошти. Так налаштовано й типово (як у KeepinCRM): «Місто» і «Відділення» ← «Адреса доставки (prom)». «Тип отримання грошей» — поле-список угоди і таблиця «Значення для типу отримання грошей» → «Тип оплати» (Без зворотної доставки / У відділенні / Накладений платіж), «+ Додати».

5Статус доставки → етап угоди

• «Пов'язані статуси»: «Зовнішній статус» → «Етап» (наприклад, «Відправлення отримано» → «Виграно», «Відмова» → «Повернення»). Без рядка етап не змінюється. Статуси Нової Пошти з датою підтримують шаблони та «починається з». Тексти зі списку (з довідки API НП) зіставляються за кодом статусу: НП пише інакше («Прибув у відділення», «Відправлення прямує до м. Фастів.»), і рядок «Прибув на відділення» чи «Відправлення прямує до міста YYYY.» спрацьовує саме за кодом. Назви з KeepinCRM («Отримано», «Прибуло у відділення», «Відмова») теж спрацьовують — під рядком видно, на які статуси НП; рядок без відповідника позначено.
• «Міняти етап, коли посилка» (16.10): етап за статусом міняється лише на позначених станах посилки — типово «відправлена / в дорозі», «у відділенні», «отримана», «повернення». Поки посилка «створена, ще не відправлена», етап стоїть, навіть якщо для такого статусу є рядок; щоб і він діяв, позначте «створена, ще не відправлена».
• Той самий статус можна зв'язати з етапами різних воронок, як у KeepinCRM: «Відправлення отримано» → «Отримано [Продажі]» і → «Отримано Покупцем [Дропшипери продаж]». Угода переходить на етап своєї воронки. Якщо статус зв'язаний лише з етапами інших воронок (кількох) — угода не рухається. Двічі той самий статус з тим самим етапом — помилка «… з тим самим етапом вказано двічі».
• «Пов'язані типи оплат та статуси»: те саме з огляду на тип оплати («Накладений платіж» + «Відправлення отримано» → «Виграно»). Ці рядки головніші. Рядок можна лишити без етапу — тоді для цього статусу діють звичайні «Пов'язані статуси».

Етап змінюється, коли оновлюється статус ТТН — кнопкою «Оновити статус» у «⋮» рядка ТТН в угоді. Архівні угоди не рухаються; у журналі угоди автор — «трекінг доставки».

• Автооновлення й архів отриманих (над «Пов'язаними статусами»): «Оновлювати статуси ТТН автоматично» кожні N хв (типово так, 30 хв) — статуси відкритих угод оновлюються самі, без кнопки «Оновити статус»; «Посилку отримано → угода «Виграно» в архів» (типово так) — коли перевізник каже «отримано», угода переходить на етап «Виграно» своєї воронки й іде в архів навіть без рядка «Пов'язаних статусів». Відмови й повернення не архівуються.

6Створити ТТН з угоди

Картка угоди → блок «Доставка» → «+» → шторка «Створити ТТН» → вкладка «Нова Пошта» → акаунт відправника → перевірте отримувача, місто, відділення, оплату й місця → «Створити ТТН». Режим «Додати ТТН» записує вже наявний номер. Покроково — стаття Доставки і ТТН.