Tento návod platí pro e-shopy na platformě PrestaShop (všechny běžné verze, 1.6 až aktuální 9.x). Obecné ovládání aplikace najdete v základní příručce.

Jak propojení funguje

ShopSync pracuje přímo s databází PrestaShopu (MySQL). Připojit se lze dvěma způsoby:

1. Přímé připojení k MySQL – jen pokud váš hosting povoluje připojení k databázi zvenčí (u českých sdílených hostingů výjimečně).
2. PHP můstek (běžný způsob) – tlačítkem Nahrát můstek na server se na váš web přes FTP nahraje malý pomocný skript. ShopSync s ním pak komunikuje šifrovaně přes běžnou webovou adresu a databáze zůstává zvenčí nedostupná.

Obrázky produktů se nahrávají přes FTP přímo do složky obrázků PrestaShopu – ShopSync sám vygeneruje i všechny náhledy (miniatury), takže v administraci nemusíte nic přegenerovávat.

Při prvním spuštění provede ShopSync jednorázovou instalaci pomocných polí do databáze e-shopu – před prvním spuštěním proto doporučujeme zálohu databáze (zálohu obvykle zajistí hosting).

Co si připravte předem

1. FTP přístup k webu – server, uživatel, heslo, typ (FTP/FTPS/SFTP). Účet musí mít právo zápisu do složky e-shopu.
2. Údaje k databázi – najdete je v souboru app/config/parameters.php (PrestaShop 1.7/8: hodnoty database_host, database_name, database_user, database_password, database_prefix), případně v administraci hostingu. Prefix tabulek je typicky ps_.
3. URL e-shopu včetně https://, bez lomítka na konci.
4. Z administrace PrestaShopu tato čísla (ID):
   • ID jazyka: Mezinárodní → Lokalizace → Jazyky (čeština bývá 1 nebo 2),
   • ID obchodu: bez multistore vždy 1,
   • ID daňových pravidel pro každou sazbu DPH: Mezinárodní → Daně → Daňová pravidla (sloupec ID),
   • ID skupin zákazníků (pro velkoobchodní ceníky): Zákazníci → Skupiny.
5. Funkční PHP 7.3 nebo novější s rozšířeními mysqli a OpenSSL na hostingu (standard).

Důležité: heslo k databázi slouží zároveň jako šifrovací klíč můstku. Pokud heslo k databázi změníte, je nutné můstek nahrát znovu – dejte nám vědět.

Pole na záložce „Připojení k eshopu"

Sekce Základní nastavení

V sekci Párování cen: vlevo cenová hladina v účetním systému, vpravo ID skupiny zákazníků v PrestaShopu.

Záložka Nastavení

Po inicializaci nastavení se automaticky načtou:

• 2. Způsoby platby – řádek pro každou platební metodu, kterou už někdo v e-shopu použil (technické názvy modulů, např. ps_wirepayment = převodem, ps_cashondelivery = dobírka). Doplňte označení v účetním systému. Nová platební metoda se v seznamu objeví až po první objednávce – pak spusťte inicializaci znovu.
• 3. Způsoby dopravy – řádek pro každého aktivního dopravce. Duplicitní názvy jsou normální (PrestaShop při úpravě dopravce vytváří nové záznamy) – vyplňte je stejně.
• 1. Objednávky → vlastni_prefix_faktury – prázdné = převezme se prefix faktur z PrestaShopu; vyplňte jen pro odlišnou řadu v účetnictví.

Ručně lze doplnit (nastavuje obvykle technik): ceny_s_dani (1 = ceny včetně DPH), nulove_polozky (1 = přenášet i dopravu zdarma), oss a oss_hlavni_zeme (prodej do EU), prenos_akcnich_cen (1 = přenášet akční ceny z ERP), importovat_nizsi_ceniky, typ_slevy (způsob zápisu velkoobchodních cen), debug (podrobný log – doporučujeme zapnout při prvním párování plateb a doprav).

Časté problémy

• „Můstek nekomunikuje…" – špatná URL e-shopu, můstek není nahraný, nebo nesedí Hlavní složka na FTP vs. URL. Po změně hesla k DB nahrajte můstek znovu.
• Špatné sazby DPH u produktů – nesedí ID daňových pravidel se sazbami v účetním systému.
• Velkoobchodní ceny se nepropisují – zkontrolujte párování cenových skupin (ID skupin zákazníků).