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:
- 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)
- Heslo (Admin API access token)
- 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:
- Customer details and customer groups
- Orders, transactions and fulfillments
- Products, variants and collections
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 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í) |
|
|