TaxLayer
Księgowość2026-06-2610 min czytaniaprzez TaxLayer Team

Integracja ZUGFeRD z ERP i systemem magazynowym: pragmatyczne rozwiązanie przejściowe

Wiele firm stoi przed tym samym problemem: system ERP lub magazynowy rozrósł się, jest głęboko zintegrowany i nie da się go po prostu wymienić. Mimo to musi generować i przetwarzać e-faktury. Pragmatyczna odpowiedź brzmi ZUGFeRD i lekkie rozwiązanie przejściowe zamiast wielkiego projektu.

> Krótka odpowiedź: ZUGFeRD to hybrydowy PDF/A-3 z osadzonym XML UN/CEFACT CII, a więc idealny pomost dla istniejących systemów ERP: obieg PDF zostaje, XML dostarcza strukturę. Proszę zbudować konwerter na wyjściu, opcjonalnie middleware dla wolumenów oraz skrzynkę wpływów, która parsuje XML na potrzeby automatycznego księgowania. Dla B2G potrzebna jest czysta XRechnung.

Dlaczego akurat ZUGFeRD?

Istotą ZUGFeRD jest jego hybrydowy charakter: plik ZUGFeRD to zwykły PDF/A-3 z osadzonym XML UN/CEFACT CII. Oznacza to, że:

  • ludzie nadal widzą czytelny PDF, jak dotąd
  • maszyny (Państwa ERP, ERP Państwa klienta) odczytują osadzony XML

Dzięki temu Państwa dotychczasowy obieg wyjściowy (generowanie PDF, wysyłka e-mailem) zasadniczo pozostaje bez zmian. Dodają Państwo jedynie część z danymi strukturalnymi. Właśnie to czyni ZUGFeRD idealnym pomostem między starym światem PDF a nowym obowiązkiem e-faktury.

Które profile są w ogóle prawidłowe?

Należy uważać na profile ZUGFeRD, ponieważ nie każdy z nich jest pełnoprawną fakturą:

ProfilPrawidłowa faktura?
MINIMUMNie (tylko dane podstawowe)
BASIC-WLNie (bez pozycji)
BASICTak
EN 16931Tak
EXTENDEDTak
XRECHNUNGTak

MINIMUM i BASIC-WL wyraźnie nie są prawidłowymi fakturami w rozumieniu obowiązku e-faktury, bo zawierają tylko dane częściowe do określonych celów księgowych. Dla faktur wychodzących proszę wybrać co najmniej BASIC, w praktyce zwykle EN 16931. Więcej w artykule Profile ZUGFeRD wyjaśnione.

Wzorzec integracji w trzech elementach

Nie muszą Państwo przebudowywać swojego ERP. Sprawdził się wzorzec trzyczęściowy:

1. Konwerter lub biblioteka na wyjściu

Państwa ERP nadal generuje dane faktury. Konwerter lub biblioteka podłącza się na wyjściu i tworzy z nich plik ZUGFeRD. Rozpowszechnionym projektem open source jest Mustangproject, za pomocą którego można generować i sprawdzać ZUGFeRD/Factur-X. Alternatywnie można użyć narzędzia webowego, takiego jak TaxLayer, bez własnego programowania.

2. Middleware i mapowanie dla dużych wolumenów

Gdy generują Państwo dużo faktur, opłaca się middleware z czystym mapowaniem: przypisuje ono Państwa wewnętrzne pola (numer klienta, artykuł, klucz podatkowy) do pól EN 16931. Po prawidłowym skonfigurowaniu wysyłka masowa działa automatycznie. Jak konwertować wiele faktur naraz, pokazuje artykuł Przetwarzanie wsadowe w praktyce.

3. Skrzynka wpływów z parsowaniem XML

Dla przychodzących e-faktur proszę skonfigurować skrzynkę wpływów, która odczytuje osadzony XML i przygotowuje go do automatycznego księgowania. W przypadku ZUGFeRD dla księgowania zawsze rozstrzygający jest XML, a nie widoczny PDF.

Przepływ danych w skrócie

KrokSystemWynik
Utworzenie fakturyERP/system magazynowywewnętrzne dane faktury
KonwersjaKonwerter/bibliotekaZUGFeRD PDF/A-3 + XML
WalidacjaWalidatorzgoda na wysyłkę
WysyłkaE-mail/Peppolfaktura u klienta
OdbiórSkrzynka wpływówXML sparsowany, propozycja księgowania

Ostrożnie z urzędami (B2G)

Ważny przypadek szczególny: wiele urzędów federalnych akceptuje tylko czystą XRechnung, a nie ZUGFeRD. Niektóre kraje związkowe i gminy przyjmują ZUGFeRD od profilu EN 16931, inne nie. Jeśli dostarczają Państwo towary lub usługi sektorowi publicznemu, potrzebują Państwo dodatkowo sposobu generowania czystej XRechnung z Leitweg-ID. Szczegóły w artykule Wysyłanie XRechnung do urzędów.

Ponieważ XRechnung i ZUGFeRD opierają się na EN 16931, dodatkowy nakład pracy jest niewielki: te same dane podstawowe, inne opakowanie.

Nie pomijać walidacji

Zanim przejdą Państwo do zautomatyzowanej wysyłki masowej, proszę dokładnie przetestować wynik. Proszę wygenerować kilka próbnych faktur i sprawdzić je w walidatorze TaxLayer pod kątem EN 16931 i niemieckich reguł BR-DE. W ten sposób znajdą Państwo błędy mapowania (błędna kategoria podatkowa, brakujące pola obowiązkowe), zanim wyjdą tysiące błędnych faktur. Komunikaty o błędach można sprawdzić w katalogu Kody błędów XRechnung.

Pamiętać o archiwizacji

Także przy integracji z ERP obowiązuje zasada: oryginalny XML należy archiwizować w sposób odporny na zmiany przez 8 lat. W przypadku hybrydowego ZUGFeRD wiodącym zbiorem danych jest osadzony XML. Archiwizację proszę zaplanować od początku, szczegóły w artykule Archiwizacja e-faktur zgodnie z GoBD.

Kiedy rozwiązanie przejściowe wystarcza, a kiedy potrzeba więcej?

Rozwiązanie przejściowe oparte na konwerterze jest idealne, aby szybko i bez zmiany systemu dostosować się do przepisów. Jeśli Państwa wolumen mocno wzrośnie lub potrzebna będzie głęboka automatyzacja procesów, można później przejść na natywne rozszerzenie ERP. Zaleta pomostu: są Państwo od razu zdolni do działania, bez presji.

---

Chcą Państwo generować ZUGFeRD bez własnego programowania? TaxLayer przekształca Państwa PDF w poprawny plik ZUGFeRD lub XRechnung, idealnie jako etap wyjściowy za Państwa ERP. Wypróbuj teraz, 2 konwersje w miesiącu bezpłatnie. Pytania prosimy kierować na info@taxlayer.de.

Najczęściej zadawane pytania

Dlaczego ZUGFeRD jest idealny dla systemów ERP?

ZUGFeRD jest hybrydowy: to PDF/A-3 z osadzonym XML UN/CEFACT CII. Ludzie widzą PDF, maszyny odczytują XML. Dzięki temu Państwa dotychczasowy obieg PDF zostaje zachowany, a XML dostarcza dane strukturalne.

Które profile ZUGFeRD są prawidłowymi fakturami?

Prawidłowe są BASIC, EN 16931, EXTENDED i XRECHNUNG. MINIMUM i BASIC-WL NIE są prawidłowymi fakturami, ponieważ zawierają tylko dane częściowe. Szczegóły w artykule Profile ZUGFeRD wyjaśnione.

Czy muszę całkowicie przebudować swój ERP?

Nie. Wystarczy rozwiązanie przejściowe: konwerter lub biblioteka na wyjściu, opcjonalnie middleware przy dużych wolumenach oraz skrzynka wpływów, która parsuje osadzony XML na potrzeby automatycznego księgowania.

Czy mogę wysyłać ZUGFeRD także do urzędów?

Nie zawsze. Wiele urzędów federalnych wymaga czystej XRechnung. Niektóre kraje związkowe i gminy akceptują ZUGFeRD od profilu EN 16931. Szczegóły w artykule Wysyłanie XRechnung do urzędów.

Jaka biblioteka nadaje się do generowania?

Rozpowszechnionym projektem open source do generowania i sprawdzania ZUGFeRD/Factur-X jest Mustangproject. Alternatywnie można użyć narzędzia webowego, takiego jak TaxLayer, bez własnego programowania.

Jak upewnić się, że wynik jest poprawny?

Każdy wygenerowany plik należy sprawdzić w walidatorze TaxLayer pod kątem EN 16931 i reguł BR-DE, zanim przejdą Państwo do wysyłki masowej.

Konwertuj swoje faktury PDF teraz

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

Rozpocznij