Як підключити ASBIS (it4profit): логін з посилання, наявність словами й повні картки

Що вміє інтеграція з ASBIS

• Завантажує прайс ASBIS — код товару, назву, бренд, ціну дилера й РРЦ, гарантію, штрихкод, категорію й посилання на картку товару в ASBIS.
• Розпізнає наявність словами — правила для трьох мов заводяться в джерелі самі.
• Заповнює повні картки товарів — усі характеристики, фото 900×900 і опис.

Де це і хто має доступ

Меню

Довідники → Обробка прайс-листів → Список прайс-листів

Нове джерело ASBIS

майстер нового джерела, крок «Звідки» → плитка «API» → «ASBIS»

Доступ і параметри

картка джерела, секція «Джерело» → «Налаштування параметрів API»

Правила наявності

картка джерела, вкладка «Наявність»

Право доступу

вікно «Список прайс-листів» і «Налаштування завантаження: файл із прайс-листом»

Підготувати

логін і пароль, якими ASBIS відкрив вам прайс у it4profit

Логін, пароль і регіон it4profit: де вони в посиланні

Потрібні логін і пароль, якими ASBIS відкрив вам прайс у сервісі it4profit. Доступу ще немає — попросіть свого менеджера ASBIS відкрити прайс у it4profit. Якщо прайс уже завантажується посиланням, усе потрібне є в ньому:

• після USERNAME= — логін, після PASSWORD= — пароль;
• мова — uk, ru чи en;
• регіон — число після мови: 508 — Україна, 720 — Казахстан.

Наприклад, у посиланні …/product/uk/508/PriceAvail.xml?… мова uk, регіон 508.

Як підключити ASBIS і перейти з посилання

У майстрі нового джерела на кроці «Звідки» оберіть плитку «API» і «ASBIS». Адресу сервісу, формат XML, колонки й правила наявності програма ставить сама (що робить привʼязка). У «Логін» впишіть логін ASBIS, у «Пароль (токен)» — пароль. Кнопка «Отримати довідкові дані» для ASBIS показує лише «У цієї інтеграції немає довідкових даних…».

1

Мова ASBIS

2

Регіон ASBIS

3

Повні картки товарів

1. Мова ASBIS — uk, ru або en: мова назв категорій, наявності, характеристик і описів.
2. Регіон ASBIS — 508 для України, 720 для Казахстану.
3. Повні картки товарів — 1 завантажує характеристики, фото й описи від постачальника.

Прайс ASBIS уже підключений посиланням

Джерело, яке завантажує PriceAvail.xml за посиланням, працює як працювало, і само на інтеграцію не переводиться. Але в нього немає повних карток, а наявність «так» / «достаточно» стандартні статуси не розпізнають. Щоб перейти:

1. заведіть нове джерело через інтеграцію «ASBIS» на того самого контрагента;
2. впишіть логін і пароль з посилання;
3. завантажте нове джерело й вимкніть старе.

Окреме джерело для ProductList.xml більше не потрібне: каталог карток інтеграція бере сама.

Що приходить від ASBIS: англійські назви й ціни регіону

ASBIS віддає прайс одним XML-файлом, і колонки джерела ASBIS — це назви тегів. Колонки, які привʼязка розмічає сама:

1

Артикул контрагента = WIC

2

Ціна = MY_PRICE

3

Опис повний = content_description

1. WIC — код товару ASBIS: за ним привʼязується картка.
2. MY_PRICE — ціна дилера, валюта UAH.
3. content_description — опис з повної картки.

• Назва — англійською, як у каталозі ASBIS, навіть в українському й російському файлі.
• Ціни регіону 508 — у гривнях, привʼязка ставить валюту UAH.
• Регіон 720 — змініть у рядках «Ціна» і «Ціна РРЦ» валюту на ту, що в тезі CURRENCY_CODE вашого прайсу.

Як отримати повні картки товарів ASBIS

У прайсі ASBIS є лише мініатюра фото. Повні картки — усі характеристики, фото 900×900 і опис — ASBIS віддає окремим файлом-каталогом ProductList.xml, і тільки цілим: це сотні мегабайт. Тому програма робить так:

• Качає каталог рідко. Повністю — раз на тиждень. Зʼявився товар без картки — не частіше, ніж раз на добу.
• Зберігає картки окремо від прайсу. Кнопка «Завантажити» їх не стирає, прайс щоразу отримує збережені картки.
• Перше завантаження з картками триває кілька хвилин, далі — як звичайний прайс.

Фото є в кожного товару, характеристики — майже в кожного, опис ASBIS пише не для всіх. Під час додавання товару з прайсу в базовий каталог картка приходить заповненою (характеристики товарів, фото товарів).

У журналі хід видно рядками «Повні картки ASBIS: завантажуємо каталог ProductList…» і «Повні картки ASBIS: збережено ‹скільки›». Якщо ASBIS не віддав каталог — «Повні картки ASBIS не отримано (…) — прайс завантажується з уже збереженими картками»; картки оновляться наступного разу.

Наявність словами: так, обмежено, по запиту

Кількості ASBIS не дає — лише три слова, мовою файла. Стандартні статуси знають з них тільки «мало», тому привʼязка заводить у джерелі три правила наявності:

1

так, достаточно, yes

2

обмежено, мало, limited

3

по запиту, звоните, call

1. так / достаточно / yes — в наявності, 10 шт.
2. обмежено / мало / limited — в наявності, 1 шт.
3. по запиту / звоните / call — під замовлення.

Кількість тут умовна: ASBIS не каже, скільки штук на складі. Більшість товарів у прайсі ASBIS — «по запиту». Інші числа чи інший статус для «по запиту» задаються на вкладці «Наявність» джерела (наявність товару в прайсі постачальника).

Сценарії

Додавати товари ASBIS у каталог одразу з фото й характеристиками

Що зробити. «Повні картки товарів» = 1 (у нових джерел так уже стоїть), завантаження джерела, далі — додавання товарів з прайсу в базовий каталог, як звичайно.

Що вийде. Нові товари в каталозі отримують фото, характеристики й опис з ASBIS. Наступні завантаження оновлюють ціни й наявність, а картки — раз на тиждень.

Не показувати на сайті товари «по запиту»

Що зробити. На вкладці «Наявність» змініть статус правила «по запиту, звоните, call» на «Немає на складі».

Що вийде. Товари, яких ASBIS фізично не має, підуть як відсутні, а в наявності лишаться «так» і «обмежено».

Прайс російською

Що зробити. «Мова ASBIS» = ru.

Що вийде. Категорії, наявність, характеристики й описи приходять російською. Правила наявності вже знають російські слова. Картки російською програма завантажить окремо, при першому ж завантаженні.

Що робити, коли ASBIS відповідає 500 або наявність не та

Коли прайс не приїхав

• «Помилка API постачальника: ASBIS PriceAvail.xml: 500 Internal Server Error» — неправильні логін чи пароль або неіснуючий регіон;
• «ASBIS: впишіть логін і пароль від B2B-кабінету ASBIS…» — логін або пароль не вписані зовсім.

Прайс тоді не затирається: ціни й наявність лишаються з попереднього завантаження (чому так). Логін, пароль і регіон найпростіше звірити з посиланням, яке ASBIS вам надіслав.

Часті запитання

Що таке it4profit?

Це B2B-сервіс ASBIS, з якого дилери отримують прайс і каталог товарів. Інтеграція «ASBIS» в Elbuz бере дані саме звідти, з тими самими логіном і паролем.

Чому в товарів ASBIS кількість 10 або 1?

ASBIS не дає кількості, лише «так», «обмежено» чи «по запиту». Програма ставить умовні 10 і 1 штук; числа можна змінити в правилах наявності джерела.

Чи можна відправити замовлення в ASBIS з Elbuz?

Ні. Сервіс it4profit віддає тільки прайс і каталог, замовлення оформлюють у кабінеті ASBIS.

Чи можна отримати назви товарів ASBIS українською?

Ні. ASBIS дає назви англійською в усіх мовах файла; українською чи російською приходять категорії, наявність, характеристики й описи.

Як часто оновлюються картки ASBIS?

Повністю — раз на тиждень, бо каталог ASBIS віддається тільки цілим. Для нового товару без картки каталог дозапитується не частіше, ніж раз на добу.

Суміжні теми

• Якщо треба зрозуміти, що програма робить з будь-яким джерелом за API і де вписати доступи, — Як підключити постачальника за API.
• Якщо правила наявності ASBIS треба змінити, — Наявність товару в прайсі постачальника.
• Якщо картки прийшли, а характеристики не лягають у ваші атрибути, — Характеристики товарів.
• Якщо прайс завантажився, а ціни на сайті старі, — Як запустити імпорт прайсу і довести ціни до каталогу.