Altus Vario
Altus Vario
Integrace s účetním systémem Altus Vario umožňuje automatický přenos přijatých faktur přímo do systému Vario prostřednictvím REST API.
Typ integrace
Na rozdíl od jiných exportů (XML soubory) probíhá přenos do systému Altus Vario přímo přes REST API z cloudu Alice. Není potřeba Redque můstek ani ruční import souborů.
Jak to funguje?
Po označení dokumentu k exportu (stav 
K exportu) Alice naváže novou autentizovanou relaci se systémem Vario a zapíše doklad jako příchozí fakturu. Dodavatel se ve Variu vyhledá podle IČO nebo DIČ; pokud neexistuje, automaticky se založí v adresáři kontaktů. Po dokončení exportu se relace ve Variu uzavře. Při úspěšném zápisu se doklad v Alici přesune do stavu Exportovaný, při chybě do stavu Chyba -- viz Řešení problémů. Přehled všech stavů viz Stavy dokumentů.
Schéma datového toku
graph LR
A[Alice] -->|doklad| B[Altus Vario]
B -.->|potvrzení| APodporované verze a předpoklady
| Oblast | Požadavek |
|---|---|
| Aplikace | Altus Vario s povoleným REST API |
| Přístupové údaje | URL, port, uživatelské jméno a heslo (poskytuje správce systému Vario) |
| Síť | API systému Vario musí být dosažitelné z cloudu Alice (firewall, public/private IP) |
| Můstek | Není potřeba -- integrace probíhá přímo přes API |
Podporované typy dokumentů
Integrace s Altus Vario podporuje následující typy dokumentů:
| Typ dokumentu | Podpora |
|---|---|
| Česká přijatá faktura |  Podporováno |
| Česká vydaná faktura |  Nepodporováno |
| Slovenská přijatá faktura | Nepodporováno |
| Slovenská vydaná faktura | Nepodporováno |
| Účtenky | Nepodporováno |
| Dobropisy | Nepodporováno |
| Zálohové faktury | Nepodporováno |
Vytvoření integrace
V nastavení na kartě Integrace přidejte Altus Vario.
Podrobný postup, jak vytvořit integraci pro účetní systémy, naleznete v části Integrace.
Konfigurace
Nastavení v Alice
Přejděte do Nastavení > Integrace a vyberte typ exportu Altus Vario.
| Parametr | Popis |
|---|---|
| URL | Adresa serveru, na kterém běží API systému Vario (např. https://vario.example.com) |
| Port | Port pro připojení k API |
| Uživatelské jméno | Přihlašovací jméno uživatele Varia |
| Heslo | Heslo uživatele Varia |
| E-mail pro upozornění | Volitelná e-mailová adresa pro zasílání oznámení o nezpracovaných zprávách |
Získání přístupových údajů
Přístupové údaje (URL, port, uživatelské jméno a heslo) získáte od správce systému Vario ve Vaší organizaci.
Ověření připojení
Při uložení nastavení integrace se automaticky testuje připojení k systému Vario. Pokud jsou přístupové údaje správné, zobrazí se potvrzení o úspěšném připojení.
Nastavení účetní jednotky
Každá účetní jednotka v Alici, ze které chcete exportovat do Varia, musí mít vyplněné Externí ID odpovídající číslu firmy (CompanyNumber) v systému Altus Vario. Externí ID určuje, do které firmy ve Variu se budou doklady zapisovat.
Externí ID nastavíte v Nastavení > Účetní jednotky.
Povinné Externí ID
Bez vyplněného Externího ID se export do Altus Vario neprovede a dokument skončí ve stavu Chyba.
Synchronizace číselníků
Synchronizace číselníků (středisek, zakázek, partnerů) není v aktuální verzi integrace dostupná. Partneři se ve Variu zakládají automaticky při každém exportu, pokud daný dodavatel ještě neexistuje -- viz Automatické vytváření partnerů.
Exportovaná pole
Hlavní údaje dokumentu
| Pole v Alice | Pole v Altus Vario | Poznámka |
|---|---|---|
| Číslo faktury | ID dokladu | |
| Poznámka | Note | |
| Měna | Currency | ISO kód měny (CZK, EUR, …) |
| Způsob úhrady | PaymentMeansCode | Viz tabulka Mapování způsobu úhrady |
| Datum vystavení | IssueDate | Pokud není vyplněno, použije se aktuální datum |
| Datum splatnosti | DueDate | Přenáší se i do platebního plánu |
| Datum zdanitelného plnění | TaxPointDate | |
| Variabilní symbol | EndToEndIdentification | Přenáší se do platebního plánu |
| Konstantní symbol | CategoryPurpose | Přenáší se do platebního plánu |
| Specifický symbol | InstructionIdentification | Přenáší se do platebního plánu |
| Směnný kurz | TaxExchangeRate | U faktur v cizí měně; pro CZK je vždy 1 |
Mapování způsobu úhrady
Způsob úhrady z Alice se do Varia přenáší jako standardní kód platebního prostředku:
| Způsob úhrady v Alice | Kód ve Variu |
|---|---|
| Hotovost | 10 |
| Stravenka / šek | 20 |
| Bankovní převod (výchozí) | 42 |
| Platební karta | 48 |
| Inkaso | 49 |
| Dobírka | 50 |
| Vzájemný zápočet | 97 |
Údaje o dodavateli (odběratel je zpracován analogicky)
| Pole v Alice | Pole v Altus Vario |
|---|---|
| IČO dodavatele | Identifikace typu UIN (kód země CZ) |
| DIČ dodavatele | Identifikace typu VAT |
| Název dodavatele | Name |
| Adresa dodavatele (ulice) | StreetName |
| Město dodavatele | CityName |
| PSČ dodavatele | PostalZone |
| Stát dodavatele | CountryIso (automaticky z DIČ, výchozí CZ) |
| Číslo bankovního účtu | Číslo účtu (bez kódu banky) |
| Kód banky | BankCode |
| IBAN | IBAN |
| BIC / SWIFT | BIC |
Finanční údaje
| Pole v Alice | Pole v Altus Vario | Poznámka |
|---|---|---|
| Celkem bez DPH | TaxExclusiveAmount | Součet základů DPH ze všech sazeb |
| Celkem s DPH | TaxInclusiveAmount | |
| Částka k úhradě | PayableAmount | |
| Zaokrouhlení | PayableRoundingAmount | Posílá se jako samostatná hodnota, ale do celkového součtu se nezapočítává |
| Základ DPH (jednotlivé sazby) | TaxSubTotal -- TaxableAmount | Pro každou nenulovou sazbu samostatný záznam |
| DPH (jednotlivé sazby) | TaxSubTotal -- TaxAmount |
Účetní údaje
| Pole v Alice | Stav exportu |
|---|---|
| Předkontace | Není exportována |
| Středisko | Není exportováno |
| Zakázka | Není exportována |
| Číselná řada | Není exportována |
Mapování vlastních polí
Aktuální verze integrace nepřenáší předkontaci, středisko, zakázku ani číselnou řadu, i když je v Alici máte vyplněné. Pokud potřebujete tyto údaje ve Variu evidovat, doplňte je tam ručně.
Automatické vytváření partnerů
Pokud partner (dodavatel) v systému Vario neexistuje, Alice ho automaticky vytvoří v adresáři kontaktů na základě údajů z dokumentu.
Párování partnerů
Párování partnerů probíhá podle IČO nebo DIČ dodavatele. Pokud je partner nalezen, použijí se jeho údaje ze systému Vario.
Automaticky přenášené údaje dodavatele
Při vytvoření nového partnera ve Variu se přenesou následující údaje z Alice:
| Údaj | Popis |
|---|---|
| Název | Obchodní název dodavatele |
| Ulice | Ulice a číslo popisné |
| Obec | Město dodavatele |
| PSČ | Poštovní směrovací číslo |
| Stát | Automaticky odvozen z DIČ (první 2 znaky), výchozí CZ |
| IČO | Identifikační číslo (Scheme = UIN) |
| DIČ | Daňové identifikační číslo (Scheme = VAT) |
| Číslo účtu | Číslo bankovního účtu |
| Kód banky | Kód banky |
| IBAN | Mezinárodní číslo bankovního účtu |
| BIC / SWIFT | Kód banky pro mezinárodní platby |
Určení kódu země
Kód země dodavatele se automaticky určí z prvních dvou znaků DIČ (např. „CZ" → CZ). Pokud DIČ není uvedeno, použije se výchozí CZ.
Položky faktury
Export podporuje přenos všech položek faktury do Varia včetně následujících údajů:
| Pole položky | Popis |
|---|---|
| Název položky | Popis (poznámka) řádku dokladu |
| Množství | Počet jednotek |
| Jednotka | Měrná jednotka. Metrické jednotky (ml, kg, m, m², m³, l, t…) se označují jako soustava SI, ostatní jako neznámé |
| Cena bez DPH | Pro plátce DPH: cena bez DPH |
| Cena s DPH | Pro plátce DPH: cena s DPH. Pro neplátce se posílá pouze celková cena |
| DPH sazba | Procentní sazba DPH řádku |
| DPH (částka) | Vypočtená výše DPH řádku |
Cizí měna
U faktur v cizí měně se přenáší jak částka v původní měně, tak kurz, kterým Vario provede přepočet. Pokud je měna CZK, kurz je vždy 1.
DPH
| Sazba | Popis |
|---|---|
| 0 % | Osvobozeno od DPH |
| 12 % | Snížená sazba |
| 21 % | Základní sazba |
Pravidlo pro export DPH
Pro plátce DPH se DPH přenáší do schématu 1 (standardní DPH) nebo 2 (přenesená daňová povinnost / reverse charge). Pokud účetní jednotka není plátcem DPH, posílá se TaxAmount = 0 a DPH se v daňovém rozpisu neuvádí.
Podpora měn
Integrace podporuje práci s více měnami.
Domácí měna
Pokud je měna faktury stejná jako měna účetnictví, všechny částky se přenášejí bez přepočtu (kurz = 1).
Cizí měna
Pokud je faktura v cizí měně, do Varia se posílají:
- Částky v původní měně faktury
- Směnný kurz (TaxCurrencyRate, ReferenceCurrencyRate) a datum kurzu (RateDate)
Vario podle nich přepočítá hodnoty do domácí měny.
Podporované měny
Integrace podporuje všechny standardní ISO měny (CZK, EUR, USD, …).
Omezení
Aktuální omezení integrace
Integrace s Altus Vario má následující omezení:
- Pouze přijaté české faktury -- vydané faktury, slovenské faktury, účtenky, dobropisy ani zálohové faktury nejsou podporovány
- Přílohy dokumentů se neexportují -- PDF soubory a další přílohy se do Varia nepřenášejí
- Žádná zpětná synchronizace -- změny provedené ve Variu se nepromítají zpět do Alice
- Číselníky se nesynchronizují -- střediska ani zakázky nelze přebírat z Varia
- Předkontace, středisko, zakázka, číselná řada se nepřenášejí -- doplňte je ve Variu ručně
- Externí ID účetní jednotky je povinné -- bez něj export selže
- Zaokrouhlení je z celkového součtu vyloučeno -- posílá se jako samostatná hodnota
Časté dotazy | FAQ
Jaké typy dokumentů lze exportovat do Altus Vario?
Aktuálně je podporován export českých přijatých faktur. Vydané faktury, slovenské faktury, účtenky, dobropisy ani zálohové faktury nejsou podporovány.
Co se stane, pokud dodavatel ve Variu neexistuje?
Pokud dodavatel (identifikovaný podle IČO nebo DIČ) ve Variu neexistuje, Alice ho automaticky vytvoří v adresáři kontaktů. Přenesou se všechny dostupné údaje jako název, adresa, IČO, DIČ a bankovní účet.
Proč potřebuji vyplňovat Externí ID na účetní jednotce?
Altus Vario umí v jednom serveru spravovat více firem. Externí ID určuje, do které firmy (CompanyNumber) se má doklad zapsat. Bez něj Alice neví, kam ve Variu doklad odeslat, a export selže.
Podporuje integrace faktury v cizích měnách?
Ano. Do Varia se posílá částka v původní měně i kurz, kterým Vario provede přepočet do domácí měny.
Exportují se přílohy dokumentu (např. PDF faktury)?
Ne, přílohy dokumentů se do Altus Vario neexportují. Exportují se pouze data faktury a její položky.
Synchronizují se z Varia partneři, střediska nebo zakázky?
Ne. Synchronizace číselníků v aktuální verzi integrace není dostupná. Partneři se ve Variu zakládají automaticky při exportu dokladu, ostatní číselníky je nutné vést pouze ve Variu.
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 (datum exportu a identifikace dokladu).
Řešení problémů
Při chybě se dokument v Alici přesune do stavu 
Chyba s detailem v náhledu.
Export selhal -- Není vyplněné externí id účetní jednotky
Příčina: Účetní jednotka, pod kterou je dokument zařazen, nemá vyplněné Externí ID.
Řešení: V Nastavení účetních jednotek doplňte u dané účetní jednotky Externí ID hodnotou odpovídající číslu firmy (CompanyNumber) v systému Vario.
Export selhal -- Tento typ dokumentu není podporován
Příčina: Pokoušíte se exportovat jiný typ dokumentu než českou přijatou fakturu (např. fakturu vydanou, dobropis nebo účtenku).
Řešení: Integrace Altus Vario podporuje pouze přijaté české faktury. Ostatní typy dokumentů exportovat nelze.
Export selhal -- Ověření přihlašovacích údajů
Příčina: Neplatná URL, port, uživatelské jméno nebo heslo.
Řešení: Zkontrolujte přístupové údaje v nastavení integrace. URL musí být dosažitelná z cloudu Alice (nikoli pouze z lokální sítě). Případně požádejte správce systému Vario o aktuální údaje.
Export selhal -- Chyba systému Vario (HTTP 400/500)
Příčina: Server Varia odmítl požadavek (např. chybějící povinné pole, neplatná hodnota, vnitřní chyba Varia).
Řešení: V chybové zprávě je uveden HTTP stavový kód a odpověď ze serveru Varia. Předejte tento výpis správci systému Vario pro další diagnostiku.