Каталог — це те, що ви продаєте; замовлення — те, що у вас купують. Elbuz уміє забирати не лише товари, а й замовлення напряму з маркетплейсів і систем через API. Тоді всі продажі з різних майданчиків стікаються в одне місце — у документи Elbuz, — і ви обробляєте їх централізовано, не перемикаючись між кабінетами й не переписуючи замовлення руками.
Ця стаття — груповий огляд усіх підключень, які приносять замовлення. Про завантаження товарів дивіться окремий огляд імпорту каталогу через API, а про завантаження даних загалом — огляд завантаження.
Звідки беруться замовлення
Замовлення в Elbuz приходять із двох типів джерел. По-перше, це ті самі каталожні інтеграції, що вміють і товари, і замовлення: Rozetka, Shopify, WooCommerce, Amazon, eBay, Allegro, eMAG. У них замовлення вмикаються тим самим підключенням — окремим перемикачем у шаблоні (докладніше — у статтях відповідних площадок і в огляді каталогу через API).
По-друге, є системи, які приносять тільки замовлення й каталогом не займаються: маркетплейси Kaspi.kz, Prom.ua (сімейство EVO), Forte KZ, ceneo.pl, а також кас-система (POS) dotykacka. Саме про них ця стаття. Товари з них у каталог не тягнуться — приходять лише як рядки самих замовлень.
Де це у програмі
У вікні імпорту ви створюєте шаблон і обираєте потрібну систему зі списку. Далі вводите ключ доступу (найчастіше це один токен) і вмикаєте завантаження замовлень. Один шаблон — одне підключення до одного акаунта; під різні акаунти чи майданчики заводять окремі шаблони. Порядок для всіх систем однаковий, тож нижче описано спільну частину, а для найбільших — Kaspi та Prom — є окремі детальні статті.
Як це працює загалом
Ви створюєте шаблон, обираєте систему й вводите ключ доступу — зазвичай це токен з кабінету продавця. Далі Elbuz звертається до системи-джерела й забирає замовлення, перетворюючи кожне на документ: із покупцем, складом позицій, сумами й статусом. Перше підключення тягне наявні замовлення за певний період, наступні — лише нові та змінені. Коли все працює, шаблон ставлять на розклад.
Що приходить із замовленням
Із кожного замовлення Elbuz бере склад позицій (що саме куплено, кількість, ціни), дані покупця (контрагента), суми й поточний статус на боці майданчика. На основі цього створюється документ — замовлення покупця, — з яким далі працюють ваші менеджери: підтверджують, комплектують, відвантажують. Оскільки джерело віддає замовлення разом із товарами-рядками, окремо завантажувати каталог для цього не треба — навіть якщо самих товарів у вашому каталозі ще немає, замовлення все одно збережеться коректно.
Статуси і їх зіставлення
У кожного майданчика свої назви статусів замовлення (новий, на підтвердженні, доставляється, виконано, скасовано). Elbuz зводить їх до власних статусів, щоб замовлення з різних джерел виглядали однаково. Базове зіставлення вже вбудоване в кожне підключення. Крім того, для низки систем (Kaspi, Prom, Forte) прямо у формі шаблону є кнопки тонкого налаштування: ви можете вручну задати, який зовнішній статус замовлення, доставки чи оплати відповідає якому вашому, а також зіставити типи оплати й доставки. Це стане в пригоді, якщо ваші внутрішні статуси відрізняються від типових.
Розклад і оновлення
Усі ці системи працюють поллінгом: Elbuz сам звертається до них за розкладом і забирає свіжі замовлення. Вебхуків (коли майданчик миттєво штовхає замовлення до вас) для них немає — тому важливий саме розклад. Частоту обирають за оборотом: активному магазину має сенс перевіряти замовлення часто, кільканадцять разів на день; спокійному — рідше. Щоб не тягнути одне й те саме двічі, Elbuz веде інкремент: запам'ятовує дату й номер останнього завантаженого замовлення й наступного разу бере лише те, що з'явилося після. Перше ж підключення забирає замовлення за розумний період назад, тож історія не губиться.
Кожен запуск лишає слід у журналі: скільки замовлень завантажено, скільки оновлено, чи були помилки. Перші кілька разів варто туди зазирати — так одразу видно, якщо, наприклад, ключ протух або майданчик тимчасово недоступний.
Які системи приносять замовлення
Нижче — системи, з яких Elbuz забирає саме замовлення. Для найбільших заведено окремі статті з їхніми ключами й особливостями; для решти вистачає спільного порядку, описаного тут.
| Система | Що це і що потрібно |
|---|---|
| Kaspi.kz | маркетплейс №1 у Казахстані; потрібен токен із кабінету продавця |
| Prom.ua (EVO) | маркетплейс №1 в Україні, сімейство EVO; потрібен токен кабінету |
| Forte KZ | маркетплейс Forte Market (Казахстан); потрібен API-ключ |
| ceneo.pl | майданчик у Польщі; потрібен ключ доступу (обмінюється на токен) |
| dotykacka | каса/POS (продажі офлайн-точки як замовлення); потрібні ID інстансу й токен |
Перелік у самому вікні імпорту може бути ширшим за цей і поповнюється. Каталожні майданчики (Rozetka, Shopify та інші) у цю таблицю не внесені навмисно — вони приносять замовлення своїм же підключенням, описаним у їхніх статтях.
Підключення ПриватБанку (Автоклієнт) стоїть поруч у списку, але приносить не замовлення, а банківські надходження — виписку по рахунку, з якої створюються платіжні документи. Це окрема тема (звірка оплат), не імпорт замовлень, тож у цьому огляді ми його не розглядаємо.
Навіщо зводити замовлення в Elbuz
Коли ви продаєте на кількох майданчиках, замовлення розкидані по різних кабінетах, і легко щось проґавити або відвантажити те, чого немає. Звівши їх у Elbuz, ви отримуєте одну чергу обробки: усі продажі в одному місці, з єдиними статусами, зі списанням зі складу й обліком контрагентів. Менеджеру не треба тримати десяток вкладок — він працює з одним списком замовлень, звідки б вони не прийшли.
Перш ніж ставити шаблон на частий розклад, зробіть одне пробне завантаження й перевірте кілька замовлень: чи правильно приїхали позиції, суми, покупець і статус. Переконались, що зіставлення статусів вас влаштовує, — тоді вмикайте регулярне оновлення.
Що далі із завантаженими замовленнями
Завантажити замовлення — це початок. Далі вони живуть у Elbuz як документи «замовлення покупця», і з ними працюють як зі звичайними замовленнями: підтверджують, резервують і списують товар зі складу, оформлюють доставку й друкують документи, ведуть покупця в базі контрагентів. Якщо ви тільки починаєте знайомство з системою, орієнтуйтеся на загальну карту дій — з чого почати і куди рухатися: там показано, як влаштований увесь робочий цикл в Elbuz.
Коли підключень кілька, усі замовлення сходяться в один список незалежно від майданчика, і менеджер обробляє їх однаково. Це і є сенс зведення продажів в одну систему: не перемикатися між кабінетами, а працювати з єдиною чергою — з передбачуваними статусами, складом і документами. А ті майданчики, що вміють ще й каталог, можна під'єднати повністю — і товари, і замовлення (див. огляд каталогу через API).
Часті питання
Чи потрібно спершу завантажити каталог, щоб тягнути замовлення?
Ні. Замовлення приходять разом зі своїми позиціями-рядками, тож зберігаються коректно навіть якщо цих товарів у вашому каталозі ще немає. Каталог і замовлення — незалежні перемикачі.
Замовлення приходять миттєво?
Для цих систем — ні, вони працюють поллінгом: Elbuz забирає замовлення за розкладом. Тому для активного магазину варто поставити частіший розклад. Миттєвий прийом (вебхук) у системі є лише для окремих інтеграцій, як-от Shopify.
Статуси замовлень із різних майданчиків будуть різні?
Ні, Elbuz зводить їх до власних статусів. Базове зіставлення вбудоване, а для Kaspi, Prom і Forte ви можете додатково налаштувати відповідність статусів, оплати й достави прямо у формі шаблону.
Повторне завантаження задвоїть замовлення?
Ні. Elbuz веде інкремент за датою й номером останнього замовлення й упізнає вже завантажені за їхнім ідентифікатором, тож копій не створює.
Можна підключити кілька майданчиків одразу?
Так. Під кожен акаунт заводиться окремий шаблон зі своїм ключем і розкладом, а всі замовлення стікаються в одну чергу обробки в Elbuz.

