HelomiWIKI

EVA

The “EVA” card in “Integrations” connects Helomi to your EVA marketplace seller account. EVA orders arrive in “Deals” on their own with the client, products, delivery, and payment, and the deal's status and waybill number go back to EVA. Product cards, prices, and availability for EVA are created by AI Eva and delivered as an XML feed — the EVA API accepts only orders.

11 minUpdated 10.11.2026
Markdown for AI

This article is in Ukrainian for now. Ask Lomi in your language — she will read the article and answer. Talk to Lomi

On this page

Можливості

  • Замовлення EVA в угоди: клієнт, отримувач, товари, доставка, оплата, сума, коментар покупця.
  • Товари замовлення зв'язуються зі складом самі: артикул на EVA → товар ШІ Єви → товар складу.
  • Доставка Новою Поштою, Укрпоштою чи Meest: служба, відділення, поштомат або адреса кур'єра — у блоці «Доставка» угоди.
  • «Пов'язані статуси»: статус замовлення EVA → етап угоди і назад; проміжні статуси CRM передає сама, ТТН — разом зі статусом «Підтверджене покупцем».
  • Скасування з причиною EVA: таблиця причина програшу CRMпричина EVA«причина програшу CRM → причина EVA».
  • Блок «EVA» в угоді: статус, оплата, ТТН, позиції замовлення, кнопки «Підтвердити», «Передати ТТН», «Відмінити…».
  • Картки товарів, ціни й наявність — через ШІ Єва.
  • Кілька кабінетів EVA — кожен своїм акаунтом зі своїм логіном і паролем.

1Логін і пароль кабінету

API замовлень EVA входить тим самим логіном і паролем, якими ви входите в кабінет продавця EVA. Окремого ключа EVA не видає.

  1. Відкрийте НалаштуванняІнтеграціїМаркетплейсиEVA«Налаштування → Інтеграції → Маркетплейси → EVA» → вкладка «Підключення».
  2. Рядок «Логін кабінету» → «Ввести» → вставте логін → «Зберегти ключ».
  3. Рядок «Пароль кабінету» → «Ввести» → вставте пароль → «Зберегти ключ».
  4. Натисніть «Перевірити»: CRM входить в API EVA і читає першу сторінку замовлень, нічого не змінюючи.

Логін і пароль зберігаються зашифрованими й більше не показуються. Вхід в API CRM поновлює сама — вводити пароль удруге не треба.

Увага

Змінили пароль у кабінеті EVA — впишіть новий і тут. Інакше замовлення перестануть приходити, а в журналі картки з'явиться «невірний логін або пароль кабінету».

2Підключити замовлення одним натиском

Кнопка ставить типові налаштування продажів і одразу забирає замовлення.

  1. Введіть логін і пароль кабінету (розділ 1).
  2. Рядок «Замовлення в угоди» → «Підключити замовлення» → підтвердіть.
  3. CRM ставить джерело «EVA», відповідального, «Зв'язувати товари по: артикул», «Пов'язані статуси» у воронці «Продажі EVA» (нема такої — у першій воронці), вмикає «Передавати статус і ТТН на EVA» і приймання замовлень.
  4. Під кнопкою — що налаштовано й що пропущено; тост показує, скільки угод створено.

Типові «Пов'язані статуси»: «Нове замовлення» → новий етап, «Підтверджене продавцем» → «Передано на збірку», «Підтверджене покупцем» і «Відправлено» → «Відправлено», «Скасовано продавцем» і «Скасовано покупцем» → етап програшу. Пропущене допишіть у вкладці «Налаштування продажів». Повторно — «Застосувати налаштування знову».

3Замовлення EVA в угодах

Коли приймання ввімкнено, CRM кожні 5 хвилин забирає замовлення, які змінились на EVA, і створює або оновлює угоди. Повтор того самого замовлення угоду не дублює, а незмінене замовлення CRM удруге не читає.

  1. Нове замовлення стає угодою «EVA <номер>» з джерелом «EVA» на етапі за «Пов'язаними статусами».
  2. Клієнт шукається за телефоном покупця; нема — створюється з ім'ям, прізвищем, телефоном і поштою.
  3. Отримувач, якщо це інша людина, пишеться в «ПІБ отримувача» і «Телефон отримувача» угоди — його бере форма ТТН.
  4. Товари: артикул позиції на EVA → товар ШІ Єви (той самий id, що в її фіді) → товар складу; нема в Єви — товар з таким артикулом; кількість і ціна — як у замовленні.
  5. Доставка: служба (Нова Пошта, Укрпошта, Meest), тип (відділення, поштомат, кур'єр), місто, відділення або адреса кур'єра — у блоці «Доставка».
  6. Оплата: «Оплата при отриманні» — післяплата на суму замовлення; LiqPay — передоплата зі статусом оплати («Очікує оплати», «Оплачено», «Помилка оплати»).

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

Примітка

Якщо EVA передала Нову Пошту з відділенням із довідника Нової Пошти, «Створити ТТН» в угоді одразу показує місто й відділення. Інакше форма шукає їх за назвою з адреси, як для інших маркетплейсів.

Дані замовлення лежать у полях угоди блоку «Маркетплейси» з ключами eva_*. Їх видно в панелі «EVA» лише в угодах EVA:

РядокПоле угоди
ID замовленняeva_order_id
Статус замовлення, код статусуeva_status, eva_status_code
Історія статусу (веде CRM: рядок на кожну зміну, найновіші зверху)eva_status_history
Сума замовлення, вартість доставкиeva_order_amount, eva_delivery_cost
Спосіб оплати, статус оплатиeva_payment, eva_payment_status
ТТНeva_ttn
Спосіб доставки, тип, адреса доставкиeva_service, eva_delivery_type, eva_delivery_address
Відділення з довідника Нової Поштиeva_np_city_ref, eva_np_warehouse_ref
ПІБ і телефон отримувача, інша особа отримувачeva_recipient_name, eva_recipient_phone, eva_other_recipient
Коментар покупцяeva_comment
Коли замовлення змінилось на EVAeva_updated_at

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

4Статус і ТТН назад на EVA

Коли менеджер переводить угоду на етап з «Пов'язаних статусів», CRM міняє статус замовлення на EVA. Вмикається перемикачем «Передавати статус і ТТН на EVA».

  1. Статуси EVA йдуть по черзі: «Нове замовлення» → «Підтверджене продавцем» → «Підтверджене покупцем». Пропущений крок CRM передає сама.
  2. «Підтверджене покупцем» EVA приймає лише разом з номером ТТН: CRM бере ТТН угоди (Нова Пошта, Укрпошта або Meest). Нема ТТН — статус не змінюється, а в журналі картки з'являється пояснення.
  3. «Відправлено» EVA ставить сама за трекінгом посилки.
  4. Скасування йде з причиною: рядок скасування в «Пов'язаних статусах» з причиною → причина програшу угоди з таблиці розділу 6 → «Причина скасування» за замовчуванням. Причина продавця ставить на EVA «Скасовано продавцем», причина покупця — «Скасовано покупцем».

Перехід, якого EVA не дозволяє (наприклад, назад з «Підтверджене покупцем»), — запис «інформація» в журналі картки, а не помилка.

Порада

Лише ТТН без руху угоди передає «⋮» рядка ТТН в угоді → «Передати ТТН на EVA». Якщо замовлення ще «Нове замовлення», CRM спершу поставить «Підтверджене продавцем», а потім «Підтверджене покупцем» з ТТН.

Увага

Після «Підтверджене покупцем» іншу ТТН через API вже не передати. Перестворили ТТН — змініть її в кабінеті EVA.

5Блок «EVA» в угоді

У картці угоди EVA є два блоки: панель «EVA» з даними замовлення (таблиця розділу 3) і блок «EVA <номер>» з живим станом замовлення. Живий блок при відкритті бере свіже замовлення з EVA й одразу дописує зміни в поля угоди.

  1. Угледіть статус пігулкою, доставку, ТТН, суму й оплату.
  2. Натисніть дію: «Підтвердити» або «Передати ТТН» (поле номера з'являється, коли ТТН в угоді ще нема).
  3. Скасувати: «Відмінити…» → оберіть причину EVA → «Відмінити на EVA».
  4. Якщо дія проходить через кілька статусів, CRM спершу спитає, що саме передасть. Результат — тостом.

Позиції замовлення в блоці — лише для читання: API EVA їх не змінює. Змінити склад замовлення можна в кабінеті EVA, а позиції угоди — у блоці «Товари».

6Налаштування замовлень EVA

Вкладка «Налаштування продажів» картки має ті самі блоки, що й інші маркетплейси («Основне», «Нові замовлення», «Пов'язані статуси», «Автоматична відправка ТТН», «Передача ТТН на маркетплейс»), і свій блок «Замовлення EVA».

  1. Нові замовленняПідтвердження на EVA«Нові замовлення → Підтвердження на EVA»: «Нові замовлення одразу «Підтверджене продавцем» на EVA». Типово вимкнено — «Підтвердити» натискає менеджер.
  2. «Перше опитування»: за скільки днів назад забрати замовлення, коли картку щойно підключили. Типово 3.
  3. «Опитувати кожні … хв»: як часто питати EVA. Типово 5, менше не буває.
  4. «Причина скасування»: що передати, коли причину не обрано. Типово «Немає в наявності».
  5. Причина програшупричина EVA«Причина програшу → причина EVA»: «+ Додати причину» → причина програшу угоди (як у воронці) → причина EVA зі списку «Продавець» або «Покупець».
  6. Натисніть «Зберегти».

Бренд, філію і юрособу угод EVA задає блок «Структура» тієї самої вкладки (Структура каналу: бренд, філія, юрособа).

7Терміни обробки EVA

EVA рахує, як швидко продавець обробляє замовлення, і за повільну обробку може заблокувати магазин.

  1. Підтвердіть замовлення («Підтверджене продавцем») протягом 24 годин.
  2. Покупець має підтвердити замовлення протягом 48 годин від створення.
  3. Передайте ТТН («Підтверджене покупцем») протягом 72 годин від підтвердження.
Небезпечно

Якщо EVA виконує менше 75 % ваших замовлень, магазин блокують. Скасовуйте замовлення лише з причиною, яка справді сталася.

8Другий кабінет EVA (акаунти)

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

  1. На картці «EVA» натисніть «Додати акаунт» і дайте назву.
  2. Введіть логін і пароль цього кабінету.
  3. Натисніть «Підключити замовлення» в картці акаунта — його замовлення прийдуть окремо, угода пам'ятає свій кабінет.
  4. У вікні Єви відкрийте НалаштуванняEVA«Налаштування → EVA» і в полі каналу «Прайс-листа» вкажіть акаунт «eva-<назва>». Канал у «Прайс-листі» матиме ту саму назву.

Можливі помилки

що бачитечомущо зробити
«Логін і пароль кабінету EVA — у картці …»логін або пароль не введенорозділ 1
«EVA: невірний логін або пароль кабінету»пароль змінили в кабінеті або помилка в логінівведіть правильні в розділі 1 і натисніть «Перевірити»
«EVA: доступ заборонено…»цей логін не має доступу до API продавцяперевірте, що це логін кабінету продавця, або спитайте менеджера EVA
«В угоді нема ТТН — створіть ТТН (блок «Доставка») і передайте ще раз»«Підтверджене покупцем» без номера ТТНстворіть ТТН в угоді або впишіть номер у блоці «EVA»
«На EVA вже стоїть ТТН … замінити ТТН через API EVA не можна»замовлення вже «Підтверджене покупцем» з іншою ТТНзмініть ТТН у кабінеті EVA
«З «…» у «…» EVA не переводить»угоду пересунули назад або статус уже далінічого: EVA переходи лише вперед
«EVA приймає ТТН лише Нової Пошти, Укрпошти та Meest»ТТН іншої службистворіть ТТН службою із замовлення
«EVA: забагато запитів — спробуйте за хвилину»ліміт запитів EVAзачекайте хвилину й повторіть
Замовлення не приходятьприймання вимкнено або логін не підходить«Стан роботи» і «Журнал подій» картки; «Підключити замовлення»
Адреса доставки — одним рядкомEVA передала адресу в незнайомому виглядіперевірте місто й відділення у формі «Створити ТТН»

Для ШІ-співробітників

  • Ключ статті: help("int-eva"); розділ про блок угоди — help("int-eva", "Блок «EVA» в угоді").
  • Угоди EVA ШІ бачить у «Угодах» (deals_list, deals_get): джерело «EVA», поля eva_* (таблиця розділу 3) і кабінет, з якого прийшла угода (crm_integration). Ці поля заповнює приймання — ШІ їх не редагує.
  • Статус на EVA ШІ змінює так само, як людина: переводить угоду на пов'язаний етап (інструменти угод); проміжні статуси й ТТН CRM передасть сама.
  • Логін і пароль кабінету ШІ не читає й не змінює; вводить їх і натискає «Підключити замовлення» лише людина. Картками й цінами для EVA керують інструменти ai_eva_* — див. help("ai-eva").

Додаткова інформація

Helomi AI employees read this same article: help("int-eva")