Exportní formáty
Výstup si vyberete při stahování nebo nastavíte jako výchozí u šanonu. Formát zvolený při nahrání rozhoduje jen o tom, co odejde webhookem a co ukazuje záložka Výsledek; stáhnout jde doklad kdykoli v jakémkoli formátu a změna cílového formátu je zdarma.
Datové formáty
- JSON — pro napojení na vlastní systém. Struktura odpovídá schématu.
- XML a YAML — totéž v jiném zápisu.
- CSV a Excel — tabulka, doklad na řádek. Vhodné pro souhrny, ne pro položky: řádek na doklad neunese deset položek. Excel 97-2003 jen u jednoho dokladu.
- PDF — doklad k přečtení, ne k importu. Faktura se vykreslí fakturovou šablonou, ostatní doklady jako pole pod sebou.
Standardy elektronické fakturace
- ISDOC 6.0.2 — český standard, rozumí mu většina českých účetních programů.
- Peppol BIS 3.0 a XRechnung 3.0.2 — evropská e-fakturace nad UBL 2.1.
- ZUGFeRD / Factur-X — CII XML samostatně, nebo vložené do PDF/A-3b.
Formáty účetních programů
Pro Pohodu (XML schéma verze 2), Money S3 (importní XML) a Abra Flexi (JSON pro REST API) generujeme přímo jejich importní soubor, takže se nemusí nic převádět. Směr dokladu rozhoduje, jestli jde o přijatou, nebo vydanou fakturu; druh dokladu o tom, jestli je to faktura, dobropis nebo záloha.
Pro Fakturoid, iDoklad, QuickBooks a Xero jde stáhnout JSON ve tvaru jejich API. Je to podklad pro vlastní integraci, do jejich aplikace ho ručně nenahrajete — tam se používá propojení, nebo ISDOC.
Účtenky
Účtenka nemá pole faktury, takže do fakturových formátů nejde. Umí ISDOC (zjednodušený daňový doklad), Pohodu a Money S3 (pokladní nebo bankovní doklad podle způsobu úhrady) a všechny datové formáty. Pohoda ISDOC bere jen jako přijatou fakturu a platbu kartou v něm nezná, takže do Pohody volte její XML.
Hromadné stažení
CSV, Excel, JSON, XML, YAML, Pohoda a Money S3 se stáhnou jako jeden soubor se všemi doklady. Ostatní formáty jsou jeden soubor na doklad a přijdou v ZIPu, soubory uvnitř pojmenované podle dokladů. Nahrané originály jdou stáhnout jako ZIP taky.
Co dělat, když import neprojde
Nejčastější příčiny, v pořadí podle četnosti:
- Účetní program chce jinou verzi standardu, než posíláme.
- Chybí údaj, který je ve standardu volitelný, ale program ho vyžaduje.
- Doklad má nulovou položku nebo zápornou částku, kterou import neumí.
- Doklad bez data vystavení — doplníme den nahrání, což program může odmítnout.
Chybová hláška importu bývá k ničemu, ale skoro vždycky ukazuje na jedno z těch čtyř. Naše soubory jsou v UTF-8.