Інтеграція з Shopify
Інтеграція переносить замовлення з магазину Shopify до QUINCEFIN. Разом із замовленням система може створити відсутнього покупця та товар, щоб менеджер продовжив роботу вже в обліковій системі.
Профіль знаходиться в меню Налаштування → Інтеграції → Інтернет-магазини → Shopify.
Що потрібно підготувати
У Shopify створіть custom app із доступом Admin API до читання замовлень (read_orders) та скопіюйте Admin API access token. Токен показується Shopify обмежену кількість разів, тому збережіть його у дозволеному компанією менеджері секретів.
Поля профілю
- Профіль - зрозуміла назва підключення;
- Домен магазину - домен виду
store-name.myshopify.com, без шляху до сторінки; - Версія API - версія Admin API, яку підтримує магазин;
- Admin API access token - токен custom app;
- Користувач - користувач QUINCEFIN, чиї параметри за замовчуванням застосовуються до документів;
- Папка товарів - куди записувати нові товари;
- Папка партнерів - куди записувати нових покупців;
- Період - дати замовлень для імпорту.
Перший імпорт
- Заповніть домен, версію API й токен.
- Натисніть Перевірити з’єднання.
- Виберіть користувача, папки товарів і партнерів.
- Збережіть профіль.
- Встановіть короткий тестовий період та запустіть імпорт.
- Перевірте створене замовлення, покупця, товари, суми й контактні дані.
Обмеження
Поточний профіль Shopify призначений для імпорту замовлень. Він не публікує каталог, ціни або залишки з QUINCEFIN до Shopify. Реквізити нового документа залежать від параметрів за замовчуванням вибраного користувача та його прав.
Типові помилки
| Ситуація | Що перевірити |
|---|---|
| З’єднання не проходить | Домен без https://, актуальну версію API, повний токен і дозвіл read_orders. |
| Замовлення не знайдені | Період імпорту та фактичну дату замовлень у Shopify. |
| Документ не створюється | Права й параметри за замовчуванням вибраного користувача. |
| Товар або покупець потрапив не туди | Папки товарів і партнерів у профілі. |
Окремі профілі та повторний імпорт
Наведені нижче правила застосовуються після встановлення оновлення ізоляції профілів у вашій базі QUINCEFIN. Наявність оновлення можна уточнити у підтримки.
Для кожного окремого кабінету використовуйте власний профіль. Не замінюйте в уже налаштованому профілі доступи одного кабінету доступами іншого. Для оновлення токена того самого кабінету збережіть наявний профіль.
Замовлення зіставляється з документом за профілем і незмінним ідентифікатором із зовнішньої системи. Однакові номери замовлень у різних кабінетах не змішують документи та їхні рядки. Повторне завантаження того самого замовлення через той самий профіль використовує вже створений документ. Проведені та анульовані документи не перезаписуються і не створюються повторно.
Під час оновлення наявні документи зберігаються. Якщо для цієї інтеграції був лише один профіль, старі зв’язки закріплюються за ним автоматично; враховуються також неактивні профілі. Якщо профілів було декілька і належність старого замовлення невідома, імпорт зупиниться з повідомленням про конфлікт зв’язку.
У такому випадку передайте підтримці назву профілю, номер замовлення у зовнішній системі, номер наявного документа QUINCEFIN і текст помилки. Потрібно підтвердити зв’язок із правильним профілем, після чого повторити імпорт. Не видаляйте старий документ і не створюйте новий профіль для обходу цієї помилки.