Как да свържеш Skroutz (Гърция) с eficio: фийд, Smart Cart и наличност на всеки 30 минути

Защо да свържеш Skroutz с eficio

Skroutz работи с eficio по три начина: чрез продуктов фийд, който Skroutz чете, чрез webhook, по който изпраща поръчките и връщанията от Smart Cart, и, ако искаш, чрез продуктовото API, през което eficio изпраща наличността и цената.

• каталогът стига до Skroutz във формата, който изискват: цена в евро с ДДС, заглавия и описания на езика на съдържанието (обикновено гръцки);
• поръчките от Smart Cart и връщанията идват сами в eficio;
• наличността и цената се изпращат на всеки 30 минути с токена за Products API;
• данните за проследяване и фактурата се изпращат от eficio към Skroutz.

Какво да подготвиш предварително

• достъп до акаунта в Skroutz Merchants;
• по избор API токена за Smart Cart от Smart Cart → Settings (API ключ от тип Bearer, по един активен за магазин) – за получаване и управление на поръчките чрез API;
• по избор токена за Products API от Products → Feed Updates, различен от този за поръчките – за наличност и цена в реално време;
• продукти с име, изображение и цена на езика на съдържанието, избран за канала.

Стъпка 1 — Настрой канала в eficio

В менюто вляво отваряш „Integrări“ (Интеграции), в раздела „Canale de vânzare“ (Канали за продажба) избираш „Marketplace“ (Маркетплейс) и натискаш „Conectează“ (Свържи) на картата на Skroutz. Попълваш:

• „Token API Smart Cart (comenzi) — opțional“ (API токен за Smart Cart за поръчки – по избор): празно поле означава само фийд и webhook;
• „Cota TVA în feed (Grecia)“ (Ставка на ДДС във фийда – Гърция): по подразбиране е 24%; Skroutz изисква цената с ДДС, в евро, а eficio превръща цената от каталога (без ДДС, в леи) по курса на Националната банка на Румъния (BNR), добавя надценката и след това тази ставка;
• „Token Products API (stoc/preț) — opțional“ (Токен за Products API за наличност и цена – по избор): нужен е само за изпращането на наличността и цената;
• „Nume conexiune“ (Име на връзката), „Limbă conținut“ (Език на съдържанието; по подразбиране гръцки) и „Status pentru comandă nouă“ (Статус за нова поръчка);
• „Adaos preț“ (Надценка), „Zile de livrare“ (Дни за доставка), ставките на ДДС, „Seria de facturare“ (Серия на фактурите), „Gestiunea la facturare“ (Склад при фактуриране) и „Tip pachet implicit“ (Тип пакет по подразбиране).

Натискаш „Conectează & testează“ (Свържи и тествай). Връзката става активна, а ако си въвел токена за Smart Cart, eficio го тества и записва резултата във „Vezi loguri“ (Виж логовете).

Стъпка 2 — Въведи адресите в Skroutz Merchants

С бутона „URL-uri“ (URL адреси) на картата виждаш двата адреса на връзката. В Skroutz Merchants:

• „URL Feed“ въвеждаш в Products → XML Feed;
• „URL Comenzi“ въвеждаш в Smart Cart → Settings – както в „Webhook за поръчки“, така и в „Webhook за връщания“ – и активираш и двата.

Адресите са тайни: всеки, който ги има, може да чете фийда или да изпраща поръчки.

Какво се случва, след като запазиш

• статусът на наличност във фийда следва полето „Zile de livrare“: 0 означава „In Stock“, до 3 дни – „Available from 1 to 3 days“, до 6 дни – „Available from 4 to 6 days“, а над това – „Available up to 12 days“;
• продуктите без име, изображение или цена не влизат във фийда; всеки продукт може да има до 15 изображения;
• при всяка нова или променена поръчка Skroutz уведомява eficio, а eficio прочита цялата поръчка чрез API и я импортира; връщанията от Smart Cart отиват в модула „Връщания“;
• с токена за Products API наличността и цената се изпращат към Skroutz на всеки 30 минути; за незабавно изпращане избираш „Retrimite ofertele“ (Изпрати офертите отново) от менюто на картата.

В детайлите на поръчка от Skroutz имаш бутоните „Acceptă pe Skroutz“ (Приеми в Skroutz; избираш мястото и интервала за вземане, а Skroutz генерира куриерския ваучер), „Respinge pe Skroutz“ (Откажи в Skroutz), „Gata de expediere (Skroutz)“ (Готова за изпращане – Skroutz) за поръчките със Skroutz Last Mile и „Trimite factura la Skroutz“ (Изпрати фактурата към Skroutz). Фактурата, издадена чрез свързаната програма за фактуриране, така или иначе се изпраща автоматично, а при издаването на товарителницата се изпращат и данните за проследяване.

Чести проблеми

• „Lipsește tokenul Products API“ (Липсва токенът за Products API) при „Retrimite ofertele“: без него Skroutz взема цената и наличността само от фийда, когато го чете; добави токена в настройките на връзката;
• в логовете пише, че токенът за Smart Cart е невалиден или няма достъп до поръчките: генерирай отново токена в Smart Cart → Settings и го въведи във връзката;
• данните за проследяване не стигат до Skroutz: Skroutz приема само ACS, DHL, Geniki Taxydromiki, DPD и GLS; от куриерите в eficio могат да се изпращат само товарителниците на DPD и GLS;
• „Nu am putut citi comanda de la Skroutz. Verifică tokenul Smart Cart al conexiunii“ (Не успяхме да прочетем поръчката от Skroutz. Провери токена за Smart Cart на връзката) при приемане: токенът за поръчки липсва или вече не е валиден.

Какво следва

• свържи програмата за фактуриране (SmartBill или Oblio), за да се изпраща фактурата сама към Skroutz;
• подготви заглавията и описанията на гръцки с преводите в eficio;
• автоматизирай повтарящите се стъпки с автоматичните потоци.

Често задавани въпроси