Návody

Tento návod platí pro ekonomický systém Oberon. Obecné ovládání aplikace najdete v základní příručce.

Jak propojení funguje

ShopSync komunikuje s Oberonem dvěma kanály:

Čtení (produkty, zásoby, ceny…): přímo z databáze Oberonu pomocí ODBC ovladače. Podporované databáze: MS Access (typické u menších instalací) a MySQL / MariaDB (časté u síťových a výkonnějších instalací).
Zápis (objednávky…): přes WebServices G2 – proto je povinné nastavit Oberon Automation Center (viz níže).

Přenáší se zejména:

import objednávek z e-shopu do Oberonu,
export skladových zásob a cen z Oberonu do e-shopu,
mapování způsobů dopravy a plateb mezi e-shopem a Oberonem.

Co si připravte předem

ODBC ovladač pro zvolený databázový systém nainstalovaný na počítači, kde běží ShopSync (ověříte v nástroji ODBC Data Sources (32 bit) – měl by být vidět např. Microsoft Access Driver nebo MySQL ODBC 8.0 ANSI Driver).
Nastavené WebServices G2 přes Oberon Automation Center (povinné pro zápis objednávek – postup viz níže) a přihlašovací údaje k WebServices.
Připojovací řetězec (connection string) k databázi Oberonu:
- MS Access: Driver={Microsoft Access Driver (*.mdb, *.accdb)};Dbq=C:\OBERON\DATA\Firma.mdb;
- MySQL: Driver={MySQL ODBC 8.0 ANSI Driver};Server=localhost;Database=nazevDb;User=uzivatel;Password=heslo;Option=3;
Účet použitý v připojovacím řetězci musí mít k databázi práva čtení i zápisu.
Složky pro obrázky a přílohy produktů (pokud se přenášejí) – účet, pod kterým běží ShopSync, k nim musí mít přístup.

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

Pole	Co vyplnit u Oberonu
IČ	IČO vaší firmy.
Domácí měna	`CZK` (resp. `EUR`).
DPH sazby	Podle účetnictví, např. `21` / `12`.
Cesta k databázi	Připojovací řetězec ODBC (viz výše).
Odkladiště souborů	Pracovní složka ShopSyncu.
Obrázky / Soubory (přílohy)	Složky s obrázky a přílohami produktů.

Záložka Nastavení – nejdůležitější položky

Sekce 1. Objednávky

Položka	Výchozí	Význam
`ceny_s_dph`	–	Musí odpovídat tomu, zda e-shop posílá ceny včetně DPH.
`zaokrouhleni_domaci` / `zaokrouhleni_cizi`	`4`	Počet desetinných míst pro zaokrouhlení částek v domácí / cizí měně.
`zaokrouhleni_polozek`	`4`	Zaokrouhlení cen na úrovni položek objednávky.
`oss`, `oss_hlavni_zeme`	`0`, `CZ`	Režim OSS pro prodej do EU – po dohodě s účetní.

Sekce 2. Způsoby platby / 3. Způsoby dopravy – po nastavení e-shopu klikněte na Inicializovat nastavení; načtou se platby a dopravy z e-shopu a ke každé doplňte odpovídající označení v Oberonu. Po přidání nové platby nebo dopravy v e-shopu spusťte inicializaci znovu a doplňte nový řádek.

Doporučení: používejte v názvech plateb a doprav srozumitelné a konzistentní řetězce (např. „kartou online", „bankovní převod", „dobírka") a po každé větší změně v e-shopu překontrolujte mapování.

WebServices (Oberon Automation Center) – povinné

Zápis dat do Oberonu (objednávky) probíhá přes WebServices G2, které zajišťuje nástroj Oberon Automation Center (OAC) – bez běžící úlohy WebServices proto import do Oberonu nefunguje. Postup nastavení:

Spusťte OAC z Oberonu: menu OBERON → OBERON Automation Center (klient).
V OAC přidejte firmu (pokud tam není), přidejte a spusťte službu a připojte se k serveru OAC.
Vytvořte automatickou úlohu typu WebServices API – OBERON G2 (menu Servis → Automatické úlohy) a ověřte, že běží.
Přístupové údaje k WebServices se pak v aplikaci ShopSync zadávají na záložce Nastavení v sekci 8. Ostatní (položky se přidávají ručně):

Položka	Co vyplnit
`oberon_api_url`	Adresa WebServices G2 – server a port automatické úlohy OAC (např. `http://localhost:8081`).
`oberon_api_user`	Přihlašovací jméno uživatele Oberonu pro WebServices.
`oberon_api_pass`	Heslo tohoto uživatele.

Pozor: port automatické úlohy a port serveru OAC se musí lišit.

Časté problémy

Nelze se připojit k databázi – zkontrolujte instalaci ODBC ovladače (32bit vs. 64bit) a přesné znění připojovacího řetězce.
Objednávka má špatnou platbu/dopravu – zkontrolujte mapování v sekcích 2 a 3; páruje se podle textových řetězců.
Zásoby se nepřenášejí – účet v připojovacím řetězci nemá práva na čtení příslušných tabulek.