ТТН Нової Пошти із замовлень
Як FOPilot створює експрес-накладні із замовлень магазину: пошук міста й відділення, накладений платіж, неоднозначні адреси, масове створення з попереднім планом.
Що відбувається, коли ви просите «створи ТТН для замовлення»
- Читаємо замовлення з магазину (Prom.ua, Horoshop, Rozetka або KeyCRM): отримувач, телефон, місто, відділення, сума, спосіб оплати.
- Шукаємо місто в довіднику Нової Пошти. Розуміємо «м. Київ», «Киев», «Kyiv», «с. Петрівка (Одеська обл.)». Якщо магазин передав ідентифікатор відділення Нової Пошти (так робить, наприклад, Prom), беремо його напряму — без вгадування.
- Шукаємо відділення або поштомат за номером («№12», «Відділення 12 (до 30 кг)», «Поштомат 25981») і звіряємо вулицю. Якщо номер є, а вулиця не збігається — не створюємо ТТН, а просимо підтвердити.
- Перевіряємо обмеження: відділення працює і приймає посилки, вага не перевищує ліміт на місце, для поштомата задані габарити й оголошена вартість у межах ліміту.
- Застосовуємо ваші налаштування: відправник, платник доставки, вага й габарити за замовчуванням, тип вантажу, оголошена вартість = сума замовлення.
- Накладений платіж: якщо оплата при отриманні й замовлення не оплачене, додаємо грошовий переказ на суму замовлення (або «контроль оплати», якщо так налаштовано і є договір).
- Створюємо ТТН і записуємо номер у замовлення магазину (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) працює у два кроки:
- Пробний прогін (
dry_run=true, за замовчуванням) — нічого не створює, повертає план: які замовлення готові, які потребують вибору адреси, які пропущено (вже є ТТН, скасовані, інший перевізник, кур'єрська доставка) і загальну суму накладеного платежу. - Створення (
dry_run=falseзplan_idпопереднього плану) — створює ТТН лише для готових позицій. Можна передати уточнення для окремих замовлень.
Дії списуються за кожну створену ТТН; пробний прогін — одна дія.
Друк наклейок
Після створення ТТН інструмент повертає посилання на PDF (накладна A4 або наклейка 100×100). Посилання підписане і діє кілька хвилин; ключ Нової Пошти в ньому не міститься.
Видалення ТТН
np_delete_waybill видаляє накладну, поки посилку не прийняли у відділенні. Це незворотна дія, тому клієнт попросить підтвердження. Після приймання посилки видалити ТТН неможливо — оформіть повернення або переадресування в кабінеті Нової Пошти.