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

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

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

З Etsy у QUINCEFIN:

• імпорт нових і змінених замовлень вручну або за розкладом;
• автоматичний пошук оновлень кожні 5 хвилин;
• імпорт лістингів Etsy і їхніх варіантів до каталогу QUINCEFIN.

З QUINCEFIN в Etsy:

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

Кількість і ціни оновлюються лише для вже пов’язаних наявних лістингів Etsy. Інтеграція не створює нові лістинги Etsy з каталогу QUINCEFIN.

Обмеження, які варто знати

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

Що підготувати

Перед підключенням підготуйте:

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

Застосунок створюється в Etsy Developers. Для довідки використовуйте офіційні матеріали Etsy Open API та OAuth 2.0 authentication. Профіль QUINCEFIN уже містить рекомендований набір дозволів для магазину, замовлень, лістингів і трекінгу; не скорочуйте його без окремої перевірки сценаріїв.

Створіть і підключіть профіль

1. Відкрийте Налаштування / Інтеграції / Маркетплейси / Etsy.
2. Створіть профіль і вкажіть зрозумілу назву, наприклад Etsy — основний магазин.
3. Збережіть профіль. У ньому буде показано адресу повернення для підключення.
4. Скопіюйте цю адресу до налаштувань застосунку Etsy як redirect URI. Використовуйте адресу з інтерфейсу без змін.
5. Натисніть Підключити Etsy. У вікні Etsy увійдіть у потрібний магазин і підтвердьте доступ.
6. Після повернення в QUINCEFIN перевірте, що профіль показує успішне підключення, та натисніть Застосувати.

Якщо Etsy не повертає вас у профіль або підключення не завершується, ще раз звірте redirect URI: він має повністю збігатися з адресою, яку показує QUINCEFIN.

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

У профілі можна запустити імпорт вручну або увімкнути розклад. Після ввімкнення розкладу QUINCEFIN перевіряє нові та змінені замовлення кожні 5 хвилин.

Для першої перевірки:

1. Виберіть невеликий безпечний період ручного імпорту.
2. Запустіть Імпорт замовлень вручну.
3. Перевірте створені або оновлені документи в QUINCEFIN.
4. Повторіть той самий імпорт: дублікати замовлень не повинні з’явитися.

Автоімпорт початково вимкнений. Після ручної перевірки він читає зміни від останньої контрольної точки з невеликим перекриттям.

Якщо замовлення не з’явилося одразу після зміни в Etsy, дочекайтеся наступної перевірки за розкладом або запустіть ручний імпорт.

Імпорт товарів і варіантів

Відкрийте вкладку товарів профілю та запустіть імпорт лістингів. QUINCEFIN створює записи каталогу відповідно до налаштувань профілю; кожна активна Etsy-варіація імпортується як окрема товарна позиція і зв’язується з відповідним offering. Якщо Etsy SKU не заповнено, інтеграція створює технічний артикул із Etsy ID.

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

Синхронізація залишків і цін

Виберіть склад, з якого береться кількість, і за потреби увімкніть синхронізацію цін із вибраного типу ціни. Спочатку протестуйте обмін на кількох уже пов’язаних лістингах.

Валюта вибраного типу ціни має відповідати валюті Etsy-магазину: інтеграція не виконує автоматичну конвертацію ціни під час відправлення в Etsy.

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

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

Відправлення і трекінг

Увімкніть синхронізацію відправлень тільки коли команда погодила процес комунікації з покупцем. Передавання трекінг-номера в Etsy може спричинити сповіщення покупцеві. За замовчуванням цей обмін вимкнений.

Типові ситуації

Безпечний запуск

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