Як підключити Artline за API: ціни рахунку, фото й замовлення з документа

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

• Прайс без ручної розмітки — код товару, артикул, назва, категорія, ціни вашого рахунку й РРЦ, наявність.
• Ціни в доларах чи гривнях рахунку — валюта читається з кожного рядка.
• Фото, характеристики й опис — разом із прайсом; товари додаються в каталог одразу заповненими.
• Залишок загальний або з одного складу.
• Замовлення з документа — зі станом і оплатою від Artline.

Загальна механіка готових інтеграцій — майстер, вікно параметрів доступу, розмітка колонок — у статті Як підключити постачальника за API. Тут тільки те, що стосується Artline.

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

Меню

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

Нове джерело

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

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

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

Замовлення

документ «Замовлення постачальнику» → «Відправити постачальнику»

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

вікно «Список прайс-листів» плюс «Налаштування завантаження» і «…файл із прайс-листом»; для замовлення — редагування документів

Підготувати

ключ API (access-token) з кабінету opt.artline.ua

Де взяти ключ API Artline

Потрібен один ключ — access-token. Він є в кабінеті порталу opt.artline.ua, у розділі «Прайс-листи». Ключ вписується в «Пароль (токен)» вікна параметрів API; поле «Логін» для Artline не використовується.

Які параметри запиту Artline заповнити

У майстрі нового джерела на кроці «Звідки» оберіть плитку «API» і «artline.ua» у списку. Адресу https://opt.artline.ua/api/, формат CSV, колонки й завантаження фото та характеристик програма підставить сама (що саме вона робить). У вікні «Налаштування параметрів доступу до API» впишіть ключ у «Пароль (токен)».

Кнопка «Отримати довідкові дані» показує склади Artline з їхніми ID і курс Artline — ID складу знадобиться для параметра «Склад Artline».

У джерел, підключених раніше, ці чотири рядки, ключ товару (колонка 1) і завантаження фото й характеристик додані з цією версією.

1

Склад Artline (ID)

2

Замовлення: оплата

3

Замовлення: доставка

1. Склад Artline: порожньо — загальний залишок; ID складу — у «Отримати довідкові дані».
2. Замовлення: оплата: 2 — без ПДВ, 1 — з ПДВ.
3. Замовлення: доставка — текст для Artline: місто, відділення, отримувач, телефон.

Що приходить від Artline

Програма складає з відповіді API CSV-файл: кожен товар — рядок, кожне поле — колонка за номером.

У джерел, підключених раніше, опис міг стояти в «Опис короткий» — за потреби перенесіть адресу 11 у рядок «Опис повний».

1

Артикул контрагента = 1, унікальність

2

Ціна = 8 (F2)

3

Валюта = 9

1. Колонка 1 — код товару Artline; за ним привʼязуються фото й характеристики і йде замовлення.
2. Колонка 8 — ціна F2 у валюті вашого рахунку.
3. Колонка 9 — валюта рядка: USD чи грн, за нею програма перераховує ціну.

Як працюють ціни F1, F2 і валюта рахунку

Привʼязка бере ціну F2 (колонка 8). Artline віддає дві ціни вашого рахунку — F1 і F2 — у валюті рахунку дилера: доларах чи гривнях. Валюту кожного рядка програма читає з колонки 9 і перераховує ціну в гривні під час застосування націнки, тож рахунок у доларах працює без ручних налаштувань. РРЦ (колонка 6) Artline завжди дає в гривнях.

Потрібна ціна F1? Поставте в рядку «Ціна» адресу 7.

Як приходять фото, характеристики й опис

Artline віддає фото, характеристики й опис разом із прайсом, окремого каталогу не треба:

• Фото — усі фото товару (1200×1200); є не в кожного товару.
• Характеристики — пари «назва: значення»; кілька значень однієї характеристики стають одним рядком через « / ».
• Опис — з HTML-розміткою, у «Опис повний».

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

Як читається наявність Artline

Artline пише наявність текстом: «1 шт», «2 шт», «>3 шт» — точна кількість лише до 3 штук. Стандартні статуси розпізнають це без налаштувань: будь-яке число — «В наявності», а кількість — саме число («>3 шт» стає 3 штуками). Товарів без наявності в прайсі немає, поки «Тільки товари в наявності» = 1.

Як відправити замовлення в Artline

Замовлення постачальнику, створене в Elbuz на контрагента Artline, відправляється з документа кнопкою «Відправити постачальнику». Програма бере параметри з першого активного API-джерела контрагента, на якого виписано документ.

Що відбувається після натискання

1. програма перевіряє, чи не відправлявся вже цей документ в Artline;
2. відправляє позиції за кодом Artline; однакові товари складаються в один рядок;
3. передає спосіб оплати, текст доставки з параметрів і коментар «Elbuz ‹номер документа›».

Номер замовлення Artline записується в документ, статус від постачальника — «Новий заказ». Якщо Artline додав до замовлення не всі товари, програма перелічує їх після «Увага:».

Повтор не створює друге замовлення. Якщо в документі вже є номер замовлення Artline, повторне натискання нічого не відправляє і показує цей номер.

Стан замовлення

Стан оновлюється лише пунктом «Оновити статус від постачальника». Він запитує в Artline поточний стан і показує «Artline: замовлення ‹номер› — ‹стан›, ‹оплата›»: наприклад, «До відвантаження, Не оплачений». Стан записується в документ як статус від постачальника.

Відправку замовлення ми перевірили на імітації сервера Artline, а не на справжньому замовленні. Перше замовлення відправте невелике й звірте результат у кабінеті Artline.

Сценарії

Рахунок у доларах, ціни на сайті в гривнях

Що зробити. Нічого додатково: привʼязка вже бере валюту з колонки 9.

Що вийде. Ціна кожного товару перераховується в гривні під час застосування націнки за вашим курсом долара.

Продавати лише зі свого складу Artline

Що зробити. Натисніть «Отримати довідкові дані», знайдіть ID складу й впишіть його в «Склад Artline (ID)».

Що вийде. Прайс показує залишок тільки цього складу.

Замовити в Artline з доставкою

Що зробити. Заповніть «Замовлення: доставка» (місто, відділення, отримувач, телефон), створіть «Замовлення постачальнику» на Artline і натисніть «Відправити постачальнику».

Що вийде. Номер замовлення Artline записується в документ, а «Оновити статус від постачальника» показує стан і оплату.

Що робити, коли прайс Artline не приїхав або замовлення не пішло

Чому прайс не оновився

Якщо ключ неправильний, Artline відмовляє, і в журналі зʼявиться «Помилка API постачальника: Artline catalog/list: …» з текстом Artline. Якщо ключ не вписаний, буде «Artline: впишіть ключ API (access-token)…». Програма в такому разі не затирає прайс: ціни й наявність лишаються з попереднього завантаження (загальна механіка).

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

Чи треба щось вмикати, щоб отримати фото й характеристики Artline?

Ні, вони приходять разом із прайсом: усі фото, характеристики й опис (докладніше).

Чому в прайсі немає товарів, яких немає на складі?

Так задає «Тільки товари в наявності» = 1. Поставте 0, щоб отримувати увесь каталог.

Чому кількість у товарів Artline не більша за 3?

Artline показує точний залишок лише до 3 штук, далі — «>3 шт». Програма бере 3.

Чи створиться дубль, якщо натиснути «Відправити постачальнику» двічі?

Ні. Якщо в документі вже є номер замовлення Artline, програма повторно не відправляє і показує цей номер.

Чи можна змінити або видалити замовлення Artline з Elbuz?

Ні. Зміни — у кабінеті Artline.

Суміжні теми

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