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

    1. Elbuz
    2. Керівництво користувача Elbuz
    3. Завантаження даних
    4. Маркетплейси України й Казахстану

    Як завантажувати замовлення з EVA.UA в Elbuz

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

    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.

    1. У вікні «Завантаження даних» натисніть «Додати» й оберіть тип «EVA.UA». Перемикачів «що завантажувати» у формі немає: підключення вміє тільки замовлення.
    2. У картці «Підключення» впишіть «Логін» і «Пароль» від кабінету продавця EVA. Форма зберігається сама, кнопки збереження немає.
    3. Натисніть «Перевірити підключення». Успіх — «Підключення працює. EVA (ваш логін)». Невдача — «Підключення не вдалося:» і відповідь EVA, наприклад про невірний логін чи пароль.
    4. Шаблон з пілюлею «Активний» протягом 5 хвилин почне забирати замовлення сам, перший раз — за 30 днів. Не чекати — натисніть «Завантажити».
    5. Відкрийте кілька замовлень і звірте позиції, суми, покупця й статус.

    Пароль у шаблоні — той самий, що від кабінету. Змінили його на 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 бере рядок із таблиці «Статуси замовлення» шаблону, а без нього документ отримує «Новий».

    Вікно «Статуси замовлення» шаблону EVA.UA: статуси EVA в завантажених замовленнях і ваші статуси
    1Статус на EVA
    2Вбудована таблиця
    3Рядок із таблиці шаблону
    1. Статус на EVA — назва й код статусу з завантажених замовлень і кількість таких замовлень.
    2. Ваш статус за вбудованою таблицею EVA — налаштовувати не треба.
    3. Позначка «з таблиці» — код EVA вписано в таблицю статусів шаблону; цим же кодом статус іде назад на EVA.
    Шлях замовлення на EVA. Стрілки «Elbuz передає» працюють, коли ввімкнено передавання статусу, а скасування AI-підтримкою — завжди; у «Відправлено» замовлення переводить тільки EVA, а зі скасованого вже нікуди не перейти
    покупець оформив на EVAElbuz передає статусElbuz передає статусразом із ТТНEVA сама, за трекінгомТТНз причиноюз причиноюз причиною1 Нове замовлення — у Elbuz«Новий»11 Підтверджене продавцем —«Підтвердження»12 Підтверджене покупцем —«Зібрано»5 Відправлено — «Відвантажено»9 або 10 Скасовано —«Скасовано»
    • Початок
    • Стан
    • Кінець

    Як статус і ТТН ідуть назад на EVA

    Змінили статус замовлення EVA в Elbuz — новий статус іде на EVA. Для ручної зміни статусу це з коробки вимкнено; скасування замовлення AI-підтримкою йде на EVA завжди. Щоб увімкнути:

    1. Увімкніть перемикач «Передавати статус замовлення на маркетплейс»: «Звернення» → шестерня → «Автономна підтримка» → вкладка «Канали й проактив».
    2. Відкрийте шаблон EVA, кнопку «Статуси замовлення», і впишіть коди EVA навпроти своїх статусів: «Підтвердження» — 11, «Зібрано» — 12, «Скасовано» — 10. На EVA йде код, що стоїть навпроти статусу документа.
    3. Перевірте, що логін і пароль у шаблоні робочі: тим самим входом 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

    Один шаблон — одне підключення до одного кабінету продавця.

    Форма підключення шаблону «EVA.UA»: поля «Логін» і «Пароль», кнопка «Перевірити підключення»
    1Поле «Логін»
    2Поле «Пароль»
    3Кнопка «Перевірити підключення»
    1. Поле «Логін» — логін від кабінету продавця EVA.
    2. Поле «Пароль» — пароль від того самого кабінету; форма зберігається сама.
    3. Кнопка «Перевірити підключення» входить в API EVA цими логіном і паролем і показує результат.

    Суміжні теми

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

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

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

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

    Зміст статті

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

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