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

ТТН Нової Пошти із замовлень

Як FOPilot створює експрес-накладні із замовлень магазину: пошук міста й відділення, накладений платіж, неоднозначні адреси, масове створення з попереднім планом.

Що відбувається, коли ви просите «створи ТТН для замовлення»

  1. Читаємо замовлення з магазину (Prom.ua, Horoshop, Rozetka або KeyCRM): отримувач, телефон, місто, відділення, сума, спосіб оплати.
  2. Шукаємо місто в довіднику Нової Пошти. Розуміємо «м. Київ», «Киев», «Kyiv», «с. Петрівка (Одеська обл.)». Якщо магазин передав ідентифікатор відділення Нової Пошти (так робить, наприклад, Prom), беремо його напряму — без вгадування.
  3. Шукаємо відділення або поштомат за номером («№12», «Відділення 12 (до 30 кг)», «Поштомат 25981») і звіряємо вулицю. Якщо номер є, а вулиця не збігається — не створюємо ТТН, а просимо підтвердити.
  4. Перевіряємо обмеження: відділення працює і приймає посилки, вага не перевищує ліміт на місце, для поштомата задані габарити й оголошена вартість у межах ліміту.
  5. Застосовуємо ваші налаштування: відправник, платник доставки, вага й габарити за замовчуванням, тип вантажу, оголошена вартість = сума замовлення.
  6. Накладений платіж: якщо оплата при отриманні й замовлення не оплачене, додаємо грошовий переказ на суму замовлення (або «контроль оплати», якщо так налаштовано і є договір).
  7. Створюємо ТТН і записуємо номер у замовлення магазину (Prom, Rozetka, KeyCRM; у Horoshop — якщо версія підтримує).

Неоднозначні адреси

Якщо місто чи відділення не вдалося визначити впевнено, ТТН не створюється. Інструмент повертає статус needs_choice і кандидатів, наприклад:

Кандидат Ref Збіг
с. Петрівка, Березівський р-н, Одеська обл. 3a8d…4375 0,70
смт Петрівка, Харківський р-н, Харківська обл. 3a8d…4378 0,70

Асистент покаже варіанти, ви обираєте, і ТТН створюється з уточненням (warehouse_ref або city_ref).

Масове створення: спочатку план

np_create_waybills_bulk (функція тарифів Pro і Business) працює у два кроки:

  1. Пробний прогін (dry_run=true, за замовчуванням) — нічого не створює, повертає план: які замовлення готові, які потребують вибору адреси, які пропущено (вже є ТТН, скасовані, інший перевізник, кур'єрська доставка) і загальну суму накладеного платежу.
  2. Створення (dry_run=false з plan_id попереднього плану) — створює ТТН лише для готових позицій. Можна передати уточнення для окремих замовлень.

Дії списуються за кожну створену ТТН; пробний прогін — одна дія.

Друк наклейок

Після створення ТТН інструмент повертає посилання на PDF (накладна A4 або наклейка 100×100). Посилання підписане і діє кілька хвилин; ключ Нової Пошти в ньому не міститься.

Видалення ТТН

np_delete_waybill видаляє накладну, поки посилку не прийняли у відділенні. Це незворотна дія, тому клієнт попросить підтвердження. Після приймання посилки видалити ТТН неможливо — оформіть повернення або переадресування в кабінеті Нової Пошти.