↑↓ вибірEnter відкритиEsc закрити

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Продажі та документи
    4. Обробка замовлень покупця
    5. Служби доставки в Elbuz

    Нова пошта API в Elbuz: ТТН, реєстри, повернення і наложка

    30 хв читанняОновлено

    Нова пошта API підключається в Elbuz одним ключем, і програма виписує ТТН, кожні 10 хвилин приносить статуси посилок, складає реєстри, оформлює переадресацію й повернення — без бізнес-кабінету Нової пошти.

    Коли це знадобиться:

    • Щодня десятки відправлень — ТТН виписується з картки замовлення, реєстр і маркування — з одного вікна.
    • Посилки повертаються з відділень — видно, у кого закінчується зберігання; SMS клієнту — звідти ж.
    • Наложений платіж — видно, які посилки отримано, а переказ ще в дорозі, і на яку суму.
    • Клієнт просить інше відділення — переадресація й повернення оформлюються з Elbuz, вартість видно заздалегідь.

    З чого почати: створіть ключ API у кабінеті Нової пошти → впишіть його в Elbuz.

    Розмова з підтримкою — замість читати: навіщо це потрібно, що налаштувати і що ви отримаєте.

    Що вміє Нова пошта в Elbuz

    • ТТН із замовлення — на відділення, поштомат чи адресу, по одній, пачкою або автоматично за статусом замовлення; до передачі посилки накладну можна змінити чи видалити.
    • Статуси посилок — кожні 10 хвилин, з терміном зберігання, причиною невручення й переказом наложки; накладні з кабінету Нової пошти прив'язуються до замовлень.
    • Реєстр і кур'єр — один документ на всі посилки дня, друк реєстру й маркувань, виклик кур'єра за посилками.
    • Переадресація, зміна даних, повернення — з розрахунком вартості до оформлення, запис у журналі замовлення.
    • Контроль наложки — які посилки чекають переказу і на яку суму.
    • Повідомлення клієнту — SMS із реєстру посилок, автоматичне SMS за статусом доставки, відповідь AI на «де моє замовлення».
    • Захист від мертвого ключа — після 10 відмов поспіль підключення вимикається й приходить сповіщення.

    Як підключити Нову пошту: ключ API і налаштування

    Де взяти API-ключ Нової пошти

    Ключ створюється в бізнес-кабінеті Нової пошти і дає Elbuz доступ до вашого договору: накладних, реєстрів, статусів.

    1. Увійдіть у бізнес-кабінет Нової пошти.
    2. Відкрийте «Налаштування» → вкладку «Безпека» → блок «Мої ключі API».
    3. Натисніть «Створити ключ», прийміть умови використання API й скопіюйте ключ.
    Бізнес-кабінет Нової пошти: Налаштування, вкладка «Безпека», блок «Мої ключі API» з кнопкою «Створити ключ»
    1Вкладка «Безпека»
    2Мої ключі API
    3Створити ключ
    1. Ключі API живуть у налаштуваннях кабінету, вкладка «Безпека».
    2. Тут видно ключі, які вже є; ключ на кадрі приховано.
    3. Новий ключ — кнопкою «Створити ключ», його й вписуєте в Elbuz.

    Опис методів API Нова пошта публікує на developers.novaposhta.ua; для роботи в Elbuz він не потрібен.

    Куди вписати ключ в Elbuz

    Де: Кабінет → Налаштування системи → Інші налаштування → «Зовнішні сервіси та інтеграції» → група «Доставка» → запис Нової пошти.

    1. Вставте ключ у поле «Токен».
    2. Увімкніть «Активність».
    3. У блоці «Відправник» виберіть «Відправник» і «Контактна особа» — списки приходять з вашого кабінету Нової пошти одразу після того, як ви вписали ключ; телефон і e-mail підставляться з контактної особи.
    4. Там само виберіть «Область», «Місто» і «Відділення», з якого відправляєте посилки.
    5. Якщо у вас підключена послуга «Контроль оплати», увімкніть перемикач «Послуга "Контроль оплати"» — він стане значенням за замовчуванням для нових накладних.
    Форма підключення Нової пошти: токен, відправник, місто та відділення, контроль оплати
    1Токен
    2Відправник і контактна особа
    3Місто та відділення відправника
    4Послуга «Контроль оплати»
    1. Токен — ключ API з кабінету Нової пошти; у формі він прихований крапками.
    2. Відправник і контактна особа — обираються один раз для всіх накладних.
    3. Місто та відділення — звідки відправник здає посилки.
    4. Послуга «Контроль оплати» — вмикається, якщо потрібна ця послуга.

    Кнопки «Зберегти» у формі немає: кожна зміна поля зберігається одразу. Ключ у полі «Токен» не показується: якщо його збережено, у полі стоять крапки. Порожнє поле ключ не стирає; щоб замінити ключ, впишіть новий поверх.

    Ключ під час збереження окремо не перевіряється. Під час першого підключення ознака неправильного ключа — порожні списки «Відправник» і «Контактна особа» після того, як ви його вписали. Якщо замінити робочий ключ на неправильний, списки лишаться старими, а помилка з'явиться в журналі операцій: «API Novapost error». Скопіюйте ключ із кабінету ще раз, без пробілів.

    Відправника й контактну особу вибирають один раз: форма накладної й виписка пачкою підставляють їх самі. У формі окремої накладної їх можна замінити.

    Довідники міст і відділень

    Області, міста, відділення й поштомати Нової пошти Elbuz оновлює сам раз на добу вночі; блок «Довідники служби» у тій самій формі показує, скільки записів у кожному довіднику і коли його оновлено. Кнопка «Оновити довідники» запускає оновлення одразу — «Оновлення довідників... це може зайняти кілька хвилин».

    Якщо оновлення не вдалося, з'явиться «Помилка оновлення довідників:» з причиною, а довідник лишиться вчорашнім — нічого не стирається. Нове відділення, відкрите сьогодні, з'явиться в списках після нічного оновлення або після ручного.

    Коли Elbuz вимикає Нову пошту сам

    Якщо Нова пошта 10 разів поспіль відхиляє ключ — прострочений, видалений у кабінеті, — Elbuz знімає з підключення «Активність». Власник акаунта отримує сповіщення «Інтеграцію вимкнено» з текстом відповіді Нової пошти і порадою «Оновіть ключ API в налаштуваннях інтеграції та знову ввімкніть її.»

    Рахуються лише відмови через ключ: збої зв'язку чи технічні роботи Нової пошти підключення не вимикають. Відмову зараховує кожне звернення до Нової пошти з цим ключем — перевірка статусів, дії користувачів, — тож підключення вимикається після 10 відмов поспіль за ключем, іноді швидше, ніж за проходи перевірки.

    Якщо відстежувати нічого, перевірка статусів до Нової пошти не звертається. Одна успішна відповідь обнуляє лічильник.

    Поки підключення вимкнене, статуси посилок не оновлюються, ТТН не виписуються, а кнопки дій Нової пошти у «Відправленні» зникають. Щоб повернути роботу, створіть новий ключ у кабінеті, впишіть у «Токен» і ввімкніть «Активність».

    Як створити ТТН Нової пошти із замовлення

    Загальний порядок для всіх служб — у статті як виписати накладну із замовлення.

    Де: картка замовлення → «Доставка» → «Створити накладну».

    Що форма заповнить сама і що перевірити

    ПолеЩо стоїть одразуЩо перевірити
    «Відправник», «Контактна особа», місто й відділення відправниказ налаштувань підключенняможна замінити для окремої відправки
    «Прізвище», «Ім'я», «По батькові», «Телефон» одержувачадані покупця із замовленняякщо забирає інша людина — виправте тут
    «Місто», «Відділення» одержувачавідділення, обране покупцем на сайті; місто — за збігом назви з довідникомполя можуть бути порожні, якщо назва не збіглася, — накладна все одно піде на відділення покупця
    «Опис відправлення»категорія товару, а без неї — список товарівдо Нової пошти піде не більше 120 символів
    «Загальна вага, кг»вага кожного товару × кількість, разомпорожня вага — у накладну піде 2 кг
    «Зворотна доставка (одержувач)»«Гроші» на суму замовлення для неоплаченого, «Не потрібно» для оплаченогооплатили карткою, а оплату не відмічено — поставте «Не потрібно»
    «Платник за доставку»«Одержувач»доставку за ваш рахунок — «Відправник»; «Третя особа» — лише з «Код ЄДРПОУ/РНОКПП» платника
    Одержувач: «Приватна особа» / «Організація»«Приватна особа»для «Організація» обов'язковий «Код ЄДРПОУ/РНОКПП»; ПІБ — її контактна особа
    «Форма оплати за доставку»«Готівка»«Безготівковий розрахунок» — якщо платите за договором
    Форма створення ТТН Нової пошти у замовленні
    1Зворотна доставка
    2Контроль оплати
    3Платник за доставку
    4Відправник
    1. Зворотна доставка (одержувач) — тут вибрано «Гроші» із сумою замовлення.
    2. Перемикач послуги «Контроль оплати».
    3. Платник за доставку — одержувач, відправник або третя особа.
    4. Відправник уже вибраний з налаштувань підключення.

    Відділення, поштомат чи адреса

    «Спосіб відправлення» за замовчуванням — «Відділення». Варіант «Поштомат» у перемикачі неактивний: поштомат вибирається в списку відділень, і Elbuz передає Новій пошті місце 20×20×10 см. Обмежень поштомата за вагою й розміром програма не перевіряє.

    «Адреса» — доставка кур'єром до дверей: замість відділення з'являються «Вулиця», «Дім», «Квартира» й «Коментар на адресу (не обов'язково)»; вулиця й дім обов'язкові.

    Вулицю Elbuz шукає за назвою в довіднику Нової пошти в місті одержувача. Не знайшлася — накладна не створюється, а у вікні «Увага» буде «Error: Street not found in the city: ‹вулиця›». Впишіть назву без «вул.».

    Що відбувається після «Створити накладну»

    1. Elbuz перевіряє право на вікно створення накладної й обов'язкові поля. Бракує даних — з'явиться «Увага» з назвою поля, наприклад «порожньо Відправник - Контактна особа»; накладна не створюється, гроші не списуються.
    2. Програма реєструє одержувача в Новій пошті й створює експрес-накладну з датою відправки «сьогодні».
    3. Номер лягає в поле «Сервіс доставки: номер» замовлення, вікно закривається з повідомленням «Створено товарно-транспортну накладну №‹номер›». Посилання «Створити накладну» в картці зникає. Якщо у способі доставки заповнено «Посилання на трекінг», у замовлення записується й посилання на відстеження.
    4. Повторне натискання отримає «Накладну вже створено: ‹номер› — пропущено.»
    5. Якщо Нова пошта відмовила, у вікні «Увага» буде її текст, а замовлення лишиться без номера.
    Накладна створюється одразу, без перепитування, і коштує грошей за тарифом Нової пошти. Видалити її можна, поки посилку не передано Новій пошті (зміна й видалення); після передачі — лише повернення. Якщо накладну видалили в кабінеті Нової пошти, номер у замовленні лишається: щоб виписати нову, очистіть «Сервіс доставки: номер» у блоці «Більше полів».

    Як змінити або видалити накладну

    Поки Нова пошта не прийняла посилку — накладна в статусі «створено», — її можна змінити або видалити з Elbuz. «Перегляд накладної» в картці замовлення тоді відкриває ту саму форму з написом «Накладну ще не передано Новій пошті: дані можна змінити й зберегти або видалити накладну.»

    Нижня частина форми накладної в режимі правки: одержувач і кнопки внизу
    1Зберегти зміни
    2Видалити накладну
    1. «Зберегти зміни» — записує правки в накладну, поки її не передано Новій пошті.
    2. «Видалити накладну» — прибирає ще не передану накладну із замовлення.
    • «Зберегти зміни» надсилає форму в Нову пошту наново, номер накладної не змінюється: «Зміни збережено в накладній Нової пошти».
    • «Видалити накладну» після підтвердження видаляє накладну в Новій пошті й очищає замовлення: номер і стан посилки зникають, з'являється «Накладну видалено. Замовлення можна оформити знову.»

    Обидві дії пишуться в історію замовлення й потребують права на вікно «Створення ТТН служби доставки». Видалити можна й у «Відправленні» — для посилки в стані «Створено».

    Після передачі форма тільки показує накладну; одержувача й платника змінюють через «Змінити дані накладної».

    Накладні пачкою, автоматично і з кабінету Нової пошти

    Накладні пачкою

    «Створити ТТН (доставка)» у списку замовлень виписує накладні по всіх позначених замовленнях без форми.

    Відкривати форму кожного замовлення не потрібно: відправник — з підключення, вага — товари × кількість, опис — категорія або список товарів, решта — як у таблиці вище.

    Спосіб доставки береться із замовлення: на відділення — обране покупцем. Для доставки на адресу вулицю й дім пачка бере тільки зі збереженої форми накладної; без неї в рядку буде «порожньо Одержувач - Вулиця». Якщо у формі замовлення щось змінювали, беруться збережені в ній значення.

    Замовлення з накладною пропускаються з червоним рядком «Накладну вже створено: ‹номер› — пропущено.» Детальніше: накладні пачкою.

    Накладна сама, коли замовлення переходить у статус

    Elbuz може виписувати накладні без натискань. У підключенні Нової пошти виберіть статус у полі «Створювати накладну автоматично, коли замовлення переходить у статус», наприклад «Зібрано». За замовчуванням там «— не створювати —».

    Форма підключення Нової пошти: відправник і поле автоматичного створення накладної
    1Відправник
    2Створювати накладну автоматично
    3Підказка під полем
    1. Відправник обирається один раз — без нього автоматичне створення накладних не працює.
    2. Поле зі статусом замовлення, при переході в який Elbuz сам створює накладну; зараз стоїть «не створювати».
    3. Підказка пояснює, як часто й для яких замовлень створюються накладні та де видно помилку.

    Раз на 10 хвилин програма бере замовлення покупця в цьому статусі з доставкою Новою поштою, створені за останні 7 днів і ще без накладної, — до 20 за раз — і виписує накладні так само, як пачкою. В історії замовлення з'являється «Накладну ‹номер› створено автоматично».

    Без вибраного відправника автостворення не працює, і форма попереджає: «Оберіть відправника вище — без нього накладні автоматично не створюються.» Якщо Нова пошта відмовила, в історії замовлення буде «Накладну не створено автоматично: ‹причина›. Наступна спроба — за годину.» Виправте дані замовлення — наступна спроба пройде сама.

    Кожна автоматична накладна — платна послуга Нової пошти, і створюється вона без перепитування. Вибирайте статус, у який замовлення переходить лише тоді, коли його справді готові відправити.

    Накладні, виписані в кабінеті Нової пошти

    Якщо частину накладних виписують у кабінеті Нової пошти, Elbuz покаже ті, яких немає в жодному замовленні. Меню вікна «Відправлення» → «Накладні з кабінету Нової пошти»: виберіть період — за замовчуванням останні 14 днів, не довше 31 дня — і натисніть «Показати».

    У списку — номер, дата, стан, вартість доставки, сума наложки й номер реєстру; ПІБ і телефону одержувача там немає. «Привʼязати до замовлення» → «Номер замовлення в Elbuz» → підтвердження → «Накладну ‹номер› привʼязано: її стан тепер оновлюється автоматично.»

    Прив'язати можна лише до замовлення покупця без накладної; вид доставки замовлення стає «Нова пошта», в історії — «Привʼязано накладну ‹номер› з кабінету Нової пошти». Список бачить співробітник, який бачить усі замовлення: у кабінеті накладні всіх менеджерів.

    Панель «Накладні з кабінету Нової пошти» зі списком накладних, яких немає в замовленнях
    1Період і «Показати»
    2Немає в замовленнях Elbuz
    3Привʼязати до замовлення
    1. Поля «З» і «По» задають період, кнопка «Показати» завантажує накладні кабінету.
    2. Рядок показує, скільки накладних кабінету ще не привʼязано до замовлень.
    3. Значок привʼязки записує номер накладної в замовлення (на кадрі лише показано, не натискався).

    Наложений платіж і «Контроль оплати»

    ПеремикачЩо піде в Нову пошту
    вимкнено, «Зворотна доставка (одержувач)» — «Гроші»наложений платіж: зворотна доставка грошей на суму з поля «Сума», платить одержувач
    увімкнено, «Гроші»послуга «Контроль оплати» на ту саму суму
    «Не потрібно» — з перемикачем чи безпосилка без наложки

    «Контроль оплати» діє лише разом із «Гроші»: для оплаченого замовлення досить поставити «Не потрібно».

    Як побачити, що переказ дійшов

    Отриману посилку Нова пошта позначає одним із трьох кодів: 9 — отримано, 10 — отримано, переказ надійде протягом доби, 11 — переказ видано. За посилкою з кодом 10 Elbuz стежить далі, доки не прийде 11.

    • Колонка «Наложений платіж» у «Відправленні» показує суму й позначку: «переказ отримано», «чекає переказ» або «не викуплено» — для відмов.
    • Швидкий фільтр «Чекає переказ» лишає посилки, які отримано, а гроші ще не прийшли.
    • Плитки «Переказ наложки в дорозі» й «Наложка в активних» показують суми.
    Відправлення з фільтром «Чекає переказ»: колонка «Наложений платіж» з плашками «чекає переказ»
    1Переказ накладки в дорозі
    2Плашка «чекає переказ»
    3Фільтр «Чекає переказ»
    1. Плитка показує суму накладеного платежу, який Нова пошта ще не переказала.
    2. Плашка «чекає переказ» у колонці «Наложений платіж» — посилка отримана, гроші ще в дорозі.
    3. Швидкий фільтр «Чекає переказ» залишає тільки такі посилки.

    Статус оплати замовлення стає «Оплачено» сам за кодом 11, якщо замовлення в позначеному статусі — див. автозміну статусів.

    Як Elbuz стежить за посилками й міняє статуси замовлень

    Elbuz сам запитує в Нової пошти стан посилок кожні 10 хвилин — за розкладом завдання «Перевірка статусу доставки». Кнопка «Оновити статуси» запускає перевірку позачергово.

    Результат складається у вікно «Відправлення»: де посилка, у якому відділенні, до якого дня зберігається, скільки коштувала доставка, чи прийшов переказ, чому не вручено. Фільтри, колонки й плитки вікна — у статті Відправлення: усі посилки в одному реєстрі.

    Вікно «Відправлення»: плитки статистики, панель операцій над відміченою посилкою та список відправлень
    1Плитки статистики
    2Кнопки операцій Нової пошти
    3Зберігання до
    1. Плитки статистики — скільки посилок у відділенні, в дорозі, з відмовою, скільки переказів накладеного платежу очікується.
    2. Кнопки операцій над відміченою посилкою «В дорозі»: реєстр, друк маркувань, переадресація, зміна даних, повернення.
    3. Колонка «Зберігання до» — дата, до якої посилку тримають у відділенні, з позначкою «ще N дн.».
    Посилки оновлюються завжди, а статус самого замовлення — лише в позначених статусах і за кодами з вікон статусів
    нітакнітакнітакКожні 10 хвилин або кнопкою«Оновити статуси»До 100 накладних на підключення— спершу ті, що найдовше неперевірялисяНова пошта прийняла ключ API?Відмова зараховується — 10поспіль, і підключеннявимикаєтьсяСтан посилки, відділення, термінзберігання, наложка — узамовлення й реєстр«Відправлення»Статус замовлення позначено впідключенні?Статус замовлення не змінюєтьсяКод Нової пошти є у вікнахстатусів?Змінюються статус замовлення,доставки й оплати, запис ужурналіСпрацьовують процеси«Документ: оновлення» — SMS,листи
    • Дія або результат
    • Розвилка: далі шлях залежить від відповіді
    • Вирішальний крок
    • Elbuz стежить за накладними Нової пошти в замовленнях за останні 60 днів, а в замовленнях позначених статусів — без обмеження за датою. Опитування припиняється на кінцевому коді: 9 — отримано, 11 — переказ видано, 106 — отримано й створено зворотну доставку, 2 — видалено, 124 — знищено. Відмови кінцевими не є: за ними Elbuz стежить далі.
    • За один прохід — до 100 накладних, першими ті, що найдовше не перевірялися.
    • Номер, вписаний у замовлення вручну (накладну створили в кабінеті Нової пошти), теж відстежується — якщо вид доставки замовлення «Нова пошта».
    • Вартість доставки, яку порахувала Нова пошта, з'являється в колонці «Доставка»; у саме замовлення під час створення ТТН вона не пишеться.
    • ПІБ, телефон і адресу одержувача з відповіді Нової пошти Elbuz не зберігає.

    Як налаштувати автозміну статусу замовлення

    Статус замовлення, статус доставки й статус оплати Elbuz міняє лише в замовленнях, чий статус позначено в підключенні. Решта посилок просто відстежується.

    1. У формі підключення, блок «Статуси замовлень, за якими перевіряти статус посилки в службі доставки», позначте статуси, у яких замовлення чекає доставки, наприклад «Відвантажено» і «Доставлено». Позначайте й ті статуси, у які програма переведе замовлення сама: замовлення в «Доставлено» без позначки вже не перейде у «Виконано» і не отримає «Оплачено».
    2. У блоці «Налаштування повідомлень» відкрийте по черзі «Статуси замовлення», «Статуси доставки» і «Статуси оплати». Під час першого відкриття програма сама впише коди Нової пошти в колонку «Код (назва) на сайті (API)».
    3. Перевірте коди або допишіть свої через кому.
    Поки вікно статусів жодного разу не відкривали, кодів у ньому немає — і статуси замовлень не міняються, хоча посилки у «Відправленні» оновлюються.
    Коди Нової пошти, які програма вписує сама
    ВікноВаш статусКоди Нової пошти
    «Статуси замовлення»«Доставлено»7, 8 — прибула у відділення чи поштомат
    «Статуси замовлення»«Виконано»9, 10, 11 — отримано
    «Статуси доставки»«У дорозі»4, 41, 5, 6
    «Статуси доставки»«У пункті призначення»7, 8
    «Статуси доставки»«Доставлено»9, 10, 11
    «Статуси доставки»«Відмова від отримання»102, 103
    «Статуси оплати»«Оплачено»11 — переказ видано
    Вікно «Статуси доставки» для Нової пошти з колонкою кодів статусів служби
    1Колонка кодів
    2У пункті призначення — 7, 8
    1. Колонка «Код (назва) на сайті (API)» — коди статусів Нової пошти, які програма зіставила зі статусами доставки.
    2. Рядок «У пункті призначення» — посилка з кодами 7 і 8 вважається такою, що прибула у відділення.

    Коли статус змінився, у журнал операцій замовлення пишеться «Змінився статус доставки: ‹код› ‹текст Нової пошти› #‹номер накладної›», і спрацьовують ваші автоматичні правила на подію «Документ: оновлення» — наприклад, SMS про прибуття.

    Реєстр, маркування і виклик кур'єра

    Реєстр — один документ на всі посилки, які ви здаєте у відділення чи кур'єру, замість окремої накладної на кожну. Elbuz складає його в кабінеті Нової пошти.

    Де: Довідники → Документи → Відправлення → позначте рядки → «Додати в реєстр Нової пошти».

    1. Відфільтруйте «Не передані» — посилки, які ще не здані.
    2. Позначте потрібні рядки й натисніть «Додати в реєстр Нової пошти».
    3. У полі «Реєстр» виберіть «Новий реєстр на сьогодні» або відкритий реєстр, який ще не друкували.
    4. Натисніть «Додати». Програма відповість «Реєстр ‹номер›: додано накладних — ‹кількість›» і перелічить накладні, які Нова пошта не прийняла, з причиною.
    5. Натисніть «Друк реєстру» — роздрукуйте два примірники — і одну з кнопок маркування: «Маркування A4 (6 наклейок 85×85)» або «Маркування для термопринтера 100×100», щоб наклеїти маркування на кожну посилку.
    Панель «Додати в реєстр Нової пошти» з двома вибраними накладними
    1Номери вибраних накладних
    2Реєстр
    3Додати
    1. Номери накладних, які потраплять у реєстр.
    2. Поле «Реєстр» — «Новий реєстр на сьогодні» або вже відкритий.
    3. Кнопка «Додати» додає накладні в реєстр.

    Номер реєстру з'являється в колонці «Реєстр НП» і в журналі замовлення.

    Правила реєстру встановлює Нова пошта: усі накладні — від одного відправника; накладна може бути лише в одному реєстрі; після друку реєстру додати до нього нічого не можна; посилку, вже відскановану у відділенні, не додати. Elbuz шукає накладну за номером у кабінеті, до якого належить ключ, тож накладна чужого кабінету в реєстр не потрапить.

    Друк накладної, маркувань і реєстру

    КнопкаЩо друкується
    «Друк» у «Перегляді накладної», «Друк накладної» у «Відправленні»бланк експрес-накладної A4; позначено кілька накладних Нової пошти — усі бланки одним PDF
    «Друк маркувань» у «Відправленні» → «Маркування A4 (6 наклейок 85×85)»наклейки 85×85 мм, по 6 на аркуші A4 — для звичайного принтера
    «Друк маркувань» → «Маркування для термопринтера 100×100»етикетки 100×100 мм для термопринтера (Zebra)
    «Друк реєстру»реєстр приймання-передачі

    PDF відкривається з Elbuz у новій вкладці: входити в кабінет Нової пошти не потрібно, а ключа API в адресі немає. Якщо Нова пошта відмовила в друку, у тій самій вкладці буде текст причини.

    Червоне спливне повідомлення замість вкладки означає, що до Нової пошти запит не дійшов: немає ключа підключення чи номера накладної, «Немає доступу до цього відправлення.» — немає права або замовлення поза «Чиї дані», «Не вдалося виконати дію. Спробуйте ще раз.» — збій зв'язку.

    Виклик кур'єра за посилками

    Кур'єра Нової пошти, який забере посилки з вашої адреси, викликають з «Відправлень». По одній посилці його можна викликати й з вікна накладної в картці замовлення — блок «Виклик курʼєра» під формою; для кількох посилок — з «Відправлень».Послугу «Виклик курʼєра» підключає персональний менеджер Нової пошти.

    1. Позначте посилки й натисніть «Викликати курʼєра».
    2. «Дата забору» — найближчий робочий день: сьогодні, якщо зараз раніше 16:00, інакше наступний; вихідні переносяться на понеділок.
    3. «Інтервал» — вільні інтервали Нової пошти; «Адреса відправника» — з вашого кабінету; «Планова вага, кг» — сума ваги позначених накладних.
    4. «Викликати» → «Курʼєра викликано, заявка ‹номер›». Накладні, які Нова пошта до заявки не прийняла, буде перелічено з причиною.
    Панель виклику курʼєра Нової пошти для двох відмічених накладних
    1Дата забору
    2Інтервал
    3Адреса відправника
    4Планова вага, кг
    5Викликати
    1. Дата, на яку викликають курʼєра.
    2. Інтервал забору зі списку доступних.
    3. Адреса, з якої курʼєр забере посилки.
    4. Орієнтовна вага для всіх відмічених накладних.
    5. Кнопка створює заявку на курʼєра (на кадрі лише показана).

    Прийняті накладні отримують запис в історії замовлення. Немає вільних інтервалів — виберіть інший день; немає адрес — додайте адресу забору в кабінеті Нової пошти.

    Меню вікна → «Заявки на курʼєра» показує заявки за останні 7 днів і кнопку «Скасувати заявку». Якщо до кінця інтервалу лишилося менше години й розрахунок безготівковий, скасування платне — 350 грн. Список і скасування доступні співробітнику, який бачить усі замовлення: заявки спільні для всього кабінету.

    Список реєстрів і розформування

    Реєстр Нової пошти спільний для всього кабінету, тому співробітник з обмеженими «Чиї дані» пункту «Реєстри Нової пошти» не бачить, а в «Додати в реєстр Нової пошти» йому доступний лише «Новий реєстр на сьогодні». Друк чужого реєстру він отримає відмову «Реєстрами Нової пошти керує співробітник, який бачить усі замовлення: у реєстрі накладні всього кабінету.»

    Меню вікна «Відправлення» → «Реєстри Нової пошти» показує реєстри кабінету: номер, дату, позначку «роздруковано» чи «відкритий». Тут же — друк і «Розформувати»: «Розформувати реєстр ‹номер›? Накладні залишаться, їх можна додати до іншого реєстру.»

    Панель «Реєстри Нової пошти» зі списком реєстрів
    1Відкритий реєстр
    2Роздрукований реєстр
    3Розформувати
    1. Відкритий реєстр — до нього ще можна додавати накладні.
    2. Роздрукований реєстр — додати до нього накладні вже не можна.
    3. Кнопка «Розформувати» (корзина) розформовує реєстр.

    Переадресація, зміна даних і повернення посилки

    Три дії з посилкою, яка вже в дорозі чи у відділенні, — без кабінету Нової пошти. Позначте рядок у «Відправленні», і над списком з'являться кнопки «Переадресувати», «Змінити дані накладної», «Повернути відправнику». Чи можна зробити дію саме зараз, вирішує Нова пошта: Elbuz спершу питає її, і якщо не можна, показує її відповідь.

    Переадресація й повернення — платні послуги Нової пошти за її тарифом. Заявку не скасувати з Elbuz: після «Оформити…» вона вже в Новій пошті. Тому спершу натисніть «Розрахувати» — він є в панелях переадресації й повернення; у зміни даних розрахунку немає.

    Переадресація посилки Нової пошти на інше відділення

    Угорі панелі видно, куди посилка йде зараз і кому. Далі:

    1. У полі «Місто» почніть вводити назву — від двох літер — і виберіть місто, потім «Відділення».
    2. Вкажіть «Хто платить» («Одержувач» або «Відправник (ми)»), «Форма оплати» й, за потреби, «Коментар для служби».
    3. «Розрахувати» покаже «Вартість» і «Орієнтовна доставка» — так ви знаєте, скільки коштує переадресація, до її оформлення.
    4. «Оформити переадресацію» → підтвердження «Переадресувати посилку на «‹відділення›»?» → «Заявку на переадресацію створено: ‹номер›».
    Панель «Переадресувати» з розрахунком вартості
    1Зараз
    2Місто й відділення
    3Вартість
    4Оформити переадресацію
    1. Рядок «Зараз» показує, куди посилка прямує зараз.
    2. Нове місто та відділення, куди треба переадресувати.
    3. Після «Розрахувати» з'являються вартість і орієнтовна доставка.
    4. Кнопка «Оформити переадресацію» створює заявку в службі.

    Відділення в картці замовлення не змінюється — заявка записується в журнал замовлення: «Оформлено переадресацію накладної ‹номер›, заявка ‹номер›».

    Зміна даних накладної

    «Змінити дані накладної» відкриває те, що Нова пошта дозволяє змінити саме для цієї посилки: «ПІБ одержувача» й «Телефон одержувача», «Хто платить» і «Форма оплати». Не дозволяє нічого — «Служба не дозволяє змінити дані цієї накладної.» «Зберегти зміни» → «Надіслати до служби зміни накладної ‹номер›?» → «Заявку на зміну даних створено: ‹номер›».

    Повернення посилки відправнику

    1. «Куди повернути» — адреса повернення, яку пропонує Нова пошта для вашого кабінету.
    2. «Причина» й «Уточнення причини» — зі списку Нової пошти.
    3. «Форма оплати»: «Готівка», а «Безготівково» — якщо Нова пошта його дозволяє; «Коментар для служби» — за потреби.
    4. «Розрахувати» — ціна й дата повернення.
    5. «Оформити повернення» → «Оформити повернення накладної ‹номер› відправнику? Послуга платна, вартість — за тарифом служби.» → «Заявку на повернення створено: ‹номер›».
    Панель «Повернути відправнику» з розрахунком вартості
    1Куди повернути
    2Причина
    3Вартість
    4Оформити повернення
    1. Відділення, куди посилка повернеться.
    2. Причина повернення та її уточнення.
    3. Після «Розрахувати» показано вартість повернення.
    4. Кнопка «Оформити повернення» створює заявку в службі.

    У журнал замовлення пишеться «Оформлено повернення накладної ‹номер› відправнику, заявка ‹номер›». Номер зворотної накладної з'явиться у «Відправленні» в колонці «Накладна повернення» після однієї з найближчих перевірок статусу. Колонка за замовчуванням прихована — увімкніть її в меню вікна → «Налаштування колонок».

    Як повідомити клієнта про посилку

    SMS одержувачу вручну

    У «Відправленні» кнопка «SMS одержувачу» над рядком або іконка SMS у рядку відкриває те саме вікно відправки, що й «Надіслати» → SMS у картці замовлення. Номер телефону підставляється з телефону доставки замовлення, а якщо він порожній — з картки клієнта; перевірте його перед надсиланням. Номер накладної впишіть у текст. Потрібен підключений сервіс SMS — як підключити.

    Посилки, яким час нагадати, лишає фільтр «Закінчується зберігання» — у відділенні, і до повернення 2 дні чи менше.

    Автоматичне SMS, коли посилка прибула

    Elbuz може сам надіслати SMS, коли Нова пошта повідомила, що посилка у відділенні. Для цього потрібне автоматичне правило (список замовлень → меню в шапці → «Автоматичні правила»):

    • подія — «Документ: оновлення»;
    • умова — «Статус доставки» дорівнює «У пункті призначення»;
    • команда — «Надіслати SMS» з текстом про відділення й номер накладної.

    Спрацює, якщо замовлення в позначеному статусі і код 7, 8 стоїть у «Статусах доставки» (налаштування). Одне замовлення отримає це SMS один раз.

    Умова «Статус доставки не дорівнює «Початкове значення»» тут не підходить: її перевіряють лише при збереженні замовлення людиною, а статус від Нової пошти приходить без збереження — і SMS не піде. Детальніше про умови: SMS за статусом.
    Раз на 32 хвилини Elbuz сам перевіряє автоматичні правила по непроведених замовленнях за останні 30 днів — до 300 найновіших. Нове правило «статус доставки дорівнює …» за перший такий прохід надішле 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 з бізнес-кабінету Нової пошти, місто й відділення, з якого відправляєте

    Дії з посилками працюють лише для замовлень, які користувач бачить за налаштуванням «Чиї дані». Список реєстрів кабінету бачить тільки той, кому відкриті всі замовлення: у реєстрі Нової пошти лежать накладні всіх менеджерів.

    1. Створити ключ APIБізнес-кабінет Нової пошти
    2. Вписати ключ, вибрати відправника, місто й відділенняЗовнішні сервіси та інтеграції → Нова пошта
    3. Позначити статуси й відкрити вікна кодівТам само, «Налаштування повідомлень»
    4. Виписати ТТНКартка замовлення, секція «Доставка»
    5. Скласти реєстр, надрукувати маркування, викликати кур'єраВідправлення
    6. Переадресувати, повернути, змінити даніВідправлення, панель над рядком

    Суміжні теми

    Чи була стаття корисною?

    Не вистачає функції? Напишіть нам.

    Ми додамо її безкоштовно, якщо вона знадобиться й іншим.

    Якщо це потрібно тільки вам — домовимося окремо.

    Зміст статті

    Запропонувати доробку

    Спробувати безкоштовно