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

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

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

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

З SalesBox в QUINCEFIN:

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

З QUINCEFIN в SalesBox:

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

Доступи SalesBox

Для підключення потрібен персональний API token SalesBox. Його потрібно отримати в акаунті SalesBox, який має доступ до потрібної компанії та операцій OpenAPI.

Зберігайте token як службовий доступ. Не передавайте його користувачам, які не адмініструють інтеграцію.

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

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

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

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

Підключення

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

• Профіль - назва профілю інтеграції в QUINCEFIN;
• API URL - адреса API SalesBox, яку показує профіль;
• API token - персональний token доступу SalesBox.

Якщо token змінено, збережіть профіль і знову виконайте перевірку з’єднання.

Перевірка з’єднання

Кнопка Перевірити з’єднання перевіряє, чи QUINCEFIN може звернутися до SalesBox з указаним token.

Якщо перевірка не проходить, перевірте:

• чи token скопійований повністю і без зайвих пробілів;
• чи token активний у SalesBox;
• чи акаунт SalesBox має доступ до OpenAPI;
• чи доступний API SalesBox з вашої мережі.

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

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

Перед першим імпортом заповніть:

• Період - дата або період, за який потрібно завантажити замовлення;
• Користувач - користувач QUINCEFIN, чиї параметри за замовчуванням використовуються для створення документа;
• Записувати товари в папку - папка для нових товарів, які прийшли з SalesBox;
• Записувати партнерів в папку - папка для нових покупців.

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

Після збереження налаштувань натисніть Імпорт. Якщо у профілі є незбережені зміни, спочатку натисніть Застосувати.

Експорт товарів

На вкладці Товари налаштовуються параметри передавання товарів у SalesBox:

• Склад - склад QUINCEFIN, за яким розраховуються залишки;
• Тип ціни - тип ціни, який передається в SalesBox;
• ID складу SalesBox - ідентифікатор складу SalesBox, якщо він використовується у вашому акаунті;
• Групи товарів для експорту - папки каталогу, з яких потрібно вивантажувати товари.

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

Для експорту товарів важливо, щоб у картках товарів були заповнені артикули. Артикул використовується як внутрішній ідентифікатор товару під час обміну з SalesBox.

Перед експортом перевірте:

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

Після збереження налаштувань натисніть Експортувати товари.

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

У профілі відображається інформація про останній обмін:

• на вкладці Замовлення - результат останнього імпорту замовлень;
• на вкладці Товари - результат останнього експорту товарів.

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

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