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

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

    Apaczka в Elbuz: накладні різних перевізників за одним договором

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

    Через Apaczka Elbuz виписує з картки замовлення посилку InPost, DPD, DHL, GLS чи іншого перевізника за цінами Apaczka. Програма друкує етикетку і кожні 10 хвилин приносить статус посилки.

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

    • Договору з перевізником немає — посилки йдуть за договором і цінами Apaczka.
    • Покупець забирає посилку в пункті — код пункту перевізника вписується в накладну.
    • Покупець платить при отриманні — наложка ставиться сама, гроші приходять на рахунок з Apaczka.

    З чого почати: створіть App ID і App Secret у панелі Apaczka → впишіть їх у запис Apaczka в Elbuz.

    Що вміє Apaczka в Elbuz

    • Накладна із замовлення — послугою, обраною в підключенні, на адресу або в пункт перевізника, з наложкою.
    • Етикетка — PDF з картки замовлення чи з «Відправлення».
    • Виклик кур'єра — разом із накладною, якщо в підключенні «Курʼєр забирає»; пізніше — для послуг DPD, якщо Apaczka ввімкнула вам забір через API.
    • Скасування накладної — доки перевізник не забрав посилку.
    • Статуси посилок — кожні 10 хвилин; за таблицею кодів міняється стан посилки і статус замовлення.

    Як підключити Apaczka API

    Де взяти App ID, App Secret і ID послуги

    1. Увійдіть у панель Apaczka і відкрийте «Ustawienia» → «API».
    2. Створіть застосунок API і скопіюйте App ID та App Secret.
    3. Дізнайтеся ID послуги, якою відправлятимете: кожна послуга — це перевізник і спосіб доставки, наприклад посилка DPD на адресу.

    Список послуг у кожного акаунта свій, Apaczka віддає його через API (service_structure). Якщо ID послуги не знаєте, запитайте підтримку Apaczka. Порядок створення ключів — у документації Apaczka API.

    Посилки Apaczka списує з передплаченого балансу («Moje konto» → «Doładuj konto») або виставляє рахунок, якщо ви перейшли на постоплату (Apaczka PRO).

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

    Де: «Зовнішні сервіси та інтеграції», група «Доставка» → запис «Apaczka.pl».

    Форма підключення Apaczka.pl: доступи, параметри служби та відправник
    1Користувач і Пароль
    2ID послуги за замовчуванням
    3Передача посилок
    4Рахунок для післяплати
    5Відправник
    1. Користувач і Пароль — App ID та App Secret із кабінету Apaczka.
    2. ID послуги Apaczka за замовчуванням — послуга зі списку вашого акаунта Apaczka.
    3. Передача посилок — здаєте в пункт самі чи викликаєте кур'єра.
    4. Рахунок для післяплати — IBAN; якщо порожньо, береться з акаунта.
    5. Відправник — контактна особа, адреса, телефон і e-mail; телефон та e-mail обов'язкові.
    ПолеЩо вписати
    «Користувач»App ID
    «Пароль»App Secret
    «ID послуги Apaczka за замовчуванням»ID послуги; без нього накладна не створиться
    «Передача посилок»«Сам здаю в пункт» (за замовчуванням) чи «Курʼєр забирає». З «Курʼєр забирає» кур'єра замовлено разом із накладною: Elbuz бере найближчий день і вікно забору, які Apaczka пропонує для індексу відправника
    «Рахунок для післяплати (IBAN, порожньо — з акаунта)»рахунок, куди Apaczka переказує наложку; порожньо — рахунок із налаштувань акаунта Apaczka
    Блок «Відправник»назва, контактна особа, індекс, місто, вулиця, дім, телефон, e-mail; усі, крім контактної особи й дому, обов'язкові
    «Активність»увімкніть

    «Токен», «Посилання на сервер API» і «API ver» для Apaczka не заповнюють. Кнопки «Зберегти» немає: кожна зміна поля зберігається одразу. App Secret після збереження показується крапками; порожнє поле його не стирає.

    Тестового середовища для Apaczka в Elbuz немає: кожна накладна — справжня посилка за тарифом Apaczka. Ключі під час збереження не перевіряються; помилку покаже перша накладна.

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

    Спосіб доставки в замовленні має бути «Apaczka.pl».

    Де: картка замовлення → «Доставка» → «Створити накладну». Якщо форму вже відкривали, посилання називається «Редагувати накладну».

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

    Форма створення накладної Apaczka.pl для замовлення PLDOC-4
    1Адреса одержувача
    2Пункт видачі перевізника
    3Вага та габарити
    4Опис відправлення
    1. Адреса одержувача підтягується із замовлення.
    2. Пункт видачі перевізника — код пункту, якщо доставка в пункт.
    3. Загальна вага та габарити посилки в кг і см.
    4. Опис відправлення — що всередині посилки.
    ПолеЩо стоїть одразуЩо перевірити
    «Прізвище», «Ім'я», «Телефон», «E-Mail»покупець із замовленняім'я — до 50 символів; без телефону накладна не створиться
    «Індекс», «Населений пункт», «Вулиця», «Дім», «Квартира»адреса доставки із замовлення, «Дім» і «Квартира» порожнідля доставки на адресу обов'язкові індекс, місто й вулиця
    «Пункт видачі перевізника (код)»пункт, обраний покупцем, якщо він є в замовленнікод пункту того перевізника, чия послуга в підключенні; з кодом адреса не обов'язкова
    «Загальна вага, кг»вага товарів × кількістьпорожня — у накладну піде 1 кг
    «Довжина», «Ширина», «Висота», смпорожніпорожні — піде 30 × 20 × 10 см
    «Опис відправлення»категорія товару, без неї — список товарівдо Apaczka піде 50 символів; порожній — «Towar»
    «Зворотна доставка (одержувач)»«Гроші» на суму замовлення, якщо воно не оплачене й оплата — наложений платіж; інакше «Не потрібно»оплатили карткою, а оплату не відмічено — поставте «Не потрібно»

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

    Суми у формі — у злотих. Якщо замовлення в іншій валюті, виправте суму наложки вручну. Наложку Apaczka переказує на ваш рахунок за 1–10 робочих днів (умови Apaczka).

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

    • Apaczka створює замовлення на посилку.
    • У поле «Сервіс доставки: номер» лягає номер посилки перевізника, з'являється «Створено товарно-транспортну накладну №‹номер›». Якщо перевізник ще не присвоїв номер, у полі буде номер замовлення Apaczka; етикетка й виклик кур'єра працюють і з ним.
    • Друга накладна на те саме замовлення не створиться: «Накладну вже створено: ‹номер› — пропущено.»
    • Якщо Apaczka відмовила, з'явиться «Error: Apaczka:» з причиною; значення форми збережено в замовленні.
    • Якщо в підключенні «Курʼєр забирає», а Apaczka не пропонує вікна забору для індексу відправника, — «Error: Apaczka: no courier pickup window…», накладну не створено. Поставте «Сам здаю в пункт» або перевірте індекс відправника.

    Накладні по десятках замовлень одразу — «Створити ТТН (доставка)» у списку замовлень, детальніше: накладні пачкою.

    Етикетка і виклик кур'єра

    Де: картка замовлення → «Перегляд накладної» → кнопка друку; або «Відправлення» → рядок → «Друк накладної». Етикетка відкривається PDF у новій вкладці, App Secret у браузер не потрапляє.

    Етикетку Elbuz друкує лише для накладних, створених з Elbuz. Для номера, вписаного в замовлення вручну, у вкладці буде «print error: Apaczka: order id is unknown…».

    Виклик кур'єра через Apaczka

    Якщо в підключенні «Курʼєр забирає», окремо кур'єра викликати не треба: заявка йде разом із накладною. Кнопка «Викликати курʼєра» — для посилок, створених із «Сам здаю в пункт».

    Забір через API Apaczka приймає лише для послуг DPD і лише після того, як підтримка Apaczka ввімкне його вашому акаунту (документація Apaczka). Для інших перевізників кур'єра замовляйте в панелі Apaczka.

    1. У «Перегляді накладної» перевірте «Дата забору»: стоїть завтрашній день, у п'ятницю й вихідні — понеділок.
    2. «Забрати з» і «до» залиште порожніми — Elbuz візьме перше вікно, яке Apaczka пропонує для індексу відправника.
    3. Натисніть «Викликати курʼєра» → «Курʼєра замовлено» і номер заявки, якщо Apaczka його повернула.

    Скасування накладної

    Де: картка замовлення → «Перегляд накладної» → «Видалити накладну»; або «Відправлення» → рядок → «Видалити накладну». Потрібне право створювати накладні.

    1. Підтвердьте «Видалити накладну ‹номер› у службі доставки?».
    2. Apaczka скасовує замовлення, у картці зникають номер і посилання відстеження → «Накладну видалено. Замовлення можна оформити знову.»

    Скасувати можна, доки перевізник не забрав посилку. Пізніше Apaczka відмовляє, і Elbuz показує «Служба доставки не видалила накладну:» з її причиною; номер у замовленні лишається. Посилку, яку відстеження вже бачить у дорозі, у пункті чи доставленою, Elbuz видалити не пропонує.

    Після скасування Apaczka не віддає етикетку цієї посилки. Потрібна етикетка — завантажте її до скасування.

    Статуси посилок Apaczka

    Elbuz питає Apaczka про кожну посилку раз на 10 хвилин, до 100 посилок за прохід. Відстежуються замовлення за останні 60 днів і замовлення в позначених статусах. Усі посилки видно у «Відправленні»; текст статусу — як його дав перевізник.

    Коди статусів Apaczka

    Apaczka зводить статуси всіх перевізників до одного списку, і цей статус Elbuz бере як код. Коди з таблиці нижче Elbuz вписує в «Статуси доставки» сам.

    Де: підключення Apaczka → «Налаштування повідомлень» → «Статуси доставки», колонка «Код (назва) на сайті (API)». Кілька кодів — через кому.

    Ваш статус доставкиКод ApaczkaЩо означає
    «Чекання від відправника»NEWзамовлення створено
    «У дорозі»PICKUP, IN_TRANSITпосилку забрано, вона в дорозі, у кур'єра на доставці чи в пункті
    «Доставлено»DELIVERED, DELIVERED_NO_SYSTEMдоставлено; Elbuz більше не питає Apaczka
    «Відмова від отримання»RETURNED_TO_SHIPPERповернуто відправнику

    EXCEPTION, CANCELLED, CORRECTION і UNKNOWN не вписуйте: такі посилки будуть у стані «Невідомо» у фільтрі «Проблеми». Список статусів — у документації Apaczka.

    Щоб сам мінявся статус замовлення чи оплати, так само заповніть «Статуси замовлення» і «Статуси оплати». Позначте статуси замовлень у блоці «Статуси замовлень, за якими перевіряти статус посилки в службі доставки». Зміна пишеться в історію замовлення: «Змінився статус доставки: ‹код› ‹текст› #‹номер›».

    Поки DELIVERED не вписано в «Доставлено», Elbuz питає Apaczka про доставлену посилку всі 60 днів.

    Що лишається в панелі Apaczka

    • Поповнення балансу, рахунки, рахунок для наложки — у налаштуваннях акаунта Apaczka.
    • Кур'єр для перевізників, крім DPD, і посилки за кордон — у панелі Apaczka.

    Кнопка «Відстеження на сайті служби» у «Відправленні» для Apaczka відповідає «У цієї служби немає публічної сторінки відстеження.»

    Сценарії

    Перше підключення

    Ситуація. Магазин відкривається, договорів з перевізниками немає.

    Що зробити. Зареєструйтеся в Apaczka, поповніть баланс, створіть ключі API й дізнайтеся ID послуги. Впишіть усе в підключення разом з адресою, телефоном і e-mail відправника.

    Що вийде. Перша ж накладна з Elbuz — справжня посилка за цінами Apaczka.

    Посилка в пункт видачі

    Ситуація. У підключенні послуга доставки в пункт, покупець обрав пункт на сайті.

    Що зробити. У формі перевірте «Пункт видачі перевізника (код)». Код має належати перевізнику послуги.

    Що вийде. Посилка поїде в пункт; адресу одержувача можна не заповнювати.

    Наложка на власний рахунок

    Ситуація. Гроші за наложку мають приходити на окремий рахунок магазину.

    Що зробити. Впишіть IBAN у «Рахунок для післяплати (IBAN, порожньо — з акаунта)».

    Що вийде. Кожна накладна з наложкою з Elbuz піде з цим рахунком.

    Що робити, коли щось пішло не так

    Розбір частих проблем
    Що ви бачитеЧому такЩо зробити
    «Служба доставки не підключена: заповніть налаштування API цієї служби…» у вікні накладної Не вписано App Secret або вимкнено «Активність» Впишіть App ID і App Secret, увімкніть «Активність» (куди вписати)
    «Error: Apaczka service ID is required (API settings)» Не вписано ID послуги Заповніть «ID послуги Apaczka за замовчуванням» (ID послуги)
    «Error: sender address, phone and email are required (API settings)» У блоці «Відправник» порожня назва, індекс, місто, вулиця, телефон чи e-mail Заповніть відправника в підключенні
    «Error: address or pickup point is required for recipient» Немає ні адреси одержувача, ні коду пункту Впишіть адресу або «Пункт видачі перевізника (код)»
    «Error: Apaczka:» з відмовою Apaczka не прийняла замовлення: неправильні ключі, послуга не вашого акаунта чи код пункту іншого перевізника Звірте ключі, ID послуги й баланс у панелі Apaczka
    «print error: Apaczka: order id is unknown…» Номер вписано в замовлення вручну, а не створено з Elbuz Надрукуйте етикетку в панелі Apaczka
    Відмова під час «Викликати курʼєра» Послуга не DPD або забір через API акаунту не ввімкнено Замовте кур'єра в панелі Apaczka або попросіть підтримку ввімкнути забір через API (виклик кур'єра)
    Посилки Apaczka у «Відправленні» в стані «Невідомо» Код Apaczka не вписаний у «Статуси доставки» Впишіть коди (коди статусів)

    Часті запитання

    Скільки коштує інтеграція з Apaczka?

    Elbuz за накладні й статуси нічого не списує. Посилки оплачуються Apaczka за її цінами — з балансу чи за рахунком.

    Чи можна вибрати перевізника для окремої посилки?

    Ні: усі накладні з Elbuz ідуть послугою з підключення. Інший перевізник — у панелі Apaczka або через пряме підключення служби, наприклад DPD Polska.

    Чи можна перевірити інтеграцію без справжніх посилок?

    Ні: Elbuz працює лише з бойовою Apaczka. Першу накладну випишіть на тестове замовлення і скасуйте її кнопкою «Видалити накладну», поки посилку не забрали.

    Чи можна скасувати накладну з Elbuz?

    Так, доки перевізник не забрав посилку: «Перегляд накладної» → «Видалити накладну» (скасування).

    Чому статус у Elbuz відстає від Apaczka?

    Elbuz питає Apaczka раз на 10 хвилин і бере до 100 посилок за прохід. Поточний статус показує «Перегляд накладної».

    Де це і хто має доступ

    Меню
    Кабінет → Налаштування системи → Інші налаштування → Зовнішні сервіси та інтеграції → Доставка
    Інші входи
    Довідники → Документи → Відправлення → «Служби доставки»; картка замовлення → секція «Доставка»
    Право доступу
    підключення — «API та токени доступу»; накладна і кур'єр — вікно «Створення ТТН служби доставки»; посилки — «Відправлення»
    Підготувати
    акаунт Apaczka з поповненим балансом, App ID і App Secret, ID послуги

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

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

    Суміжні теми

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

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

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

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

    Зміст статті

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

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