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:
- Adresu API – má tvar
https://csapi.<vaše-doména>(u testovacích e-shopůhttps://csapi-xxx.creativeshop.sk). - Uživatelské jméno a heslo pro API.
- 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.
- 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.