Как да свържеш Shopify магазин с eficio: приложение, Client ID и Secret

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

Магазинът ти остава в Shopify, а поръчките от него влизат в eficio заедно с тези от маркетплейсите. Връзката използва приложение, създадено от теб в Shopify; не инсталираш никакъв плъгин.

• новите, променените, редактираните и анулираните поръчки в Shopify идват в eficio чрез webhooks;
• продуктите, създадени или променени в Shopify, стигат до eficio по същия начин, а синхронизация на всеки час улавя пропуснатото;
• анулирането в eficio анулира поръчката в Shopify, а поръчката, изпратена с товарителница, се маркира като изпълнена в Shopify, с номера на товарителницата като номер за проследяване;
• поръчките, платени с наложен платеж и открити в описа на плащанията, импортиран в eficio, се маркират като платени в Shopify.

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

• администраторски достъп до Shopify, за да създадеш приложение в dev dashboard;
• постоянния домейн .myshopify.com на магазина (не собствения ти домейн);
• приложението, създадено поне с обхватите (scopes) read_orders и read_products.

Стъпка 1 — Създай приложението в Shopify

1. В Shopify отваряш dev dashboard → Apps и създаваш приложение.
2. Даваш му поне обхватите read_orders и read_products.
3. В приложението, в Настройки → Идентификационни данни, намираш Client ID и Secret. Правилният Secret започва с shpss_.

Стъпка 2 — Отвори страницата на Shopify в eficio

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

Стъпка 3 — Попълни данните на приложението

• „Domeniu magazin“ (Домейн на магазина): във вида magazin.myshopify.com;
• „ID client (API key)“ (ID на клиента): от идентификационните данни → Client ID;
• „Secret (Client secret)“ (Таен ключ): от същата страница, стойността, която започва с shpss_, а не токенът, който започва с atkn_;
• „Limbă conținut“ (Език на съдържанието): езикът, на който се публикуват продуктовите страници в този магазин; продуктите без превод на този език се блокират при публикуване.

Натискаш „Conectează & testează“ (Свържи и тествай). eficio сам получава токена за достъп и проверява магазина.

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

При успех получаваш известието „Magazin conectat“ (Магазинът е свързан) с името на магазина и броя на активираните webhooks. Магазинът се появява в списъка със състояние „Conectat“ (Свързан), валутата и версията на API.

• eficio регистрира в Shopify webhooks за създадени и променени продукти и за създадени, обновени, редактирани и анулирани поръчки;
• поръчките влизат в модула „Поръчки“, когато Shopify ги изпрати;
• веднъж на час eficio прочита отново каталога в Shopify, за да не липсват при фактурирането или в наличностите продукти, пропуснати от някой webhook;
• когато запазиш продукт, публикуван в Shopify, полетата му се изпращат към Shopify; продажбите и автоматичните синхронизации не презаписват сайта;
• от „Produse → Magazine online → Produse“ (Продукти → Онлайн магазини → Продукти) можеш да изтеглиш продуктите от магазина с „Importă produse din magazin“ (Импортирай продукти от магазина); намерените по SKU се свързват, а останалите влизат като чернова.

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

• „Secret greșit“ (Грешен Secret): в полето Secret си въвел токена, който започва с atkn_; използвай стойността shpss_ от идентификационните данни;
• „Domeniul trebuie să fie de forma «magazin.myshopify.com»“ (Домейнът трябва да е във вида magazin.myshopify.com): въвел си собствения си домейн вместо този с .myshopify.com;
• „Nu am putut obține un token de acces. Verifică ID client + Secret“ (Не успяхме да получим токен за достъп. Провери Client ID + Secret): една от двете стойности е грешна или принадлежи на друго приложение;
• „Token invalid sau fără permisiuni (verifică scopurile read_orders, read_products)“ (Невалиден токен или липсват права; провери обхватите read_orders, read_products): приложението няма нужните обхвати;
• състоянието преминава в „Eroare“ (Грешка): натискаш „Testează“ (Тествай) на реда на магазина; за нови данни използваш „Reconectează / schimbă token“ (Свържи отново / смени токена) от менюто на реда.

Какво следва

• импортирай описите на наложените платежи, за да стигат плащанията и до Shopify; за GLS виж ръководството за GLS;
• задай куриера за поръчките от Shopify в правилата за маршрутизиране;
• автоматизирай фактурата и товарителницата с автоматичните потоци;
• виж как се движи наличността между каналите в ръководството за синхронизацията на наличностите.

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