Tento návod platí pro ABRA Gen. Obecné ovládání aplikace najdete v základní příručce.
Jak propojení funguje
ShopSync komunikuje s ABRA Gen přes její REST API (webové rozhraní) – po síti, jménem a heslem uživatele ABRA Gen. Žádný program se nespouští; stačí, aby byl API server ABRA Gen dostupný z počítače, kde běží ShopSync (funguje i s vlastním/self-signed certifikátem).
- Čtení: skladové karty, ceníky, zásoby, kategorie (menu zboží), číselníky.
- Zápis: přijaté objednávky (včetně založení firmy/provozovny v adresáři), vydané faktury.
Ve výchozím nastavení se na e-shop přenášejí jen karty označené příznakem
pro e-shop (uživatelský atribut, často pojmenovaný x_eshop).
Co si připravte předem
- Spuštěný API server ABRA Gen a jeho adresu (např.
http://server:8555). Zapnutí API typicky provádí přímo ABRA a je k němu potřeba licence – kontaktujte svého ABRA konzultanta. - Alias (název) databáze – druhá část adresy API, např.
Data. Žádná typická hodnota neexistuje: po otevření adresy API serveru v prohlížeči se zobrazí seznam dostupných agend – vyberete alias té, kterou chcete napojit, a ten se vloží do aplikace. - Uživatele ABRA Gen pro ShopSync (jméno + heslo) s právy číst i zapisovat agendy: skladové karty, ceníky, přijaté objednávky, faktury vydané, adresář firem, a číst číselníky (sklady, střediska, typy plateb, bankovní účty, sazby DPH, měny, číselné řady). Doporučujeme samostatný účet „shopsync".
- Označení zboží pro e-shop – v ABRA Gen musí existovat uživatelský
atribut na skladové kartě, kterým označíte zboží určené pro e-shop.
Často se používá
x_eshop, ale není to standard – uživatelské (x) pole může být jakékoliv, případně nemusí být žádné (pak se přenášejí všechny karty). - Rozhodnutí, do jaké číselné řady mají padat e-shopové objednávky, který sklad, ceník a bankovní účet se má používat. Interní identifikátory těchto číselníků dohledá náš technik (máme na to pomocný přehled načítaný přímo z API) – od vás potřebujeme jen názvy.
- Sazby DPH v ABRA Gen správně nastavené (včetně sazeb zemí EU, pokud prodáváte do zahraničí v režimu OSS).
Pole na záložce „Připojení k IS"
Pozor – u ABRA Gen mají dvě pole jiný význam, než říká jejich popisek:
| Pole | Co vyplnit u ABRA Gen |
|---|---|
| IČ | IČO vaší firmy (jen informativně). |
| Domácí měna | CZK (resp. EUR). |
| DPH sazby | Nechte podle účetnictví – sazby se ale reálně dohledávají přímo v ABRA Gen. |
| Typ | ABRA GEN. |
| Cesta k databázi | Adresa API serveru ABRA Gen, např. http://server:8555. |
| Jméno souboru agendy | Alias databáze, např. Data. |
| Uživatelské jméno / Heslo | Uživatel ABRA Gen pro ShopSync. |
| Cesta k .exe | Nepoužívá se – nechte prázdné. |
| Agenda / Rok | Nepoužívá se – nechte prázdné. |
| Odkladiště souborů | Pracovní složka ShopSyncu. |
Záložka Nastavení – nejdůležitější položky
U ABRA Gen se většina „účetních" voleb (sklad, ceník, středisko, číselné řady, bankovní účet) nastavuje interními identifikátory při nasazení – řeší náš technik. V tabulce vlastních nastavení jsou pro vás podstatné hlavně:
| Položka | Sekce | Výchozí | Význam |
|---|---|---|---|
oss |
1. Objednávky | 0 |
Režim OSS pro prodej koncovým zákazníkům do EU (1 = zapnuto). Po dohodě s účetní. |
oss_hlavni_zeme |
1. Objednávky | CZ |
Domovská země pro DPH (SK pro slovenské firmy). |
kompletni_prenos_vzdy |
4. Produkty | 0 |
1 = vždy přenášet všechny produkty (jen pro ladění, pomalé). |
kompletni_prenos_denne (+ _od, _do) |
4. Produkty | 0 |
Jednou denně úplný přenos v nočním okně – doporučeno; nastavuje technik. |
debug |
8. Ostatní | – | Podrobnost logu, jen pro řešení problémů. |
Sekce 2. Způsoby platby / 3. Způsoby dopravy – vlevo název z e-shopu, vpravo odpovídající typ platby / dopravy v ABRA Gen.
V tabulce uvidíte i další položky společné šablony (předkontace, zaokrouhlení, sekce 7. Importy…), které se u ABRA Gen standardně neuplatní. Můžete je ignorovat.
Časté problémy
- Nelze se připojit – zkontrolujte adresu a port API serveru a průchodnost firewallu z počítače se ShopSyncem.
- Produkty se nenačítají – karty nemají nastavený příznak pro e-shop, nebo uživatel nemá práva na čtení skladových karet.
- Objednávka se nezaloží – obvykle chybí či nesouhlasí některý číselník (řada dokladů, typ platby); přesná hláška je ve výstupu přenosu.