Helios Inuvio

Helios iNuvio

Integrace s Helios iNuvio umožňuje export přijatých faktur z Alice prostřednictvím REST API Helios iNuvio. Doklad se zapisuje synchronně -- výsledek (číslo dokladu) se vrací ihned po zápisu.

Založení účetní jednotky

Nejdříve je nutné vytvořit účetní jednotku, ze které budou doklady exportovány. Pokud účetní jednotku již máte vytvořenou, nastavte jí ID databáze Helios Inuvio viz Externí ID účetní jednotky. Dále v nastavení na kartě číselníky synchronizujte číselník s účetní jednotkou Helios Inuvio.

Jak to funguje?

Po označení dokumentu k exportu (stav K exportu) Alice naváže session s REST API Helios iNuvio. Dohledá aktivní účetní období a dodavatele v adresáři Helios podle IČO/DIČ (pokud dodavatel neexistuje, automaticky ho založí), ověří duplicity a doklad zapíše. 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[Helios iNuvio]
    B -.->|potvrzení| A

Podporované verze a předpoklady

Oblast	Požadavek
Aplikace	Helios iNuvio s aktivním REST API
Autentizace	HTTP Basic Authentication (uživatel + heslo)
Externí ID	Název databáze v Helios iNuvio (nutno nastavit u účetní jednotky)
Účetní období	V Helios iNuvio musí existovat aktivní účetní období pokrývající aktuální datum
Síť	API server Helios iNuvio musí být dosažitelný z cloudu Alice

Podporované typy dokumentů

Integrace s Helios iNuvio podporuje následující typy dokumentů:

Typ dokumentu	Podpora	Agenda v Helios iNuvio
Česká přijatá faktura	Podporováno	Přijaté faktury (MovementType=18)
Účtenky	Nepodporováno	Nepodporováno Helios API
Vydané faktury	Nepodporováno	-
Slovenské faktury	Nepodporováno	-
Přijatý dobropis		Importuje se jako běžná přijatá faktura (MovementType=18), nikoli jako Dobropis přijatý (19)
Zálohová faktura		Importuje se jako běžná přijatá faktura
Přenesená daňová povinnost (reverse charge)		Doklad se zapíše, ale bez příznaku PDP na položkách

Vytvoření integrace

V nastavení na kartě Integrace přidejte Helios Inuvio.

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

Konfigurace

• Vyplnění údajů

  

• Popis polí

  Číslo	Název	Popis
  1	Název	Uživatelský název spojení pro Helios Inuvio
  2	Účetní jednotka	Účetní jednotka, ze které budou dokumenty importovány
  3	Adresa serveru	Adresa serveru s Helios Inuvio API včetně protokolu.
  4	Port	Číslo portu, na kterém je služba dostupná
  5	Uživatelské jméno	Jméno uživatele, který má patřičná oprávnění pro práci s agendou v Helios Inuvio
  6	Uživatelské heslo	Heslo uživatele Helios Inuvio

Nastavení uložte.

Synchronizace číselníků

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

Synchronizace číselníků

Alice umožňuje jednosměrně (Helios iNuvio -> Alice) synchronizovat hodnoty číselníků. Synchronizace zajistí, že budete mít k dispozici aktuální hodnoty pro správné vyplnění dokumentů před exportem.

Dostupné číselníky z Helios iNuvio

Číselník	Popis	Povinný
Řada dokladu (Přijaté faktury)	Číselná řada pro přijaté faktury	✓

Automatický výběr účetního období

Při synchronizaci číselníků systém automaticky vybere aktivní účetní období v Helios iNuvio.

Mapování polí dokumentu

Pro správný export dokladu do Helios iNuvio je potřeba správně vyplnit pole dokumentu v Alice. Některá pole jsou povinná, ostatní se přenášejí automaticky.

Povinná pole

Pole	Pole v Helios iNuvio	Popis
Řada dokladu	DocumentType	Číselná řada pro přijaté faktury -- POVINNÉ POLE
Datum uplatnění odpočtu DPH	TransactionDate	POVINNÉ POLE -- export selže, pokud chybí

Nastavení vlastních polí

Podrobný návod pro nastavení mapování vlastních polí najdete v sekci Vlastní pole.

Datumy

Pole v Alice	Pole v Helios iNuvio	Poznámka
Datum uplatnění odpočtu DPH	TransactionDate	Povinné
Datum vystavení	IssueDate
Datum splatnosti	DueDate
Datum zdanitelného plnění	VatDate
Datum přepočtu kurzu	ExchangeDate	Pouze u cizoměnových dokladů

Identifikátory dokladu

Pole v Alice	Pole v Helios iNuvio
Číslo faktury	InvoiceNo
Variabilní symbol	VariableSymbol
Konstantní symbol	ConstantSymbol
Specifický symbol	SpecificSymbol
Číslo objednávky	OrderNo
Poznámka	Note

Finanční údaje

Pole v Alice	Pole v Helios iNuvio	Poznámka
Měna	CurrencyCode
Směnný kurz	ExchangeRate	Výchozí 1
Zaokrouhlení	TotalCurrencyRounding	Zapisuje se jednotně do zadané částky zaokrouhlení dokladu
DIČ účetní jednotky	Tin	Z konfigurace ÚJ (CustomerVatId)

Zaokrouhlení u neplátců DPH

U dokladů, kde se DPH nepřenáší (neplátce DPH), se zaokrouhlení nezahrnuje do souhrnné položky dokladu -- do celkové částky se tak nezapočítá dvakrát.

Podporované DPH sazby

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

Pravidlo pro export DPH

DPH se do Helios iNuvio exportuje pouze v případě, kdy je dodavatel plátcem DPH a zároveň je účetní jednotka také plátcem DPH. Pokud jedna z těchto podmínek není splněna, DPH se nepřenáší.

Práce s dodavateli

Při exportu se dodavatel dohledává v adresáři Helios iNuvio podle IČO nebo DIČ:

1. Vyhledá se v agendě Organizace podle IČO (TabCisOrg.ICO) nebo DIČ (TabCisOrg.DIC)
2. Pokud je nalezen, na doklad se uloží jeho interní číslo organizace (CompanyId / CisloOrg)
3. Pokud nalezen není, Alice dodavatele automaticky založí v adresáři Helios iNuvio a doklad na něj napojí

Automatické založení dodavatele

Nový dodavatel se zakládá v databázi Helios iNuvio, která je nastavena jako Externí ID u účetní jednotky. Bankovní spojení dodavatele (číslo účtu, IBAN, měna) se přitom zapisuje do číselníku bankovních spojení Helios iNuvio -- účty jsou u organizace správně vidět a funguje párování plateb.

Položky faktury

Export přenáší jednotlivé položky faktury do Helios iNuvio:

Pole v Alice	Pole v Helios iNuvio	Poznámka
Název položky	Description
Množství	Quantity	Výchozí hodnota 1
Měrná jednotka	MeasureUnit
Cena bez DPH	CurrencyAmount	Zapisuje se jako primární cena CC bez daní (doklady v CZK), resp. CC bez daní valuty (cizí měna)
Sazba DPH	VatRate	V % (např. 21)

Dopočet částek v Helios iNuvio

Položky se přenášejí s cenou CC bez daní (u dokladů v CZK), resp. CC bez daní valuty (u dokladů v cizí měně). DPH a odvozené částky si Helios iNuvio dopočítá sám podle vlastní logiky -- částky na dokladu tak odpovídají stavu, jako byste doklad pořídili ručně. Pokud na dokumentu v Alici chybí jednotková cena, nedopočítává se z celkového základu a počtu kusů a v Helios iNuvio zůstane prázdná.

PDP na položkách

Aktuální verze integrace neaplikuje na položky příznak přenesené daňové povinnosti.

Podpora měn

Integrace podporuje práci s více měnami. Při exportu se přenáší informace o měně dokladu společně se směnným kurzem, pokud se jedná o jinou než domácí měnu.

Kontrola duplicit

Před exportem přijaté faktury systém automaticky ověří, zda doklad se stejným číslem faktury nebo variabilním symbolem od stejného dodavatele (identifikace podle IČO nebo DIČ) již v Helios iNuvio neexistuje. Číslo faktury se přitom porovnává s polem Dodavatelská faktura dokladu v Helios iNuvio, tedy s hodnotou, do které se číslo faktury při exportu skutečně zapisuje. Pokud je nalezen duplicitní doklad, export se neprovede a v Alice se zobrazí informace o duplicitě.

Po úspěšném exportu

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

• U dokumentu v Alici se uloží označení dokladu ve formátu Řada/Pořadové číslo, pod kterým doklad najdete v Helios iNuvio
• Dokument je spárován s dokladem v Helios iNuvio
• V detailu dokumentu v Alice se zobrazí informace o provedeném exportu

Označení dokladu

Pokud se označení dokladu nepodaří po zápisu z Helios iNuvio načíst, export přesto proběhne úspěšně a označení u dokumentu zůstane prázdné.

Diagnostika

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

Tax deduction application date missing

Příčina: Datum uplatnění odpočtu DPH je prázdné a kód ho považuje za povinné (mapuje se na TransactionDate).

Řešení: Doplňte na dokumentu Datum uplatnění odpočtu DPH a export opakujte.

Numerical serie (document type) is mandatory

Příčina: Vlastní pole Řada dokladu není vyplněné.

Řešení: V detailu dokumentu vyberte řadu dokladu (nutno mít synchronizované číselníky).

External id of accounting unit is not defined

Příčina: Účetní jednotka v Alici nemá vyplněné Externí ID (název databáze v Helios iNuvio).

Řešení: V detailu účetní jednotky doplňte Externí ID odpovídající názvu databáze v Helios iNuvio.

No active period for {date} found

Příčina: V Helios iNuvio neexistuje účetní období pokrývající dnešní datum (případně je uzavřené).

Řešení: V Helios iNuvio otevřete/vytvořte aktivní účetní období.

Invoice(s) with the same invoice number or variable symbol already exist(s)

Příčina: Duplicitní doklad od stejné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 Helios iNuvio.

Časté dotazy | FAQ

Jaké typy dokumentů lze exportovat do Helios iNuvio?

Podporován je export českých přijatých faktur. Vydané faktury, slovenské faktury, účtenky ani objednávky se neexportují. Doklady se do Heliosu vždy zapisují jako běžná přijatá faktura -- speciální typ (zálohová faktura, dobropis, přenesená daňová povinnost) se v Heliosu nerozliší a případnou kategorizaci je nutné nastavit přímo v Helios iNuvio.

Je nutné synchronizovat číselníky před prvním exportem?

Ano, před prvním exportem je nutné synchronizovat číselníky, aby byla v Alice dostupná řada dokladu pro přijaté faktury. Bez nastavení řady dokladu nelze export provést.

Jak se přenášejí údaje o dodavateli?

Údaje o dodavateli (IČO, DIČ, název, adresa, bankovní údaje) se přenesou přímo do dokladu v Helios iNuvio. Pokud dodavatel v adresáři Helios iNuvio neexistuje, automaticky se založí -- jeho bankovní spojení se zapíše do číselníku bankovních spojení. Kód země se automaticky určí z prvních dvou znaků DIČ.

Podporuje integrace faktury v cizích měnách?

Ano, integrace podporuje práci s více měnami. Při exportu se přenáší informace o měně dokladu i směnný kurz.

Co se stane, pokud je v Helios iNuvio již faktura se stejným číslem?

Systém před exportem kontroluje duplicity podle čísla faktury nebo variabilního symbolu a IČO/DIČ dodavatele. Pokud je nalezen duplicitní doklad, export se neprovede a budete o tom informováni.

Exportuje se i DPH?

DPH se exportuje pouze v případě, kdy je dodavatel plátcem DPH a zároveň je účetní jednotka také plátcem DPH. Pokud některá z podmínek není splněna, DPH se do dokladu nepřenáší.

Kde najdu informace o úspěšně exportovaném dokumentu?

Po úspěšném exportu se v detailu dokumentu v Alice zobrazí informace o provedeném exportu včetně označení dokladu v Helios iNuvio ve formátu Řada/Pořadové číslo.