E-shop Shopify

Níže je popis výměny dat mezi Eurofakturou a e-shopem vytvořeným v platformě Shopify.

Podporujeme i nejnovější verzi Shopify 2021-07.

Nastavení v Shopify

Před samotným přenosem dat je nutné aktivovat "private app", kde získáte API klíč a API heslo. Jak na to je vysvětleno v odkazu:

https://shopify.dev/docs/apps/auth/admin-app-access-tokens#generate-private-app-credentials

Aktivace výměny dat

Když je aktivována Shopify "private app", je potřeba připravit následující data pro správnou výměnu dat:

1. URL adresa e-shopu, resp. administrativního rozhraní serveru. Adresa URL nesmí obsahovat heslo ani klíč API a musí obsahovat protokol HTTPS (jak je ukázáno na příkladu níže)
2. Heslo (Admin API access token)
3. API klíč (API key)

V rámci Eurofaktury vyberete rovněž sklad a nákladové středisko, na které se budou vázat veškeré objednávky importované z e-shopu.

Nastavení e-shopu zadáme podle níže uvedeného příkladu. Vlevo jsou data z uživatelského rozhraní Shopify, která zadáváme do Eurofaktury, jak je znázorněno vpravo:

	Obrázek 1: Nastavení e-shop synchronizace pro Shopify

Přístupová práva

Pro přístup přes API musí být v Shopify povolena následující práva:

• READ

• Customer details and customer groups
• Orders, transactions and fulfillments
• Products, variants and collections

• READ/WRITE

• Inventory

Import objednávek přes webhooky

Po zapnutí synchronizace dat s e-shopem se objednávky přenášejí do Eurofaktury přibližně každou hodinu. Pokud chcete, aby se objednávky přenášely do Eurofaktury ihned po jejich zadání v e-shopu, můžete zapnout synchronizaci přes webhooky. V takovém případě se poté periodická synchronizace vypne a provede se 1x denně (v noci), aby bylo možné stáhnout chybějící objednávky, které nebyly staženy např. z důsledky výpadku spojení s e-shopem, nebo chybně zaslaného webhooku, apod.

Při použití webhooků se synchronizují rovněž stavy objednávek. Pokud se tedy změní stav objednávky v e-shopu, změní se v krátkém okamžiku stav obj. i v Eurofaktuře.

1. Vygenerujte jedinečný identifikátor „Web Hook URL“ v |Nastavení |Nastavení společnosti |E-shop synchronizace v sekci WebHook u Vašeho propojeného e-shopu.

	Obrázek 2: Generování "Web Hook URL"

2. Přidejte webhook do e-shopu v menu "Apps -> Notifications -> Webhook" (Obr.7) a použijte následující nastavení:

• Pro vytvořené objednávky
• Událost: Vytvoření objednávky
• Formát: JSON
• Adresa URL dotazu: Vygenerovaná adresa URL webhooku z nastavení e-shopu v Eurofaktuře (Obr. 3)
• Verze rozhraní Webhook API: 2021-07

• Pro aktualizované objednávky
• Událost: Aktualizace objednávky
• Formát: JSON
• Adresa URL dotazu: Vygenerovaná adresa URL webhooku z nastavení e-shopu v Eurofaktuře (Obr. 3)
• Verze rozhraní Webhook API: 2021-07

	Obrázek 3: Vygenerovaná „Web Hooku URL“ kliknutím na tlačítko „Generovat“.

Poté se přihlaste na webovou platformu Shopify, kde v ovládacím panelu vybereme nabídku Apps.

	Obrázek 4: Chcete-li vytvořit webhooky, klikněte na nabídku Apps

V nastavení aplikace klikněte na nabídku Notifications:

	Obrázek 5: Vyberte nastavení oznámení (Notifications)

Poté vyberte možnost Webhooks, kde kliknutím na tlačítko vytvoříme nový webhookCreate webhook:

	Obrázek 6: Generování nového webhooku pro vytváření a aktualizaci objednávek

	Obrázek 7: Nastavení webhooku pro vytvořenou objednávku v Shopify

	Obrázek 8: Nastavení pro webhook pro aktualizovanou objednávku v Shopify

	Obrázek 9: Příklad správně nakonfigurovaných webhooků v Shopify

V Shopify se synchronizace pomocí webhooků automaticky vypne, pokud přenos pomocí webhooků selže několikrát za sebou. Pokud máte zapnuté webhooky v Eurofaktuře a objednávky se nepřenášejí správně, zkontrolujte, zda jsou webhooky v Shopify stále aktivní.

Další možnosti synchronizace dostupné pro platformu Shopify Pro uživatele, kteří mají aktivovanou synchronizaci pro webovou platformu Shopify, jsou kromě standardní synchronizace k dispozici také: Okamžitá synchronizace stavu zásob z Eurofaktury do Shopify e-shopu Import produktů z e-shopu. Tato možnost, pokud jí vyberete umožňuje importovat veškeré produkty z vašeho e-shopu do Eurofaktury. Můžete při importu určit, zda chcete, aby se údaje o existujícím produktu v Eurofaktuře přepsaly těmi z e-shopu (zaškrtněte tuto volbu) nebo ne (nezaškrtávejte) Export produktů do e-shopu Mapování skupin/kategorií produktů          Obrázek 10: Synchronizace skladových zásob (ruční spuštění)

Odkazy na tuto stránku

• Online tržiště
• Eshop - synchronizace