Tento návod platí pro ABRA Flexi (dříve FlexiBee) – cloudovou i lokální instalaci. Obecné ovládání aplikace najdete v základní příručce.
Jak propojení funguje
ShopSync komunikuje s ABRA Flexi přes její REST API (webové rozhraní) – po síti, jménem a heslem uživatele Flexi. Nic se nespouští, nikam se nekopírují soubory; stačí, aby byl server Flexi dostupný z počítače, kde běží ShopSync.
- Čtení: ceník, skladové karty a zásoby.
- Zápis: přijaté objednávky (včetně založení zákazníka v adresáři), vydané faktury, změny stavů objednávek, případně zakládání ceníkových karet s obrázky.
Doklady se ve Flexi označují externím identifikátorem, takže se nikdy nezaloží
dvakrát. Produkty se párují podle kódu v ceníku (Kód ve Flexi = kód
zboží v e-shopu; porovnává se bez ohledu na velikost písmen).
Co si připravte předem
- Adresu serveru Flexi:
- cloud ABRA:
https://vasefirma.flexibee.eu - vlastní server:
https://server:5434(výchozí port REST API) REST API vyžaduje licenci pro REST API – viz ceník ABRA Flexi; ověřte, že ji vaše instalace má.
- cloud ABRA:
- Identifikátor firmy (účetní jednotky) – krátký text, který je v adrese
webového rozhraní Flexi za
/c/(např.https://server:5434/c/mojefirma_s_r_o_). V aplikaci se zadává do pole účetní jednotky (Jméno souboru agendy). - Uživatele Flexi pro ShopSync (jméno + heslo) s přístupem do agend, se kterými se bude pracovat – tj. podle rozsahu přenosu typicky ceník, sklady, adresář, přijaté objednávky a vydané faktury (čtení i zápis). Doporučujeme samostatný účet, ne osobní účet účetní.
- Číselníky ve Flexi, které přenos používá (musí existovat, jinak zápis
selže): typ dokladu objednávky (výchozí
OBP), typ dokladu faktury (výchozíFAKTURA), sklad, skupina zboží (výchozíZBOŽÍ), formy úhrady a dopravy, měny a státy. - Kódy zboží ve Flexi vyplněné a shodné s kódy v e-shopu.
Rychlá kontrola správnosti údajů: v prohlížeči otevřete
https://<server>/c/<firma>/cenik.xml?limit=1 – po zadání jména a hesla se má
zobrazit XML s jednou položkou ceníku.
Pole na záložce „Připojení k IS"
Pozor – u ABRA Flexi mají dvě pole jiný význam, než říká jejich popisek:
| Pole | Co vyplnit u ABRA Flexi |
|---|---|
| IČ | IČO vaší firmy. |
| Domácí měna | CZK (resp. EUR). |
| DPH sazby | Podle účetnictví, např. 21 / 12. |
| Typ | ABRA FLEXIBEE. |
| Cesta k .exe | Adresa serveru Flexi včetně https:// a portu, bez lomítka na konci – např. https://server:5434. (Žádný program se nespouští.) |
| Jméno souboru agendy | Identifikátor firmy ve Flexi (část adresy za /c/). |
| Uživatelské jméno / Heslo | Uživatel Flexi pro ShopSync. |
| Agenda / Rok | Nepoužívá se – nechte prázdné. |
| Cesta k databázi | Nepoužívá se – nechte prázdné. |
| Odkladiště souborů | Pracovní složka ShopSyncu. |
| Obrázky | Složka s obrázky produktů (jen pokud se obrázky posílají do Flexi). |
Záložka Nastavení – nejdůležitější položky
Sekce 1. Objednávky
| Položka | Výchozí | Význam |
|---|---|---|
ceny_s_dani |
1 |
1 = ceny z e-shopu jsou včetně DPH. |
objednavka_typ_dokladu |
OBP |
Kód typu dokladu přijaté objednávky ve Flexi. |
faktura_typ_dokladu |
FAKTURA |
Kód typu dokladu vydané faktury. |
vychozi_sklad |
– | Kód skladu, ze kterého se hledá skladová karta k položkám. |
nulove_polozky |
1 |
Přenášet i položky s nulovou cenou. |
oss, oss_hlavni_zeme, registrace_dph_v_eu |
0, CZ, – |
Režim OSS pro prodej do EU – po dohodě s účetní. |
zaokrouhleni_domaci / zaokrouhleni_cizi |
jednotky / setiny |
Zaokrouhlení dokladů v domácí / cizí měně. |
Sekce 2. Způsoby platby / 3. Způsoby dopravy – vlevo název z e-shopu, vpravo kód formy úhrady / dopravy ve Flexi.
Sekce 7. Importy (zakládání zboží z e-shopu do Flexi):
| Položka | Výchozí | Význam |
|---|---|---|
sklad_k_importu |
SKLAD |
Kód skladu, na kterém se nové kartě založí skladová karta. |
skupina_zbozi |
ZBOŽÍ |
Kód skupiny zboží pro nové karty. |
typ_zasoby |
zbozi |
Typ zásoby nové karty (zbozi, sluzba, …). |
importovat_ceny_s_dph |
0 |
Ceny při zakládání karty chápat včetně DPH. |
aktualizovat_ceny |
0 |
1 = přepisovat ceny i u existujících karet (opatrně). |
Sekce 4. Produkty – kompletni_prenos_denne a příbuzné volby (úplný přenos
jednou denně) nastavuje technik.
Ostatní zobrazené položky (středisko, předkontace, řady…) se u standardního napojení Flexi neuplatní – chování řídí typy dokladů. Pokud je potřebujete, domluvte se s námi na úpravě.
Časté problémy
- Chyba přihlášení – zkontrolujte adresu serveru, identifikátor firmy a jméno/heslo (test v prohlížeči viz výše).
- Zápis dokladu selže – nejčastěji neexistuje kód typu dokladu, skladu nebo formy úhrady/dopravy ve Flexi (musí přesně souhlasit).
- Nepřenáší se dostupnost zboží – karta nemá ve Flexi skladovou kartu.