Nastavení pro e-shop CREATIVE sites

Aktualizováno 15.08.2026

Tento návod platí pro e-shopy na platformě CREATIVE sites. Obecné ovládání aplikace najdete v základní příručce.

Jak propojení funguje

ShopSync komunikuje s CREATIVE sites výhradně přes jejich API (jméno a heslo + povolená IP adresa). Databáze, FTP ani PHP můstek se nepoužívají.

Přenáší se: produkty (ceny, zásoby, parametry), objednávky a doklady. Párování produktů probíhá přes kód zboží (SKU) – kódy v účetním systému a v e-shopu si musí odpovídat.

Co si připravte předem

Přístup k API nelze vytvořit svépomocí v administraci – vydává ho přímo CREATIVE sites (obchodní oddělení / podpora). Vyžádejte si:

  1. Adresu API – má tvar https://csapi.<vaše-doména> (u testovacích e-shopů https://csapi-xxx.creativeshop.sk).
  2. Uživatelské jméno a heslo pro API.
  3. Povolení IP adresy počítače/serveru, kde běží ShopSync – bez toho API odmítne i správné heslo. Při změně IP (nový server, změna poskytovatele internetu) je nutné požádat o úpravu.
  4. Dostatečný tarif – některé funkce API (např. skladové zásoby po prodejnách, sady) jsou dostupné jen ve vyšších tarifech; probereme při nasazení.

Dále si připravte seznam způsobů platby a dopravy v e-shopu (budou se párovat na účetní systém).

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

Pole Co vyplnit u CREATIVE sites
Databáze Nepoužívá se – nechte prázdné.
FTP Nepoužívá se – nechte prázdné.
URL eshopu Adresa e-shopu – použije se v textech dokladů ([url]).
PHP můstek / Bezpečnostní klíč Nepoužívá se – nechte vypnuté.

V sekci Základní nastavení je důležitá jen Domácí měna (např. CZK) a Základní sazba DPH.

Ceny se z e-shopu čtou z cenové hladiny č. 5 (maloobchod) – to je výchozí cena produktu v CREATIVE sites.

Záložka Nastavení

Sekce 8. Ostatní – přístup k API (vytvoří se při inicializaci, hodnoty doplňte):

Položka Co vyplnit
api_url Adresa API bez lomítka na konci, např. https://csapi.vase-domena.cz.
api_uzivatel Uživatelské jméno od CREATIVE sites.
api_heslo Heslo od CREATIVE sites.
debug Podrobnost logu – jen při řešení problémů.

Postup: nejdřív spusťte inicializaci nastavení (vytvoří tyto položky), vyplňte je, uložte – a spusťte inicializaci znovu. Teprve pak se načtou seznamy plateb a doprav z e-shopu.

Sekce 2. Způsoby platby / 3. Způsoby dopravy – ke každé platbě/dopravě z e-shopu doplňte označení v účetním systému (stačí část názvu).

Sekce 1. Objednávky – jak se objednávky zapisují do účetního systému. Nejdůležitější položky (podrobně viz návod vašeho účetního systému):

Položka Výchozí Význam
ceny_s_dani 1 1 = e-shop posílá ceny včetně DPH.
rada_objednavek Číselná řada objednávek v účetním systému.
vychozi_sklad Sklad, ze kterého se odepisuje.
stredisko, zakazka, predkontace, typ_dph, bank_ucet Účetní zařazení dokladů – zadává účetní.
oss, oss_hlavni_zeme 0, CZ Režim OSS pro prodej do EU.
objednavka_text Objednávka z [url] Text dokladu; [url] = adresa e-shopu.
typ_dokladu OP Typ dokladu (objednávka přijatá).

Časté problémy

  • API vrací „přístup odepřen" i se správným heslem – vaše IP adresa není na straně CREATIVE sites povolená (typicky po změně připojení/serveru).
  • Chybí funkce / chyba „Upgrade Required" – funkce není ve vašem tarifu CREATIVE sites.
  • Nová doprava/platba se nepáruje – po přidání v e-shopu spusťte inicializaci nastavení znovu a doplňte nový řádek.