Как да свържете Skroutz с easySales: пълно ръководство за интеграция

Защо да свържете Skroutz с easySales

Skroutz е най-големият маркетплейс и платформа за сравнение на цени в Гърция, а да продавате в него означава да държите обяви, поръчки и фактури в ред. easySales обединява Skroutz в едно табло заедно с останалите ви канали за продажба, така че управлявате един каталог и един поток от поръчки, вместо да превключвате между екрани.

След като бъде свързан, поръчките ви от Skroutz влизат в easySales готови за фактуриране, обработка с потоци за автоматизация и изпращане. Каталогът ви върви в обратната посока: easySales публикува продуктите ви в Skroutz и поддържа техните цени и наличности актуални, така че поддържате един каталог, вместо да редактирате всяка обява в Skroutz на ръка.

Как работи конекторът за Skroutz

Skroutz е хибридна интеграция — отчасти фийд, отчасти жив API — затова помага да разберете разделението, преди да започнете.

• Каталогът ви излиза през продуктов фийд. easySales изгражда XML продуктов фийд с вашите обяви — имена, описания, марки, EAN кодове, категории, изображения, цени, ДДС, наличности, тегло и характеристики — и го обновява по периодичен график. Skroutz чете този фийд, за да създава и обновява обявите ви.
• Поръчките влизат през webhook. Skroutz изпраща всяка нова и обновена поръчка направо в easySales, където тя се появява в Поръчки и клиенти → Поръчки готова за фактуриране и потоци.
• Действията по поръчките се връщат чрез вашия Merchant API токен. Токенът, който въвеждате във връзката, позволява на easySales да действа върху поръчките ви в Skroutz — да ги приема или отхвърля, да изпраща данни за проследяване и да качва фактури обратно в Skroutz.

Тъй като каталожната част работи чрез фийд, няколко неща се държат различно от чист API маркетплейс. Промените, които правите в easySales, не са мигновени в Skroutz — те пътуват със следващото обновяване на фийда. И потокът на места е еднопосочен: easySales не чете обратно статуса на офертите ви от Skroutz, а съществуващи обяви в Skroutz не се импортират в easySales.

Предварителни условия — какво да подготвите преди да започнете

Няколко неща трябва да са налице преди първата ви синхронизация.

Стъпка 1 — Свържете Skroutz в easySales

В easySales, от страничното меню отидете на Интеграции → Маркетплейси, намерете картата Skroutz и натиснете Свържете върху нея. Формата с настройки за Skroutz се отваря с два раздела: Основни настройки (основната конфигурация) и Допълнителни настройки (поведение при синхронизация). Първо ще работите в Основни настройки.

В раздела Основни настройки попълнете как easySales да изгражда фийда ви, да оценява офертите ви и да обработва поръчките ви:

• Име на връзката — етикет, който избирате за тази връзка. Видим само в easySales.
• Добавък към цената — незадължителен процент, добавян върху цената на продукта ви, когато нова оферта се публикува в Skroutz. Прилага се към новосъздадени оферти.
• Такса за доставка по подразбиране — ставката на ДДС, приложена към реда за доставка в поръчките ви от Skroutz.
• ДДС ставка по подразбиране — процентът ДДС по подразбиране, приложен към офертите и поръчките ви. Задайте го на 0, ако не сте регистрирани по ДДС.
• API токен — вашият Merchant API токен за Skroutz. Оставете го празен засега; Skroutz го издава, след като валидира продуктовия ви фийд, и ще се върнете, за да го поставите (вижте Стъпка 4).
• Серия за фактуриране — серията за фактуриране по подразбиране, присвоена на импортираните поръчки от Skroutz, съответстваща на серията, която използвате в софтуера си за фактуриране.
• тип опаковка — дали пратките ви по подразбиране да са Плик или Колет.
• Атрибути за размер и Атрибути за цвят — продуктовите характеристики, които Skroutz чете като размер и цвят на вариация. Свързването им е това, което позволява на Skroutz да групира вариантите ви в едно семейство (вижте Стъпка 3).
• Характеристики, изключени от офертите — всякакви характеристики, които не искате да бъдат записани във вашия фийд за Skroutz.
• Показвай характеристиките в описанието на продукта и Продуктова документация на местен език — контролират как характеристиките и продуктовият текст се показват в Skroutz.
• Дни за доставка — времето за обработка, публикувано с офертите ви.
• Финализиране на поръчката при генериране на товарителница и опциите за доставка — разгледани в секцията за поръчки по-долу.

Натиснете Save, за да създадете връзката.

Стъпка 2 — Публикувайте продуктите си и изпратете фийдовете си на Skroutz

Свързването на акаунта само по себе си не поставя каталога ви в Skroutz — вие избирате кои продукти да публикувате.

От страничното меню отидете на Онлайн магазини → Продукти, изберете продуктите, които искате да продавате в Skroutz, и от лентата с групови действия използвайте действието Добавете оферта(и) на, като изберете вашата връзка към Skroutz. easySales създава оферта за Skroutz за всеки продукт, свързана с него в каталога ви. От този момент офертата пътува в продуктовия ви фийд, а нейната наличност и цена остават обвързани с изходния продукт. Само оферти, които са активни, синхронизирани и свързани с каталожен продукт, се записват във фийда. Публикуваните ви оферти се появяват в Маркетплейси → Оферти, в раздела Skroutz, където можете да ги преглеждате и редактирате.

Когато запазите връзката, easySales генерира два фийда, които карат интеграцията да работи. И двата се появяват на картата ви за Skroutz в Интеграции → Маркетплейси:

• URL за връзка — XML продуктовият фийд, който Skroutz чете, за да изгражда и обновява обявите ви.
• Orders URL — адресът, на който Skroutz изпраща поръчките ви.

easySales не регистрира тези URL адреси автоматично — вие ги копирате от картата си за Skroutz и ги подавате на Skroutz, като всеки от тях отива на различно място във вашия Skroutz Merchants акаунт:

• URL за връзка — изпратете го в Services → XML file: валидирайте фийда си, след което използвайте Send XML link. Екипът на Skroutz прави допълнителни проверки и завършва прегледа.
• Orders URL — в Skroutz отворете Services → Skroutz Marketplace и превъртете надолу до Integration with the online store → Order webhooks: поставете URL адреса в полето Webhook URL и отметнете Enable, така че Skroutz да започне да изпраща поръчките ви в easySales.

Пускането в реален режим е оперативна стъпка, която може да отнеме известно време, вместо да се случи мигновено. Свързан фийд без поръчки все още е нормално, докато Skroutz все още обработва фийда ви.

Групиране на вариации в семейство

Ако продавате продукт в няколко размера или цвята, Skroutz може да покаже вариантите като една обява-семейство вместо като отделни продукти. easySales изгражда това групиране изцяло от вашите собствени продуктови данни — продуктовото семейство и неговите характеристики — плюс едно малко свързване, което задавате във връзката. Ето как се съчетават частите:

• Семейството идва от структурата на продукта ви. Варианти, които са едно цяло, трябва да споделят родителски продукт в easySales (същото семейство от вариации). easySales пренася това автоматично, когато продуктите вече са групирани в изходния ви магазин; в противен случай задавате вариацията на всяка оферта ръчно или чрез Excel импорт. Варианти, които не споделят родител, се изпращат към Skroutz като самостоятелни обяви, а обявата-семейство взема името си от родителския продукт.
• Стойностите за размер и цвят се четат от характеристиките на продукта. Размерът на всеки вариант — и неговият цвят — идва директно от собствените характеристики на продукта, например характеристика „
  ” със стойност „
  ” или характеристика „
  ” със стойност „
  ”. Не ги въвеждате отново за Skroutz; те се извличат от продукта.
• Вие свързвате коя характеристика е размерът и коя е цветът. В раздела Основни настройки на връзката използвайте Атрибути за размер, за да кажете на easySales коя характеристика съдържа размера, и Атрибути за цвят за цвета. Това свързване е това, което превръща вашите продуктови характеристики в измеренията за размер и цвят на Skroutz.

Две условия решават дали семейство наистина се формира:

• Атрибут за размер трябва да е свързан. Семейството се изгражда около измерението за размер — ако не сте свързали Атрибут за размер или продукт няма стойност за него, този продукт излиза като самостоятелна обява, вместо да се присъедини към семейство. Свързването само на Атрибут за цвят не създава семейство; то само добавя измерението за цвят към варианти, вече групирани по размер.
• Стойността за размер или цвят не трябва да е в заглавието на офертата. Вариантите в едно семейство споделят едно и също име на продукта, а размерът живее в собственото си поле, затова не пишете „
  ” или „
  ” в заглавието — иначе Skroutz не може да ги групира чисто.

Свързването на атрибута само казва на easySales коя характеристика да чете — все още трябва да попълните стойността на тази характеристика за всеки продукт. easySales никога не измисля размер, така че продукт, чиято характеристика за размер е празна, се изпраща без размер и няма да се присъедини към семейство. Това е най-честата причина размер да липсва във фийд за Skroutz. Ако на няколко продукта липсва стойността, попълнете я масово с Mass edit от списъка ви с оферти за Skroutz. За продукт, който наистина няма размер, въведете буквалната стойност One Size (на английски) в тази характеристика — Skroutz очаква точно този текст, а easySales го изпраща както е. След като стойностите са налице, easySales генерира Вариациите по размер автоматично за продукти, които вече са групирани като варианти — без допълнителна настройка.

Стъпка 3 — Фина настройка на синхронизацията

Разделът Допълнителни настройки контролира как easySales синхронизира със Skroutz, след като връзката е активна.

• Изпращай MPN — изберете какво easySales да изпраща на Skroutz като MPN на продукта (номер на частта на производителя). Има четири опции: да не изпраща нищо, SKU на офертата, Родителски SKU (SKU на родителския продукт — удобно за групирани варианти, които трябва да споделят един MPN) или стойността на конкретна характеристика. Ако изберете Характеристика, се появява второ поле, където избирате коя характеристика да се изпраща.
• Автоматично активирай офертите, когато продуктите имат наличност — активира офертите автоматично отново, щом продукт е отново на склад над нула.

Стъпка 4 — Добавете API токена си, след като Skroutz валидира фийда

Това е частта, която обърква продавачите, затова си струва да я подчертаем ясно. Skroutz не ви дава Merchant API токен предварително — те го издават след като са валидирали продуктовия фийд, който сте им изпратили. Така последователността е:

1. Свържете Skroutz в easySales и публикувайте офертите си (Стъпки 1–2).
2. Изпратете вашия URL за връзка и Orders URL на Skroutz.
3. След като Skroutz одобри фийда ви, генерирайте вашия Merchant API токен в Skroutz Merchants акаунта си под Products → API, използвайки Generate a new API token. Skroutz пази само един активен токен наведнъж, така че генерирането на нов заменя всеки предишен ключ.
4. Обратно в easySales, отворете връзката си към Skroutz, поставете токена в полето API токен в Основни настройки и запазете.

Докато токенът не е налице, поръчки все още могат да пристигат, но easySales не може да ги приема или да изпраща проследяване и фактури обратно към Skroutz — всички тези действия се удостоверяват с токена. Ако виждате поръчки да влизат, но да не се приемат, празният API токен е първото нещо, което да проверите.

Как работят поръчките, доставката и фактурите в Skroutz

Поръчките са частта от Skroutz, която работи самостоятелно. easySales не изтегля поръчки от Skroutz — Skroutz изпраща всяка поръчка на вашия Orders URL, така че Skroutz контролира доставката. easySales импортира всяка една, съпоставяйки продуктите по EAN и оценявайки всичко в евро. След като API токенът ви е налице, easySales приема поръчката обратно в Skroutz автоматично и резервира прозорец за вземане от куриер. Настройката Забави прозорец за вземане решава кой слот се резервира: включена по подразбиране, тя взема най-късния наличен прозорец; изключете я, за да резервира най-ранния.

Тъй като доставката е базирана на изпращане, ако някоя поръчка все пак не достигне easySales, можете да я изпратите отново сами от Skroutz: отворете тази поръчка в Skroutz Merchants акаунта си и в нейния панел Webhook натиснете New Request, за да я изпратите отново.

Доставката работи по един от два начина и вие избирате за всяка връзка:

• Skroutz предоставя етикета. Включете Прикачи awb от маркетплейса и easySales прикача товарителницата за доставка, която Skroutz издава за поръчката, така че не генерирате отделна AWB.
• Вие генерирате AWB. Генерирайте етикета за доставка в easySales както обикновено, а easySales изпраща данните за проследяване обратно на Skroutz. Skroutz разпознава фиксиран набор от куриери за това — DPD, DHL, GLS, ACS, Speedex, ELTA и Geniki Taxydromiki — така че използвайте един от тях, за да се регистрира проследяването в Skroutz.

Фактурите също се връщат: когато генерирате фактура за поръчка от Skroutz, easySales качва PDF файла в Skroutz автоматично. Финализиране на поръчката при генериране на товарителница е включено по подразбиране, така че easySales също маркира поръчката като финализирана, щом етикетът ѝ за доставка е прикачен — изключете го, ако предпочитате да управлявате този статус сами.

Свързани сте — какво следва

С пристигащи поръчки следващата стъпка е автоматизацията: настройте потоци под Обработка → Потоци, за да генерирате фактури и да обработвате поръчките, докато влизат. Наблюдавайте офертите си под Маркетплейси → Оферти, в раздела Skroutz, където всяка, която се провали при валидация, е маркирана — и се свържете с поддръжката, ако нещо изглежда нередно.