AbraGen

AbraGen

Integrace s AbraGen umožňuje export dokumentů z Alice prostřednictvím REST API AbraGen. Alice posílá doklad jako batch operaci -- v jediném volání se vytvoří faktura, případně dohledá objednávka, vygeneruje žádost o platební příkaz a nahraje příloha.

Jak to funguje?

Po označení dokumentu k exportu (stav K exportu) Alice volá REST API AbraGen. Před zápisem se v AbraGen dohledá nebo vytvoří partner (podle IČO/DIČ), namapují se reference na číselníky (zdrojová řada, období, …) a doklad se zapíše batch požadavkem. Volitelně se vygeneruje platební příkaz a/nebo napojí na vydanou objednávku. Po úspěšném zápisu se v Alici doklad přesune do stavu Exportovaný, při chybě do stavu Chyba -- viz Diagnostika. Přehled všech stavů viz Stavy dokumentů.

Schéma datového toku

graph LR
    A[Alice] -->|doklad| B[AbraGen]
    B -.->|potvrzení| A

Podporované verze a předpoklady

Oblast	Požadavek
Aplikace	AbraGen s REST API
Typ účetnictví	Pouze podvojné účetnictví -- daňová evidence není přes API podporována
Autentizace	HTTP Basic Authentication (uživatel + heslo)
Alias	Alias databáze AbraGen (výchozí data) -- viz Externí ID účetní jednotky
Síť	API server AbraGen musí být dosažitelný z cloudu Alice (URL + port)
Můstek	Není potřeba -- integrace probíhá přímo přes API

Daňová evidence není podporována

AbraGen API v současné době neumožňuje export dokladů do daňové evidence -- integrace funguje pouze u účetních jednotek vedených v podvojném účetnictví.

Podporované typy dokumentů

Alice podporuje export následujících typů dokumentů do AbraGen:

Typ dokumentu v Alice	Podpora	Agenda v AbraGen
Přijatá faktura	Podporováno	Přijaté faktury (receivedinvoices)
Vydaná faktura	Podporováno	Vydané faktury (issuedinvoices)
Přijatá zálohová faktura	Podporováno	Přijaté zálohové faktury (receiveddepositinvoices)
Přijatý dobropis	Podporováno	Přijaté dobropisy (receivedcreditnotes)
Vydaný dobropis	Bez special-case logiky	Vydané faktury -- nezakládá se zvlášť jako dobropis
Účtenky, Slovenské faktury	Nepodporováno	--

Postup napojení AbraGen

Kroky, které jsou potřeba k úspěšnému napojení na účetní systém AbraGen:

• Připravte si číselníky

  ---

  Pro správnou funkci je nutné mít vytvořené číselníky pro zdrojovou řadu a období.

• Připravte si účetní jednotky

  ---

  Je nutné mít vytvořenou účetní jednotku pro každý alias a vyplnit jí Externí ID.

• Vytvořte napojení na AbraGen

  ---

  Přidejte novou definici exportu typu AbraGen.

Vytvoření integrace

V nastavení na kartě Integrace přidejte AbraGen.

Podrobný postup, jak vytvořit integraci pro účetní systémy, naleznete v části Integrace

• Nová definice importu

  ---

  

• Popis polí

  ---

  Název pole	Popis pole
  Název	Vlastní název exportu
  Typ	AbraGen
  Účetní jednotka1	Účetní jednotka, do které budou dokumenty importovány
  Adresa	Adresa serveru s AbraGen API včetně protokolu
  Port	Číslo portu, na kterém je služba dostupná
  Alias	Alias připojení
  Uživatelské jméno	Uživatelské jméno do AbraGen
  Uživatelské heslo	Uživatelské heslo do AbraGen

Připojení k AbraGen

Připojení k AbraGen využívá HTTP Basic Authentication. Výchozí alias připojení je data a výchozí uživatelské jméno je Supervisor. Tyto hodnoty upravte dle konfigurace ve Vaší instalaci AbraGen.

Externí ID účetní jednotky

Každá účetní jednotka v AbraGen má vlastní databázi, na kterou odkazuje její alias. Aby Alice exportovala doklady do správné databáze, vyplňte alias do pole Externí ID u příslušné účetní jednotky v Alice.

Kde zjistím alias databáze?

Alias je nastaven v konfiguraci API serveru AbraGen. Výchozí alias je data; pokud máte v AbraGen více účetních jednotek, každá má vlastní alias. Přesnou hodnotu Vám sdělí správce Vaší instalace AbraGen.

Více účetních jednotek na jednom napojení

Pokud jedno napojení na AbraGen přiřadíte více účetním jednotkám, musí mít každá z nich vyplněné Externí ID s aliasem své databáze.

Synchronizace číselníků

Alice umožňuje jednosměrně (AbraGen -> Alice) synchronizovat hodnoty číselníků.

Následující tabulka shrnuje číselníky, které lze synchronizovat z AbraGen:

Číselník	Popis	Úroveň	Povinný	Poznámka
Zdrojová řada	Řada, do které se doklad zařadí	Doklad	Ano
Období	Účetní období	Doklad	Ano
Typ výdaje	Typ výdaje pro přijaté faktury	Doklad i položka	Ne	Pouze pro přijaté faktury
Typ příjmu	Typ příjmu pro vydané faktury	Doklad i položka	Ne	Pouze pro vydané faktury
Středisko	Organizační středisko	Položka	Ne
Obchodní případ	Přiřazení k obchodnímu případu	Položka	Ne

Povinné číselníky

Číselníky Zdrojová řada a Období jsou povinné. Bez jejich nastavení nebude export do AbraGen fungovat.

Mapování polí dokumentu

Při exportu dokumentu do AbraGen se přenášejí hodnoty polí z Alice do odpovídajících polí v AbraGen.

Identifikace dokumentu

Pole v Alice	Pole v AbraGen	Poznámka
Číslo faktury	externalnumber
Variabilní symbol	varsymbol
Konstantní symbol	constsymbol_id	Dynamicky se dohledá v AbraGen podle kódu
Specifický symbol	specsymbol	Pouze u přijatých faktur
ID dokumentu v Alici	docuuid	Pouze u přijatých faktur (omezení délky)

Datumy

Pole v Alice	Pole v AbraGen	Poznámka
Datum vystavení	docdate, accdate	accdate = účetní datum
Datum splatnosti	duedate
Datum uplatnění odpočtu DPH	vatdate	Datum DPH; pokud není vyplněno, použije se datum vystavení
Datum zdanitelného plnění	vatadmitdate	Pokud není vyplněno, použije se datum vystavení

Povinná pole (vlastní pole / číselníky)

Pole	Pole v AbraGen	Popis
Zdrojová řada	Docqueue	Řada, do které se doklad v AbraGen zařadí (synchronizovaná)
Období	Period	Účetní období v AbraGen (synchronizované)

Volitelná pole (vlastní pole / číselníky)

Pole	Pole v AbraGen	Poznámka
Typ výdaje / Typ příjmu	ExpenseType / IncomeType	Typ výdaje (přijaté faktury) nebo typ příjmu (vydané faktury). Lze nastavit i na úrovni položek faktury.
Středisko	Division	Nastavuje se na úrovni položek faktury
Obchodní případ	BusTransaction	Nastavuje se na úrovni položek faktury
Účetní řada	Accdocqueue	Dynamicky lookup v AbraGen podle kódu (nesynchronizuje se -- musíte v Alici nastavit ručně, klíč = kód v AbraGen)
Předkontace	Accpresetdefinition	Dynamicky lookup v AbraGen podle kódu (nesynchronizuje se)

Podporované sazby DPH

Při exportu do AbraGen se používají následující sazby DPH:

Sazba	Popis
0 %	Osvobozeno od DPH
12 %	Snížená sazba
21 %	Základní sazba

Práce s partnery

Při exportu dokladu do AbraGen Alice automaticky vyhledá nebo vytvoří obchodního partnera (dodavatele/odběratele) v adresáři AbraGen. Postup je následující:

1. Vyhledání partnera podle IČO v adresáři AbraGen
2. Pokud není nalezen, vyhledání podle DIČ
3. Pokud partner neexistuje, automaticky se vytvoří nový záznam v adresáři včetně adresy a bankovních účtů
4. Pokud IČO ani DIČ nejsou k dispozici, použije se výchozí firma

Automatické vytvoření partnera

Při vytváření nového partnera se do AbraGen přenesou: název firmy, IČO, DIČ, adresa, PSČ, město a bankovní účty (u přijatých faktur).

Položky faktury

Alice přenáší do AbraGen jednotlivé položky faktury včetně následujících údajů:

• Název položky
• Množství
• Měrná jednotka
• Cena za jednotku
• Cena bez DPH
• Cena s DPH
• Sazba DPH

Na úrovni jednotlivých položek lze dále nastavit pole Středisko a Obchodní případ.

Dokumenty bez položek

Pokud dokument nemá položky nebo je export položek vypnutý, vytvoří se v AbraGen jedna souhrnná položka. Jako název této položky se použije poznámka dokumentu.

Podpora měn

Integrace s AbraGen podporuje práci s více měnami. Při exportu dokladu v cizí měně Alice:

• Automaticky vyhledá odpovídající měnu v AbraGen
• Přenese směnný kurz
• Uvede ceny v domácí i cizí měně
• Automaticky dopočítá lokální částky u cizích měn

Přílohy dokumentů

K dokladu v AbraGen se automaticky připojí originální dokument (např. PDF faktura) z Alice.

Omezení velikosti přílohy

Příloha je omezena velikostí přibližně 1 MB. Pokud je soubor příliš velký, příloha se k dokladu v AbraGen nepřipojí. Samotný export dokladu tím není ovlivněn.

Kontrola duplicit

U přijatých faktur Alice před exportem automaticky kontroluje, zda doklad se stejným číslem nebo variabilním symbolem již v AbraGen neexistuje. Pokud je nalezen duplicitní doklad, export se neprovede a budete na tuto skutečnost upozorněni.

Generování platebního příkazu

Generování platebního příkazu povolíte v nastavení integrace. Platební příkaz je vygenerován do agendy Žádosti o platební příkazy

Podmínky pro vygenerování platebního příkazu

1. Platba dokladu je převodem
2. Dokument není uhrazen
3. Částka k úhradě je vyšší než 0

Napojení na objednávky

U přijatých faktur lze automaticky napojit doklad na vydanou objednávku v AbraGen. Systém vyhledá odpovídající objednávku podle čísla objednávky uvedeného na faktuře.

Tuto funkci aktivujete v nastavení integrace.

Po úspěšném exportu

Po úspěšném exportu dokumentu do AbraGen:

1. Alice obdrží evidenční číslo dokladu z AbraGen
2. Dokument je spárován s dokladem v AbraGen
3. V detailu dokumentu v Alice se zobrazí informace o exportu
4. U přijatých faktur hrazených převodem se automaticky vygeneruje platební příkaz (pokud je funkce povolena v nastavení integrace)

Diagnostika

Při chybě se dokument v Alici přesune do stavu Chyba s detailem v náhledu.

Chybí zdrojová řada / Chybí období

Příčina: Dokument nemá vyplněnou Zdrojovou řadu nebo Období -- obě pole jsou povinná.

Řešení: Doplňte vlastní pole Zdrojová řada a Období v detailu dokumentu. Hodnoty se získávají synchronizací číselníků z AbraGen.

Měna dokladu nebyla nalezena v účetním systému

Příčina: Měna na dokumentu (např. USD) neexistuje jako záznam v AbraGen.

Řešení: V AbraGen přidejte odpovídající měnu (kód ISO 4217), nebo upravte dokument na podporovanou měnu.

Nelze zadat doklad bez firmy

Příčina: Nepodařilo se najít ani vytvořit dodavatele/odběratele v AbraGen.

Řešení: Doplňte na dokumentu IČO nebo DIČ, případně ověřte, že má uživatel API právo na zápis do adresáře v AbraGen.

Doklad již existuje

Příčina: U přijaté faktury byl nalezen duplicitní doklad podle čísla nebo variabilního symbolu téhož dodavatele -- viz Kontrola duplicit.

Řešení: Pokud je doklad správně, označte ho v Alici ručně jako exportovaný. V opačném případě smažte duplicitu v AbraGen.

Příloha se nepřipojila

Příloha přesahuje limit (~1 MB AbraGen). Doklad samotný se zapsal, jen bez přílohy. PDF lze nahrát ručně přímo v AbraGen.

Časté dotazy | FAQ

Jaké číselníky je nutné nastavit před prvním exportem?

Před prvním exportem je nutné nastavit minimálně dva povinné číselníky: Zdrojová řada a Období. Doporučujeme využít funkci synchronizace číselníků, která tyto hodnoty automaticky načte z AbraGen.

Co se stane, když partner (dodavatel/odběratel) v AbraGen ještě neexistuje?

Alice partnera automaticky vytvoří v adresáři AbraGen. Přenesou se údaje jako název firmy, IČO, DIČ, adresa a bankovní účty. Pokud dokument nemá IČO ani DIČ, použije se výchozí firma.

Proč se k dokladu v AbraGen nepřipojila příloha?

Příloha je omezena velikostí přibližně 1 MB. Pokud je originální dokument větší, příloha se nepřipojí. Samotný export dokladu tím však není ovlivněn -- doklad se do AbraGen přenese bez přílohy.

Jak funguje kontrola duplicit?

U přijatých faktur Alice před exportem ověří, zda doklad se stejným číslem nebo variabilním symbolem již v AbraGen existuje. Pokud ano, export se neprovede a zobrazí se upozornění. Tím se zabrání duplicitnímu zaúčtování.

Lze nastavit středisko nebo obchodní případ na úrovni celého dokladu?

Ano. Středisko, obchodní případ, typ výdaje (u přijatých faktur) i typ příjmu (u vydaných faktur) lze nastavit jak na úrovni celého dokladu, tak na úrovni jednotlivých položek. Hodnota na položce má přednost; pokud položka hodnotu nemá, použije se ta z hlavičky dokladu.

Podporuje integrace export v cizí měně?

Ano, Alice podporuje export dokladů v cizí měně. Při exportu se automaticky vyhledá odpovídající měna v AbraGen, přenese se směnný kurz a ceny se uvedou v domácí i cizí měně.

Jak funguje napojení na objednávky?

U přijatých faktur lze v nastavení integrace zapnout volbu Napojit na objednávky. Pokud je volba aktivní a faktura má vyplněné číslo objednávky, Alice po exportu vyhledá v AbraGen vydanou objednávku se stejným číslem a propojí ji s importovaným dokladem. Pokud volba není zapnuta nebo číslo objednávky chybí, propojení se neprovede.

---

1. Dostupné pouze, pokud pracujete s účetními jednotkami. ↩