Як створювати ТТН Нової Пошти за допомогою Claude
10 листопада 2026 · Команда FOPilot
На початку 2026 року в Україні було 2 181 217 активних ФОП, і 659 тисяч з них працюють у роздрібній торгівлі (дані Opendatabot, вересень 2026). Для більшості онлайн-продавців день починається однаково: відкрити кабінет магазину, переписати дані покупця в кабінет Нової Пошти, перевірити відділення, проставити накладений платіж, скопіювати номер ТТН назад у замовлення. На 20 замовленнях це година-півтори щодня. У цій статті — як передати цю роботу AI-асистенту і не втратити контроль.
Що змінюється, коли накладні створює асистент
Асистент не «клацає» кабінет замість вас. Він викликає офіційні API: читає замовлення з магазину, шукає місто й відділення в довіднику Нової Пошти і створює експрес-накладну методом InternetDocument.save. Тобто результат такий самий, як у кабінеті, але без ручного перенесення даних.
Головна цінність навіть не у швидкості, а в тому, що асистент не вгадує. Якщо покупець написав «Петрівка» — а населених пунктів з такою назвою в Україні десятки, — накладна не створюється, поки ви не оберете потрібний.
Крок 1. Підготуйте API-ключ Нової Пошти
- Увійдіть у бізнес-кабінет Нової Пошти.
- Відкрийте Налаштування → Безпека і в блоці «Мої ключі API» натисніть «Створити ключ».
- Підтвердіть ліцензійну угоду і скопіюйте ключ.
Порада: створіть окремий ключ для інтеграції. Якщо колись захочете відключити асистента, достатньо видалити один ключ — інші інтеграції працюватимуть далі.
Крок 2. Налаштуйте відправника один раз
Щоб створити ТТН, потрібні дані відправника: контрагент, контактна особа, телефон, місто і відділення, звідки ви відправляєте. У FOPilot це заповнюється один раз у налаштуваннях доставки. Там же задаються:
- платник доставки — зазвичай отримувач;
- вага і габарити за замовчуванням — наприклад, 1 кг і 30×20×10 см для типової коробки;
- опис відправлення — «Одяг», «Косметика», «Товари»;
- правило накладеного платежу — грошовий переказ або «контроль оплати» (для клієнтів з договором).
Габарити варто вказати, навіть якщо ви рідко відправляєте в поштомати: без них ТТН у поштомат не створити.
Крок 3. Перша накладна — з одного замовлення
Підключіть магазин (Prom.ua, Horoshop, Rozetka або KeyCRM) і напишіть асистенту:
Створи ТТН для замовлення prom:312874561.
Під капотом відбувається таке:
- Читання замовлення: отримувач, телефон, місто, відділення, сума, спосіб оплати.
- Пошук міста. Розуміються «м. Київ», «Киев», «Kyiv», «Біла Церква, Київська обл.». Якщо магазин сам передає ідентифікатор відділення Нової Пошти (так часто буває в замовленнях Prom), він використовується напряму.
- Пошук відділення за номером і вулицею. «Відділення №12 (до 30 кг): вул. Хрещатик, 22» розпізнається як відділення №12, а вулиця звіряється з довідником. Якщо номер є, а вулиця інша — асистент попросить підтвердити, бо це типова помилка покупця.
- Перевірки: відділення працює, вага не перевищує ліміт на місце, для поштомата задані габарити, а оголошена вартість не більша за ліміт.
- Накладений платіж додається, якщо покупець обрав оплату при отриманні і замовлення не оплачене. Сума — сума замовлення.
- Створення ТТН і запис номера назад у замовлення магазину.
Відповідь міститиме номер ТТН, орієнтовну дату доставки, вартість і посилання на друк наклейки.
Крок 4. Масово, але з планом
Коли замовлень десятки, просіть план:
Підготуй план ТТН для всіх нових замовлень з накладеним платежем. Нічого не створюй.
Пробний прогін поверне таблицю:
| Статус | Що означає |
|---|---|
| готово | місто й відділення визначені впевнено, усі дані є |
| потрібен вибір | неоднозначне місто або відділення — є список кандидатів |
| пропущено | вже є ТТН, замовлення скасоване, інший перевізник або кур'єрська доставка |
| помилка | немає телефону, не налаштовано відправника тощо |
Плюс загальна сума накладеного платежу — зручна контрольна цифра. Далі:
Створи накладні за цим планом. Для замовлення з Петрівки обери Петрівку в Одеській області.
Асистент створить ТТН лише для готових позицій і тих, де ви зробили вибір. Пробний прогін коштує одну дію, створення — по одній дії за кожну накладну.
Що варто перевірити перед першим запуском
- Імена кирилицею. Нова Пошта може відхилити отримувача з латинським іменем. Асистент попередить про такі замовлення.
- Телефони. Номер має бути українським мобільним. «067 123 45 67», «+38 (067) 123-45-67» і «80671234567» розпізнаються однаково.
- Адресна доставка. Кур'єрську доставку на адресу поки краще оформлювати в кабінеті — асистент пропустить такі замовлення і скаже про це.
- Ліміти відділень. Невеликі відділення приймають посилки до 30 кг на місце; поштомати — менші за розміром і вагою. Ці ліміти перевіряються автоматично.
Друк і передача посилок
Після створення накладних попросіть:
Дай посилання на друк наклейок 100×100 для сьогоднішніх ТТН.
Посилання ведуть на PDF через сервер FOPilot і діють кілька хвилин. Ваш API-ключ у посилання не потрапляє — це важливо, бо стандартні посилання друку Нової Пошти містять ключ у відкритому вигляді.
Якщо накладну треба скасувати
Поки посилку не прийняли у відділенні, ТТН можна видалити:
Видали ТТН 20451234567891 — покупець скасував замовлення.
Це незворотна дія, тому асистент попросить підтвердження. Після приймання посилки видалення неможливе — тоді оформлюють повернення або переадресування.
Скільки часу це економить
Підрахуйте на своїх цифрах. Якщо ручне оформлення однієї накладної займає 2–3 хвилини (переписати дані, знайти відділення, перевірити суму, скопіювати номер назад), то 30 замовлень — це 60–90 хвилин. З асистентом — кілька запитів і перевірка плану, 5–10 хвилин. Плюс менше помилок у телефонах і відділеннях, які потім обертаються поверненнями.
П'ять помилок, які найчастіше зупиняють створення ТТН
- Не налаштований відправник. Без контрагента, контактної особи і відділення відправлення накладна не створюється. Асистент назве конкретні поля, яких бракує.
- Номер відділення без міста. «Відділення 5» без міста не визначає нічого — у кожному місті є своє п'яте відділення. Якщо магазин не передає місто, попросіть асистента показати такі замовлення і уточніть місто в покупця.
- Поштомат без габаритів. Поштомат приймає посилки обмеженого розміру і ваги, тому Нова Пошта вимагає габарити місця. Задайте типові габарити в налаштуваннях — і ця помилка зникне.
- Неправильний платник. Якщо доставку оплачує отримувач, оплата можлива лише готівкою у відділенні. Для безготівкової оплати доставки відправником потрібен договір з Новою Поштою.
- «Контроль оплати» без договору. Послуга доступна клієнтам з договором. Без нього використовуйте грошовий переказ — це налаштування в правилах накладеного платежу.
Як перевірити, що все працює правильно
Перші кілька днів звіряйте результат із кабінетом Нової Пошти: відкрийте створену ТТН і перевірте отримувача, відділення, суму накладеного платежу та оголошену вартість. Корисно також подивитися на номер замовлення в полі внутрішнього номера клієнта — FOPilot записує туди джерело і номер замовлення (наприклад, «prom-312874561»), тож накладну легко знайти за номером замовлення навіть у кабінеті Нової Пошти.
Коли кілька десятків накладних пройдуть без зауважень, переходьте на масове створення з планом — і перевіряйте вже лише позиції зі статусом «потрібен вибір».
Підсумок
- Окремий API-ключ Нової Пошти — 2 хвилини.
- Налаштування відправника і параметрів посилки — 5 хвилин, один раз.
- Перша ТТН з одного замовлення — перевірте результат у кабінеті Нової Пошти.
- Далі — масово, але завжди через пробний план.
Спробувати без ризику можна в демо-режимі: там є замовлення з неоднозначною адресою, поштомат і посилки в різних статусах.
Спробуйте FOPilot сьогодні
Підключення за дві хвилини. Безкоштовний план, картка не потрібна.