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Č, 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
Můstek	Není potřeba -- integrace probíhá přímo přes API

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	připravujeme integraci
Vydané faktury	Nepodporováno	-
Slovenské faktury	Nepodporováno	-
Přijatý dobropis	Bez special-case	Importuje se jako běžná přijatá faktura (MovementType=18), nikoli jako Dobropis přijatý (19)
Zálohová faktura	Bez special-case	Importuje se jako běžná přijatá faktura
Přenesená daňová povinnost (reverse charge)	Bez special-case	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
DIČ účetní jednotky	Tin	Z konfigurace ÚJ (CustomerVatId)

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í, doklad se zapíše bez napojení na adresář -- záznam dodavatele si poté musíte v Helios iNuvio doplnit ručně

Předpoklad existence dodavatele

Aktuální verze integrace nezakládá nové organizace v adresáři Helios iNuvio. Před exportem se ujistěte, že dodavatel je v adresáři evidovaný (s vyplněným IČO nebo DIČ).

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
Sazba DPH	VatRate	V % (např. 21)

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. 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:

• Alice obdrží identifikátor dokladu z Helios iNuvio
• Dokument je spárován s dokladem v Helios iNuvio
• V detailu dokumentu v Alice se zobrazí informace o provedeném exportu

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?

Aktuálně je podporován export českých přijatých faktur včetně variant jako přenesená daňová povinnost, zálohové faktury a dobropisy. Vydané faktury, slovenské faktury, účtenky ani objednávky nejsou podporovány.

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. 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ě identifikátoru dokladu v Helios iNuvio.