Export do systému Karat

Integrace s účetním systémem Karat umožňuje automatický přenos přijatých faktur přímo do systému Karat prostřednictvím REST API.

Typ integrace

Na rozdíl od jiných exportů (XML soubory) probíhá přenos do systému Karat přímo přes API. Dokumenty se odesílají automaticky bez nutnosti ručního importu souborů.

Vytvoření integrace

V nastavení na kartě Integrace přidejte IS Karat.

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

Konfigurace

Nastavení v Alice

Přejděte do Nastavení > Export a vyberte typ exportu Karat.

Parametr	Popis
URL	Adresa API systému Karat (např. `https://karat.example.com/api`)
Port	Port pro připojení k API
Token	Autentizační token pro přístup k API

Získání přístupových údajů

Přístupové údaje (URL, port a token) získáte od správce systému Karat ve Vaší organizaci.

Ověření připojení

Při uložení nastavení integrace se automaticky testuje připojení k systému Karat. Pokud jsou přístupové údaje správné, zobrazí se potvrzení o úspěšném připojení.

Podporované typy dokumentů

Integrace s IS Karat podporuje následující typy dokumentů:

Typ dokumentu	Podpora
Česká přijatá faktura	✓
Česká vydaná faktura	✗
Slovenská přijatá faktura	✗
Slovenská vydaná faktura	✗
Účtenky	✗
Dobropisy	✗
Zálohové faktury	✗

Nepodporované typy dokumentů

Integrace s IS Karat aktuálně nepodporuje export následujících typů dokumentů:

Vydané faktury
Slovenské faktury (přijaté i vydané)
Účtenky
Dobropisy
Zálohové faktury

Synchronizace číselníků

Alice umožňuje jednosměrně (IS Karat -> 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 IS Karat

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

Automatický výběr fiskálního roku

Číselné řady se získávají pro aktuální fiskální rok. Fiskální rok se automaticky odvozuje z data zdanitelného plnění na faktuře (poslední 2 cifry roku).

Účetní kniha

Z vybrané číselné řady se automaticky odvodí účetní kniha, do které bude faktura zaúčtována.

Exportovaná pole

Hlavní údaje dokumentu

Pole v Alice	Pole v Karat	Poznámka
Číslo faktury	Vnější číslo dokladu + interní číslo
Číslo dodacího listu	Číslo dodacího listu
Číslo objednávky	Číslo objednávky
Poznámka	Poznámka	Max 4000 znaků
Datum vystavení	Datum vystavení
Datum splatnosti	Datum splatnosti
Datum zdanitelného plnění	Datum zdanitelného plnění	Povinné - odvozuje se fiskální rok
Datum uplatnění odpočtu DPH	Datum uplatnění odpočtu DPH
Variabilní symbol	Variabilní symbol	Povinné, max 10 znaků
Konstantní symbol	Konstantní symbol	Max 4 znaky
Specifický symbol	Specifický symbol	Max 10 znaků
Měna	Měna operace
Směnný kurz	Kurz	Pokud není vyplněn, použije se 1

Údaje o dodavateli

Pole v Alice	Pole v Karat
IČO dodavatele	ID partnera
DIČ dodavatele	VAT ID
Jméno dodavatele	Název partnera
Adresa dodavatele	Ulice
Město dodavatele	Město
PSČ dodavatele	PSČ
Číslo bankovního účtu	Číslo účtu
Kód banky	Kód banky
IBAN	IBAN

Finanční údaje

Pole v Alice	Pole v Karat
Celkem k úhradě	Částka k úhradě
Základ DPH (základní sazba)	Základ základní sazba
Základ DPH (snížená sazba)	Základ snížená sazba
DPH (základní sazba)	DPH základní sazba
DPH (snížená sazba)	DPH snížená sazba
Zaokrouhlení	Zaokrouhlení

Účetní údaje

Pokud máte nakonfigurované vlastní pole, můžete exportovat:

Účetní údaj	Popis
Předkontace	Kód předkontace
Středisko	Nákladové středisko
Zakázka	Číslo zakázky
Číselná řada	Série dokumentu v Karat - POVINNÉ POLE

Nastavení vlastních polí

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

Automatické vytváření partnerů

Pokud partner (dodavatel) v systému Karat neexistuje, Alice ho automaticky vytvoří 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 Karat.

Automaticky přenášené údaje dodavatele

Při vytvoření nového partnera v IS Karat 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
DIČ	Daňové identifikační číslo
Měna	Měna partnera
Číslo účtu	Číslo bankovního účtu
Kód banky	Kód banky
IBAN	Mezinárodní číslo bankovního účtu
Specifický symbol	Specifický symbol účtu
Měna účtu	Měna bankovního účtu

Určení kódu země

Kód země dodavatele se automaticky určí z prvních dvou znaků DIČ. Pokud má dodavatel například DIČ začínající na „CZ", nastaví se kód země na CZ. Pokud DIČ není uvedeno, použije se výchozí CZ.

Položky faktury

Export podporuje přenos položek faktury do IS Karat včetně následujících údajů:

Pole položky	Popis
Název položky	Popis položky, max 255 znaků
Množství	Množství jednotek
Cena za jednotku	Jednotková cena bez DPH
Základ	Celková cena položky bez DPH
DPH	Částka DPH

Cizí měna

U faktur v cizí měně se částky položek automaticky přepočítávají směnným kurzem do domácí měny.

Podporované DPH sazby

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

Pravidlo pro export DPH

DPH se do IS Karat 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áší.

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.

Cizí měna

Pokud je faktura v cizí měně, systém automaticky:

Přenese částky v původní měně faktury
Přepočte všechny částky směnným kurzem do domácí měny
Pokud není vyplněn směnný kurz, automaticky se použije hodnota 1

Podporované měny

Integrace podporuje všechny standardní ISO měny (CZK, EUR, USD, atd.).

Kontrola duplicit

Před exportem přijaté faktury systém automaticky ověří, zda doklad se stejným vnějším číslem faktury NEBO variabilním symbolem od stejného dodavatele (identifikace podle IČO nebo DIČ) již v IS Karat neexistuje.

Pokud je nalezen duplicitní doklad, export se neprovede a v Alice se zobrazí chybová hláška.

Povinná pole

Pro úspěšný export do systému Karat jsou povinná následující pole:

Pole	Poznámka
IČO dodavatele nebo DIČ dodavatele	Alespoň jedno z těchto polí musí být vyplněno
Variabilní symbol	Povinné, max 10 znaků
Datum zdanitelného plnění	Povinné - z něj se odvozuje fiskální rok
Číselná řada	Povinné vlastní pole

Po úspěšném exportu

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

Alice obdrží ID vytvořeného dokladu v IS Karat
Dokument je spárován s dokladem v systému Karat
V detailu dokumentu v Alice se zobrazí datum exportu a číslo dokladu

Sledování exportovaných dokumentů

Exportované dokumenty můžete snadno identifikovat podle zobrazené informace o exportu v detailu dokumentu.

Omezení

Aktuální omezení integrace

Integrace s IS Karat má následující omezení:

Pouze přijaté faktury - vydané faktury, účtenky, dobropisy a zálohové faktury nejsou podporovány
Přílohy dokumentů se neexportují - PDF soubory a další přílohy se do IS Karat nepřenášejí
Žádná zpětná synchronizace - změny provedené v IS Karat se nepromítají zpět do Alice
Slovenské faktury nejsou podporovány - integrace funguje pouze pro české faktury
Reverse charge není speciálně řešen - přenesená daňová povinnost není explicitně podporována

Časté dotazy | FAQ

Jaké typy dokumentů lze exportovat do IS Karat?

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.

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

Ano, před prvním exportem je nutné synchronizovat číselné řady přijatých faktur. Číselná řada je povinné pole při exportu a bez její synchronizace export nelze provést.

Jak se určuje fiskální rok pro export?

Fiskální rok se automaticky odvozuje z data zdanitelného plnění na faktuře. Používají se poslední 2 cifry roku (např. faktura s datem zdanitelného plnění 15.3.2024 má fiskální rok 24).

Co se stane, pokud dodavatel v IS Karat neexistuje?

Pokud dodavatel (identifikovaný podle IČO nebo DIČ) v IS Karat neexistuje, systém ho automaticky vytvoří. Přenesou se všechny dostupné údaje jako název, adresa, IČO, DIČ a bankovní údaje.

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

Ano, integrace podporuje práci s více měnami. Při exportu faktury v cizí měně se částky automaticky přepočítávají směnným kurzem do domácí měny. Pokud směnný kurz není vyplněn, použije se hodnota 1.

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 jedna z podmínek není splněna, DPH se do dokladu nepřenáší.

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

Systém před exportem kontroluje duplicity podle vnějšího čísla faktury nebo variabilního symbolu a IČO/DIČ dodavatele. Pokud je nalezen duplicitní doklad, export se neprovede a zobrazí se chybová hláška.

Exportují se přílohy dokumentu (např. PDF faktury)?

Ne, přílohy dokumentů se do IS Karat neexportují. Exportují se pouze data faktury a její položky.

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ě data exportu a ID dokladu v IS Karat.

Řešení problémů

Export selhal - Unauthorized

Příčina: Neplatný nebo expirovaný token.

Řešení: Zkontrolujte token v nastavení exportu. Případně požádejte správce systému Karat o nový token.

Export selhal - Partner nenalezen

Příčina: Dokument nemá vyplněné IČO ani DIČ dodavatele.

Řešení: Doplňte IČO nebo DIČ dodavatele na dokumentu.

Export selhal - Duplicitní dokument

Příčina: Dokument s tímto variabilním symbolem již v systému Karat existuje.

Řešení: Zkontrolujte, zda dokument není v Karat již zaúčtován. Pokud ano, označte dokument v Alice jako exportovaný.

Export selhal - Connection refused

Příčina: Nelze se připojit k API systému Karat.

Řešení: Zkontrolujte URL a port v nastavení. Ověřte, že je systém Karat dostupný a firewall neblokuje spojení.