TaxLayer
Technika2026-10-206 min czytaniaprzez TaxLayer Team

E-faktura z CSV: budowa szablonu importu i co jest objęte

Za pomocą importu CSV generują Państwo e-faktury bezpośrednio z ustrukturyzowanego eksportu z Państwa ERP, bez okrężnej drogi przez PDF. Ta droga jest deterministyczna: dane pochodzą już czysto z Państwa systemu, rozpoznawanie nie jest potrzebne, a TaxLayer buduje z nich plik ZUGFeRD lub XRechnung 1:1 z Państwa wartości. Każdy plik jest dodatkowo automatycznie sprawdzany względem oficjalnego zestawu reguł KoSIT/Mustang (EN 16931).

> Krótko: jeden wiersz na pozycję, pola nagłówka w każdym wierszu, jeden plik na fakturę. Szablon pobierają Państwo w aplikacji w sekcji „Konwertuj PDF” w obszarze „Importuj z eksportu ERP (CSV)”.

Budowa pliku

CSV jest zbudowany według wzorca jeden wiersz na pozycję faktury. Pola na poziomie faktury (numer, data, sprzedawca, nabywca, płatność) występują w każdym wierszu i są odczytywane z pierwszego wiersza. Separatorem jest średnik. Niemieckie liczby dziesiętne (1.234,56) są rozpoznawane.

Przegląd pól

KolumnaZnaczenieObowiązkowa
invoiceNumbernumer fakturytak
issueDatedata faktury (RRRR-MM-DD)tak
deliveryDatedata dostawy/świadczeniaopcjonalna
currencyCodewaluta (domyślnie EUR)opcjonalna
buyerReferenceLeitweg-ID / referencja nabywcy (B2G)opcjonalna
orderReferencenumer zamówienia/zlecenia (BT-13)opcjonalna
sellerNamenazwa sprzedawcytak
sellerVatIdUSt-IdNr. sprzedawcytak*
sellerTaxNumbernumer podatkowy sprzedawcytak*
sellerStreet / sellerZip / sellerCity / sellerCountryadres sprzedawcyopcjonalna
sellerEmaile-mail sprzedawcyopcjonalna
buyerNamenazwa nabywcytak
buyerVatIdUSt-IdNr. nabywcyopcjonalna**
buyerStreet / buyerZip / buyerCity / buyerCountryadres nabywcyopcjonalna
iban / bicdane bankoweopcjonalna
paymentTermswarunki płatności (tekst dowolny, BT-20)opcjonalna
dueDatetermin płatnościopcjonalna
skontoDays / skontoPercentdni i procent skontaopcjonalna
deliveryNoteIdnumer dowodu dostawyopcjonalna
discountAmount / discountVatRate / discountVatCategoryrabat dotyczący całej fakturyopcjonalna
descriptionnazwa pozycjitak
quantityilośćtak
unitjednostka (np. godzina, kg, sztuka)opcjonalna
unitPricecena jednostkowa nettotak
vatRatestawka podatku w procentachtak
vatCategorykategoria podatkowa (S, AE, K, G, E, O, Z)opcjonalna

\* Wymagany jest co najmniej jeden identyfikator sprzedawcy (USt-IdNr. lub numer podatkowy).

\*\* Przy odwrotnym obciążeniu (kategoria AE) USt-IdNr. nabywcy jest obowiązkowy.

Dlaczego CSV obejmuje około 95 procent

EN 16931 definiuje około 160 pól danych, z których większość jest opcjonalna. Prawdziwa niemiecka faktura B2B potrzebuje tylko około 20 do 30 z nich i właśnie je odwzorowuje szablon. Pozostałe wartości (zestawienie podatku, wszystkie sumy) TaxLayer oblicza automatycznie z pozycji.

CSV to płaska tabela: jeden kierunek powtarzania, mianowicie wiersze. Wykorzystujemy je dla pozycji. Pojedyncze wartości można dowolnie uzupełniać jako kolejne kolumny. Czego płaski CSV nie potrafi czysto odwzorować, to wielokrotnie powtarzane, zagnieżdżone struktury: kilka rabatów dotyczących całej faktury, rabaty na pozycję lub wiele referencji. Te struktury tworzą drzewo, a dla nich odpowiednim formatem jest XML.

Skonto i rabat

Skonto podają Państwo przez skontoDays i skontoPercent. Powstaje z nich automatycznie zapis DATEV w warunkach płatności, dzięki czemu skonto jest czytelne maszynowo. Jak dokładnie zbudowany jest ten wzorzec i dlaczego sam tekst dowolny wywołuje regułę BR-DE-18, wyjaśnia artykuł Skonto w XRechnung i ZUGFeRD. Rabat dotyczący całej faktury podają Państwo przez discountAmount; jest prowadzony jako osobna pozycja z kwotą ujemną i obniża podstawę opodatkowania.

A potem?

Po przesłaniu dane trafiają do znanego etapu weryfikacji. Tam sprawdzają Państwo kwoty, stawki podatku i jednostki, a następnie generują sprawdzoną e-fakturę. Import CSV jest jednocześnie najprostszą drogą do konwersji wielu faktur naraz, ponieważ jeden plik na fakturę jest przetwarzany zbiorczo. Pierwsze 2 konwersje miesięcznie są bezpłatne: przetestuj teraz.

Najczęściej zadawane pytania

Jak zbudowany jest plik CSV?

Jeden wiersz na pozycję faktury. Pola nagłówka faktury (numer, data, sprzedawca, nabywca, płatność) występują w każdym wierszu i są przejmowane z pierwszego wiersza. Jeden plik odpowiada jednej fakturze.

Które pola są obowiązkowe?

invoiceNumber, issueDate, sellerName, identyfikator sprzedawcy (sellerVatId lub sellerTaxNumber), buyerName oraz dla każdej pozycji description, quantity, unitPrice i vatRate. Wszystko inne jest opcjonalne.

Czy CSV obejmuje wszystkie pola EN 16931?

Około 95 procent przypadków z praktyki. EN 16931 ma około 160 pól danych, z których większość jest opcjonalna. Płaski CSV odwzorowuje wszystkie pojedyncze wartości (nagłówek, strony, płatność, skonto, jeden rabat, data dostawy). Nie da się odwzorować wielokrotnie powtarzanych, zagnieżdżonych struktur, takich jak kilka rabatów dotyczących całej faktury lub rabaty na pozycję. Do tego nadaje się XML.

Jak podać skonto?

Przez kolumny skontoDays i skontoPercent. TaxLayer generuje z nich automatycznie czytelny maszynowo zapis DATEV (#SKONTO#TAGE=14#PROZENT=2.00#) w warunkach płatności (BT-20), dzięki czemu DATEV rozpoznaje skonto.

Jak podać rabat?

Przez discountAmount (kwota netto), opcjonalnie discountVatRate i discountVatCategory. Rabat jest odwzorowywany jako osobna pozycja z kwotą ujemną i obniża podstawę opodatkowania podanej stawki podatku. Dla faktur z jedną stawką podatku jest to dokładne; przy mieszanych stawkach lepiej podać rabat jako osobną pozycję dla każdej stawki.

Czy mogę zaimportować kilka faktur w jednym pliku?

Obecnie jedną fakturę na plik. W przypadku wielu faktur proszę przesłać kilka plików lub skontaktować się z nami w sprawie zautomatyzowanej integracji.

Konwertuj swoje faktury PDF teraz

Wypróbuj TaxLayer za darmo – 2 konwersje miesięcznie, bez karty kredytowej.

Rozpocznij