Elbuz сам забирає замовлення з кабінету продавця EVA.UA через API EVA (Merchant Center API) і кладе їх документами в одну чергу з іншими каналами. Підключення — логіном і паролем кабінету, а статус і ТТН можуть іти назад на EVA.
Коли це знадобиться:
- Каталог на EVA іде фідом з Elbuz — позиції замовлень лягають на ваші картки.
- Менеджери не хочуть двічі міняти статус — підтвердження й скасування доходять до EVA самі.
- EVA вимагає ТТН на підтвердженні — номер із документа йде разом зі статусом.
- Покупець скасував на EVA — документ сам стає «Скасовано», навіть проведений.
З чого почати: «Завантаження даних» → «Додати» → тип «EVA.UA», далі логін і пароль кабінету.
Що вміє підключення EVA
- Замовлення — покупець, отримувач, доставка, ТТН, оплата й коментар лягають у документ.
- Зіставлення з каталогом — позиції знаходять картки за кодом пропозиції з вашого фіду або за артикулом і назвою.
- Статуси EVA — зводяться до ваших без налаштування.
- Статус назад на EVA — підтвердження, ТТН і скасування з причиною.
- Розклад — кожні 5 хвилин, лише змінені замовлення.
Товари, ціни й залишки це підключення не передає: API EVA вміє тільки замовлення. Асортимент іде на майданчик XML-фідом.
Як підключити EVA за логіном і паролем
Окремих ключів чи токенів у кабінеті EVA немає. Elbuz входить в API тим самим логіном і паролем, якими ви заходите в кабінет продавця EVA.
- У вікні «Завантаження даних» натисніть «Додати» й оберіть тип «EVA.UA». Перемикачів «що завантажувати» у формі немає: підключення вміє тільки замовлення.
- У картці «Підключення» впишіть «Логін» і «Пароль» від кабінету продавця EVA. Форма зберігається сама, кнопки збереження немає.
- Натисніть «Перевірити підключення». Успіх — «Підключення працює. EVA (ваш логін)». Невдача — «Підключення не вдалося:» і відповідь EVA, наприклад про невірний логін чи пароль.
- Шаблон з пілюлею «Активний» протягом 5 хвилин почне забирати замовлення сам, перший раз — за 30 днів. Не чекати — натисніть «Завантажити».
- Відкрийте кілька замовлень і звірте позиції, суми, покупця й статус.
Пароль у шаблоні — той самий, що від кабінету. Змінили його на EVA — наступне завантаження отримає відмову, і в журналі з'явиться «EVA: помилка звернення до API.» з причиною. Впишіть новий пароль у шаблон і перевірте підключення.
Що переноситься в замовлення
Замовлення лягає документом «Замовлення покупця». EVA віддає список без деталей, тож кожне замовлення Elbuz дочитує окремим запитом — так вимагає й документація EVA.
| Дані EVA | Що з них виходить в Elbuz |
|---|---|
| номер замовлення | зовнішній номер і ключ, за яким замовлення впізнається повторно |
| покупець: ім'я, по батькові, прізвище, телефон, пошта | контрагент і контакти документа |
| отримувач: ім'я, прізвище, телефон | отримувач доставки |
| спосіб доставки | служба й спосіб: «Нова пошта (Відділення)», «Нова пошта (Поштомат)», «Нова пошта (Кур'єр)», «Укрпошта», «Meest (Відділення)», «Meest (Поштомат)», «Meest (Кур'єр)» |
| адреса доставки | одним рядком: місто, відділення або вулиця |
| вартість доставки | окремо від товарів; сума документа = товари + доставка |
| номер відправлення | ТТН документа |
| спосіб оплати | код EVA як є: CASH_ON_DELIVERY (оплата при отриманні) або LIQPAY |
| статус оплати | authorized — «Оплачено», решта — «Чекання» |
| коментар покупця | опис замовлення |
| статус замовлення | статус документа (таблиця) |
Валюта — гривня. Дати створення й зміни замовлення на EVA зберігаються в документі.
Як позиції знаходять картки каталогу
Рядок замовлення EVA несе код пропозиції — той offer id, який EVA отримала з вашого фіду, — а також артикул, назву, ціну й кількість. Порядок пошуку загальний для всіх майданчиків (як позиції знаходять товар), для EVA він працює так:
- Спершу — картка, яку Elbuz уже заводив під цю пропозицію EVA на минулих завантаженнях.
- Далі — за артикулом разом із назвою, потім за самою назвою. У шаблоні EVA з Elbuz артикул — це артикул виробника з картки.
- Останнім — за кодом пропозиції як номером товару в Elbuz: у шаблоні EVA
offer idі є цей номер. Якщо фід зібрано не в Elbuz і коди в ньому числові, позиція може лягти на чужу картку з тим самим номером. - Не знайшлося нічого — Elbuz заводить картку в службовій категорії «Товари - eva - ‹назва шаблону›». Категорія створюється вимкненою, тож у фіди такі картки самі не підуть.
Картки зі службової категорії можна переносити у свої категорії: рядок документа посилається на товар, а не на категорію. Саму службову категорію видаляйте останньою — разом із нею видаляються товари, для яких вона основна.
Як статуси EVA стають вашими
Зіставлення вбудоване в підключення, налаштовувати його не треба:
| Статус на EVA | Код | Статус документа в Elbuz |
|---|---|---|
| Нове замовлення | 1 | Новий |
| Підтверджене продавцем | 11 | Підтвердження |
| Підтверджене покупцем | 12 | Зібрано |
| Відправлено | 5 | Відвантажено |
| Скасовано покупцем | 9 | Скасовано |
| Скасовано продавцем | 10 | Скасовано |
Статус «Відправлено» ставить сама EVA, коли за ТТН бачить, що посилку передано перевізнику. Інших кодів вбудована таблиця не знає: для них Elbuz бере рядок із таблиці «Статуси замовлення» шаблону, а без нього документ отримує «Новий».
1
Статус на EVA2
Вбудована таблиця3
Рядок із таблиці шаблону- Статус на EVA — назва й код статусу з завантажених замовлень і кількість таких замовлень.
- Ваш статус за вбудованою таблицею EVA — налаштовувати не треба.
- Позначка «з таблиці» — код EVA вписано в таблицю статусів шаблону; цим же кодом статус іде назад на EVA.
- Початок
- Стан
- Кінець
Як статус і ТТН ідуть назад на EVA
Змінили статус замовлення EVA в Elbuz — новий статус іде на EVA. Для ручної зміни статусу це з коробки вимкнено; скасування замовлення AI-підтримкою йде на EVA завжди. Щоб увімкнути:
- Увімкніть перемикач «Передавати статус замовлення на маркетплейс»: «Звернення» → шестерня → «Автономна підтримка» → вкладка «Канали й проактив».
- Відкрийте шаблон EVA, кнопку «Статуси замовлення», і впишіть коди EVA навпроти своїх статусів: «Підтвердження» — 11, «Зібрано» — 12, «Скасовано» — 10. На EVA йде код, що стоїть навпроти статусу документа.
- Перевірте, що логін і пароль у шаблоні робочі: тим самим входом Elbuz змінює статус.
EVA приймає не будь-який перехід, а лише такі:
| Зараз на EVA | Можна перевести в | Умова |
|---|---|---|
| 1 Нове замовлення | 11, 9, 10 | — |
| 11 Підтверджене продавцем | 12, 9, 10 | для 12 — ТТН у документі |
| 12 Підтверджене покупцем | 9, 10 | — |
| 9, 10 Скасовано | — | кінцевий статус |
- ТТН. Окремого способу передати ТТН в API EVA немає: номер іде разом зі статусом 12. Якщо в документі ТТН порожня, Elbuz статус не відправляє і пише про це в історію документа. Впишіть ТТН і поставте статус ще раз.
- «Відправлено» (5) не передається — EVA ставить його сама. Не вписуйте 5 у таблицю статусів шаблону: майданчик відповість помилкою.
- Скасування йде з причиною. Менеджер поставив «Скасовано» вручну — 1012 «Інше». Скасовує AI-підтримка за зверненням покупця — причина з приводу звернення:
- прохання покупця, «передумав» або привід не вказано — 1001 «Передумав»;
- «знайшов дешевше» — 1003 «Купив в іншому місці»;
- дубль — 1008 «Дубль замовлення»;
- будь-який інший привід — 1012 «Інше».
- Результат видно в історії документа: «Статус передано на маркетплейс: 11» або причина, чому ні — статус не зіставлено, немає доступів шаблону, помилка від EVA (розбір повідомлень).
Таблиця «Статуси замовлення» працює в обидва боки. Якщо в рядку «Скасовано» стоїть список «9,10», на EVA піде перший код. Продавець скасовує кодом 10, тому ставте його першим або єдиним.
Що буде з уже завантаженим замовленням
Замовлення впізнається за номером на EVA, тож копії не з'являється. Правила ті самі, що в інших маркетплейсів (два статуси одного замовлення):
- Документ проведено — статус змінюється лише на скасування: EVA прислала 9 чи 10 — документ переходить у «Скасовано», і резерв перераховується. Решту проведеного документа завантаження не чіпає.
- Не проведено, код EVA той самий — ваш статус лишається, правку менеджера не чіпають.
- Не проведено, код EVA змінився — статус перезаписується за таблицею.
Після успішного передавання статусу на EVA Elbuz запам'ятовує відправлений код. Тому наступне завантаження, яке принесе той самий код, ваш статус не перепише.
Сума, кількість і ціна в рядках при повторному завантаженні не змінюються, рядки не видаляються. У непроведеному документі дописуються лише порожні контакти й адреса, а статус оплати оновлюється.
Автоматичне завантаження
EVA не надсилає миттєвих сповіщень, тож Elbuz звертається сам: системне завдання «Замовлення з маркетплейсів» кожні 5 хвилин забирає замовлення всіх активних шаблонів EVA з логіном і паролем. Розклад шаблону не потрібен. Докладніше — автоматичне завантаження замовлень.
- Перший запуск забирає замовлення за останні 30 днів.
- Наступні — лише змінені після найсвіжішого вже завантаженого.
- Обсяг прогону — сторінки по 100 замовлень, до 500 сторінок. Кожні 200 замовлень записуються окремою порцією: обрив лишає збереженим усе до останньої порції.
- Збої мережі — на запит 30 секунд на з'єднання і 120 на відповідь. На «забагато запитів» (429) і помилку сервера — до трьох спроб із паузою, далі рядок журналу з причиною.
Рядки журналу: «EVA: сторінка N, отримано замовлень: M» і в кінці «EVA: завантаження замовлень завершено, усього: N».
Як призупинити завантаження
Переведіть пілюлю «Активний» / «Вимкнений» у колонці «Стан» списку завантажень. Вимкнений шаблон автоматичне завантаження пропускає, а ручне «Завантажити» працює. Документи, картки, логін і пароль лишаються, а після ввімкнення прогін забере все, що змінилося на EVA за паузу.
Передавання статусу на EVA шукає активний шаблон EVA. Вимкнули єдиний — статуси перестають іти на майданчик, а в історії документа з'являється «немає доступів шаблону завантаження площадки».
Сценарії
Замовлення мають приходити самі
Впишіть логін і пароль кабінету EVA, натисніть «Перевірити підключення» й переконайтеся, що шаблон «Активний». Кожні 5 хвилин прогін забирає змінені замовлення, перший — за 30 днів. Нові замовлення лягають непроведеними, і залишок не зрушить до проведення.
Менеджер підтверджує в Elbuz, EVA дізнається сама
Увімкніть «Передавати статус замовлення на маркетплейс» і впишіть у «Статуси замовлення» шаблону 11 навпроти «Підтвердження», 12 навпроти «Зібрано». Менеджер ставить «Підтвердження» — на EVA замовлення стає «Підтверджене продавцем». Коли посилку оформлено, впишіть ТТН і поставте «Зібрано»: EVA отримає статус 12 разом із ТТН і далі сама переведе замовлення у «Відправлено».
Покупець передумав — скасувати на обох боках
Поставте в документі «Скасовано»: при ввімкненому передаванні й коді 10 у таблиці на EVA піде «Скасовано продавцем» з причиною «Інше». Якщо покупець скасував сам на EVA, наступне завантаження переведе непроведений документ у «Скасовано» без вашої участі.
Позиції мають лягати на наявні картки
Вивантажуйте каталог на EVA шаблоном Elbuz і не міняйте в ньому offer id. Код пропозиції в замовленні тоді дорівнює номеру товару, і позиція знайде свою картку, навіть якщо EVA змінила назву під час модерації. Позиція без відповідника отримає картку в службовій категорії, і наступне замовлення з тією ж пропозицією ляже на неї.
Що робити, коли замовлення не приходять або статус не доходить
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «EVA: не вказано логін або пароль кабінету продавця» | У шаблоні порожній логін або пароль — до EVA навіть не зверталися | Впишіть логін і пароль кабінету (як підключити) |
| «Підключення не вдалося: …» з кодом 401 | EVA не прийняла логін або пароль — часто після зміни пароля в кабінеті | Впишіть актуальний пароль і перевірте підключення ще раз |
| «EVA: помилка звернення до API.» у журналі | EVA відповіла помилкою; причина стоїть у тому ж рядку. На «забагато запитів» (429) і збій сервера Elbuz перед цим пробує тричі, іншу помилку записує одразу | Разовий збій мережі чи сервера EVA — наступний прогін через 5 хвилин забере решту. Помилка повторюється щоразу — читайте причину: найчастіше це логін і пароль |
| «Статус 12 не передано на маркетплейс: для нього площадка вимагає ТТН» | У документі немає ТТН, а EVA підтвердження покупцем без неї не приймає | Впишіть ТТН у документ і поставте статус ще раз (статус назад) |
| «Статус не передано на маркетплейс: «…» не зіставлено зі статусом площадки» | У таблиці «Статуси замовлення» шаблону навпроти цього статусу немає коду EVA | Впишіть код, якщо цей статус має щось означати на EVA; інакше нічого робити не треба |
| «Статус 11 не передано на маркетплейс: …» з відповіддю EVA про недозволений перехід | EVA не дозволяє такий перехід — замовлення там уже скасовано або далі за ланцюжком | Звірте статус на EVA з таблицею переходів; скасоване замовлення вже не відновити |
| Позиції лягають у службову категорію, а не на ваші картки | Код пропозиції у фіді не номер товару Elbuz, а артикул і назва не збіглися з каталогом | Вивантажуйте каталог шаблоном EVA з Elbuz (зіставлення) |
Часті запитання
Чи можна цим підключенням завантажити товари або оновлювати ціни на EVA?
Ні. API EVA працює лише із замовленнями, тож товари, ціни й залишки йдуть на майданчик XML-фідом — вивантаження на EVA.UA.
Де в кабінеті EVA взяти токен?
Ніде: окремих токенів у кабінеті немає. Elbuz входить в API логіном і паролем кабінету продавця і сам отримує тимчасовий ключ доступу.
За який період підтягнуться замовлення під час першого запуску?
За останні 30 днів. Далі беруться лише замовлення, змінені після найсвіжішого вже завантаженого. Потрібен інший період — впишіть дату в поле «Завантаження замовлень починаючи з дати (РРРР-ММ-ДД)» розділу «Розширене» форми шаблону.
Чому не вдається поставити на EVA «Відправлено»?
Цей статус ставить сама EVA, коли посилка за ТТН вирушила. Ваше завдання — передати ТТН разом зі статусом 12 (статус назад).
Чи заважає EVA підключенню Епіцентру чи Prom?
Ні. Кожен майданчик — свій шаблон, замовлення мають своє джерело, а таблиці статусів ведуться для кожного шаблону окремо.
Де це і хто має доступ
- Меню
- Операції → Завантаження даних → шаблон типу «EVA.UA»
- Право доступу
- вікно «Завантаження» у «Правах груп»
- Підготувати
- логін і пароль кабінету продавця EVA
Один шаблон — одне підключення до одного кабінету продавця.
1
Поле «Логін»2
Поле «Пароль»3
Кнопка «Перевірити підключення»- Поле «Логін» — логін від кабінету продавця EVA.
- Поле «Пароль» — пароль від того самого кабінету; форма зберігається сама.
- Кнопка «Перевірити підключення» входить в API EVA цими логіном і паролем і показує результат.
Суміжні теми
- Якщо каталог на EVA ще не вивантажено — вивантаження товарів на EVA.UA XML-фідом.
- Якщо замовлення приклеїлося не до того покупця — завантаження замовлень через API.
- Якщо поряд з EVA продаєте на Епіцентрі — замовлення з Епіцентру.
