Tento návod platí pro e-shopy na platformě Shoptet. Obecné ovládání aplikace najdete v základní příručce.
Jak propojení funguje
ShopSync komunikuje se Shoptetem přes oficiální Shoptet API. Existují dvě cesty, jak získat přístup:
- Doplněk ShopSync nainstalovaný ve vašem Shoptetu – po instalaci od nás dostanete dvojici údajů (ID e-shopu a tajný klíč), přístup si pak aplikace obnovuje automaticky. Součástí je i automatické hlášení nových objednávek (webhooky) – nic nemusíte nastavovat.
- Privátní API token – jednodušší varianta bez doplňku; token vygenerovaný ve vaší administraci Shoptetu se zadá přímo do aplikace.
Kterou cestu použijeme, se dohodneme při nasazení.
Důležité – FTP je u Shoptetu potřeba také. Obrázky produktů, hromadné
aktualizace zboží a případná PDF faktur se nahrávají na FTP úložiště vašeho
Shoptetu (soubory jsou pak dostupné na adrese https://vas-eshop/user/documents/…).
Bez FTP nefunguje přenos obrázků.
Databáze e-shopu ani PHP můstek se u Shoptetu nepoužívají.
Co si připravte předem
- Přístup k API – podle zvolené varianty:
- instalace doplňku Shopsync by Pohoda ze sekce Doplňky v administraci Shoptetu; ID e-shopu a tajný klíč vydává náš server shopsync.cz a najdete je tamtéž v detailu doplňku, nebo
- privátní API token – vygenerujete ho také v administraci Shoptetu v sekci Doplňky.
- FTP přístup k Shoptetu – v administraci Shoptetu v sekci Nastavení → Hosting si založte FTP účet a předejte nám server, jméno a heslo.
- URL e-shopu – přesná adresa včetně
https://, bez lomítka na konci. - Zkontrolovaný seznam způsobů platby a dopravy v Shoptetu – budou se párovat na účetní systém.
Pole na záložce „Připojení k eshopu"
| Pole | Co vyplnit u Shoptetu |
|---|---|
| Databáze (server, název, uživatel, heslo, prefix) | Nepoužívá se – nechte prázdné. |
| FTP – typ spojení | Podle údajů Shoptetu (obvykle FTP/FTPS). |
| FTP – server / uživatel / heslo | FTP účet vašeho Shoptetu. |
| FTP – Složka obrázků | Složka v rámci user/documents/, kam se nahrávají obrázky. |
| FTP – Hlavní složka | Kořenová složka pro pomocné soubory. |
| URL eshopu | https://www.vas-eshop.cz (bez lomítka na konci) – z ní se skládají veřejné adresy nahraných souborů; při chybě selže přenos obrázků. |
| PHP můstek | Nepoužívá se – nechte vypnuté. |
| Bezpečnostní klíč | Vygenerujte tlačítkem – používá se v názvech pomocných souborů. |
Záložka Nastavení
Sekce 8. Ostatní – přístup k API (podle varianty):
| Položka | Význam |
|---|---|
shoptet_id |
ID e-shopu v systému doplňku ShopSync (varianta s doplňkem). |
shoptet_secret |
Tajný klíč doplňku. |
shoptet_private_api_token |
Privátní API token (varianta bez doplňku). Pokud je vyplněn, má přednost. |
debug |
Podrobnost logu – jen při řešení problémů. |
Přístupové údaje musí být vyplněné před spuštěním inicializace nastavení – jinak se seznam plateb a doprav nenačte.
Sekce 2. Způsoby platby / 3. Způsoby dopravy – po inicializaci se načtou všechny platby a dopravy z vašeho Shoptetu; doplňte k nim označení v účetním systému. U výdejních míst (Zásilkovna, GLS ParcelShop…) může vzniknout hodně řádků – stačí vyplnit společné řádky, párování funguje i na část názvu.
Sekce 4. Produkty (nejužitečnější volby):
| Položka | Význam |
|---|---|
vychozi_kategorie |
Kategorie, do které se zařadí produkt bez kategorie z ERP. |
prenos_akcnich_cen |
1 = přenášet i akční ceny. |
zakladat_znacky |
1 = automaticky zakládat chybějící značky (výrobce). |
shoptet_neplatce_dph |
Režim pro neplátce DPH. |
Sekce 1. Objednávky – ceny_s_dani, zaokrouhlování, OSS – společné volby
popsané v návodu vašeho účetního systému.
Časté problémy
- Nenačetly se platby/dopravy – nebyl vyplněn API přístup před inicializací; vyplňte a spusťte inicializaci znovu.
- Obrázky se nepřenášejí – zkontrolujte FTP údaje a přesnou URL e-shopu.
- Přenos je pomalý – Shoptet API omezuje počet požadavků; delší běh u velkých katalogů je normální.