Etsy — міжнародний майданчик для handmade, вінтажу й товарів для творчості, з основною аудиторією у США та ЄС. На відміну від класичних маркетплейсів, тут продавець створює власні лістинги: картку веде він сам, а не майданчик. Це означає, що Elbuz може працювати з Etsy у повному циклі — забирати лістинги в базовий каталог, приймати замовлення, оновлювати ціни й залишки, а за потреби й публікувати нові лістинги.
Загальний порядок для всіх API-джерел каталогу описано в огляді імпорту каталогу через API, спільні правила замовлень — в огляді імпорту замовлень. Тут — про Etsy.
Де це у програмі
У вікні завантаження створіть шаблон і оберіть тип «Etsy». Це API-джерело: файл не потрібен, підключення відбувається прив'язкою магазину.
1
Поле «Shop ID»2
Поле «Shipping profile ID»- Shop ID можна лишити порожнім — визначиться автоматично.
- Shipping profile ID потрібне для публікації лістингів.
Як підключити: код прив'язки
Реєструвати застосунок у Etsy й розбиратися з ключами не потрібно. У формі шаблону є картка встановлення застосунку: ви натискаєте «Підключити», підтверджуєте доступ до свого магазину Etsy і вводите короткий код прив'язки. Після цього Elbuz отримує доступ від вашого імені, а токен оновлюється автоматично — це принципово для Etsy, бо доступи там короткоживучі й ротуються, і продовжувати їх руками було б щоденною роботою.
У картці «Підключення» лишаються два необов'язкові поля:
| Поле | Навіщо |
|---|---|
| Shop ID | Ідентифікатор вашого магазину. Можна лишити порожнім — Elbuz визначить його сам |
| Shipping profile ID | Профіль доставки Etsy. Потрібен лише для публікації нових лістингів |
Перевірити, що все зчепилося, можна кнопкою «Перевірити підключення»: у відповідь Elbuz покаже ідентифікатор магазину.
Довідка майданчика для продавців: Etsy Open API v3. Профіль доставки створюється в кабінеті продавця, у розділі налаштувань доставки.
Як підключити крок за кроком
Створіть шаблон типу «Etsy» і збережіть його — прив'язка працює вже для збереженого шаблону. Натисніть «Підключити», підтвердіть доступ у вікні Etsy, скопіюйте короткий код і вставте його у форму. Перевірте результат кнопкою «Перевірити підключення»: у відповіді має бути ідентифікатор вашого магазину.
Далі позначте, що завантажувати — лістинги, замовлення чи і те, й інше, — і чи тягнути фотографії. Запустіть завантаження вручну, не чекаючи розкладу, і перевірте результат очима: відкрийте кілька карток і звірте ціну, залишок і назву з кабінетом Etsy, а в замовленнях — склад, суму й покупця. Коли все сходиться, поставте шаблон на розклад.
Що приходить у каталог
Elbuz забирає активні лістинги магазину разом із фотографіями й даними про наявність.
| Дані Etsy | Поле товару в Elbuz |
|---|---|
| заголовок лістинга | Назва |
| опис | Опис |
| артикул (SKU) | Артикул |
| ціна пропозиції | Ціна |
| кількість | Залишок |
| стан лістинга | Статус: активний — увімкнений товар |
| теги лістинга | Теги |
| матеріали | Характеристика «Material» |
| таксономія (категорія Etsy) | Категорія |
| фотографії | Фотографії (якщо ввімкнено галочку) |
Ціна й залишок беруться саме з блоку наявності лістинга — того, що Etsy показує покупцеві, — і лише якщо його немає, Elbuz бере значення з самої картки.
Etsy передає категорію числовим кодом таксономії. Щоб у каталозі було зрозуміле ім'я, Elbuz звіряється з довідником таксономії Etsy — а він наповнюється окремо, при першому підключенні майданчика. Тому на самому початку категорія може виявитися порожньою, і товари ляжуть у категорію джерела. Це не помилка й не втрата даних: розкладіть такі товари по своєму дереву, далі вони туди й оновлюватимуться.
Замовлення
Замовлення на Etsy називаються чеками (receipts), і позиції приходять разом із ними — окремих запитів на кожен товар не потрібно. Перший запуск переносить історію, далі забираються нові й змінені, а вже завантажені оновлюються.
У документ потрапляють номер чека, дати створення й зміни, ім'я та прізвище покупця (Etsy віддає їх одним рядком — Elbuz ділить його на ім'я й прізвище), пошта, адреса доставки з містом, індексом і кодом країни, валюта, повідомлення від покупця, статус чека, ознака оплати, спосіб оплати й позиції з артикулом, ціною та кількістю.
Etsy не передає телефон покупця — у чеку є пошта й адреса. Тому покупець упізнається за поштою та своїм ідентифікатором на Etsy: саме за ними повторні замовлення однієї людини збираються в одного контрагента. Якщо у вашій роботі телефон обов'язковий, беріть його з листування або запитуйте окремо.
Оновлення цін і залишків
Зворотний напрямок — окремий шаблон вивантаження типу «Etsy». Для кожного пов'язаного лістинга Elbuz читає його блок наявності, підставляє вашу ціну й залишок і повертає назад. Звучить просто, але важливий нюанс: Etsy приймає цей блок цілком, а не частинами, тому Elbuz кожного разу пересобирає його зі збереженням артикула й властивостей варіанта.
Публікація нових лістингів
Якщо ввімкнено галочку створення товарів, Elbuz може завести на Etsy нові лістинги з ваших карток. Порядок такий: спершу створюється чернетка, потім Elbuz завантажує фотографію (він скачує її за посиланням і заливає у лістинг), далі проставляє ціну, залишок і артикул, і лише після цього переводить лістинг в активний стан.
Щоб лістинг опублікувався, потрібні три речі. Перша — заповнений «Shipping profile ID» у шаблоні: без профілю доставки Etsy лістинг не прийме. Друга — сопоставлена таксономія Etsy для категорії товару; товари без неї тихо пропускаються, їх кількість видно в журналі. Третя — хоча б одна фотографія: Etsy не активує лістинг без зображення, тож така картка лишиться чернеткою в кабінеті. Чернетка не втрачається — дозавантажте фото й опублікуйте її вручну.
Розклад
Etsy працює поллінгом: Elbuz звертається до майданчика за розкладом. Розклад задають кнопкою налаштування завдання у формі шаблону. Для магазину з рівним потоком замовлень вистачає кількох запусків на день; каталог достатньо оновлювати раз на добу.
Навіщо зводити Etsy в Elbuz
Etsy рідко буває єдиним каналом: майстри й невеликі виробництва зазвичай продають ще й у себе на сайті, в соцмережах, часом на локальному маркетплейсі. Поки залишок ведеться в голові чи в таблиці, рано чи пізно трапляється продаж того, що вже поїхало іншому покупцеві. Elbuz тримає єдиний каталог і єдиний залишок: продаж на Etsy зменшує наявність скрізь, а замовлення з усіх каналів сходяться в одну чергу. Плюс історія покупців і документи — те, чого в кабінеті майданчика немає.
Часті труднощі
Перша й найчастіша — прив'язка не спрацювала: код прив'язки живе недовго, і якщо між його отриманням і вставкою минуло багато часу, майданчик його вже не прийме. Повторіть підключення й вставте код одразу; перевірка підключення має відповісти ідентифікатором магазину.
Друга — товарів завантажилося менше, ніж є в кабінеті. Elbuz забирає активні лістинги: чернетки, приховані й розпродані позиції не приходять. Це не втрата даних, а фільтр за станом лістинга на боці Etsy.
Часті питання
Чи треба реєструвати застосунок Etsy?
Ні. Підключення відбувається кодом прив'язки: ви натискаєте «Підключити», підтверджуєте доступ до свого магазину й вводите короткий код. Доступ після цього продовжується автоматично, вручну оновлювати токени не доводиться.
Що вписувати в поле Shop ID?
Можна нічого не вписувати: Elbuz визначить ідентифікатор магазину сам. Заповнити поле варто, якщо на акаунті кілька магазинів або якщо в журналі з'явилося повідомлення, що Shop ID визначити не вдалося.
Чому новий лістинг залишився чернеткою?
Etsy не активує лістинг без фотографії. Якщо у товару в Elbuz не було жодного придатного зображення, картка створюється, але лишається чернеткою в кабінеті. Додайте фото й опублікуйте лістинг вручну — або заповніть фотографії в Elbuz і повторіть вивантаження.
Чому товари потрапили в категорію джерела, а не в потрібну?
Etsy передає категорію числовим кодом таксономії, а зрозуміле ім'я Elbuz бере з довідника, який наповнюється при першому підключенні майданчика. Поки довідника немає, ім'я категорії порожнє й товари лягають у категорію джерела. Розкладіть їх по своєму дереву — далі оновлення потраплятимуть саме туди.
Чому в замовленнях з Etsy немає телефону?
Тому що Etsy його не передає: у чеку є пошта, ім'я й адреса доставки. Покупець упізнається за поштою та ідентифікатором на Etsy, тож повторні замовлення однієї людини все одно збираються в одного контрагента.