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
| Kolumna | Znaczenie | Obowiązkowa |
|---|---|---|
| invoiceNumber | numer faktury | tak |
| issueDate | data faktury (RRRR-MM-DD) | tak |
| deliveryDate | data dostawy/świadczenia | opcjonalna |
| currencyCode | waluta (domyślnie EUR) | opcjonalna |
| buyerReference | Leitweg-ID / referencja nabywcy (B2G) | opcjonalna |
| orderReference | numer zamówienia/zlecenia (BT-13) | opcjonalna |
| sellerName | nazwa sprzedawcy | tak |
| sellerVatId | USt-IdNr. sprzedawcy | tak* |
| sellerTaxNumber | numer podatkowy sprzedawcy | tak* |
| sellerStreet / sellerZip / sellerCity / sellerCountry | adres sprzedawcy | opcjonalna |
| sellerEmail | e-mail sprzedawcy | opcjonalna |
| buyerName | nazwa nabywcy | tak |
| buyerVatId | USt-IdNr. nabywcy | opcjonalna** |
| buyerStreet / buyerZip / buyerCity / buyerCountry | adres nabywcy | opcjonalna |
| iban / bic | dane bankowe | opcjonalna |
| paymentTerms | warunki płatności (tekst dowolny, BT-20) | opcjonalna |
| dueDate | termin płatności | opcjonalna |
| skontoDays / skontoPercent | dni i procent skonta | opcjonalna |
| deliveryNoteId | numer dowodu dostawy | opcjonalna |
| discountAmount / discountVatRate / discountVatCategory | rabat dotyczący całej faktury | opcjonalna |
| description | nazwa pozycji | tak |
| quantity | ilość | tak |
| unit | jednostka (np. godzina, kg, sztuka) | opcjonalna |
| unitPrice | cena jednostkowa netto | tak |
| vatRate | stawka podatku w procentach | tak |
| vatCategory | kategoria 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.
Darmowe narzędzia
Powiązane artykuły
Konwertuj swoje faktury PDF teraz
Wypróbuj TaxLayer za darmo – 2 konwersje miesięcznie, bez karty kredytowej.
Rozpocznij