Elbuz сам забирає дилерський прайс comportal — файл dealer.xml з comportal.kz: ціну в тенге, наявність, бренд, модель, гарантію, категорію, усі фото й характеристики товару.
Коли це знадобиться:
- Потрібні всі фото товару, а не одне — приходять усі, що є в прайсі.
- Бренд, модель і гарантія лежать серед параметрів — привʼязка сама розкладає їх по полях.
- Менеджер дав персональне посилання на прайс — програма завантажуватиме за ним.
- Ціни мають оновлюватися часто — файл невеликий і приходить за секунди.
З чого почати: майстер нового джерела → крок «Звідки» → плитка «API» → «Comportal».
Що вміє інтеграція з Comportal
- Прайс без ручної розмітки — код Comportal, артикул, назва й повна назва, категорія, ціна в тенге, наявність, бренд, модель і гарантія.
- Усі фото товару — усі, що є в прайсі.
- Характеристики — процесор, памʼять, діагональ, колір та інші параметри товару.
- Точний залишок — число одиниць на складі Comportal.
Ціни й наявність оновлюються за розкладом, як у будь-якого джерела прайсу. Загальна механіка готових інтеграцій — у статті Як підключити постачальника за API.
Де це і хто має доступ
- Меню
- Довідники → Обробка прайс-листів → Список прайс-листів
- Нове джерело
- майстер нового джерела, крок «Звідки» → плитка «API» → «Comportal»
- Адреса прайсу
- картка джерела, секція «Джерело» → «Налаштування параметрів API» → «Посилання на сервер API»
- Право доступу
- вікно «Список прайс-листів» плюс «Налаштування завантаження» і «…файл із прайс-листом»
- Підготувати
- доступ дилера Comportal; за потреби — персональне посилання на dealer.xml
Звідки програма бере прайс Comportal
Програма бере прайс за адресою https://www.comportal.kz/auth/documents/prices/dealer.xml — це дилерський прайс Comportal у форматі YML. Логін і пароль у джерелі не потрібні. Якщо менеджер Comportal дав вам інше, персональне посилання на прайс, впишіть його в поле «Посилання на сервер API» — програма завантажуватиме за ним.
Не плутайте з «ComPortal ESD» у тому самому списку інтеграцій: це окрема інтеграція для електронних ключів і ліцензій esd.comportal.kz, з власним логіном і паролем.
Як підключити Comportal
- У майстрі нового джерела на кроці «Звідки» оберіть плитку «API» і «Comportal» у списку.
- Натисніть «Імпортувати» — перший прайс приїде за кілька секунд: файл невеликий, близько тисячі товарів.
Програма сама підставляє адресу прайсу, ставить формат XML, вказує вузол товару offer і вузол категорій category, розмічає колонки, вмикає завантаження фото й характеристик і ставить валюту KZT (що робить привʼязка). Параметрів запиту в Comportal немає: що лежить у dealer.xml, те й приходить.
Що приходить від Comportal
Колонки XML-прайсу — це імена тегів. Бренд, модель і гарантія в прайсі Comportal окремих тегів не мають, вони лежать серед параметрів товару, тому привʼязка бере їх виразом виду param[@name="Бренд"].
| Колонка | Що в ній | Поле в Elbuz |
|---|---|---|
| [id] | код товару Comportal (атрибут offer) | «Артикул контрагента» |
| articul | артикул виробника | «Артикул виробника» |
| name | назва | «Найменування» |
| fullname | повна назва з короткими характеристиками | «Опис короткий» |
| param[@name="Бренд"] | бренд | «Виробник» |
| param[@name="Модель"] | модель | «Модель» |
| param[@name="Гарантия"] | гарантія | «Гарантія» |
| stock | залишок на складі | «Статус наявності (з прайсу)» і «Кількість» |
| categoryId | код категорії Comportal | категорія з прайсу |
| price | ціна, тенге | «Ціна» |
Інші теги теж є у файлі, і будь-який можна взяти вільним рядком секції «Колонки»:
articul_quality— стан товару (новий чи ні);inReserve— резерв;TnVedCode— код ТН ЗЕД;- будь-який параметр:
param[@name="Цвет"]дасть колір.
1
Фото з прайсу2
Виробник з параметра «Бренд»3
Усі фото товару4
Модель з параметра «Модель»- Мініатюра — перше фото товару з прайсу Comportal.
- Виробник береться з параметра «Бренд» прайсу.
- Галерея — усі фото товару, а не одне.
- Модель береться з параметра «Модель» прайсу.
Як читається наявність Comportal
Привʼязка бере наявність і кількість з тегу stock — це число одиниць на складі Comportal. Стандартні статуси розпізнають число від 1 як «В наявності» з цією кількістю, а 0 — як відсутній товар (наявність товару в прайсі постачальника).
Які характеристики брати в каталог
Кожен тег param товару стає характеристикою: процесор, памʼять, тип матриці, колір, розʼєми та інше. Разом із ними приходять і службові параметри Comportal — «Процент скидки», «Дата начала акции», «Товары в пути», «Специальная цена» тощо. Програма їх не відсіює, а для каталогу вони зайві: не зіставляйте їх зі своїми атрибутами, і в картки товарів вони не потраплять (характеристики товарів).
Сценарії
Завантажувати прайс за персональним посиланням
Що зробити. Отримайте посилання на свій прайс у менеджера Comportal і впишіть його в «Посилання на сервер API» вікна параметрів джерела.
Що вийде. Програма завантажуватиме саме ваш прайс; якщо посилання перестане працювати, причина зʼявиться в журналі, а старі ціни лишаться.
Показувати на сайті колір товару окремим полем
Що зробити. У секції «Колонки» додайте рядок потрібного поля з адресою param[@name="Цвет"].
Що вийде. Колір ляже в це поле, а не тільки в характеристики. Так само береться будь-який інший параметр Comportal.
Оновлювати ціни щогодини
Що зробити. У розкладі джерела Comportal задайте завантаження щогодини (імпорт і розклад).
Що вийде. Прайс невеликий і приходить одним файлом, тож часте оновлення займає секунди й не навантажує програму.
Що робити, коли прайс Comportal не приїхав
Чому прайс не оновився
Якщо Comportal не віддав прайс — посилання закрите, змінилося або сайт недоступний, — у журналі джерела зʼявиться «Помилка API постачальника: Comportal dealer.xml: …» з кодом відповіді сервера, наприклад «HTTP 403», і початком сторінки, яку повернув Comportal. Програма в такому разі не затирає прайс: ціни й наявність лишаються з попереднього завантаження (загальна механіка).
| Що ви бачите | Чому так | Що зробити |
|---|---|---|
| «Помилка API постачальника: Comportal dealer.xml: HTTP 403 …» | Comportal закрив посилання або змінив адресу прайсу | Взяти актуальне посилання в менеджера Comportal і вписати в «Посилання на сервер API» (звідки прайс) |
| У прайсі «HP», а в Comportal — «HP Europe» | Довідник виробників зводить варіанти назви бренду до одного | Нічого: так товари різних постачальників потрапляють до одного виробника |
| У прайсі тільки ключі й ліцензії | Джерело заведене на «ComPortal ESD», а не на «Comportal» | Завести нове джерело з інтеграцією «Comportal» |
Часті запитання
Чи потрібен логін і пароль Comportal?
Ні. Програма бере дилерський прайс dealer.xml за посиланням (звідки прайс).
У якій валюті ціни Comportal?
У тенге. Привʼязка ставить валюту KZT за кодом.
Чим «Comportal» відрізняється від «ComPortal ESD»?
«Comportal» завантажує товарний прайс dealer.xml. «ComPortal ESD» — окрема інтеграція для електронних ключів і ліцензій з власним логіном і паролем.
Чому в характеристиках «Процент скидки» чи «Товары в пути»?
Це службові параметри Comportal. Не зіставляйте їх зі своїми атрибутами — у картки вони не потраплять.
Чи можна відправити замовлення в Comportal з Elbuz?
Ні. Прайс Comportal — тільки файл, замовлення оформлюють на сайті Comportal.
Суміжні теми
- Якщо потрібна загальна картина готових інтеграцій і вікна параметрів — Як підключити постачальника за API.
- Якщо прайс завантажився і треба налаштувати розклад та імпорт — імпорт прайсу.
- Якщо характеристики Comportal не лягають на ваші атрибути — характеристики товарів.
- Якщо ви працюєте ще з одним дистрибʼютором Казахстану — Як підключити Al-Style за API.