Helios Nephrite

Helios Nephrite

Integrace s Helios Nephrite umožňuje export přijatých faktur z Alice prostřednictvím REST API systému Helios Nephrite. Alice se k serveru přihlašuje uživatelským jménem a heslem, doklad se zapisuje synchronně -- výsledek (identifikátor 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. U účetní jednotky je povinné vyplnit Externí ID -- používá se jako název databázového profilu Helios Nephrite při přihlášení. Bez vyplněného Externího ID selže export i validace integrace.

Jak to funguje?

Po označení dokumentu k exportu (stav K exportu) se Alice přihlásí k REST API serveru Helios Nephrite -- jako databázový profil se použije Externí ID účetní jednotky. Poté dohledá dodavatele a vlastní firmu v Helios Nephrite podle IČO/DIČ 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 Nephrite]
    B -.->|potvrzení| A

Podporované verze a předpoklady

Oblast	Požadavek
Aplikace	Helios Nephrite s dostupným REST API
Autentizace	Uživatelské jméno a heslo uživatele Helios Nephrite
Externí ID	Název databázového profilu Helios Nephrite (nutno nastavit u účetní jednotky)
Síť	API server Helios Nephrite musí být dosažitelný z cloudu Alice

Podporované typy dokumentů

Integrace s Helios Nephrite podporuje pouze přijaté tuzemské faktury (typ dokumentu Faktura CZ):

Typ dokumentu	Podpora	Typ dokladu v Helios Nephrite
Česká přijatá faktura	Podporováno	Realizační doklad
Česká přijatá zálohová faktura	Podporováno	Zálohový daňový doklad
Český přijatý dobropis	Podporováno	Dobropis
Vydané faktury	Nepodporováno	-
Slovenské faktury	Nepodporováno	-
Účtenky	Nepodporováno	-
Objednávky	Nepodporováno	-

Nepodporované typy dokumentů

Při pokusu o export jiného typu dokumentu než přijaté tuzemské faktury export skončí chybou, že typ dokumentu není podporován.

Vytvoření integrace

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

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

Konfigurace

Pole	Popis
Adresa serveru	Adresa serveru s Helios Nephrite API
Port	Číslo portu, na kterém je služba dostupná (1--65535)
Uživatelské jméno	Jméno uživatele, který má patřičná oprávnění pro práci s doklady v Helios Nephrite
Heslo	Heslo uživatele Helios Nephrite

V sekci Notifikace můžete navíc vyplnit pole Emailová adresa pro notifikace při chybě exportu -- na tuto adresu vám přijde upozornění, pokud export dokladu selže.

Nastavení uložte. Při uložení systém ověří přihlašovací údaje -- pokud jsou chybné, zobrazí se chyba přihlášení.

Synchronizace číselníků

Alice umožňuje jednosměrně (Helios Nephrite -> Alice) synchronizovat hodnoty číselníků. Synchronizace zajistí, že budete mít k dispozici aktuální kódy DPH pro správné vyplnění dokumentů před exportem. Obecný postup synchronizace najdete na stránce Číselníky.

Dostupné číselníky z Helios Nephrite

Synchronizují se kódy DPH z Helios Nephrite, a to ve čtyřech číselnících:

Číselník	Použití
Kód DPH (položky)	Kód DPH na jednotlivých položkách faktury
Kód DPH (0% DPH)	Kód DPH pro sazbu 0 % na hlavičce dokladu
Kód DPH (12% DPH)	Kód DPH pro sazbu 12 % na hlavičce dokladu
Kód DPH (21% DPH)	Kód DPH pro sazbu 21 % na hlavičce dokladu

Hodnoty číselníků se zobrazují ve formátu Kód - Název.

Ostatní číselníky

Střediska, zakázky ani činnosti se z Helios Nephrite v aktuální verzi integrace nesynchronizují.

Přenášená data

Při exportu se do Helios Nephrite přenáší:

Oblast	Údaje
Identifikace dokladu	Číslo faktury, variabilní symbol, konstantní symbol, specifický symbol
Datumy	Datum zdanitelného plnění (DUZP), datum splatnosti, datum přijetí, datum transakce
Měna	CZK přímo; cizí měna včetně kurzu a data kurzu
Částky	Celkové částky, zaokrouhlení (přenáší se zvlášť)
Platební metoda	Převod, karta, hotovost apod.
DPH	Rekapitulace DPH po sazbách (0 %, 12 %, 21 %), příznak přenesené daňové povinnosti (reverse charge)
Položky faktury	Popis, množství, jednotka, sazba DPH, částky

Pravidla pro DPH

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

Pravidla pro export DPH

Rozpis DPH se sestavuje pouze v případě, kdy je účetní jednotka plátcem DPH. U dokladů v režimu přenesené daňové povinnosti (reverse charge) se přenáší příznak reverse charge a částka DPH se posílá nulová.

Párování firem

Dodavatel a vlastní firma se v Helios Nephrite dohledávají podle IČO a DIČ:

1. Alice vyhledá firmu v Helios Nephrite podle IČO nebo DIČ uvedeného na dokladu
2. Pokud je firma nalezena, doklad se s ní propojí
3. Pokud doklad nemá vyplněné IČO ani DIČ, firma se k dokladu nepřiřadí

Předpoklad existence firmy

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

Podpora měn

Integrace podporuje práci s více měnami. Doklady v CZK se přenášejí přímo, u dokladů v cizí měně se přenáší také směnný kurz a datum kurzu.

Po úspěšném exportu

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

• Alice obdrží identifikátor dokladu přidělený systémem Helios Nephrite a uloží ho k dokumentu
• Dokument je spárován s dokladem v Helios Nephrite
• 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.

Chyba přihlášení při validaci integrace

Příčina: Chybné přihlašovací údaje (uživatelské jméno nebo heslo), případně nesprávná adresa serveru či port.

Řešení: Zkontrolujte v nastavení integrace Adresu serveru, Port, Uživatelské jméno a Heslo a nastavení uložte znovu.

Chybějící Externí ID účetní jednotky

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

Řešení: V detailu účetní jednotky doplňte Externí ID odpovídající názvu databázového profilu v Helios Nephrite.

Typ dokumentu není podporován

Příčina: Pokusili jste se exportovat jiný typ dokumentu než přijatou tuzemskou fakturu (např. vydanou fakturu, slovenskou fakturu nebo účtenku).

Řešení: Do Helios Nephrite lze exportovat pouze přijaté tuzemské faktury (Faktura CZ).

Chyba API při exportu

Příčina: Server Helios Nephrite odmítl zápis dokladu (např. kvůli neplatným datům nebo nastavení na straně Helios Nephrite).

Řešení: Chybová hláška v detailu dokumentu obsahuje detail vrácený serverem Helios Nephrite. Odstraňte příčinu dle textu chyby a export opakujte.

Časté dotazy | FAQ

Jaké typy dokumentů lze exportovat do Helios Nephrite?

Podporován je export přijatých tuzemských faktur (Faktura CZ). Běžná faktura se zapisuje jako realizační doklad, zálohová faktura jako zálohový daňový doklad a dobropis jako dobropis. Vydané faktury, slovenské faktury, účtenky ani objednávky se neexportují.

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

Dodavatel se v Helios Nephrite dohledává podle IČO nebo DIČ a doklad se s ním propojí. Firma musí v Helios Nephrite existovat -- automatické zakládání firem není podporováno. Pokud doklad nemá IČO ani DIČ, firma se k dokladu nepřiřadí.

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

Ano. Doklady v CZK se přenášejí přímo, u dokladů v cizí měně se přenáší také směnný kurz a datum kurzu.

Které číselníky lze synchronizovat?

Synchronizují se kódy DPH z Helios Nephrite -- číselník kódů DPH pro položky a tři číselníky kódů DPH pro hlavičku dokladu (sazby 0 %, 12 % a 21 %). Střediska, zakázky ani činnosti se v aktuální verzi nesynchronizují.

Exportuje se i DPH?

Rozpis DPH se sestavuje pouze pro plátce DPH. U dokladů v režimu přenesené daňové povinnosti (reverse charge) se přenáší příznak reverse charge a částka DPH se posílá nulová.

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 přiděleného systémem Helios Nephrite.