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ĺpec | Význam | Povinné |
|---|---|---|
| invoiceNumber | číslo faktúry | áno |
| issueDate | dátum vystavenia (RRRR-MM-DD) | áno |
| deliveryDate | dátum dodania/plnenia | voliteľné |
| currencyCode | mena (štandardne EUR) | voliteľné |
| buyerReference | Leitweg-ID / referencia kupujúceho (B2G) | voliteľné |
| orderReference | číslo objednávky/zákazky (BT-13) | voliteľné |
| sellerName | názov predávajúceho | áno |
| sellerVatId | IČ DPH predávajúceho (USt-IdNr.) | áno* |
| sellerTaxNumber | daňové číslo predávajúceho | áno* |
| sellerStreet / sellerZip / sellerCity / sellerCountry | adresa predávajúceho | voliteľné |
| sellerEmail | e-mail predávajúceho | voliteľné |
| buyerName | názov kupujúceho | áno |
| buyerVatId | IČ DPH kupujúceho (USt-IdNr.) | voliteľné** |
| buyerStreet / buyerZip / buyerCity / buyerCountry | adresa kupujúceho | voliteľné |
| iban / bic | bankové spojenie | voliteľné |
| paymentTerms | platobné podmienky (voľný text, BT-20) | voliteľné |
| dueDate | dátum splatnosti | voliteľné |
| skontoDays / skontoPercent | dni a percentá skonta | voliteľné |
| deliveryNoteId | číslo dodacieho listu | voliteľné |
| discountAmount / discountVatRate / discountVatCategory | zľava na celú faktúru | voliteľné |
| description | označenie položky | áno |
| quantity | množstvo | áno |
| unit | jednotka (napr. hodina, kg, kus) | voliteľné |
| unitPrice | jednotková cena netto | áno |
| vatRate | sadzba dane v percentách | áno |
| vatCategory | daň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.
Bezplatné nástroje
Súvisiace články
Konvertujte PDF faktúry hneď teraz
Vyskúšajte TaxLayer zadarmo, 2 konverzie mesačne, bez kreditnej karty.
Začať teraz