TaxLayer
Technika2026-10-206 min Čas čítaniaod TaxLayer Team

E-faktúra z CSV: štruktúra šablóny importu a čo pokrýva

Importom CSV vytvoríte e-faktúry priamo zo štruktúrovaného exportu Vášho ERP, bez obchádzky cez PDF. Táto cesta je deterministická: Dáta už pochádzajú čisto z Vášho systému, nie je potrebné žiadne rozpoznávanie a TaxLayer z nich zostaví súbor ZUGFeRD alebo XRechnung 1:1 z Vašich hodnôt. Každý súbor sa navyše automaticky overí podľa oficiálnej sady pravidiel KoSIT/Mustang (EN 16931).

> Stručne: Jeden riadok na položku, polia hlavičky v každom riadku, jeden súbor na faktúru. Šablónu stiahnete v aplikácii v časti „Konvertovať PDF“ v oblasti „Importovať z exportu ERP (CSV)“.

Štruktúra súboru

CSV je zostavené podľa vzoru jeden riadok na položku faktúry. Polia na úrovni faktúry (číslo, dátum, predávajúci, kupujúci, platba) sú v každom riadku a načítavajú sa z prvého riadku. Oddeľovačom je bodkočiarka. Nemecké desatinné čísla (1.234,56) sa rozpoznajú.

Prehľad polí

StĺpecVýznamPovinné
invoiceNumberčíslo faktúryáno
issueDatedátum vystavenia (RRRR-MM-DD)áno
deliveryDatedátum dodania/plneniavoliteľné
currencyCodemena (štandardne EUR)voliteľné
buyerReferenceLeitweg-ID / referencia kupujúceho (B2G)voliteľné
orderReferencečíslo objednávky/zákazky (BT-13)voliteľné
sellerNamenázov predávajúcehoáno
sellerVatIdIČ DPH predávajúceho (USt-IdNr.)áno*
sellerTaxNumberdaňové číslo predávajúcehoáno*
sellerStreet / sellerZip / sellerCity / sellerCountryadresa predávajúcehovoliteľné
sellerEmaile-mail predávajúcehovoliteľné
buyerNamenázov kupujúcehoáno
buyerVatIdIČ DPH kupujúceho (USt-IdNr.)voliteľné**
buyerStreet / buyerZip / buyerCity / buyerCountryadresa kupujúcehovoliteľné
iban / bicbankové spojenievoliteľné
paymentTermsplatobné podmienky (voľný text, BT-20)voliteľné
dueDatedátum splatnostivoliteľné
skontoDays / skontoPercentdni a percentá skontavoliteľné
deliveryNoteIdčíslo dodacieho listuvoliteľné
discountAmount / discountVatRate / discountVatCategoryzľava na celú faktúruvoliteľné
descriptionoznačenie položkyáno
quantitymnožstvoáno
unitjednotka (napr. hodina, kg, kus)voliteľné
unitPricejednotková cena nettoáno
vatRatesadzba dane v percentácháno
vatCategorydaňová kategória (S, AE, K, G, E, O, Z)voliteľné

\* Vyžaduje sa aspoň jeden identifikátor predávajúceho (IČ DPH alebo daňové číslo).

\*\* Pri reverse charge (kategória AE) je IČ DPH kupujúceho povinné.

Prečo CSV pokrýva približne 95 percent

EN 16931 definuje približne 160 dátových polí, väčšina z nich voliteľná. Skutočná nemecká faktúra B2B potrebuje z nich len asi 20 až 30 a práve tie šablóna pokrýva. Ostatné hodnoty (rozpis dane, všetky súčty) TaxLayer vypočíta automaticky z položiek.

CSV je plochá tabuľka: jeden smer opakovania, a to riadky. Tie využívame pre položky. Jednotlivé hodnoty možno ľubovoľne doplniť ďalšími stĺpcami. Čo plochý súbor CSV nevie čisto zobraziť, sú opakovane vnorené štruktúry: viac zliav na celú faktúru, zľavy na jednotlivé položky alebo veľa referencií. Tieto štruktúry tvoria strom a na to je vhodným formátom XML.

Skonto a zľava

Skonto uvediete cez skontoDays a skontoPercent. Z nich automaticky vznikne zápis DATEV v platobných podmienkach, takže je skonto strojovo čitateľné. Ako presne je tento vzor zostavený a prečo samotný voľný text spúšťa pravidlo BR-DE-18, vysvetľuje článok Uvedenie skonta v XRechnung a ZUGFeRD. Zľavu na celú faktúru uvediete cez discountAmount; vedie sa ako samostatná položka so zápornou sumou a znižuje základ dane.

A potom?

Po nahraní sa dáta dostanú do zvyčajného kroku kontroly. Tam skontrolujete sumy, sadzby dane a jednotky a následne vytvoríte overenú e-faktúru. Import CSV je zároveň najjednoduchšou cestou, ako skonvertovať veľa faktúr naraz, pretože sa súbor na faktúru spracúva hromadne. Prvé 2 konverzie mesačne sú bezplatné: vyskúšať teraz.

Často kladené otázky

Ako je súbor CSV zostavený?

Jeden riadok na položku faktúry. Polia hlavičky faktúry (číslo, dátum, predávajúci, kupujúci, platba) sú v každom riadku a preberajú sa z prvého riadku. Jeden súbor zodpovedá jednej faktúre.

Ktoré polia sú povinné?

invoiceNumber, issueDate, sellerName, identifikátor predávajúceho (sellerVatId alebo sellerTaxNumber), buyerName a pri každej položke description, quantity, unitPrice a vatRate. Všetko ostatné je voliteľné.

Pokrýva CSV všetky polia EN 16931?

Približne 95 percent prípadov z praxe. EN 16931 má asi 160 dátových polí, z ktorých je väčšina voliteľná. Plochý súbor CSV zobrazí všetky jednotlivé hodnoty (hlavička, strany, platba, skonto, jedna zľava, dátum dodania). Nezobrazí sa opakovane vnorené štruktúry, ako je viac zliav na celú faktúru alebo zľavy na jednotlivé položky. Na to sa hodí XML.

Ako uvediem skonto?

Cez stĺpce skontoDays a skontoPercent. TaxLayer z nich automaticky vytvorí strojovo čitateľný zápis DATEV (#SKONTO#TAGE=14#PROZENT=2.00#) v platobných podmienkach (BT-20), takže DATEV skonto rozpozná.

Ako uvediem zľavu?

Cez discountAmount (suma netto), voliteľne discountVatRate a discountVatCategory. Zľava sa zobrazí ako samostatná položka so zápornou sumou a znižuje základ dane uvedenej sadzby. Pre faktúry s jedinou sadzbou dane je to presné; pri zmiešaných sadzbách uveďte zľavu radšej ako samostatnú položku pre každú sadzbu.

Môžem importovať viac faktúr v jednom súbore?

Momentálne jednu faktúru na súbor. Pri veľkom počte faktúr nahrajte viac súborov alebo nás oslovte kvôli automatizovanému prepojeniu.

Konvertujte PDF faktúry hneď teraz

Vyskúšajte TaxLayer zadarmo, 2 konverzie mesačne, bez kreditnej karty.

Začať teraz