Elbuz сам забирає прайс ELKO Ukraine з кабінету ecom.elko.ua — ціну й РРЦ у гривнях, наявність, усі фото й габарити, опис і характеристики — і відправляє в ELKO замовлення постачальнику з документа.
Коли це знадобиться:
- Прайс великий, а ELKO віддає опис по одному товару — програма добирає описи за кілька завантажень, спершу для товарів у наявності.
- Замовлення в ELKO вводите руками в кабінеті — відвантаження створюється однією кнопкою з документа.
- Потрібен номер ТТН — він записується в документ, коли ELKO його створить.
- ELKO пускає лише з дозволених IP — адреса сервера Elbuz написана у вікні параметрів доступу.
З чого почати: отримайте доступ до API ELKO й дозвіл для IP Elbuz.
Що вміє інтеграція з ELKO
- Прайс без ручної розмітки — код товару, артикул, назва, бренд, ціна й РРЦ у гривнях, гарантія, штрихкод, категорія, наявність і посилання на товар в ELKO.
- Усі фото, вага й габарити — разом із прайсом.
- Опис і характеристики — добираються поступово в межах ліміту ELKO.
- Відвантаження з документа — у резерв або на відвантаження, зі станом і номером ТТН.
Загальна механіка готових інтеграцій — майстер, вікно параметрів доступу, розмітка колонок — у статті Як підключити постачальника за API. Тут тільки те, що стосується ELKO.
Де це і хто має доступ
- Меню
- Довідники → Обробка прайс-листів → Список прайс-листів
- Нове джерело
- майстер нового джерела, крок «Звідки» → плитка «API» → «ELKO»
- Доступ і параметри
- картка джерела, секція «Джерело» → «Налаштування параметрів API»
- Замовлення
- документ «Замовлення постачальнику» → «Відправити постачальнику»
- Право доступу
- вікно «Список прайс-листів» плюс «Налаштування завантаження» і «…файл із прайс-листом»; для замовлення — редагування документів
- Підготувати
- логін і пароль ecom.elko.ua або токен API; IP Elbuz у дозволених ELKO
Що попросити в ELKO: доступ до API і дозвіл для IP
- Доступ до API. Підійдуть логін і пароль від кабінету ecom.elko.ua — програма сама отримає токен. Або токен API з кабінету ELKO: його вписують у «Пароль (токен)» цілком.
- IP-адресу Elbuz у дозволених. ELKO пускає в API тільки з дозволених адрес. Передайте менеджеру ELKO адресу сервера Elbuz з вікна «Налаштування параметрів доступу до API» (де її знайти).
Які параметри запиту ELKO заповнити
У майстрі нового джерела на кроці «Звідки» оберіть плитку «API» і «ELKO» у списку. Адресу https://uaapi.elko.cloud/v3.0/, формат XML, колонки й завантаження фото програма підставить сама (що саме вона робить). У вікні «Налаштування параметрів доступу до API» впишіть логін і пароль або токен.
Кнопка «Отримати довідкові дані» показує ваші адреси доставки ELKO з номерами — номер знадобиться для замовлення.
| Параметр | За замовчуванням | Що робить |
|---|---|---|
| «Повні картки товарів» | 1 | 1 — опис і характеристики з ELKO (докладніше); 0 — тільки прайс |
| «Мова прайсу, опису й характеристик» | ua | ua — українська, ru — російська; після зміни програма заново отримує описи |
| «Обʼєднувати значення характеристик», «Розділювач значень характеристик» | 1, / | характеристики з однаковою назвою стають однією зі значеннями через розділювач |
| «Опис і характеристики: секунд за завантаження» | 240 | скільки часу одне завантаження добирає опис і характеристики (чому так) |
| «Замовлення: адреса доставки (addressNumber)» | порожньо | номер адреси з «Отримати довідкові дані»; без нього замовлення не відправляється |
| «Замовлення: тільки резерв» | 1 | 1 — ELKO ставить товар у резерв; 0 — оформлює відвантаження |
У джерел, підключених раніше, ці рядки, колонки опису й габаритів і завантаження всіх фото додані з цією версією.
1
Опис і характеристики: секунд за завантаження2
Замовлення: адреса доставки (addressNumber)3
Замовлення: тільки резерв- Скільки секунд за одне завантаження добирати опис і характеристики (240 за замовчуванням).
- Номер адреси доставки з «Отримати довідкові дані».
- 1 — резерв, 0 — відвантаження.
Що приходить від ELKO
ELKO віддає прайс XML-файлом. Колонки джерела ELKO — це назви тегів XML:
| Колонка | Що в ній | Поле в Elbuz |
|---|---|---|
| Id | код товару ELKO | «Артикул контрагента»; за ним іде замовлення й привʼязується картка |
| ManufacturerCode | артикул виробника | «Артикул виробника» |
| Name | назва | «Найменування» |
| VendorName | бренд | «Виробник» |
| Catalog | код категорії ELKO | категорія з прайсу |
| Price | ваша ціна, грн | «Ціна» |
| RRP | РРЦ, грн | «Ціна РРЦ» |
| Quantity | наявність | «Статус наявності (з прайсу)» (наявність) |
| FullDsc | коротко основні характеристики | «Опис короткий» |
| EanCode, Warranty, HttpDescription | штрихкод, гарантія, посилання на товар в ELKO | «Штрихкод EAN», «Гарантія», «Посилання на товар (URL)» |
| content_description, content_weight, content_width, content_height, content_depth | опис, вага й габарити | «Опис повний», «Вага», «Ширина», «Висота», «Довжина» |
Фото приходять разом із прайсом — усі фото товару, а також вага й розміри, які перевірив сам ELKO. РРЦ у ELKO — у гривнях; старі версії привʼязки ставили РРЦ валюту долара, у нових джерел валюта UAH.
1
Артикул контрагента = Id2
Ціна = Price, UAH3
Ціна РРЦ = RRP, UAH- Id — код товару ELKO: за ним іде замовлення й привʼязується картка.
- Price — ваша ціна в гривнях.
- RRP — РРЦ у гривнях (раніше привʼязка ставила долар).
Чому опис і характеристики приходять частинами
ELKO віддає опис і характеристики тільки по одному товару за запит, а API дозволяє не більше 50 запитів за 10 секунд — понад це ELKO блокує доступ на хвилину. Тому програма:
- бере по 4 товари одночасно й тримає темп нижче ліміту;
- за одне завантаження добирає стільки, скільки встигне за «Опис і характеристики: секунд за завантаження»; решту — під час наступних завантажень, спершу товари в наявності;
- зберігає картки окремо від прайсу й оновлює раз на 30 днів; кнопка «Завантажити» їх не стирає.
Під час завантаження в журналі видно «Опис і характеристики ELKO: отримано ‹скільки› з ‹скільки›…». Для великого прайсу перше заповнення розтягнеться на кілька завантажень — це нормально.
Під час додавання товару в базовий каталог картка приходить заповненою (характеристики товарів, фото товарів).
Як читається наявність ELKO
ELKO показує точну кількість до 10 штук, далі — порогами: «> 10», «> 40», «> 100». Стандартні статуси розпізнають це без налаштувань: число від 1 — «В наявності», а кількість — сам поріг; 0 — «Немає на складі» (наявність товару в прайсі постачальника).
Як відправити замовлення в ELKO і отримати ТТН
Замовлення постачальнику, створене в Elbuz на контрагента ELKO, відправляється з документа кнопкою «Відправити постачальнику». Спершу впишіть номер адреси доставки в «Замовлення: адреса доставки (addressNumber)».
ELKO створює справжнє відвантаження, тож перед відправкою програма просить підтвердження. Скасувати чи змінити відвантаження з Elbuz не можна — тільки в кабінеті ecom.elko.ua.
- програма перевіряє, чи не відправлявся вже цей документ в ELKO;
- відправляє позиції за кодом ELKO; однакові товари складаються в один рядок;
- ELKO створює відвантаження (у резерв, якщо «тільки резерв» = 1); номер відвантаження записується в документ, а стан — у статус від постачальника.
Стан оновлюється лише пунктом «Оновити статус від постачальника»: він показує стан відвантаження («Очікує на обробку», «Збірка», «Готовий до видачі»…), а коли зʼявляється ТТН — записує її в документ.
Повтор не створює друге відвантаження. Якщо в документі вже є номер ELKO, повторне натискання нічого не відправляє.
Відправку замовлення ми перевірили на імітації сервера ELKO, а не на справжньому замовленні. Перше замовлення відправте невелике й звірте результат у кабінеті ecom.elko.ua.
Сценарії
Додавати товари ELKO в каталог з описом і характеристиками
Що зробити. «Повні картки товарів» = 1 (у нових джерел так уже стоїть), завантаження джерела за розкладом.
Що вийде. Фото й габарити є одразу, опис і характеристики заповнюються за кілька завантажень — спершу для товарів у наявності. Після цього товари додаються в каталог заповненими.
Резервувати товар у ELKO під замовлення клієнта
Що зробити. «Замовлення: тільки резерв» = 1, адреса доставки вписана; створіть «Замовлення постачальнику» на ELKO й натисніть «Відправити постачальнику».
Що вийде. ELKO ставить товар у резерв, номер відвантаження записується в документ.
Одразу оформлювати відвантаження й стежити за ТТН
Що зробити. «Замовлення: тільки резерв» = 0; після відправки час від часу натискайте «Оновити статус від постачальника».
Що вийде. ELKO оформлює відвантаження, а номер ТТН зʼявляється в документі, щойно ELKO його створить.
Що робити, коли прайс ELKO не приїхав або замовлення не пішло
Чому прайс не оновився
Якщо токен застарів, логін чи пароль неправильні або IP-адреси Elbuz немає серед дозволених, ELKO відповідає помилкою, і в журналі зʼявиться «Помилка API постачальника: ELKO Catalogs/Products: …» з текстом ELKO. Програма в такому разі не затирає прайс: ціни й наявність лишаються з попереднього завантаження (загальна механіка).
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «ELKO Catalogs/Products: …» з кодом доступу | Застарілий токен, неправильний логін чи пароль або IP-адреса не дозволена | Оновити токен або вписати логін і пароль; попросити ELKO дозволити IP-адресу Elbuz (що попросити) |
| РРЦ у десятки разів більша за ціну | У старому джерелі РРЦ стоїть валюта долара | У вкладці «Колонки» в рядку «Ціна РРЦ» поставити валюту UAH |
| У товарів по одному фото | Старі налаштування брали тільки одне фото | Завантажити прайс ще раз — з цією версією приходять усі фото |
| «Не вказано адресу доставки ELKO…» | Порожній параметр «Замовлення: адреса доставки» | Вписати addressNumber з «Отримати довідкові дані» (параметри) |
Часті запитання
Що вписати в доступ до API ELKO?
Логін і пароль від кабінету ecom.elko.ua — програма сама отримає токен. Або токен API з кабінету ELKO цілком у «Пароль (токен)».
Як пришвидшити заповнення описів ELKO?
Збільште «Опис і характеристики: секунд за завантаження» — одне завантаження добиратиме більше товарів. Швидше за ліміт ELKO (50 запитів за 10 секунд) програма не запитує.
Чи можна отримувати опис ELKO російською?
Так. Поставте «Мова прайсу, опису й характеристик» = ru — програма заново отримає описи.
Чи можна скасувати відвантаження ELKO з Elbuz?
Ні. Скасування й зміни відвантаження — у кабінеті ecom.elko.ua.
Чи підтягнеться номер ТТН від ELKO сам?
Ні, після натискання «Оновити статус від постачальника». Пункт показує стан відвантаження й записує ТТН у документ, коли ELKO її створить.
Суміжні теми
- Якщо потрібна загальна картина готових інтеграцій і вікна параметрів — Як підключити постачальника за API.
- Якщо прайс завантажився і треба налаштувати розклад та імпорт — імпорт прайсу.
- Якщо треба зібрати замовлення постачальникам з потреб магазину — замовлення постачальнику.
- Якщо пороги «> 10», «> 40» треба читати інакше — наявність товару в прайсі постачальника.