Vollständiger Leitfaden zur
brasilianischen NF-e-Extraktion

Die Datenextraktion aus einer brasilianischen NF-e unterscheidet sich grundlegend von der aus einer normalen Rechnung. Eine Standardrechnung im PDF-Format erfordert OCR oder KI-basiertes Dokumentenverständnis, um Felder aus einem visuellen Layout zu lesen. Eine NF-e liegt als XML-Datei vor – von Natur aus maschinenlesbar – mit einer Struktur, die von der brasilianischen Steuerbehörde SEFAZ anhand von über 400 automatisierten Regeln validiert wurde, bevor die darin beschriebenen Waren überhaupt das Lager verlassen durften.

Die Herausforderung liegt nicht in der Datenverfügbarkeit, sondern in der Datenkomplexität. Eine europäische Peppol-BIS-Rechnung verwendet etwa 100 XML-Elemente. Eine NF-e nach Layoutversion 4.0 enthält mehr als 500 strukturierte Elementgruppen, die über mehrere verschachtelte Ebenen verteilt sind, mit vier separaten Steuerberechnungszweigen pro Position – jeder mit eigenem Steuersituationscode, Bemessungsgrundlage, Steuersatz und Kreditregel. Die Daten sind vollständig – aber ihre korrekte Extraktion erfordert das Verständnis der Bedeutung jedes Feldes und seiner Verknüpfung mit anderen.

Dieser Leitfaden dient als Arbeitsreferenz. Wenn Sie zum ersten Mal einen NF-e-Extraktionsworkflow einrichten, beginnen Sie mit der Schritt-für-Schritt-Anleitung in Abschnitt 2. Wenn Sie bereits eine Extraktionspipeline betreiben und einen bestimmten ICMS-Satz validieren oder einen CFOP-Code nachschlagen müssen, springen Sie zu den Referenztabellen in den Abschnitten 3 bis 6. Jeder Abschnitt ist eigenständig nutzbar, aber der volle Wert ergibt sich aus dem Gesamtbild: zu wissen, welche Felder extrahiert werden müssen, wie man ihre Richtigkeit überprüft und was zu tun ist, wenn die NF-e mit einem Stornierungsereignis oder einem Kontingenzindikator eintrifft.

Was NF-e-Extraktion von der normalen Rechnungsextraktion unterscheidet

Drei strukturelle Unterschiede bestimmen, wie die NF-e-Extraktion funktioniert und warum ein Standardansatz zur Rechnungsextraktion – PDF hochladen, Spalten definieren, Daten erhalten – nur einen Teil des Problems löst.

1. Die Quelle ist XML, kein visuelles Dokument. Die normale Rechnungsextraktion ist ein Leseproblem: Die KI oder OCR muss Text auf einer Seite lokalisieren, erkennen, welche Zeichenfolge die Rechnungsnummer ist, und sie der richtigen Spalte zuordnen. Die NF-e-Extraktion ist ein Parse- und Zuordnungsproblem: Die Daten liegen bereits in maschinenlesbaren Tags vor, aber die XML-Struktur verwendet portugiesische Tag-Namen (<emit> für Aussteller, <dest> für Empfänger, <imposto> für Steuern) und tief verschachtelte Hierarchien, die je nach Steuerregime variieren. Die Herausforderung verschiebt sich von „Daten finden" zu „den richtigen XML-Pfad jeder Ausgabespalte zuordnen".

2. Die Steuerstruktur ist mehrdimensional. Eine einzelne NF-e-Position enthält bis zu vier unabhängige Steuerberechnungen – ICMS (bundesstaatlich, mit über 10 Varianten je nach CST-Code), IPI (Bundesverbrauchsteuer, produktabhängig), PIS und COFINS (bundesstaatliche Sozialabgaben). Jede Steuer hat ihre eigene Bemessungsgrundlage, ihren eigenen Satz, ihren eigenen CST (Steuersituationscode) und eigene Regeln zur Steuergutschrift. Anders als bei einer EU-Mehrwertsteuerrechnung, bei der ein Steuersatz für die gesamte Position gilt, enthält eine NF-E-Position separate Untergruppen für <ICMS>, <IPI>, <PIS> und <COFINS>, jede mit potenziell unterschiedlichen Bemessungsgrundlagen. Nur die Summen zu extrahieren, übersieht die Details, die entscheiden, ob jede Steuergutschrift korrekt berechnet wurde.

3. Der Extraktionsworkflow muss Ereignisse nach der Ausstellung berücksichtigen. Eine NF-e kann innerhalb von 24 Stunden storniert werden. Sie kann eine Carta de Correção (CC-e) erhalten, die bestimmte Felder korrigiert. Sie kann im Notfallmodus ausgestellt werden, wenn SEFAZ nicht erreichbar war. Sie löst empfängerseitige Ereignisse aus, die sogenannte manifestação do destinatário – eine rechtliche Verpflichtung des Käufers, den Erhalt zu bestätigen, die Transaktion anzuerkennen oder abzulehnen. Eine vollständige Extraktionspipeline muss diese ereignisgesteuerten Änderungen verarbeiten, nicht nur das ursprüngliche XML extrahieren und die Sache als erledigt betrachten. Für einen tieferen Einblick, wie Stornierungs- und Notfallregeln AP-Workflows beeinflussen, lesen Sie unsere Analyse der NF-e-Verarbeitungskomplexität.

Diese drei Unterschiede bedeuten, dass NF-e-Extraktion nicht „Rechnungsextraktion mit portugiesischen Feldnamen" ist. Sie ist eine eigene Kategorie – näher am EDI-Parsing als an der Dokumenten-OCR, aber mit einer Steuerkomplexität, die die meisten EDI-Standards um Größenordnungen übertrifft. Für einen Blick auf das andere große lateinamerikanische elektronische Rechnungssystem mit seinen eigenen strukturellen Komplexitäten, lesen Sie unseren vollständigen Leitfaden zur mexikanischen CFDI-Extraktion.

Der vollständige NF-e-Extraktions-Workflow: Schritt für Schritt

Ein durchgängiger NF-e-Extraktions-Workflow – ob manuell, skriptbasiert oder KI-gesteuert – folgt stets derselben logischen Abfolge. Jeder Schritt erzeugt eine spezifische Ausgabe, die als Eingabe für den nächsten dient.

NF-e-XML-Feldzuordnungs-Referenz

Die folgenden Tabellen ordnen die wesentlichen NF-e-XML-Pfade den Spalten einer Tabelle zu. Felder sind nach Kritikalität bewertet: Kritisch (erforderlich für die grundlegende Verarbeitung), Wichtig (erforderlich für Steuerprüfung und Gutschrift-Rückgewinnung) und Nischen (erforderlich für spezifische Szenarien wie Zoll oder SPED-Meldungen). Alle Pfade beziehen sich auf den Standard-NF-e-XML-Namensraum.

Kopffelder (Eine Zeile pro Rechnung)

Positionen-Felder (Eine Zeile pro Produktzeile)

Jedes <det>-Element innerhalb von <infNFe> repräsentiert eine Produktzeile. Das Attribut nItem gibt die Zeilennummer an (beginnend mit 1). Die folgenden Felder wiederholen sich für jedes <det>:

Wichtiger Hinweis zu ICMS-Untergruppen: Der ICMS-XML-Pfad innerhalb von <imposto> variiert je nach CST-Code. Ein normal besteuertes ICMS verwendet die Untergruppe <ICMS00>. Andere CST-Codes verwenden <ICMS10> (besteuert + ST), <ICMS20> (reduzierte Bemessungsgrundlage), <ICMS30> (ST, von regulärem ICMS befreit), <ICMS40> (befreit), <ICMS51> (aufgeschoben), <ICMS60> (bereits erhoben), <ICMS90> (sonstige), <ICMSPart> (DIFAL – Steuersatzdifferenz zwischen Bundesstaaten) und <ICMSST> (Steuersubstitution). Ihre Extraktionszuordnung muss all diese Varianten abdecken, nicht nur <ICMS00>.

Steuerprüfung: So überprüfen Sie Ihre extrahierten Nummern

Eine NF-e-XML enthält die eigenen Steuerberechnungen des Lieferanten, die fehlerhaft sein können. SEFAZ prüft, ob die XML-Struktur vollständig und die grundlegende Arithmetik konsistent ist, aber nicht, ob der korrekte ICMS-Satz für das Ursprungs-Ziel-Paar verwendet wurde oder ob der IPI-Satz dem offiziellen TIPI-Satz der NCM-Nummer entspricht. Diese Prüfung liegt in Ihrer Verantwortung als Käufer – und sie ist die häufigste Quelle für erstattungsfähige Überzahlungen in der brasilianischen AP.

ICMS-Interstatesatz-Prüfung nach Bundesstaat-Paar

Der ICMS-Satz für eine Interstate-Transaktion hängt vom Ursprungsstaat (wo der Lieferant versendet) und dem Zielstaat (wo Ihr Unternehmen ansässig ist) ab. Nutzen Sie diese Tabelle, um zu prüfen, ob der ICMS-Satz auf der NF-e dem korrekten Satz für das Bundesstaat-Paar entspricht:

Wenn der ICMS-Satz auf der NF-e nicht dem erwarteten Satz für das Ursprungs-Ziel-Paar (von <emit>/<enderEmit>/<cUF> nach <dest>/<enderDest>/<cUF>) entspricht, markieren Sie das Dokument zur Überprüfung. Satzabweichungen gehören zu den häufigsten Fehlern auf brasilianischen Lieferantenrechnungen und können zu falschen Steuergutschriftsberechnungen führen.

CST-Codes: Die Steuersituationscodes, die alles verändern

Der CST (Código da Situação Tributária) ist ein dreistelliger Code, der angibt, wie eine Steuer angewendet wurde – nicht nur den Steuersatz. Jede ICMS-, IPI-, PIS- und COFINS-Berechnung auf einer NF-e hat ihren eigenen CST. Die erste Ziffer des CST gibt die Herkunft des Steuerregimes an (0=inländisch, 1=ausländisch, 2=ausländisch mit Inlandsanteil – variiert je nach Steuer). Speziell für ICMS bestimmt der CST, ob die ICMS steuerpflichtig, befreit, aufgeschoben, substituiert (ST) oder durch ein Sonderregime erhoben wird. Die dreistelligen ICMS-CST-Codes folgen einer bestimmten Logik:

Ihr Extraktionsworkflow sollte immer den CST-Code zusammen mit dem Steuerbetrag erfassen – eine „ICMS Null“ mit CST 40 (befreit) ist eine völlig andere Situation als eine „ICMS Null“ mit CST 00 (Fehler). Der CST bestimmt, ob Null eine legitime steuerliche Behandlung oder eine Datenlücke ist, die Sie untersuchen müssen.

IPI-, PIS- und COFINS-Prüfung

IPI-Prüfung: Der IPI-Satz wird durch den NCM-Code des Produkts bestimmt. Brasilien veröffentlicht die TIPI (Tabela de Incidência do IPI), eine umfassende Satztabelle, die jedem NCM-Code einen IPI-Satz zuordnet. Da Sie die vollständige TIPI-Tabelle nicht intern pflegen können (sie enthält tausende Einträge und wird regelmäßig von der Receita Federal aktualisiert), können Sie hochwertige Positionen stichprobenartig prüfen: Extrahieren Sie den NCM, schlagen Sie die TIPI-Satzspanne nach und bestätigen Sie, dass das pIPI-Feld im erwarteten Bereich liegt. Auch der IPI-CST-Code ist wichtig – CST 50 bedeutet IPI-Befreiung, während 00 die Steuerpflicht anzeigt.

PIS- und COFINS-Prüfung: Diese Bundesabgaben werden entweder im kumulativen oder nicht-kumulativen System erhoben. Das System wird durch die Steuerklassifikation des Lieferanten bestimmt und regelt sowohl den Satz als auch die Verfügbarkeit von Gutschriften für Sie als Käufer:

Liegt der PIS-Satz auf der NF-e bei 1,65 % und der COFINS-Satz bei 7,6 %, ist der Lieferant im nicht-kumulativen System und Sie können PIS/COFINS-Vorsteuergutschriften geltend machen. Bei Sätzen von 0,65 % und 3,0 % sind keine Gutschriften verfügbar. Der CST des Lieferanten (in der Regel 01 = nicht-kumulativ oder 02 = kumulativ) bestätigt das System. Die Extraktion und Prüfung dieser Sätze wirkt sich direkt auf Ihre erstattungsfähige Steuerposition aus.

ICMS-Steuerersatzverfahren (ICMS-ST): Der Mechanismus, den Sie nicht ignorieren können

ICMS-ST (Substituição Tributária) ist ein Mechanismus, bei dem die Steuerbehörde die Verantwortung für die Erhebung der ICMS auf die gesamte Lieferkette dem ersten Glied überträgt – in der Regel dem Hersteller oder Importeur. Anstatt dass jeder Käufer in der Kette (Hersteller → Großhändler → Einzelhändler) ICMS auf seine eigene Marge zahlt, erhebt der Hersteller die ICMS auf den mutmaßlichen Endverkaufspreis an den Verbraucher zu Beginn der Kette. Diese "Substitution" des Steuerpflichtigen verlagert den Steuererhebungszeitpunkt stromaufwärts.

Für AP-Teams, die NF-e-Dokumente verarbeiten, tritt ICMS-ST in zwei Szenarien auf:

Szenario 1 – Ihr Unternehmen ist in der Mitte der Kette (Kauf vom substituierten Teil). Sie kaufen Waren von einem Großhändler, der sie bereits unter ST vom Hersteller gekauft hat. Die NF-e enthält die reguläre ICMS (CST 00, normal besteuert) und einen separaten ICMS-ST-Betrag (CST 10, unter <ICMS10> oder <ICMSST>). Ihre Extraktion muss beide erfassen: Die reguläre ICMS ist Ihre Vorsteuer; die ICMS-ST ist keine Vorsteuer – es ist eine kosteninklusive Abgabe, die bereits vom vorgelagerten Lieferanten an SEFAZ abgeführt wurde. Sie können sie nicht zurückfordern.

Szenario 2 – Ihr Unternehmen ist das letzte Glied (Einzelhändler oder Endverbraucher). Sie kaufen von einem Lieferanten, der der ST-substituierte Teil ist. Die NF-e enthält einen einzigen ICMS-ST-Betrag (CST 30 – von regulärer ICMS befreit, ST gilt). Die gesamten ICMS-Kosten der Kette sind in diesem einen Betrag enthalten. Ihre Extraktion erfasst nur die ST-Felder, und es ist keine reguläre ICMS-Vorsteuer verfügbar.

Um in Ihrem Extraktionsworkflow zwischen diesen beiden Szenarien zu unterscheiden, prüfen Sie den CST-Code: CST 10 = reguläre ICMS + ST (Sie erhalten Teilgutschriften), CST 30 = nur ST (keine regulären ICMS-Gutschriften). Der ICMS-ST-XML-Pfad verwendet eine separate Untergruppe: <imposto>/<ICMS>/<ICMSST>/<vICMSST> für den ST-Betrag und <vBCST> für die ST-Berechnungsgrundlage. Extrahieren Sie diese als separate Spalten von der regulären ICMS – summieren Sie sie niemals in einem einzigen Feld "Gesamt-ICMS". Einige AP-Teams summieren reguläre ICMS und ST und buchen einen kombinierten Betrag, was ihre ICMS-Vorsteuerposition überbewertet und Prüfungsfeststellungen auslöst.

CFOP und NCM: Die Klassifikationscodes, die die Steuerkonformität steuern

Jede Position einer NF-e enthält zwei Codes, die gemeinsam die steuerliche Behandlung dieses Produkts bestimmen. Sie sind keine optionalen Metadaten – sie sind die Eingaben für Ihre Steuerermittlungslogik.

CFOP-Code-Referenz (Klassifikation nach erster Ziffer)

Der CFOP (Código Fiscal de Operações e Prestações) ist ein vierstelliger Code, dessen erste Ziffer die Richtung und Art der Transaktion angibt. Bei der Verarbeitung eingehender (kaufseitiger) NF-e begegnen Ihnen am häufigsten CFOP-Codes aus den Bereichen 1xxx, 2xxx und 3xxx:

Warum CFOP für die Extraktion wichtig ist: Der CFOP-Code bestimmt, welche ICMS-Regeln auf die Transaktion angewendet werden. Ein CFOP, der mit 1 beginnt (innerstaatlich), bedeutet, dass der ICMS-Satz der interne Satz des Lieferantenstaates sein sollte (17-22 %), nicht ein zwischenstaatlicher Satz. Ein CFOP, der mit 2 beginnt (zwischenstaatlich), bedeutet, dass der Satz der obigen Tabelle der zwischenstaatlichen Sätze entsprechen sollte. Wenn CFOP und ICMS-Satz inkonsistent sind – z. B. CFOP 1102 (innerstaatlich) mit ICMS-Satz 12 % (ein zwischenstaatlicher Satz) – liegt eine strukturelle Diskrepanz in der Rechnung vor, die korrigiert werden muss. Ihr Extraktionsworkflow sollte dies automatisch kennzeichnen.

NCM-Code: Die Produktklassifikation, die IPI und Einfuhrzölle bestimmt

Der NCM (Nomenclatura Comum do Mercosul) ist ein achtstelliger Produktklassifikationscode, der auf dem Harmonisierten System (HS) basiert und um zwei Mercosur-spezifische Ziffern ergänzt wird. Format: NNNN.NN.NN (wobei die ersten 6 Ziffern der HS-Code sind). Der NCM-Code bestimmt:

• IPI-Satz: Wird über die TIPI-Tabelle zugeordnet. Produkte mit NCM, die mit bestimmten Kapiteln beginnen, unterliegen höheren oder niedrigeren IPI-Sätzen.
• ICMS-ST-Anwendbarkeit: Bestimmte NCM-Kapitel unterliegen länderübergreifend verbindlichen ICMS-ST-Protokollen (Convênios).
• Einfuhrzoll (II) für internationale Käufe.
• Ersatzsteuersatz (z. B. vereinfachte ICMS-ST-Berechnungen gemäß CONFAZ-Protokoll).

Bei der Extraktion sollte der NCM stets als Textfeld unter Beibehaltung führender Nullen erfasst werden. Nie in eine Zahl umwandeln – NCM 8471.30.00 (Computerausrüstung) würde bei numerischer Behandlung seine führende Struktur verlieren. Der NCM dient auch als Primärschlüssel für die Suche nach IPI-Sätzen, falls Ihr Workflow eine automatische Satzprüfung umfasst.

Umgang mit NF-e-Sonderereignissen in Ihrem Extraktions-Workflow

Eine NF-e ist kein statisches Dokument. Sie kann durch eine Reihe rechtlich definierter Ereignisse geändert, storniert oder neu ausgestellt werden. Ein vollständiger Extraktions-Workflow muss diese Ereignisse berücksichtigen, da sie die bereits extrahierten Daten verändern können.

Stornierung. Der Aussteller kann eine NF-e innerhalb von 24 Stunden nach Erhalt des Autorisierungsprotokolls stornieren, sofern die Ware nicht physisch bewegt wurde. Das Stornierungsereignis wird bei SEFAZ registriert und mit demselben Zugangsschlüssel verknüpft. Nach 24 Stunden ist eine Stornierung nicht mehr möglich – der Aussteller muss eine Sonderstornierung bei der Steuerbehörde beantragen oder eine Gutschrift (NF-e de devolução) ausstellen. Für Ihren Extraktions-Workflow: Die wichtigste Prüfung ist, den NF-e-Status zum Zeitpunkt der Extraktion und erneut vor der Zahlung zu überprüfen. Wenn Sie NF-e-Dokumente programmatisch verarbeiten, integrieren Sie einen Statusprüfungsschritt, der den SEFAZ-Webdienst ConsNFeDest nach der Statusliste der empfangenen NF-e des Käufers abfragt.

Carta de Correção (CC-e). Wenn der Lieferant ein Feld auf einer bereits autorisierten NF-e korrigieren muss (z. B. Produktbeschreibung korrigieren, Lieferadresse berichtigen, Zahlungsfälligkeitsdatum aktualisieren), stellt er eine CC-e aus – ein elektronisches Korrekturschreiben, das mit dem Zugangsschlüssel der NF-e verknüpft ist. Die CC-e ersetzt nicht die XML-Datei, sondern ändert bestimmte Felder. Ihr Extraktions-Workflow sollte bei der Verarbeitung von NF-e-Dokumenten abfragen, ob für diesen Zugangsschlüssel CC-e-Ereignisse vorliegen. Die Stapelverarbeitung von ImageToTable.ai bietet die Option, extrahierte Dokumente auf Korrekturereignisse zu prüfen – denn wenn der Lieferant das Fälligkeitsdatum per CC-e korrigiert hat und Ihr Workflow das Fälligkeitsdatum der ursprünglichen XML-Datei verwendet hat, zahlen Sie nach dem falschen Zeitplan.

Notfallmodi. Wenn SEFAZ nicht erreichbar ist, können Lieferanten NF-e im Notfallmodus ausstellen. Die Emissionsart (<ide>/<tpEmis>) gibt die Notfallmethode an: 2 = FS-DA (getippter DANFE), 3 = EPEC (Vorereignis-Notfall), 4 = DPEC (elektronischer Notfall), 5 = FS-IA (Formular-Notfall), 6 = SVC (SEFAZ Virtual Contingency – ein Backup-Autorisierungsserver). Im Notfallmodus fehlt der NF-e zum Zeitpunkt der Extraktion möglicherweise das vollständige SEFAZ-Autorisierungsprotokoll. Ihr Workflow sollte im Notfallmodus ausgestellte Dokumente zur Nachverfolgung kennzeichnen: Sobald das System wiederhergestellt ist, übermittelt der Lieferant die vollständige NF-e, und Sie sollten die endgültige XML-Datei abrufen und erneut extrahieren, falls sich Felder geändert haben.

Manifestação do Destinatário. Dies ist kein Lieferantenereignis, sondern eine Pflicht des Käufers. Nach brasilianischem Recht muss der Käufer von Waren seine Ereignisantwort innerhalb bestimmter Fristen im SEFAZ-Portal registrieren: Bestätigung des Erhalts innerhalb von 10 Tagen nach Ausstellung sowie Annahme oder Ablehnung der Transaktion. Dieser Vorgang wird als manifestação do destinatário bezeichnet und über die DF-e-Plattform von SEFAZ verwaltet. Obwohl die Manifestação ein separater Compliance-Schritt ist, sollte Ihr Extraktions-Workflow den Zugangsschlüssel jeder verarbeiteten NF-e in einem Manifestação-Tracking-System erfassen, damit die Compliance-Abteilung die erforderlichen Ereignisse rechtzeitig melden kann. Wenn Sie die Manifestação nicht registrieren, geht SEFAZ davon aus, dass die Transaktion nicht bestätigt wurde, was zukünftige NF-e-Ausstellungen dieses Lieferanten blockieren kann.

Für einen tieferen Einblick in diese Ereignistypen und deren Auswirkungen auf die Kreditorenbuchhaltung lesen Sie unsere Analyse der NF-e-Verarbeitungskomplexität.

Extraktionsmethoden im Vergleich: Welcher Ansatz passt zu Ihrem Volumen

Es gibt vier gängige Methoden zur Extraktion von NF-e-Daten. Die richtige hängt von Ihrem Volumen, Ihren technischen Ressourcen und davon ab, ob Sie Steuerdetails auf Positionsebene oder nur Kopfsummen benötigen.

Der entscheidende Unterschied für NF-e ist, ob die Extraktionsmethode sowohl DANFE als auch XML verarbeitet. Wenn Ihre Lieferanten eine Mischung senden – einige übermitteln die XML direkt, andere drucken und versenden nur die DANFE – benötigen Sie eine Methode, die beide Quellen konsistent verarbeitet. ImageToTable.ai unterstützt beides: Sie können rohe NF-e-XML-Dateien zusammen mit DANFE-PDFs im selben Batch hochladen, eine einzige Spaltenvorlage definieren und erhalten eine einheitliche Tabelle. Das Tool verarbeitet auch die oben beschriebenen variablen ICMS-Untergruppenpfade – ein erheblicher Vorteil, wenn die Schema-Komplexität Scripting-Teams zwingt, Dutzende von XPath-Varianten zu pflegen. Eine praktische Anleitung zur Batch-Verarbeitung mehrerer NF-e-Dokumente finden Sie in unserem Leitfaden zur Batch-NF-e-Verarbeitung.

Extraktions-Workflow für die Steuerreform 2026 vorbereiten

Die brasilianische Verfassungsänderung 132/2023 und das Ergänzungsgesetz 214/2025 führen ein duales Mehrwertsteuersystem ein, das fünf bestehende Steuern durch zwei neue ersetzt. Für die NF-e-Extraktion bedeutet dies, dass das heute verwendete XML-Schema während einer Übergangsphase von August 2026 bis 2033 sowohl alte als auch neue Steuerfelder enthalten wird. Hier erfahren Sie, was sich auf Extraktionsebene ändert und was Sie tun müssen.

Bleibt gleich: Die gesamte XML-Struktur (<ide>, <emit>, <det>, <total>) bleibt unverändert. Kopffelder, Positionsmengen, NCM-Codes und CFOP-Codes sind nicht betroffen.

Ändert sich: Neue XML-Elementgruppen werden zum <imposto>-Abschnitt jeder Position und zur <total>-Zusammenfassung hinzugefügt. Die neuen Gruppen enthalten CBS- (Bundes-) und IBS- (Staats-/Gemeinde-) Steuerberechnungen neben den bestehenden ICMS-, IPI-, PIS- und COFINS-Feldern. Während der Übergangsphase müssen Sie beide Feldsätze extrahieren und für nachgelagerte Systeme bereithalten.

Drei praktische Schritte zur Vorbereitung Ihres Extraktions-Workflows:

Häufig gestellte Fragen

Muss ich XML-Namespaces beim Extrahieren von NF-e-Feldern berücksichtigen?

Ja. Das NF-e-XML verwendet einen Standard-Namespace, der auf dem Element <nfeProc> deklariert ist (typischerweise xmlns="http://www.portalfiscal.inf.br/nfe"). Jede XPath-Abfrage muss diesen Namespace entweder registrieren (in Pythons lxml: ns = {'nfe': 'http://www.portalfiscal.inf.br/nfe'}) oder local-name() verwenden, um ihn zu umgehen. Der XML-Connector von Power Query behandelt Namespaces in den meisten Fällen automatisch. Falls Ihr Extraktionstool eine explizite Namespace-Registrierung erfordert, stellen Sie sicher, dass die korrekte URI verwendet wird – eine Abweichung führt stillschweigend zu leeren Ergebnismengen.

Sollte ich die Steuerbeträge der Positionen summieren und mit den Kopfsummen vergleichen?

Ja – dies ist eine der wertvollsten Prüfungen, die Sie implementieren können. Das NF-e-XML enthält Steuersummen in <total>/<ICMSTot> und die Positionsdetails in jedem <det>. Diese sollten übereinstimmen. Eine Abweichung zwischen der Summe der Positionen und der Kopfsumme ist ein Warnsignal: Sie kann darauf hindeuten, dass eine Position bei der XML-Erstellung ausgelassen wurde, ein Rabatt inkonsistent angewendet wurde oder das ERP des Lieferanten eine Konfigurationsfehler aufweist. Gleichen Sie die Steuerbeträge der Positionen mit den Kopfsummen als Standardschritt in jedem Extraktionsdurchlauf ab.

Deckt die NF-e-Extraktion die SPED-Berichtsanforderungen ab?

Nein. SPED (Sistema Público de Escrituração Digital) ist Brasiliens System für digitale Buchhaltungseinreichungen – EFD-ICMS/IPI für staatliche Steuern und EFD-Contribuições für Bundesabgaben – die Daten in bestimmten SPED-Formaten erfordern und über zertifizierte Software eingereicht werden müssen. Die NF-e-Extraktion überführt die Rechnungsdaten in eine Tabelle; sie erzeugt keine SPED-konformen Datensätze. Die aus NF-e extrahierten Daten (ICMS, PIS, COFINS, CFOP, NCM, CST auf Positionsebene) sind jedoch dieselben Daten, die in SPED-Meldungen einfließen. Wenn Ihr Extraktionsworkflow die Steuerdetails korrekt auf Positionsebene erfasst, kann Ihr brasilianisches Buchhaltungsteam diese Daten nutzen, um die erforderlichen SPED-Datensätze zu befüllen, anstatt sie aus Quelldokumenten neu zu erfassen. Die Abbildung von NF-e-Feldern auf SPED-Layout-Positionen ist ein separater Transformationsschritt, den einige ERP-Lokalisierungsmodule automatisch durchführen.

Was ist, wenn mein Unternehmen mehrere CNPJs in verschiedenen brasilianischen Bundesstaaten hat?

Dies ist bei größeren Organisationen üblich. Jeder CNPJ (oder "estabelecimento" auf Portugiesisch) ist eine separate rechtliche Einheit für Steuerzwecke, und der Bestimmungsstaat in der NF-e entspricht dem CNPJ, der die Waren erhalten hat. Beim Extrahieren von NF-e-Daten für eine Organisation mit mehreren Einheiten filtern Sie Ihre Extraktionsausgabe nach dem CNPJ des Empfängers (<dest>/<CNPJ>) und pflegen Sie separate GL-Zuordnungen pro Einheit. Die ICMS-Satzprüfung unterscheidet sich ebenfalls pro Einheit – Waren, die an Ihren CNPJ in São Paulo versendet werden, unterliegen anderen Sätzen als Waren, die an Ihren CNPJ in Bahia versendet werden, selbst vom selben Lieferanten. Weitere Informationen zum Umgang mit Brasiliens Komplexität auf Bundesstaatsebene finden Sie in unserem Leitfaden zur erschwinglichen NF-e-Extraktion.

Was passiert, wenn sich der NCM-Code ändert, während ich bereits Daten aus einem vergangenen Zeitraum extrahiert habe?

NCM-Codes werden regelmäßig von der Receita Federal aktualisiert (in der Regel jährlich, manchmal aber auch mit unterjährigen Anpassungen durch Notas Técnicas). Wenn sich ein NCM-Code ändert, kann sich auch der IPI-Satz für diese Produktklassifikation ändern. Für Extraktionszwecke sollten Sie den NCM-Code erfassen, wie er zum Zeitpunkt der Ausstellung auf der NF-e steht – es ist der Code, der am Rechnungsdatum gültig war, und er bestimmt die Steuern, die rechtlich geschuldet waren. Wenn Sie eine retrospektive Analyse oder SPED-Anpassungen durchführen, verwenden Sie den NCM, wie er im Originaldokument aufgezeichnet ist, nicht die aktuelle NCM-Liste.

Was ist, wenn die NF-e-XML des Lieferanten fehlende oder fehlerhafte Elemente enthält?

Das kommt vor. Die häufigsten Probleme sind: fehlende <cobr>-Gruppe (Abrechnung), unvollständige Adresse in <enderEmit> oder ICMS-Untergruppen, die nicht dem erwarteten Schema-Varianten für den deklarierten CST-Code entsprechen. Ihr Extraktionsworkflow sollte diese elegant behandeln – geben Sie null oder einen Platzhalter für fehlende Felder zurück und protokollieren Sie eine Validierungswarnung. Brechen Sie niemals bei nicht-kritischen fehlenden Elementen ab. Bei kritischen Feldern (Zugangsschlüssel, CNPJ, Positionssummen) sollte ein fehlender Wert die Ablehnung dieser NF-e aus dem Batch mit einer klaren Fehlermeldung auslösen. Ein Validierungszusammenfassungsbericht ist unerlässlich: Protokollieren Sie jede NF-e mit fehlenden oder anomalen Feldern, damit Ihr Team vor der Buchung im Hauptbuch nachforschen kann.

Wie gehe ich mit DIFAL (ICMS-Steuersatzdifferenz zwischen Bundesstaaten) um?

DIFAL (Diferencial de Alíquota do ICMS) kommt zur Anwendung, wenn Waren über Staatsgrenzen hinweg verkauft werden und der ICMS-Satz im Bestimmungsstaat höher ist als der zwischenstaatliche Satz am Ursprungsort. Der Käufer muss die Steuerdifferenz an seinen eigenen Staat zahlen. In der NF-e wird DIFAL durch die Untergruppe <ICMSPart> unter <imposto>/<ICMS> dargestellt. Diese Untergruppe enthält vBC (die Berechnungsgrundlage), pICMS (den bereits angewandten zwischenstaatlichen Satz), pICMSUf (den internen Satz des Bestimmungsstaates) und vICMS (den DIFAL-Betrag = Differenz zwischen den beiden Sätzen auf die Grundlage). Sie müssen den DIFAL-Betrag separat extrahieren und über Ihre staatspezifischen ICMS-Gutschrift-Workflows abwickeln – er ist nicht Teil der regulären ICMS-Gutschrift.

Sollte ich Fracht und Versicherung getrennt von den Produktwerten extrahieren?

Ja. Die NF-e-XML gliedert die Transaktion auf in Produktwert (vProd), Fracht (vFrete), Versicherung (vSeg) und sonstige Kosten (vOutro). Die ICMS-Bemessungsgrundlage umfasst oft die Summe aus Produktwert + Fracht + Versicherung + sonstige Kosten – aber nicht immer. Bei einigen Produkten wird die ICMS nur auf den Produktwert berechnet. Die separate Extraktion jeder Komponente ermöglicht Ihnen zu prüfen, ob die ICMS-Bemessungsgrundlage Ihrem Verständnis der Preisstruktur entspricht. Wenn die Fracht in der NF-e in die ICMS-Basis einfließt, Ihr ERP-Modell jedoch vorsieht, dass die Fracht außerhalb der ICMS-Basis bleibt, haben Sie einen Abstimmungsposten zu klären.

Können KI-basierte Extraktionstools die vollständige NF-e-XML verarbeiten oder nur das DANFE-PDF?

Das hängt vom Tool ab. Die KI-basierte Extraktion von ImageToTable.ai kann sowohl NF-e-XML-Dateien (strukturierte Daten) als auch DANFE-PDFs (visuelles Dokument) im selben Batch verarbeiten. Wenn Sie eine XML hochladen, liest das Tool die strukturierten Elemente direkt aus – keine OCR erforderlich – und ordnet sie Ihrer Spaltenvorlage zu. Wenn Sie ein DANFE-PDF hochladen, liest die KI den visuellen Inhalt und extrahiert die sichtbaren Felder. Der entscheidende Vorteil einer einzigen Plattform für beides ist die Konsistenz: Sie definieren eine Spaltenvorlage für „NF-e-Zugangsschlüssel", „ICMS-Betrag", „CFOP-Code", und das Tool befüllt sie aus dem jeweiligen Quelldokument. Dies macht separate Workflows für XML-basierte vs. DANFE-basierte Lieferanten überflüssig – ein häufiger Fragmentierungspunkt in brasilianischen Kreditorenbuchhaltungsprozessen.

Muss ich die Extraktionsausgabe zusammen mit der XML archivieren?

Das brasilianische Recht schreibt vor, dass die originale NF-e-XML für fünf Jahre ab Ende des Geschäftsjahres, in dem die Transaktion stattfand, archiviert werden muss. Die Extraktionsausgabe (Ihre Tabelle oder ERP-Daten) ersetzt nicht die XML. Dennoch ist es bewährte Praxis, eine strukturierte Extraktionsausgabe zusammen mit dem rohen XML-Archiv aufzubewahren – für interne Abstimmungen und die Vorbereitung auf Betriebsprüfungen. Bei einer SEFAZ-Prüfung müssen Sie in der Regel beides vorlegen: die originalen XMLs (um die Existenz und ordnungsgemäße Autorisierung der Dokumente nachzuweisen) und Ihre Buchhaltungsunterlagen (um die Datenverarbeitung zu belegen). Ein Extraktions-Workflow, der sowohl die Quell-XML als auch die extrahierte Ausgabe automatisch in einer verknüpften Struktur archiviert – mit dem Zugangsschlüssel als Verbindungsschlüssel – spart bei der Prüfungsvorbereitung erheblich Zeit. Für kosteneffiziente Compliance-Optionen siehe unseren NF-e-Extraktionsleitfaden für kleine Unternehmen.