Як підключити Etsy: лістинги, замовлення й залишки в одному каталозі

Що вміє підключення Etsy

• Переносить активні лістинги — назву, опис, артикул, ціну, залишок, теги, матеріали, категорію й фото.
• Забирає замовлення — чеки Etsy лягають документами «Замовлення покупця» з покупцем і адресою.
• Оновлює ціни й залишки у пов'язаних лістингах окремим шаблоном вивантаження.
• Публікує нові лістинги з ваших карток — із фото, ціною й артикулом.
• Працює за розкладом — на сервері, без відкритого браузера.

Де це і хто має доступ

Меню

Довідники → Операції → Завантаження даних

Шаблон

новий шаблон → тип «Etsy»; файл не потрібен

Ціни й публікація

вікно «Вивантаження даних» → шаблон типу «Etsy»

Право доступу

вікно «Завантаження даних» у «Правах груп»

Підготувати

доступ до кабінету продавця Etsy; для публікації — профіль доставки

1

Поле «Shop ID»

2

Поле «Shipping profile ID»

1. Shop ID можна лишити порожнім — визначиться автоматично.
2. Shipping profile ID потрібне для публікації лістингів.

Як працюють шаблони завантаження загалом — огляд завантаження даних.

Що потрібно від Etsy: код прив'язки

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

Як підключити крок за кроком

1. Створіть шаблон типу «Etsy» і збережіть його — прив'язка працює для збереженого шаблону.
2. Натисніть «Підключити», підтвердіть доступ у вікні Etsy і скопіюйте код.
3. Одразу вставте код у форму: він живе недовго.
4. Натисніть «Перевірити підключення» — у відповіді має бути ідентифікатор вашого магазину.
5. Позначте, що завантажувати — товари, замовлення, фото, — і запустіть прогін вручну. Звірте кілька карток і замовлень із кабінетом Etsy, потім поставте шаблон на розклад.

Прив'язка одна на акаунт Etsy і зберігається на рівні вашого акаунта Elbuz, а не шаблона. Підключили в шаблоні завантаження — шаблон вивантаження працює з тим самим доступом, і навпаки. Вимкнення чи видалення одного шаблона прив'язку не розриває.

Поля картки «Підключення»

Що переноситься в картку

Elbuz забирає активні лістинги магазину разом із фотографіями й даними про наявність.

Ціна й залишок беруться з блоку наявності лістинга — того, що Etsy показує покупцеві. Лише якщо його немає, Elbuz бере значення з самої картки лістинга.

Категорія: довідник таксономії Etsy

Etsy передає категорію числовим кодом таксономії. Зрозуміле ім'я Elbuz бере з довідника, який завантажують окремо: вікно «Зіставлення категорій та атрибутів з маркетплейсами» → чип Etsy → «Завантажити довідник майданчика».

Поки довідника немає, товари лягають у службову категорію «Товари - etsy» — вимкнену й без участі у вивантаженнях. Це не втрата даних: розкладіть товари по своєму дереву, далі вони туди й оновлюватимуться. Детальніше: службові категорії.

Що робить повторний прогін з вашими правками

Товар упізнається за назвою: Elbuz шукає картку, заведену під тим самим заголовком лістинга. Знайшов — перезаписує, не знайшов — заводить нову. Артикул і номер лістинга в пошуку не беруть участі.

• Перезаписуються: назва, опис, ціна, кількість, статус наявності, позначка «увімкнено», теги, артикул.
• Порожнє з Etsy не затирає ваше: стара (закреслена) ціна й штрихкод, яких Etsy не передає, лишаються; лістинг без тегів чи артикула ваших не зітре.
• Не чіпає у вже заведеної картки: фотографії й характеристику «Material» (їх отримують лише нові картки), місце в дереві категорій.
• Вимкнений руками товар увімкнеться — з Etsy приходять лише активні лістинги, тому пишеться «увімкнено».

Закріпити картку можна в секції «Захист під час імпорту»: «Не оновлювати» — прогін пропускає її цілком, «Фіксована ціна» — тримає лише ціни. Детальніше: як закріпити своє значення.

Лістинг зник з Etsy

Elbuz просить у Etsy тільки активні лістинги. Знятий з продажу, прихований, чернетка чи розпроданий лістинг у прогін не потрапляє, і з карткою не відбувається нічого:

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

Такі картки прибирайте руками у вікні «Товари» за колонкою «Джерело: назва». Загальне правило — товар зник із джерела.

У зворотному напрямку Elbuz ніколи не знімає лістинг з продажу. Прибрали товар з вивантаження — лістинг на Etsy перестає оновлюватися й лишається активним з останніми цифрами. Зняти його можна тільки в кабінеті Etsy.

Як приймати замовлення Etsy

Замовлення на Etsy — це чеки (receipts); позиції приходять разом із ними. Перший запуск переносить історію, наступні просять чеки, створені після дати останнього завантаження — її Elbuz запам'ятовує в шаблоні сам.

Чек лягає документом «Замовлення покупця», непроведеним: залишок і резерв не зміняться, поки документ не проведуть. У документ потрапляють:

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

Статуси

Статус документа береться зі зіставлення кнопками «Статуси замовлення», «Статуси оплати» й «Статуси доставки» в секції «Повʼязані налаштування». Ключ — стан чека, як його називає Etsy; якщо стану немає, Elbuz підставляє shipped для відправленого або paid для оплаченого. В оплаті кодів два: paid і unpaid. Незіставлений стан дає перший статус довідника.

1

Налаштування розкладу

2

Статуси замовлення

1. Налаштування розкладу — розклад прогонів завантаження.
2. Статуси замовлення — зіставлення стану чека зі статусом документа.

Що оновлює повторне завантаження

Дубля не буде — документ шукається за номером чека. Але переписується не все:

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

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

Як оновлювати ціни й залишки на Etsy

Зворотний напрямок — окремий шаблон вивантаження типу «Etsy». Для кожного пов'язаного лістинга Elbuz читає його блок наявності, підставляє вашу ціну й залишок і записує назад. Etsy приймає блок цілком, тому Elbuz щоразу збирає його заново, зберігаючи артикул і властивості варіанта.

• Оновлюються лише товари зі зв'язком із лістингом — його ставить завантаження каталогу або публікація. Товар без зв'язку прогін мовчки пропускає, якщо не ввімкнено «Публікувати нові товари».
• У відбір товар потрапляє з позначкою «Вивантажувати у файл (на сайт)» і в увімкненій категорії, що бере участь у вивантаженнях. Службова «Товари - etsy» вимкнена — розкладіть товари по своїх категоріях.
• Варіанти отримують однакові ціну й кількість — окремої ціни на варіант вивантаження не передає.

Журнал на кожні 50 оновлених лістингів пише «Etsy: оновлено лістингів: N», у кінці — «Etsy: ціни та залишки оновлено, лістингів: N (помилок: M)». Відмову по лістингу Etsy пояснює своїм текстом — окремим червоним рядком із назвою товару. Як налаштувати шаблон вивантаження — шаблони вивантаження.

Як опублікувати нові лістинги

З галочкою «Публікувати нові товари» у шаблоні вивантаження Elbuz заводить на Etsy лістинги з ваших карток: створює чернетку, завантажує фотографію за посиланням, проставляє ціну, залишок і артикул і лише потім переводить лістинг в активний стан.

Обов'язкові поля Etsy, яких у картці немає, Elbuz заповнює фіксовано: «зроблено мною», «виготовляється на замовлення», фізичний товар. Для вінтажу чи матеріалів для творчості поправте це в лістингу після публікації. Заголовок обрізається до 140 символів, опис — до 5000 і без HTML, кількість — не менше одиниці.

Підсумок у журналі: «Etsy: створено нових лістингів: N (помилок: M). Публікація лістингу на Etsy платна ($0.20)» — плату бере майданчик за кожен лістинг.

Оновлення за розкладом

Etsy працює опитуванням: Elbuz звертається до майданчика за розкладом, який задають кнопкою «Налаштування розкладу» в секції «Повʼязані налаштування». Для рівного потоку замовлень вистачає кількох запусків на день, каталог достатньо оновлювати раз на добу. Прогін іде на сервері, браузер для нього не потрібен.

Межі одного прогону

Вимкнути шаблон

Пілюля «Активний» / «Вимкнений» у шапці картки знімає шаблон з розкладу — і тільки. Кнопка «Завантажити» працює й на вимкненому шаблоні.

1

Стан шаблону

2

Завантажити

1. Пілюля «Вимкнений» / «Активний» — знімає шаблон з розкладу.
2. «Завантажити» — ручний запуск, працює й на вимкненому шаблоні.

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

Сценарії

Перенести каталог з Etsy в Elbuz і тримати його свіжим

Що ввімкнути. Шаблон завантаження «Etsy», галочка «Товари», для фото — «Фото», розклад кнопкою «Налаштування розкладу».

Що вийде. Кожен активний лістинг стає карткою; знайомий заголовок оновлює наявну. Картки зниклих лістингів лишаються як були (лістинг зник).

Приймати замовлення з Etsy, не рухаючи склад до перевірки

Що ввімкнути. Галочка «Замовлення» і зіставлення станів чека кнопками «Статуси замовлення», «Статуси оплати» й «Статуси доставки».

Що вийде. Кожен новий чек лягає непроведеним документом «Замовлення покупця» з позиціями, покупцем і адресою. Залишок зрушить, коли ви проведете документ.

Вести залишок в Elbuz і передавати ціни й залишки на Etsy

Що ввімкнути. Шаблон вивантаження «Etsy» з галочкою «Товари»; у товарів і їхніх категорій — «Вивантажувати у файл (на сайт)». Зв'язок із лістингом дає попереднє завантаження каталогу.

Що вийде. Кожен пов'язаний лістинг отримує вашу ціну й залишок, журнал підсумовує кількість оновлених і помилок.

Доробляти картки в Elbuz так, щоб завантаження їх не затерло

Що ввімкнути. У картці товару, секція «Захист під час імпорту», — «Не оновлювати» або «Фіксована ціна».

Що вийде. З «Не оновлювати» прогін картку пропускає, зокрема й залишок; з «Фіксована ціна» — оновлює все, крім цін. Від перейменування лістинга в кабінеті Etsy захист не рятує (повторний прогін).

Що робити, коли Etsy не завантажується або не оновлюється

Якщо прогін обірвався

Каталог лягає пачками по 500: усе, що встигло лягти, лишається оновленим, недочитану пачку візьме наступний прогін. Повтор безпечний — дублів не буде. Останній рядок журналу однаково «Завантаження даних завершено!», тож про успіх судять за рядками вище. Загальна механіка — якщо прогін обірвався.

Кнопка «Стоп» дає дочитати й записати поточну сторінку Etsy, а наступну вже не запитує — і в каталозі, і в замовленнях.

Якщо прогін зробив не те

Помилкове завантаження. Заведені підключенням картки знаходяться у «Товарах» за колонками «Джерело: назва» й «Джерело: код» (для Etsy — etsy), перезаписані — за сьогоднішньою «Датою оновлення». Що можна повернути — якщо завантажили не те.

Помилкове вивантаження. Блок наявності записується цілком, і попередніх цін і кількостей Elbuz не зберігає — кнопки «повернути як було» немає. Виправте ціни в Elbuz, звузьте відбір шаблона до потрібних товарів і запустіть вивантаження ще раз. Які лістинги зачеплено, видно в журналі й «Історії запусків».

Часті запитання

Що вписувати в поле Shop ID?

Можна нічого: Elbuz визначить ідентифікатор магазину сам. Заповніть поле, якщо на акаунті кілька магазинів або журнал повідомив, що Shop ID визначити не вдалося.

Чому в замовленнях з Etsy немає телефону?

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

Я зняв лістинг з продажу на Etsy — товар у Elbuz вимкнеться?

Ні. Знятий лістинг у прогін не потрапляє, і картка лишається увімкненою з останньою ціною й залишком. Вимкніть або видаліть її руками у вікні «Товари» (лістинг зник).

Я вимкнув товар в Elbuz, а він знову увімкнувся. Чому?

З Etsy приходять лише активні лістинги, тому прогін пише в картку «увімкнено». Щоб картка лишалася вимкненою, поставте в ній «Не оновлювати» (повторний прогін).

Чи може Elbuz зняти лістинг з продажу на Etsy?

Ні. Товар, прибраний з вивантаження, просто перестає оновлюватися на Etsy й лишається активним. Знімають лістинг у кабінеті Etsy.

Чи приїде скасування або повернення по вже завантаженому замовленню?

Ні. Чеки беруться від дати останнього завантаження, тож зміни в старих чеках не забираються, а документів повернення підключення не заводить — оформіть їх руками (повторне завантаження).

Суміжні теми

• Якщо треба зрозуміти, як шаблон завантаження поводиться з будь-яким джерелом, — Завантаження даних у каталог.
• Якщо підключаєте ще й інші майданчики через API — Імпорт каталогу через API.
• Якщо замовлення з Etsy треба звести з іншими каналами — Завантаження замовлень із майданчиків.
• Якщо налаштовуєте відбір і розклад вивантаження на Etsy — Шаблони вивантаження.