Tento článek shrnuje obecný postup řešení problémů s přenosy mezi e-shopem a účetním systémem a společné chybové kódy. Postupy pro konkrétní účetní systémy najdete v samostatných článcích:
Obecný postup
- Spusťte přenos ručně a sledujte záložku Výstup – většina chyb se vypíše přímo zde.
- Projděte historii přenosů a chybová hlášení. Poznamenejte si přesný text chyby, případně HTTP kód.
- Ověřte, zda problém nesouvisí s nedávnou změnou – přechod na nový účetní rok (viz články „Nový účetní rok" pro váš systém), změna hesel, migrace e-shopu, aktualizace účetního systému.
- Po každé provedené změně ověřte propojení na jedné testovací objednávce a jednom testovacím produktu. Tím přesně ověříte funkčnost změn.
Pokud si nebudete vědět rady, ozvěte se na podpora@shopsync.cz.
Chybové kódy HTTP a FTP
| Chyba | Příčina | Řešení |
|---|---|---|
| 500 | Chyba na straně e-shopu – nejčastěji nekompatibilita modulu/můstku s PHP 8+, nebo chyba databáze e-shopu. | Aktualizujte aplikaci (můstek/modul) na nejnovější verzi, nebo nastavte kompatibilní verzi PHP. Případně kontaktujte podporu e-shopu. |
| 404 | Nesprávná URL integrace, špatné FTP údaje, nebo můstek není nahrán ve správné složce na FTP. | Zkontrolujte URL adresu, FTP připojení a správné umístění můstku. |
| 403 nebo 0 | Server e-shopu blokuje IP adresu serveru, na kterém běží ShopSync, nebo jsou chybné přihlašovací údaje. | Ověřte dostupnost URL v prohlížeči, zkontrolujte API klíče a nechte IP adresu serveru se ShopSync povolit (whitelist) na firewallu či hostingu e-shopu. |
Pokud se problém nedaří vyřešit:
- Přegenerujte bezpečnostní/API klíče a uložte je na obou stranách (e-shop i ShopSync).
- Znovu nahrajte můstek/integrační skripty na FTP, ideálně nejnovější verzi, a ověřte oprávnění k souborům a složkám.
- Zajistěte whitelist IP adresy serveru, na kterém ShopSync běží.
Reset přenosu změn
Reset přenosu změn slouží k vynucení kompletní synchronizace všech dat mezi e-shopem a účetním softwarem, jako by šlo o první přenos.
Postup:
- Spusťte aplikaci ShopSync.
- Na záložce Ovládání klikněte v pravém dolním rohu na tlačítko Reset přenosu změn.
- Počkejte na dokončení operace – po provedení resetu se na záložce Výstup zobrazí potvrzení o úspěšném resetu.
Důležité upozornění:
- Po resetu se při příštím spuštění přenosu načítají všechna data znovu – včetně produktů, obrázků, faktur, zákazníků a adresářů.
- Prvotní synchronizace může trvat i několik hodin, v závislosti na množství dat v e-shopu a účetním systému.
- Nedoporučujeme provádět reset bez doporučení technika nebo podpory ShopSync.
Kdy reset použít:
- kompletní migrace dat,
- rozsáhlé změny v e-shopu či účetním systému,
- řešení problémů se synchronizací za asistence technické podpory ShopSync.