Перейти до основного вмісту

Типові помилки інтеграцій

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

Починайте діагностику з картки інтеграції в Налаштування → Інтеграції.

Підключення не проходить перевірку​

Якщо Перевірити підключення не проходить успішно, перевірте:

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

Для Monobank може знадобитися Перепідключити обліковий запис. Для ПриватБанку перевірте токен у Приват24 для бізнесу.

Дані доступу правильні, але обмін не працює​

Після перевірки підключення відкрийте Журнал синхронізації.

Далі перевірте:

  • чи увімкнена Інтеграція активна;
  • чи увімкнена синхронізація потрібного блоку: товарів, замовлень або виписок;
  • чи заповнено інтервал синхронізації, якщо потрібен автоматичний обмін;
  • чи не обмежили ви товари категорією, складом або типом товару;
  • чи не вибрано дату, після якої потрібні дані ще не з'явилися.

Створюються дублікати товарів​

Дублікати товарів зазвичай з'являються через неправильний Ідентифікатор товара або Ідентифікатор модифікації.

Перевірте:

  • яке поле вибране як ідентифікатор;
  • чи заповнене це поле в Skynum;
  • чи є таке саме значення у зовнішньому сервісі;
  • чи не змінювали артикул, код або зовнішній ID після першої синхронізації;
  • чи окремо налаштований ідентифікатор модифікації.
попередження

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

Товар не вивантажується​

Якщо окремий товар не потрапляє в інтернет-магазин або маркетплейс, перевірте:

  • чи товар активний;
  • чи не виключена його категорія;
  • чи входить він у Тільки товари з категорії;
  • чи входить він у Тільки товари з типами;
  • чи є залишок, якщо Вивантажувати товари без залишків вимкнено;
  • чи є потрібна ціна;
  • чи заповнені обов'язкові характеристики або модифікації;
  • чи немає помилки в Журнал синхронізації.

Для Хорошоп окремо перевірте, що категорія створена вручну в самому магазині.

Неправильні залишки​

Якщо в зовнішньому сервісі показується неправильна наявність або кількість, перевірте:

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

Докладніше: Залишки товарів, Резерви товарів.

Неправильна ціна​

Якщо ціна в магазині або маркетплейсі не збігається з очікуваною, перевірте:

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

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

Замовлення не завантажуються​

Якщо замовлення із зовнішнього сервісу не потрапляють у Skynum, перевірте:

  • чи увімкнена Синхронізація замовлень активна;
  • дату або обмеження імпорту замовлень;
  • Спосіб оновлення замовлень;
  • API-мапінг статусів;
  • Склад за замовчуванням;
  • Канал продажів;
  • Група контрагента;
  • чи існують товари в Skynum, якщо інтеграція пропускає відсутні товари.
порада

Для першої перевірки створіть тестове замовлення із простим товаром, який точно існує в Skynum і має залишок на потрібному складі.

Статус замовлення передається неправильно​

Перевірте вкладку API мапінг.

Особливо уважно звірте:

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

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

Виписки не з'являються​

Для банківських інтеграцій перевірте:

  • чи активна інтеграція;
  • чи підключений обліковий запис або вставлений токен;
  • Дата початку синхронізації;
  • зіставлення банківських рахунків;
  • фільтр Рахунок у Фінанси → Виписки;
  • фільтр Статус;
  • період у фільтрах.

Якщо виписка вже оброблена або архівована, вона може бути не в статусі У роботі.

Платежі дублюються​

Дублювання платежів може виникнути, якщо:

  • частину оплат уже внесли вручну;
  • потім завантажили виписки за той самий період;
  • автоматичне створення платежів увімкнули до перевірки правил;
  • виписку кілька разів рознесли вручну без перевірки Пов'язані платежі.

Перед створенням платежу з виписки перевіряйте колонку Пов'язані платежі.

Коли використовувати очищення кешу​

У картках інтеграцій може бути дія Очистити кеш.

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

Не починайте діагностику з очищення кешу, якщо причина помилки очевидна в налаштуваннях або журналі.

Короткий порядок діагностики​

  1. Відкрийте картку інтеграції.
  2. Перевірте, що інтеграція активна.
  3. Перевірте доступ кнопкою Перевірити підключення.
  4. Перевірте дані доступу.
  5. Перевірте мапінг.
  6. Перевірте обмеження: категорії, склади, типи товарів, дати.
  7. Відкрийте Журнал синхронізації.
  8. Перевірте фактичний результат у Skynum.
  9. Перевірте фактичний результат у зовнішньому сервісі.
  10. Повторіть обмін на невеликому тестовому наборі.

Підсумок​

Найнадійніший спосіб розібрати помилку інтеграції — йти від доступу до даних: підключення, активність, мапінг, обмеження, журнал і фактичний результат. Більшість проблем знаходяться саме в цих місцях.

Останнє оновлення