Інтеграція з Kasta

Інтеграція з Kasta дозволяє обмінюватися даними між кабінетом постачальника Kasta HUB та обліковою системою QUINCEFIN.

Що підтримується

З Kasta в QUINCEFIN:

• імпорт замовлень покупців;
• створення документа замовлення покупця;
• створення нового партнера, якщо покупця ще немає в системі;
• створення нового товару, якщо він не знайдений за артикулом або штрихкодом.

З QUINCEFIN в Kasta:

• актуальні залишки товарів;
• ціни товарів;
• товарний контент: назви, описи, бренд, колір, розмір, склад, категорії та зображення.

Доступи Kasta

Для роботи інтеграції потрібен API token Kasta HUB. Його надає Kasta для акаунта постачальника.

Для тестування потрібно попросити у Kasta тестовий supplier account і API token для тестового контуру HUB. У зверненні варто вказати, що потрібен доступ для перевірки API інтеграції із QUINCEFIN: імпорт замовлень, оновлення залишків, оновлення цін і завантаження товарного контенту.

Створення профілю

Профіль інтеграції знаходиться в меню Налаштування / Інтеграції / Маркетплейси / Kasta.

У профілі є вкладки:

• Підключення;
• Замовлення;
• Товари;
• Контент.

Після заповнення параметрів потрібно натиснути Перевірити з’єднання, а потім Застосувати.

Підключення

На вкладці Підключення заповнюються основні параметри:

• Профіль - назва профілю в QUINCEFIN;
• API URL - адреса Kasta HUB API;
• API token - токен доступу постачальника Kasta;
• Користувач - користувач QUINCEFIN, чиї налаштування використовуються під час створення документів;
• Папка товарів - папка, у якій створюються нові товари з замовлень;
• Папка партнерів - папка, у якій створюються нові покупці;
• Склад - склад для розрахунку залишків;
• Тип ціни - тип ціни для експорту в Kasta;
• Ідентифікатор SKU - поле, за яким QUINCEFIN передає товар у Kasta: unique_sku_id або barcode.

Імпорт замовлень

На вкладці Замовлення обирається період імпорту. Після натискання кнопки імпорту QUINCEFIN завантажує замовлення з Kasta та створює документи замовлення покупця.

Якщо в замовленні є новий покупець або товар, система створює відповідну картку за налаштуваннями профілю.

Перед першим імпортом перевірте:

• папку партнерів, у якій будуть створюватися нові покупці;
• папку товарів для позицій, які ще не знайдені в каталозі;
• склад, відповідального користувача і тип ціни;
• правило ідентифікації SKU: unique_sku_id або barcode.

Експорт залишків і цін

На вкладці Товари можна передати в Kasta:

• залишки товарів за обраним складом;
• ціни товарів за обраним типом ціни.

Перед експортом переконайтесь, що у товарах заповнений артикул або штрихкод відповідно до вибраного ідентифікатора SKU.

Завантаження товарного контенту

На вкладці Контент налаштовуються дані для створення або оновлення товарних карток у Kasta.

Перед завантаженням потрібно:

• заповнити дефолтні значення бренду, кольору, розміру та складу, якщо ці дані не ведуться у картці товару;
• для кожної папки товарів вказати kind_id і affiliation_id Kasta;
• переконатися, що товари мають ціну та хоча б одне зображення;
• перевірити, що для товарів заповнені назви, бренд, колір, розмір і Kasta size.

Товари потрапляють у вивантаження тільки з папок, для яких налаштована категорія Kasta.

Категорії Kasta

У таблиці папок товарів потрібно відкрити папку подвійним кліком і заповнити:

• kind_id - ідентифікатор типу товару в Kasta;
• affiliation_id - ідентифікатор прив’язки категорії Kasta.

Ці значення беруться з довідників або документації Kasta для категорій товарів.

Журнали обміну

У профілі відображаються останні операції:

• імпорт замовлень;
• експорт залишків;
• експорт цін;
• вивантаження контенту.

Якщо обмін завершився помилкою, перевірте API token, доступність Kasta HUB API та заповнення обов’язкових полів товарів.

Типові помилки