Нова пошта API підключається в Elbuz одним ключем, і програма виписує ТТН, кожні 10 хвилин приносить статуси посилок, складає реєстри, оформлює переадресацію й повернення — без бізнес-кабінету Нової пошти.
Коли це знадобиться:
- Щодня десятки відправлень — ТТН виписується з картки замовлення, реєстр і маркування — з одного вікна.
- Посилки повертаються з відділень — видно, у кого закінчується зберігання; SMS клієнту — звідти ж.
- Наложений платіж — видно, які посилки отримано, а переказ ще в дорозі, і на яку суму.
- Клієнт просить інше відділення — переадресація й повернення оформлюються з Elbuz, вартість видно заздалегідь.
З чого почати: створіть ключ API у кабінеті Нової пошти → впишіть його в Elbuz.
Розмова з підтримкою — замість читати: навіщо це потрібно, що налаштувати і що ви отримаєте.
Що вміє Нова пошта в Elbuz
- ТТН із замовлення — на відділення, поштомат чи адресу, по одній, пачкою або автоматично за статусом замовлення; до передачі посилки накладну можна змінити чи видалити.
- Статуси посилок — кожні 10 хвилин, з терміном зберігання, причиною невручення й переказом наложки; накладні з кабінету Нової пошти прив'язуються до замовлень.
- Реєстр і кур'єр — один документ на всі посилки дня, друк реєстру й маркувань, виклик кур'єра за посилками.
- Переадресація, зміна даних, повернення — з розрахунком вартості до оформлення, запис у журналі замовлення.
- Контроль наложки — які посилки чекають переказу і на яку суму.
- Повідомлення клієнту — SMS із реєстру посилок, автоматичне SMS за статусом доставки, відповідь AI на «де моє замовлення».
- Захист від мертвого ключа — після 10 відмов поспіль підключення вимикається й приходить сповіщення.
Як підключити Нову пошту: ключ API і налаштування
Де взяти API-ключ Нової пошти
Ключ створюється в бізнес-кабінеті Нової пошти і дає Elbuz доступ до вашого договору: накладних, реєстрів, статусів.
- Увійдіть у бізнес-кабінет Нової пошти.
- Відкрийте «Налаштування» → вкладку «Безпека» → блок «Мої ключі API».
- Натисніть «Створити ключ», прийміть умови використання API й скопіюйте ключ.
1
Вкладка «Безпека»2
Мої ключі API3
Створити ключ- Ключі API живуть у налаштуваннях кабінету, вкладка «Безпека».
- Тут видно ключі, які вже є; ключ на кадрі приховано.
- Новий ключ — кнопкою «Створити ключ», його й вписуєте в Elbuz.
Опис методів API Нова пошта публікує на developers.novaposhta.ua; для роботи в Elbuz він не потрібен.
Куди вписати ключ в Elbuz
Де: Кабінет → Налаштування системи → Інші налаштування → «Зовнішні сервіси та інтеграції» → група «Доставка» → запис Нової пошти.
- Вставте ключ у поле «Токен».
- Увімкніть «Активність».
- У блоці «Відправник» виберіть «Відправник» і «Контактна особа» — списки приходять з вашого кабінету Нової пошти одразу після того, як ви вписали ключ; телефон і e-mail підставляться з контактної особи.
- Там само виберіть «Область», «Місто» і «Відділення», з якого відправляєте посилки.
- Якщо у вас підключена послуга «Контроль оплати», увімкніть перемикач «Послуга "Контроль оплати"» — він стане значенням за замовчуванням для нових накладних.
1
Токен2
Відправник і контактна особа3
Місто та відділення відправника4
Послуга «Контроль оплати»- Токен — ключ API з кабінету Нової пошти; у формі він прихований крапками.
- Відправник і контактна особа — обираються один раз для всіх накладних.
- Місто та відділення — звідки відправник здає посилки.
- Послуга «Контроль оплати» — вмикається, якщо потрібна ця послуга.
Кнопки «Зберегти» у формі немає: кожна зміна поля зберігається одразу. Ключ у полі «Токен» не показується: якщо його збережено, у полі стоять крапки. Порожнє поле ключ не стирає; щоб замінити ключ, впишіть новий поверх.
Відправника й контактну особу вибирають один раз: форма накладної й виписка пачкою підставляють їх самі. У формі окремої накладної їх можна замінити.
Довідники міст і відділень
Області, міста, відділення й поштомати Нової пошти Elbuz оновлює сам раз на добу вночі; блок «Довідники служби» у тій самій формі показує, скільки записів у кожному довіднику і коли його оновлено. Кнопка «Оновити довідники» запускає оновлення одразу — «Оновлення довідників... це може зайняти кілька хвилин».
Якщо оновлення не вдалося, з'явиться «Помилка оновлення довідників:» з причиною, а довідник лишиться вчорашнім — нічого не стирається. Нове відділення, відкрите сьогодні, з'явиться в списках після нічного оновлення або після ручного.
Коли Elbuz вимикає Нову пошту сам
Якщо Нова пошта 10 разів поспіль відхиляє ключ — прострочений, видалений у кабінеті, — Elbuz знімає з підключення «Активність». Власник акаунта отримує сповіщення «Інтеграцію вимкнено» з текстом відповіді Нової пошти і порадою «Оновіть ключ API в налаштуваннях інтеграції та знову ввімкніть її.»
Рахуються лише відмови через ключ: збої зв'язку чи технічні роботи Нової пошти підключення не вимикають. Відмову зараховує кожне звернення до Нової пошти з цим ключем — перевірка статусів, дії користувачів, — тож підключення вимикається після 10 відмов поспіль за ключем, іноді швидше, ніж за проходи перевірки.
Якщо відстежувати нічого, перевірка статусів до Нової пошти не звертається. Одна успішна відповідь обнуляє лічильник.
Поки підключення вимкнене, статуси посилок не оновлюються, ТТН не виписуються, а кнопки дій Нової пошти у «Відправленні» зникають. Щоб повернути роботу, створіть новий ключ у кабінеті, впишіть у «Токен» і ввімкніть «Активність».
Як створити ТТН Нової пошти із замовлення
Загальний порядок для всіх служб — у статті як виписати накладну із замовлення.
Де: картка замовлення → «Доставка» → «Створити накладну».
Що форма заповнить сама і що перевірити
| Поле | Що стоїть одразу | Що перевірити |
|---|---|---|
| «Відправник», «Контактна особа», місто й відділення відправника | з налаштувань підключення | можна замінити для окремої відправки |
| «Прізвище», «Ім'я», «По батькові», «Телефон» одержувача | дані покупця із замовлення | якщо забирає інша людина — виправте тут |
| «Місто», «Відділення» одержувача | відділення, обране покупцем на сайті; місто — за збігом назви з довідником | поля можуть бути порожні, якщо назва не збіглася, — накладна все одно піде на відділення покупця |
| «Опис відправлення» | категорія товару, а без неї — список товарів | до Нової пошти піде не більше 120 символів |
| «Загальна вага, кг» | вага кожного товару × кількість, разом | порожня вага — у накладну піде 2 кг |
| «Зворотна доставка (одержувач)» | «Гроші» на суму замовлення для неоплаченого, «Не потрібно» для оплаченого | оплатили карткою, а оплату не відмічено — поставте «Не потрібно» |
| «Платник за доставку» | «Одержувач» | доставку за ваш рахунок — «Відправник»; «Третя особа» — лише з «Код ЄДРПОУ/РНОКПП» платника |
| Одержувач: «Приватна особа» / «Організація» | «Приватна особа» | для «Організація» обов'язковий «Код ЄДРПОУ/РНОКПП»; ПІБ — її контактна особа |
| «Форма оплати за доставку» | «Готівка» | «Безготівковий розрахунок» — якщо платите за договором |
1
Зворотна доставка2
Контроль оплати3
Платник за доставку4
Відправник- Зворотна доставка (одержувач) — тут вибрано «Гроші» із сумою замовлення.
- Перемикач послуги «Контроль оплати».
- Платник за доставку — одержувач, відправник або третя особа.
- Відправник уже вибраний з налаштувань підключення.
Відділення, поштомат чи адреса
«Спосіб відправлення» за замовчуванням — «Відділення». Варіант «Поштомат» у перемикачі неактивний: поштомат вибирається в списку відділень, і Elbuz передає Новій пошті місце 20×20×10 см. Обмежень поштомата за вагою й розміром програма не перевіряє.
«Адреса» — доставка кур'єром до дверей: замість відділення з'являються «Вулиця», «Дім», «Квартира» й «Коментар на адресу (не обов'язково)»; вулиця й дім обов'язкові.
Вулицю Elbuz шукає за назвою в довіднику Нової пошти в місті одержувача. Не знайшлася — накладна не створюється, а у вікні «Увага» буде «Error: Street not found in the city: ‹вулиця›». Впишіть назву без «вул.».
Що відбувається після «Створити накладну»
- Elbuz перевіряє право на вікно створення накладної й обов'язкові поля. Бракує даних — з'явиться «Увага» з назвою поля, наприклад «порожньо Відправник - Контактна особа»; накладна не створюється, гроші не списуються.
- Програма реєструє одержувача в Новій пошті й створює експрес-накладну з датою відправки «сьогодні».
- Номер лягає в поле «Сервіс доставки: номер» замовлення, вікно закривається з повідомленням «Створено товарно-транспортну накладну №‹номер›». Посилання «Створити накладну» в картці зникає. Якщо у способі доставки заповнено «Посилання на трекінг», у замовлення записується й посилання на відстеження.
- Повторне натискання отримає «Накладну вже створено: ‹номер› — пропущено.»
- Якщо Нова пошта відмовила, у вікні «Увага» буде її текст, а замовлення лишиться без номера.
Як змінити або видалити накладну
Поки Нова пошта не прийняла посилку — накладна в статусі «створено», — її можна змінити або видалити з Elbuz. «Перегляд накладної» в картці замовлення тоді відкриває ту саму форму з написом «Накладну ще не передано Новій пошті: дані можна змінити й зберегти або видалити накладну.»
1
Зберегти зміни2
Видалити накладну- «Зберегти зміни» — записує правки в накладну, поки її не передано Новій пошті.
- «Видалити накладну» — прибирає ще не передану накладну із замовлення.
- «Зберегти зміни» надсилає форму в Нову пошту наново, номер накладної не змінюється: «Зміни збережено в накладній Нової пошти».
- «Видалити накладну» після підтвердження видаляє накладну в Новій пошті й очищає замовлення: номер і стан посилки зникають, з'являється «Накладну видалено. Замовлення можна оформити знову.»
Обидві дії пишуться в історію замовлення й потребують права на вікно «Створення ТТН служби доставки». Видалити можна й у «Відправленні» — для посилки в стані «Створено».
Після передачі форма тільки показує накладну; одержувача й платника змінюють через «Змінити дані накладної».
Накладні пачкою, автоматично і з кабінету Нової пошти
Накладні пачкою
«Створити ТТН (доставка)» у списку замовлень виписує накладні по всіх позначених замовленнях без форми.
Відкривати форму кожного замовлення не потрібно: відправник — з підключення, вага — товари × кількість, опис — категорія або список товарів, решта — як у таблиці вище.
Спосіб доставки береться із замовлення: на відділення — обране покупцем. Для доставки на адресу вулицю й дім пачка бере тільки зі збереженої форми накладної; без неї в рядку буде «порожньо Одержувач - Вулиця». Якщо у формі замовлення щось змінювали, беруться збережені в ній значення.
Замовлення з накладною пропускаються з червоним рядком «Накладну вже створено: ‹номер› — пропущено.» Детальніше: накладні пачкою.
Накладна сама, коли замовлення переходить у статус
Elbuz може виписувати накладні без натискань. У підключенні Нової пошти виберіть статус у полі «Створювати накладну автоматично, коли замовлення переходить у статус», наприклад «Зібрано». За замовчуванням там «— не створювати —».
1
Відправник2
Створювати накладну автоматично3
Підказка під полем- Відправник обирається один раз — без нього автоматичне створення накладних не працює.
- Поле зі статусом замовлення, при переході в який Elbuz сам створює накладну; зараз стоїть «не створювати».
- Підказка пояснює, як часто й для яких замовлень створюються накладні та де видно помилку.
Раз на 10 хвилин програма бере замовлення покупця в цьому статусі з доставкою Новою поштою, створені за останні 7 днів і ще без накладної, — до 20 за раз — і виписує накладні так само, як пачкою. В історії замовлення з'являється «Накладну ‹номер› створено автоматично».
Без вибраного відправника автостворення не працює, і форма попереджає: «Оберіть відправника вище — без нього накладні автоматично не створюються.» Якщо Нова пошта відмовила, в історії замовлення буде «Накладну не створено автоматично: ‹причина›. Наступна спроба — за годину.» Виправте дані замовлення — наступна спроба пройде сама.
Накладні, виписані в кабінеті Нової пошти
Якщо частину накладних виписують у кабінеті Нової пошти, Elbuz покаже ті, яких немає в жодному замовленні. Меню вікна «Відправлення» → «Накладні з кабінету Нової пошти»: виберіть період — за замовчуванням останні 14 днів, не довше 31 дня — і натисніть «Показати».
У списку — номер, дата, стан, вартість доставки, сума наложки й номер реєстру; ПІБ і телефону одержувача там немає. «Привʼязати до замовлення» → «Номер замовлення в Elbuz» → підтвердження → «Накладну ‹номер› привʼязано: її стан тепер оновлюється автоматично.»
Прив'язати можна лише до замовлення покупця без накладної; вид доставки замовлення стає «Нова пошта», в історії — «Привʼязано накладну ‹номер› з кабінету Нової пошти». Список бачить співробітник, який бачить усі замовлення: у кабінеті накладні всіх менеджерів.
1
Період і «Показати»2
Немає в замовленнях Elbuz3
Привʼязати до замовлення- Поля «З» і «По» задають період, кнопка «Показати» завантажує накладні кабінету.
- Рядок показує, скільки накладних кабінету ще не привʼязано до замовлень.
- Значок привʼязки записує номер накладної в замовлення (на кадрі лише показано, не натискався).
Наложений платіж і «Контроль оплати»
| Перемикач | Що піде в Нову пошту |
|---|---|
| вимкнено, «Зворотна доставка (одержувач)» — «Гроші» | наложений платіж: зворотна доставка грошей на суму з поля «Сума», платить одержувач |
| увімкнено, «Гроші» | послуга «Контроль оплати» на ту саму суму |
| «Не потрібно» — з перемикачем чи без | посилка без наложки |
«Контроль оплати» діє лише разом із «Гроші»: для оплаченого замовлення досить поставити «Не потрібно».
Як побачити, що переказ дійшов
Отриману посилку Нова пошта позначає одним із трьох кодів: 9 — отримано, 10 — отримано, переказ надійде протягом доби, 11 — переказ видано. За посилкою з кодом 10 Elbuz стежить далі, доки не прийде 11.
- Колонка «Наложений платіж» у «Відправленні» показує суму й позначку: «переказ отримано», «чекає переказ» або «не викуплено» — для відмов.
- Швидкий фільтр «Чекає переказ» лишає посилки, які отримано, а гроші ще не прийшли.
- Плитки «Переказ наложки в дорозі» й «Наложка в активних» показують суми.
1
Переказ накладки в дорозі2
Плашка «чекає переказ»3
Фільтр «Чекає переказ»- Плитка показує суму накладеного платежу, який Нова пошта ще не переказала.
- Плашка «чекає переказ» у колонці «Наложений платіж» — посилка отримана, гроші ще в дорозі.
- Швидкий фільтр «Чекає переказ» залишає тільки такі посилки.
Статус оплати замовлення стає «Оплачено» сам за кодом 11, якщо замовлення в позначеному статусі — див. автозміну статусів.
Як Elbuz стежить за посилками й міняє статуси замовлень
Elbuz сам запитує в Нової пошти стан посилок кожні 10 хвилин — за розкладом завдання «Перевірка статусу доставки». Кнопка «Оновити статуси» запускає перевірку позачергово.
Результат складається у вікно «Відправлення»: де посилка, у якому відділенні, до якого дня зберігається, скільки коштувала доставка, чи прийшов переказ, чому не вручено. Фільтри, колонки й плитки вікна — у статті Відправлення: усі посилки в одному реєстрі.
1
Плитки статистики2
Кнопки операцій Нової пошти3
Зберігання до- Плитки статистики — скільки посилок у відділенні, в дорозі, з відмовою, скільки переказів накладеного платежу очікується.
- Кнопки операцій над відміченою посилкою «В дорозі»: реєстр, друк маркувань, переадресація, зміна даних, повернення.
- Колонка «Зберігання до» — дата, до якої посилку тримають у відділенні, з позначкою «ще N дн.».
- Дія або результат
- Розвилка: далі шлях залежить від відповіді
- Вирішальний крок
- Elbuz стежить за накладними Нової пошти в замовленнях за останні 60 днів, а в замовленнях позначених статусів — без обмеження за датою. Опитування припиняється на кінцевому коді: 9 — отримано, 11 — переказ видано, 106 — отримано й створено зворотну доставку, 2 — видалено, 124 — знищено. Відмови кінцевими не є: за ними Elbuz стежить далі.
- За один прохід — до 100 накладних, першими ті, що найдовше не перевірялися.
- Номер, вписаний у замовлення вручну (накладну створили в кабінеті Нової пошти), теж відстежується — якщо вид доставки замовлення «Нова пошта».
- Вартість доставки, яку порахувала Нова пошта, з'являється в колонці «Доставка»; у саме замовлення під час створення ТТН вона не пишеться.
- ПІБ, телефон і адресу одержувача з відповіді Нової пошти Elbuz не зберігає.
Як налаштувати автозміну статусу замовлення
Статус замовлення, статус доставки й статус оплати Elbuz міняє лише в замовленнях, чий статус позначено в підключенні. Решта посилок просто відстежується.
- У формі підключення, блок «Статуси замовлень, за якими перевіряти статус посилки в службі доставки», позначте статуси, у яких замовлення чекає доставки, наприклад «Відвантажено» і «Доставлено». Позначайте й ті статуси, у які програма переведе замовлення сама: замовлення в «Доставлено» без позначки вже не перейде у «Виконано» і не отримає «Оплачено».
- У блоці «Налаштування повідомлень» відкрийте по черзі «Статуси замовлення», «Статуси доставки» і «Статуси оплати». Під час першого відкриття програма сама впише коди Нової пошти в колонку «Код (назва) на сайті (API)».
- Перевірте коди або допишіть свої через кому.
| Вікно | Ваш статус | Коди Нової пошти |
|---|---|---|
| «Статуси замовлення» | «Доставлено» | 7, 8 — прибула у відділення чи поштомат |
| «Статуси замовлення» | «Виконано» | 9, 10, 11 — отримано |
| «Статуси доставки» | «У дорозі» | 4, 41, 5, 6 |
| «Статуси доставки» | «У пункті призначення» | 7, 8 |
| «Статуси доставки» | «Доставлено» | 9, 10, 11 |
| «Статуси доставки» | «Відмова від отримання» | 102, 103 |
| «Статуси оплати» | «Оплачено» | 11 — переказ видано |
1
Колонка кодів2
У пункті призначення — 7, 8- Колонка «Код (назва) на сайті (API)» — коди статусів Нової пошти, які програма зіставила зі статусами доставки.
- Рядок «У пункті призначення» — посилка з кодами 7 і 8 вважається такою, що прибула у відділення.
Коли статус змінився, у журнал операцій замовлення пишеться «Змінився статус доставки: ‹код› ‹текст Нової пошти› #‹номер накладної›», і спрацьовують ваші автоматичні правила на подію «Документ: оновлення» — наприклад, SMS про прибуття.
Реєстр, маркування і виклик кур'єра
Реєстр — один документ на всі посилки, які ви здаєте у відділення чи кур'єру, замість окремої накладної на кожну. Elbuz складає його в кабінеті Нової пошти.
Де: Довідники → Документи → Відправлення → позначте рядки → «Додати в реєстр Нової пошти».
- Відфільтруйте «Не передані» — посилки, які ще не здані.
- Позначте потрібні рядки й натисніть «Додати в реєстр Нової пошти».
- У полі «Реєстр» виберіть «Новий реєстр на сьогодні» або відкритий реєстр, який ще не друкували.
- Натисніть «Додати». Програма відповість «Реєстр ‹номер›: додано накладних — ‹кількість›» і перелічить накладні, які Нова пошта не прийняла, з причиною.
- Натисніть «Друк реєстру» — роздрукуйте два примірники — і одну з кнопок маркування: «Маркування A4 (6 наклейок 85×85)» або «Маркування для термопринтера 100×100», щоб наклеїти маркування на кожну посилку.
1
Номери вибраних накладних2
Реєстр3
Додати- Номери накладних, які потраплять у реєстр.
- Поле «Реєстр» — «Новий реєстр на сьогодні» або вже відкритий.
- Кнопка «Додати» додає накладні в реєстр.
Номер реєстру з'являється в колонці «Реєстр НП» і в журналі замовлення.
Правила реєстру встановлює Нова пошта: усі накладні — від одного відправника; накладна може бути лише в одному реєстрі; після друку реєстру додати до нього нічого не можна; посилку, вже відскановану у відділенні, не додати. Elbuz шукає накладну за номером у кабінеті, до якого належить ключ, тож накладна чужого кабінету в реєстр не потрапить.
Друк накладної, маркувань і реєстру
| Кнопка | Що друкується |
|---|---|
| «Друк» у «Перегляді накладної», «Друк накладної» у «Відправленні» | бланк експрес-накладної A4; позначено кілька накладних Нової пошти — усі бланки одним PDF |
| «Друк маркувань» у «Відправленні» → «Маркування A4 (6 наклейок 85×85)» | наклейки 85×85 мм, по 6 на аркуші A4 — для звичайного принтера |
| «Друк маркувань» → «Маркування для термопринтера 100×100» | етикетки 100×100 мм для термопринтера (Zebra) |
| «Друк реєстру» | реєстр приймання-передачі |
PDF відкривається з Elbuz у новій вкладці: входити в кабінет Нової пошти не потрібно, а ключа API в адресі немає. Якщо Нова пошта відмовила в друку, у тій самій вкладці буде текст причини.
Червоне спливне повідомлення замість вкладки означає, що до Нової пошти запит не дійшов: немає ключа підключення чи номера накладної, «Немає доступу до цього відправлення.» — немає права або замовлення поза «Чиї дані», «Не вдалося виконати дію. Спробуйте ще раз.» — збій зв'язку.
Виклик кур'єра за посилками
Кур'єра Нової пошти, який забере посилки з вашої адреси, викликають з «Відправлень». По одній посилці його можна викликати й з вікна накладної в картці замовлення — блок «Виклик курʼєра» під формою; для кількох посилок — з «Відправлень».Послугу «Виклик курʼєра» підключає персональний менеджер Нової пошти.
- Позначте посилки й натисніть «Викликати курʼєра».
- «Дата забору» — найближчий робочий день: сьогодні, якщо зараз раніше 16:00, інакше наступний; вихідні переносяться на понеділок.
- «Інтервал» — вільні інтервали Нової пошти; «Адреса відправника» — з вашого кабінету; «Планова вага, кг» — сума ваги позначених накладних.
- «Викликати» → «Курʼєра викликано, заявка ‹номер›». Накладні, які Нова пошта до заявки не прийняла, буде перелічено з причиною.
1
Дата забору2
Інтервал3
Адреса відправника4
Планова вага, кг5
Викликати- Дата, на яку викликають курʼєра.
- Інтервал забору зі списку доступних.
- Адреса, з якої курʼєр забере посилки.
- Орієнтовна вага для всіх відмічених накладних.
- Кнопка створює заявку на курʼєра (на кадрі лише показана).
Прийняті накладні отримують запис в історії замовлення. Немає вільних інтервалів — виберіть інший день; немає адрес — додайте адресу забору в кабінеті Нової пошти.
Меню вікна → «Заявки на курʼєра» показує заявки за останні 7 днів і кнопку «Скасувати заявку». Якщо до кінця інтервалу лишилося менше години й розрахунок безготівковий, скасування платне — 350 грн. Список і скасування доступні співробітнику, який бачить усі замовлення: заявки спільні для всього кабінету.
Список реєстрів і розформування
Реєстр Нової пошти спільний для всього кабінету, тому співробітник з обмеженими «Чиї дані» пункту «Реєстри Нової пошти» не бачить, а в «Додати в реєстр Нової пошти» йому доступний лише «Новий реєстр на сьогодні». Друк чужого реєстру він отримає відмову «Реєстрами Нової пошти керує співробітник, який бачить усі замовлення: у реєстрі накладні всього кабінету.»
Меню вікна «Відправлення» → «Реєстри Нової пошти» показує реєстри кабінету: номер, дату, позначку «роздруковано» чи «відкритий». Тут же — друк і «Розформувати»: «Розформувати реєстр ‹номер›? Накладні залишаться, їх можна додати до іншого реєстру.»
1
Відкритий реєстр2
Роздрукований реєстр3
Розформувати- Відкритий реєстр — до нього ще можна додавати накладні.
- Роздрукований реєстр — додати до нього накладні вже не можна.
- Кнопка «Розформувати» (корзина) розформовує реєстр.
Переадресація, зміна даних і повернення посилки
Три дії з посилкою, яка вже в дорозі чи у відділенні, — без кабінету Нової пошти. Позначте рядок у «Відправленні», і над списком з'являться кнопки «Переадресувати», «Змінити дані накладної», «Повернути відправнику». Чи можна зробити дію саме зараз, вирішує Нова пошта: Elbuz спершу питає її, і якщо не можна, показує її відповідь.
Переадресація посилки Нової пошти на інше відділення
Угорі панелі видно, куди посилка йде зараз і кому. Далі:
- У полі «Місто» почніть вводити назву — від двох літер — і виберіть місто, потім «Відділення».
- Вкажіть «Хто платить» («Одержувач» або «Відправник (ми)»), «Форма оплати» й, за потреби, «Коментар для служби».
- «Розрахувати» покаже «Вартість» і «Орієнтовна доставка» — так ви знаєте, скільки коштує переадресація, до її оформлення.
- «Оформити переадресацію» → підтвердження «Переадресувати посилку на «‹відділення›»?» → «Заявку на переадресацію створено: ‹номер›».
1
Зараз2
Місто й відділення3
Вартість4
Оформити переадресацію- Рядок «Зараз» показує, куди посилка прямує зараз.
- Нове місто та відділення, куди треба переадресувати.
- Після «Розрахувати» з'являються вартість і орієнтовна доставка.
- Кнопка «Оформити переадресацію» створює заявку в службі.
Відділення в картці замовлення не змінюється — заявка записується в журнал замовлення: «Оформлено переадресацію накладної ‹номер›, заявка ‹номер›».
Зміна даних накладної
«Змінити дані накладної» відкриває те, що Нова пошта дозволяє змінити саме для цієї посилки: «ПІБ одержувача» й «Телефон одержувача», «Хто платить» і «Форма оплати». Не дозволяє нічого — «Служба не дозволяє змінити дані цієї накладної.» «Зберегти зміни» → «Надіслати до служби зміни накладної ‹номер›?» → «Заявку на зміну даних створено: ‹номер›».
Повернення посилки відправнику
- «Куди повернути» — адреса повернення, яку пропонує Нова пошта для вашого кабінету.
- «Причина» й «Уточнення причини» — зі списку Нової пошти.
- «Форма оплати»: «Готівка», а «Безготівково» — якщо Нова пошта його дозволяє; «Коментар для служби» — за потреби.
- «Розрахувати» — ціна й дата повернення.
- «Оформити повернення» → «Оформити повернення накладної ‹номер› відправнику? Послуга платна, вартість — за тарифом служби.» → «Заявку на повернення створено: ‹номер›».
1
Куди повернути2
Причина3
Вартість4
Оформити повернення- Відділення, куди посилка повернеться.
- Причина повернення та її уточнення.
- Після «Розрахувати» показано вартість повернення.
- Кнопка «Оформити повернення» створює заявку в службі.
У журнал замовлення пишеться «Оформлено повернення накладної ‹номер› відправнику, заявка ‹номер›». Номер зворотної накладної з'явиться у «Відправленні» в колонці «Накладна повернення» після однієї з найближчих перевірок статусу. Колонка за замовчуванням прихована — увімкніть її в меню вікна → «Налаштування колонок».
Як повідомити клієнта про посилку
SMS одержувачу вручну
У «Відправленні» кнопка «SMS одержувачу» над рядком або іконка SMS у рядку відкриває те саме вікно відправки, що й «Надіслати» → SMS у картці замовлення. Номер телефону підставляється з телефону доставки замовлення, а якщо він порожній — з картки клієнта; перевірте його перед надсиланням. Номер накладної впишіть у текст. Потрібен підключений сервіс SMS — як підключити.
Посилки, яким час нагадати, лишає фільтр «Закінчується зберігання» — у відділенні, і до повернення 2 дні чи менше.
Автоматичне SMS, коли посилка прибула
Elbuz може сам надіслати SMS, коли Нова пошта повідомила, що посилка у відділенні. Для цього потрібне автоматичне правило (список замовлень → меню в шапці → «Автоматичні правила»):
- подія — «Документ: оновлення»;
- умова — «Статус доставки» дорівнює «У пункті призначення»;
- команда — «Надіслати SMS» з текстом про відділення й номер накладної.
Спрацює, якщо замовлення в позначеному статусі і код 7, 8 стоїть у «Статусах доставки» (налаштування). Одне замовлення отримає це SMS один раз.
Де моє замовлення: відповідь AI і «Звернення»
- AI-підтримка відповідає клієнту на «де моє замовлення» в чаті, месенджері чи пошті: стан посилки, відділення, очікувана дата, до якого дня зберігається. Детальніше: статус посилки в AI.
- Проактивні повідомлення: «прибуло у відділення» і нагадування перед поверненням — повідомлення клієнту.
- «Звернення» для менеджера по проблемних посилках — «посилка чекає у відділенні, клієнт не забирає», «відмова від посилки / повернення відправнику», «накладений платіж не надійшов після доставки», «посилка застрягла в дорозі — немає руху». За замовчуванням вимкнені, клієнту нічого не надсилають: проблемні замовлення.
- AI змінює відділення Нової пошти за словами клієнта: зміна відділення. Режим за замовчуванням вимкнений. Перестворити ТТН у статусі «створено» AI може лише з увімкненим «Можна перестворити ТТН» — стару накладну він тоді видаляє через API; без дозволу передає звернення співробітнику.
Що лишається в кабінеті Нової пошти
Щоденна робота з посилками йде в Elbuz. У кабінет Нової пошти доведеться зайти для таких дій:
| Дія | Що зробити |
|---|---|
| Продовжити зберігання | у кабінеті; Elbuz показує, до якого дня посилка зберігається |
| Переадресувати на адресу, повернути на інше відділення чи адресу | у кабінеті; з Elbuz — переадресація на відділення й повернення на адресу з вашого кабінету |
| Змінити наложку на переказ на картку, змінити інтервал доставки кур'єром одержувачу, скасувати заявку на повернення чи переадресацію | у кабінеті |
| Видалити накладну, яку Нова пошта вже прийняла | ніде — посилку повертають відправнику (повернення) |
| Документи, палети, шини; місця з різними габаритами | у кабінеті; з Elbuz — посилка або вантаж із загальною вагою й кількістю місць |
Сценарії
Перше підключення
Що зробити. Створіть ключ у кабінеті, впишіть у «Токен», увімкніть «Активність», виберіть місто й відділення відправника, позначте статуси «Відвантажено» і «Доставлено» й відкрийте три вікна статусів.
Що вийде. За 10 хвилин (або одразу після «Оновити статуси») у «Відправленні» почнуть з'являтися статуси посилок за останні 60 днів — по 100 накладних за прохід. Замовлення у «Відвантажено» самі переходитимуть у «Доставлено», а далі у «Виконано».
Щоденне відвантаження
Що зробити. Позначте замовлення в списку й виберіть «Створити ТТН (доставка)», потім у «Відправленні» відфільтруйте «Не передані», позначте всі, «Додати в реєстр Нової пошти» → «Новий реєстр на сьогодні» → «Додати», потім «Друк реєстру» і «Друк маркувань». Посилки забирає кур'єр — «Викликати курʼєра» по тих самих рядках.
Що вийде. Один реєстр у двох примірниках і маркування на кожну посилку; номер реєстру — у кожному замовленні, кур'єр приїде в обраний інтервал.
Накладні без натискань
Що зробити. У підключенні Нової пошти виберіть відправника, а в автоствореннях — статус «Зібрано».
Що вийде. Щойно склад переводить замовлення в «Зібрано», протягом 10 хвилин у ньому з'являється номер накладної; відмови Нової пошти видно в історії замовлення.
Клієнт просить інше відділення, посилка вже їде
Що зробити. «Відправлення» → рядок → «Переадресувати», виберіть місто й відділення, «Розрахувати», назвіть клієнту ціну, «Оформити переадресацію».
Що вийде. Заявка в Новій пошті, запис у журналі замовлення; нове відділення з'явиться в колонці «Відділення» після перевірки статусу.
Посилка лежить, скоро повернеться
Що зробити. Фільтр «Закінчується зберігання» → «SMS одержувачу».
Що вийде. Клієнт отримує нагадування, поки посилку ще можна забрати; продовжити зберігання — у кабінеті Нової пошти.
Контроль наложки за тиждень
Що зробити. Фільтр «Чекає переказ» і плитка «Переказ наложки в дорозі»; увімкніть у «Зверненнях» проблему «накладений платіж не надійшов після доставки».
Що вийде. Ви бачите суму, що в дорозі, а замовлення, де гроші не прийшли за 5 днів, потрапляють менеджеру окремим зверненням.
Що робити, коли щось пішло не так
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Служба доставки не підключена: заповніть налаштування API цієї служби (Налаштування → Зовнішні сервіси API).» під час відкриття форми накладної; пачкою — «порожньо - API токен» | Не вписано ключ або вимкнено «Активність», зокрема після автовимкнення | Впишіть ключ і ввімкніть «Активність» (куди вписати ключ) |
| Сповіщення «Інтеграцію вимкнено» | Нова пошта 10 разів поспіль відхилила ключ | Створіть новий ключ у кабінеті, впишіть у «Токен», увімкніть «Активність» (автовимкнення) |
| «порожньо Відправник - Відправник» (або «- Контактна особа», «- Місто», «- Відділення») | У підключенні Нової пошти не вибрано відправника, контактну особу чи відділення відправки | Виберіть їх у блоці «Відправник» підключення — далі всі накладні підставлять їх самі (куди вписати ключ) |
| Списки «Відправник» і «Контактна особа» в підключенні порожні | Нова пошта не прийняла ключ | Скопіюйте ключ із кабінету ще раз і впишіть у «Токен» (ключ API) |
| «Error: Street not found in the city: ‹вулиця›» | Вулиці з такою назвою немає в довіднику Нової пошти для міста одержувача | Впишіть назву вулиці без «вул.» і скорочень, як її пише Нова пошта (адресна доставка) |
| У формі накладної порожні місто й відділення одержувача | Назва міста чи відділення в замовленні не збіглася з довідником Нової пошти | Виберіть місто й відділення у формі вручну (довідники) |
| Накладну видалили в кабінеті, а «Створити накладну» в картці немає | Номер видаленої накладної лишився в замовленні | Очистіть «Сервіс доставки: номер» у «Більше полів» (після створення) |
| «‹номер›: накладної немає в кабінеті Нової пошти цього ключа API (створена в іншому кабінеті або видалена).» при додаванні в реєстр | Накладну створено в іншому кабінеті Нової пошти, не в тому, чий ключ вписано в Elbuz | Додайте її до реєстру в тому кабінеті, де її створено (реєстр) |
| «Реєстрами Нової пошти керує співробітник, який бачить усі замовлення: у реєстрі накладні всього кабінету.» | У вас обмежено «Чиї дані» | Додавайте накладні в новий реєстр; чужі реєстри друкує співробітник із доступом до всіх замовлень (список реєстрів) |
| «Служба не дозволяє змінити дані цієї накладної.» | На цьому етапі Нова пошта зміни не приймає | Перевірте переадресацію або зверніться в кабінет Нової пошти (дії з посилкою) |
| «Посилку вже передано Новій пошті — накладну не можна змінити чи видалити.» | Нова пошта вже прийняла посилку | Одержувача чи платника змініть через «Змінити дані накладної», посилку поверніть «Повернути відправнику» (дії з посилкою) |
| «Послугу «Виклик курʼєра» підключає персональний менеджер Нової пошти…» | У вашому договорі не підключено виклик кур'єра | Зверніться до персонального менеджера Нової пошти (виклик кур'єра) |
| «Накладну не створено автоматично: ‹причина›. Наступна спроба — за годину.» в історії замовлення | Нова пошта відмовила або в замовленні бракує даних | Виправте дані замовлення — повторна спроба буде сама (автостворення) |
| Посилки оновлюються, а статус замовлення не змінюється | Статус замовлення не позначено в підключенні або вікна статусів ще не відкривали | Позначте статуси й відкрийте три вікна статусів (автозміна статусів) |
| «Помилка оновлення довідників:» і причина | Довідник зараз недоступний; лишається попередня версія | Спробуйте «Оновити довідники» пізніше або дочекайтеся нічного оновлення (довідники) |
Часті запитання
Скільки коштує інтеграція з Новою поштою?
Elbuz за накладні, статуси й дії з посилками нічого не списує. Накладну, переадресацію й повернення ви оплачуєте Новій пошті за її тарифом, SMS — сервісу SMS.
Чи бачить Elbuz накладні, створені в кабінеті Нової пошти?
Так: меню «Відправлення» → «Накладні з кабінету Нової пошти» показує ті, яких немає в замовленнях, і прив'язує їх до замовлення (накладні з кабінету). Після прив'язки посилка відстежується, як створена в Elbuz.
Чому статус у Elbuz відстає від сайту Нової пошти?
Elbuz питає Нову пошту кожні 10 хвилин і за прохід бере до 100 накладних. Щоб оновити зараз, натисніть «Оновити статуси» у «Відправленні».
Скільки часу Elbuz стежить за посилкою?
До кінцевого коду Нової пошти — 9, 11, 106, видалено чи знищено. Замовлення в непозначених статусах — до 60 днів від створення, у позначених — без обмеження за датою. Посилка з кодом 10 відстежується далі, доки не прийде переказ.
Ключ у формі показується крапками — він збережений?
Так: крапки в полі «Токен» стоять, лише якщо ключ збережено. Порожнє поле ключ не стирає; щоб замінити ключ, впишіть новий поверх.
Чи можна скасувати накладну з Elbuz?
Так, поки Нова пошта не прийняла посилку: «Видалити накладну» в картці замовлення або у «Відправленні». Після передачі — лише повернення відправнику (зміна й видалення).
Чи можна продовжити зберігання посилки з Elbuz?
Ні, продовження — у кабінеті Нової пошти. Elbuz показує, до якого дня посилка чекає у відділенні, і дає надіслати клієнту SMS (SMS вручну).
Чому SMS «статус змінився» не приходить, коли статус змінила Нова пошта?
В умові стоїть «не дорівнює «Початкове значення»», а її перевіряють лише при збереженні людиною. Для статусу від Нової пошти задайте умову «Статус доставки дорівнює …» (автоматичне SMS).
Де це і хто має доступ
- Меню
- Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка
- Інші входи
- Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
- Право доступу
- підключення — «API та токени доступу»; посилки — вікно «Відправлення»; ТТН — вікно «Створення ТТН служби доставки»
- Підготувати
- ключ API з бізнес-кабінету Нової пошти, місто й відділення, з якого відправляєте
Дії з посилками працюють лише для замовлень, які користувач бачить за налаштуванням «Чиї дані». Список реєстрів кабінету бачить тільки той, кому відкриті всі замовлення: у реєстрі Нової пошти лежать накладні всіх менеджерів.
- Створити ключ APIБізнес-кабінет Нової пошти
- Вписати ключ, вибрати відправника, місто й відділенняЗовнішні сервіси та інтеграції → Нова пошта
- Позначити статуси й відкрити вікна кодівТам само, «Налаштування повідомлень»
- Виписати ТТНКартка замовлення, секція «Доставка»
- Скласти реєстр, надрукувати маркування, викликати кур'єраВідправлення
- Переадресувати, повернути, змінити даніВідправлення, панель над рядком
Суміжні теми
- Якщо потрібно побачити всі посилки всіх служб в одному списку — Відправлення.
- Якщо відправляєте іншою службою або через Rozetka — як виписати накладну із замовлення.
- Якщо накладні треба виписати по десятках замовлень — накладні пачкою.
- Якщо клієнт не забирає посилку чи не прийшла наложка — проблемні замовлення у «Зверненнях».
- Якщо SMS ще не підключено — розсилка SMS.
