So extrahieren Sie NFS-e-Daten für Ihre
Brasilien-Aktivitäten (Leitfaden 2026)

Warum sich eine brasilianische Dienstleistungsrechnung von jeder anderen Rechnung unterscheidet, die Sie verarbeiten

Wenn Sie bereits mit brasilianischen Steuerdokumenten gearbeitet haben, kennen Sie wahrscheinlich die NF-e – die elektronische Warenrechnung, die jedes AP-Team in Brasilien oder im Umgang mit brasilianischen Lieferanten bearbeiten muss. Die NF-e wird auf staatlicher Ebene von der SEFAZ (Finanzamt des Bundesstaates) verwaltet, folgt einem einzigen nationalen XML-Schema (Layout-Version 4.0) und enthält ICMS (Warenverkehrssteuer) – eine Steuer auf den Warenverkehr auf staatlicher Ebene. Sie ist komplex, aber sie ist ein System.

Eine Dienstleistungsrechnung (Nota Fiscal de Serviços / NFS-e) wird auf kommunaler Ebene verwaltet. Die darauf erhobene Steuer ist die ISS (Dienstleistungssteuer) – und der Steuersatz, das Layout, der Validierungsworkflow und sogar die Anforderungen an digitale Zertifikate können von Stadt zu Stadt unterschiedlich sein. São Paulo hat seinen eigenen NFS-e-Webdienst. Rio de Janeiro hat einen anderen. Belo Horizonte einen dritten. Und 5.567 weitere Gemeinden haben jeweils ihren eigenen.

Das ist kein Randfall. Es ist die strukturelle Realität des brasilianischen Steuerföderalismus, verankert im Ergänzungsgesetz 116/2003, das jeder Gemeinde die Befugnis einräumt, ihren eigenen ISS-Steuersatz (2%–5%) festzulegen und ihre eigene Dienstleistungssteuer zu erheben. Die Bundesregierung arbeitet daran, dies über das Nationale NFS-e-System (Sistema Nacional de NFS-e / SNNFS-e) zu vereinheitlichen, dem Anfang 2026 über 1.280 Gemeinden beigetreten sind. Die Teilnahme ist jedoch freiwillig, und viele Großstädte betreiben weiterhin ihre eigenen Systeme.

Für das Team, das diese Dokumente empfängt – den AP-Sachbearbeiter, der eine PDF von einer brasilianischen Marketingagentur oder einem IT-Berater öffnet – ist die praktische Konsequenz: Keine zwei NFS-e-Dokumente sehen gleich aus. Eine in São Paulo ausgestellte Dienstleistungsrechnung platziert die Bemessungsgrundlage der ISS an einer anderen Stelle als eine in Porto Alegre ausgestellte. Die CNPJ (Unternehmenssteuernummer) des Dienstleistungserbringers befindet sich in einem Dokument im Kopfbereich und in einem anderen in einer Seitenleiste. Eine Vorlage, die für São Paulo funktioniert, scheitert in Campinas.

Aus diesem Grund scheitert die vorlagenbasierte OCR – der Ansatz, den die meisten Dokumentextraktionstools verwenden – systematisch bei NFS-e. Vorlagen gleichen Koordinaten ab. Gemeinden ändern Koordinaten. Für einen genaueren Blick auf Brasiliens andere wichtige elektronische Rechnungsart lesen Sie unseren NF-e-XML-Extraktionsleitfaden, der die staatliche Warenrechnung behandelt.

Was eine brasilianische Dienstleistungsrechnung (NFS-e) tatsächlich enthält

Bevor Sie Daten aus einer Dienstleistungsrechnung (Nota Fiscal de Serviços / NFS-e) extrahieren können, müssen Sie wissen, was darauf steht – und vor allem, was jedes Feld für Ihre Buchhaltung bedeutet. Eine NFS-e ist nicht nur eine Rechnung. Es ist ein Steuerdokument mit gesetzlich vorgeschriebenen Feldern, deren Werte Ihre Steuerpflicht, Ihren Lieferantenstammabgleich und Ihren Prüfpfad bestimmen.

Hier sind die wichtigsten Felder einer typischen NFS-e und warum jedes auf der Empfängerseite relevant ist:

Die LC-116-Dienstleistungscodeliste enthält 40 Hauptkategorien, jeweils mit Unterpositionen, die alles abdecken – von IT-Dienstleistungen (Kategorie 1) über Rechtsdienstleistungen (Position 17.14), Ingenieurwesen (Kategorie 7) bis hin zum Gesundheitswesen (Kategorie 4). Die vollständige Liste ist öffentlich im Anhang des Ergänzungsgesetzes 116/2003 verfügbar. Jede NFS-e, die Sie erhalten, trägt einen dieser Codes, und dieser Code bestimmt direkt den ISS-Steuersatz, den Ihr Dienstleistungserbringer hätte anwenden sollen.

Keines dieser Felder ist optional. Die Stadtverwaltung, die die NFS-e validiert, prüft jedes einzelne, bevor sie das Dokument autorisiert. Das bedeutet: Die Daten, die Sie für eine präzise Kreditorenbuchhaltung benötigen, existieren bereits – sie wurden von einer staatlichen Steuerbehörde geprüft, bevor die Rechnung in Ihrem Posteingang landete. Die Frage ist, ob Sie sie ohne erneutes Abtippen aus dem Dokument in Ihre Tabellenkalkulation bekommen.

Was die manuelle NFS-e-Erfassung Ihr Finanzteam kostet

Die gängige Annahme ist, dass die manuelle Eingabe von Rechnungsdaten langsam ist. Das stimmt – ein durchschnittliches einseitiges Dokument benötigt etwa 3 Minuten, um es in eine Tabellenkalkulation einzutippen. Aber speziell bei NFS-e ist Langsamkeit nicht das teuerste Problem. Das teuerste Problem ist die Fehlerfortpflanzung in Ihren Steuerunterlagen.

Ein falsch eingegebener CNPJ – eine falsche Ziffer in einer 14-stelligen Zeichenfolge – führt dazu, dass Ihre Lieferantenstammdatenabstimmung fehlschlägt und Sie den ISS-Vorsteuerabzug nicht geltend machen können, wenn Ihr Unternehmen der Quellensteuerabzugspflichtige ist. Ein falscher ISS-Steuersatz, der in Ihr ERP eingegeben wurde (2 % statt 5 %), bedeutet, dass Ihre Steuerrückstellung für den gesamten Berichtszeitraum falsch ist – möglicherweise mit Beanstandung bei einer Kommunalprüfung. Ein übersehenes Flag „ISS Retido na Fonte = Sim“ bedeutet, dass Sie ISS nicht abführen, für dessen Zahlung an die Stadtverwaltung Sie – nicht der Dienstleistungserbringer – rechtlich verantwortlich sind.

Das sind keine hypothetischen Risiken. Die brasilianischen Steuerbehörden führen elektronische Abgleiche zwischen NFS-e-Ausstellern und -Empfängern durch. Wenn Ihr Dienstleistungserbringer den Erhalt von R$50.000 von Ihrem CNPJ gemeldet hat, Ihre SPED-Aufzeichnungen aber R$48.000 ausweisen, weil zwei Rechnungen falsch eingegeben wurden, löst die Abweichung eine automatische Benachrichtigung aus – und anschließend eine formelle Anfrage.

Multiplizieren Sie das selbst mit einem moderaten Volumen. Ein mittelständisches Unternehmen mit 10 brasilianischen Dienstleistungserbringern – einer IT-Beratung, einer Marketingagentur, einer Anwaltskanzlei, einem Buchhaltungsbüro, einem Facility-Management-Unternehmen und einigen Freiberuflern – könnte monatlich 30 bis 50 NFS-e-Dokumente erhalten. Bei 3 Minuten pro Dokument sind das rund 2,5 Stunden manuelle Erfassung. Doch die eigentlichen Kosten sind nicht die 2,5 Stunden. Es ist der Korrekturzyklus: die Abstimmungstabelle, die nicht aufgeht, der Anruf beim Dienstleistungserbringer mit der Bitte um ein Duplikat, die berichtigte Steuererklärung, die Buchhaltungsgebühr zur Klärung der Unstimmigkeit.

Hier wird der Begriff „Dokumentextraktion“ konkret. Es geht nicht darum, Tippzeit zu sparen. Es geht darum, die Lücke zwischen dem, was die Stadtverwaltung validiert hat, und dem, was Ihr ERP erhalten hat, zu schließen.

So bewältigt die KI-Extraktion kommunale Unterschiede – ohne Vorlagen pro Stadt

Die zentrale technische Herausforderung bei der NFS-e-Extraktion liegt nicht darin, dass die Dokumente schwer zu lesen sind. Eine Dienstleistungsrechnung (Nota Fiscal de Serviços / NFS-e) aus jeder brasilianischen Stadt ist ein klar gedrucktes, überwiegend maschinell erzeugtes Dokument. Die Herausforderung ist, dass dasselbe Feld auf Dokumenten verschiedener Städte an unterschiedlichen Positionen und mit unterschiedlichen Bezeichnungen erscheint.

Traditionelle template-basierte OCR löst dies, indem sie für jedes Feld eine rechteckige Zone definiert: „CNPJ do Prestador befindet sich bei den Koordinaten (x=150, y=320, w=200, h=30)." Das funktioniert einwandfrei – für eine Gemeinde. Bei der nächsten versagt es. Eine Vorlagenbibliothek für 5.570 Städte zu pflegen, ist nicht praktikabel. Selbst eine für die 20 Städte zu pflegen, in denen Ihre Anbieter zufällig ansässig sind, bedeutet 20 Vorlagen, die brechen, sobald die Stadtverwaltung ein Layout-Update veröffentlicht (wie São Paulo es zuletzt im August 2025 mit Version 3.2 seines NFS-e-Handbuchs tat).

Die Alternative ist die semantische Extraktion: Statt ein Feld über seine Position zu suchen, suchen Sie es über seine Bedeutung. Sie teilen der Extraktions-Engine mit: „Ich benötige die CNPJ des Dienstleistungserbringers", und die Engine liest das Dokument, versteht, dass eine 14-stellige Zahl mit der Beschriftung „CNPJ" neben „Prestador" die Steuernummer des Erbringers ist – unabhängig davon, wo sie auf der Seite steht.

Das unterscheidet sich grundlegend von OCR. OCR wandelt Pixel in Zeichen um. Semantische Extraktion – unterstützt durch visuelle Sprachmodelle – liest ein Dokument eher so, wie ein Mensch es liest: Sie versteht Beschriftungen, Kontext und Dokumentstruktur. Wenn das São-Paulo-Layout „Prestador de Serviços" oben links platziert und Porto Alegre es in eine zentrierte Kopfzeile setzt, ist das einer semantischen Engine gleichgültig. Sie sucht nicht nach einer Position. Sie sucht nach einer Bedeutung.

Der Extraktionsansatz verwendet die Benutzerdefinierte Spaltenextraktion: Sie geben die gewünschten Feldnamen in Ihre Ausgabe ein – „Anbieter-CNPJ", „Dienstleistungscode (LC 116)", „ISS-Betrag", „NFS-e-Nummer" – und die KI lokalisiert jeden Wert im Dokument, indem sie versteht, was die Beschriftung bedeutet, nicht wo sie steht. Diese Spaltennamen werden zu den Kopfzeilen Ihrer finalen Excel-Tabelle, sodass die Ausgabe ohne Neuformatierung direkt in Ihr ERP oder Buchhaltungssystem hochgeladen werden kann.

Schritt für Schritt: NFS-e-Daten in Excel extrahieren

Hier ist der praktische Arbeitsablauf zum Extrahieren von Daten aus Ihren erhaltenen NFS-e-Dokumenten in eine strukturierte Tabelle. Der Prozess funktioniert sowohl mit dem PDF/DANFSE (dem gedruckten Hilfsdokument für Dienstleistungen) als auch mit der zugrunde liegenden XML-Datei.

Umgang mit ISS-Quellensteuerabzug, mehreren Dienstleistungscodes und Batch-Szenarien

Die meisten NFS-e-Extraktionen sind unkompliziert – ein einzelner Dienstleistungserbringer, eine einzelne Dienstleistung, Standardfelder. Aber reale Finanzworkflows stoßen auf Randfälle, die wichtig sind. Hier sind drei, die manuelle Prozesse ausbremsen:

ISS-Quellensteuerabzug (ISS Retido na Fonte)

Wenn eine NFS-e mit „ISS Retido na Fonte = Sim" markiert ist, geht die Pflicht zur Abführung der ISS an die Gemeinde vom Dienstleistungserbringer auf den Dienstleistungsempfänger über – also auf Sie. Das ist kein Dateneingabehinweis. Es ist ein Steuer-Compliance-Pflichtpunkt. Ihr Finanzteam muss: (1) diese Rechnungen im Extraktionsergebnis identifizieren, (2) den abzuführenden ISS-Betrag berechnen (Steuersatz × Bemessungsgrundlage laut Rechnung) und (3) die Zahlung fristgerecht an die Stadtverwaltung der richtigen Gemeinde leisten.

Wird dieser Schritt übersehen, wurde die ISS an niemanden gezahlt – der Dienstleistungserbringer hat sie nicht gezahlt (weil er sie als einbehalten deklariert hat) und Sie haben sie nicht gezahlt (weil Sie das Kennzeichen übersehen haben). Beide Parteien sind exponiert. Ein Extraktionsworkflow, der diese Dokumente automatisch kennzeichnet – indem er das Feld „ISS Retido" als Ja/Nein-Spalte extrahiert – verwandelt ein Compliance-Risiko in eine sortierbare Tabellenspalte.

Mehrere Dienstleistungscodes auf einer Rechnung

Eine einzelne NFS-e kann mehrere Positionen enthalten, jeweils mit eigenem LC-116-Dienstleistungscode und eigenem ISS-Steuersatz. Ein IT-Beratungsunternehmen könnte „Análise e desenvolvimento de sistemas" (Code 1.01, ISS 5 % in São Paulo) und „Suporte técnico" (Code 1.07, möglicherweise mit anderem Satz) getrennt abrechnen. Wenn Sie nur den ISS-Gesamtbetrag auf Rechnungsebene extrahieren, verlieren Sie die positionsbezogene Klassifizierung, die bestimmt, ob jede Position korrekt besteuert wurde. Definieren Sie Ihre Spalten so, dass Sie Dienstleistungscodes und ISS-Beträge auf Positionsebene extrahieren, nicht nur den Beleggesamtbetrag.

Batch-Verarbeitung über mehrere Dienstleistungserbringer hinweg

Wenn Sie NFS-e-Dokumente von fünf verschiedenen Erbringern in fünf verschiedenen Städten erhalten, vervielfacht sich der Vorteil der Batch-Verarbeitung. Statt jedes PDF einzeln zu öffnen und Felder in separate Tabellenzeilen zu kopieren, laden Sie alle gemeinsam hoch. Die Extraktionsengine verarbeitet sie parallel – eine einzelne Seite dauert 5 bis 10 Sekunden – und erzeugt eine konsolidierte Tabelle mit den Daten aller Erbringer in denselben Spalten. Das ist die praktische Antwort auf das Problem der kommunalen Fragmentierung: Die KI übernimmt die Layoutunterschiede pro Dokument automatisch, und Ihr Team bearbeitet eine einzige Ausgabedatei. Für die strukturelle Analyse, warum diese Fragmentierung existiert und was sie kostet, siehe warum die NFS-e-Verarbeitung in Brasilien teurer ist, als die meisten Finanzteams denken.

Für Mengenszenarien – 50, 100 oder mehr NFS-e-Dokumente pro Monat – eliminiert Batch-Rechnungsextraktion nach Excel den Einrichtungsaufwand pro Dokument, der die manuelle Verarbeitung linear mit der Dokumentanzahl skalieren lässt.

Die Steuerreform 2026: Was sich für die NFS-e-Extraktion ändert

Brasilien befindet sich mitten in einer Steuerreform, die ISS und ICMS durch eine einheitliche IBS (Steuer auf Waren und Dienstleistungen) ersetzen und PIS/COFINS durch CBS (Sozialbeitrag auf Waren und Dienstleistungen) ablösen wird. Der Übergang ist schrittweise – bis 2033 – aber die NFS-e-Layouts werden bereits aktualisiert. São Paulo veröffentlichte im August 2025 Version 3.2 seines NFS-e-Handbuchs mit Feldern für die neue Steuerstruktur. Andere Gemeinden werden folgen.

Aus Sicht der Datenextraktion bedeutet das zwei Dinge. Erstens werden Felder, die Sie heute extrahieren (ISS-Bemessungsgrundlage, ISS-Steuersatz, ISS-Betrag), auf künftigen NFS-e-Dokumenten durch IBS/CBS-Felder ergänzt oder ersetzt. Zweitens können Sie während der Übergangszeit Rechnungen erhalten, die sowohl alte ISS-Felder als auch neue IBS-Felder enthalten – und Sie müssen beide für den Abgleich extrahieren.

Der oben beschriebene Extraktionsansatz bewältigt das natürlich. Da er nicht von festen Feldpositionen oder hartcodierten Vorlagen abhängt, werden neue Felder in einem aktualisierten NFS-e-Layout genauso extrahiert wie bestehende: Sie fügen den Spaltennamen hinzu (z. B. „IBS-Betrag"), und die KI findet ihn im Dokument. Keine Vorlagenkonfiguration erforderlich.

Für einen praktischen Leitfaden zur Extraktion von Steuerdaten aus brasilianischen Warenrechnungen – die ICMS, IPI, PIS und COFINS enthalten und einem anderen Regulierungsrahmen unterliegen – siehe unseren NF-e-XML-Extraktionsleitfaden. Wenn Sie auch brasilianische Lohnabrechnungsdokumente verarbeiten, deckt unser Holerite-Extraktionsleitfaden (Gehaltsabrechnung) diesen Workflow ab.

FAQ: Extraktion von NFS-e-Dienstleistungsrechnungen

Kann ich Daten aus einem NFS-e-PDF extrahieren, wenn ich keine XML-Datei habe?

Ja. Das PDF/DANFSE enthält alle für die Gemeinde verbindlichen Steuerfelder zur Validierung. Anders als das NF-e-DANFE – das rund 90 % der zugrunde liegenden XML-Daten auslässt – ist das NFS-e-Druckdokument eigenständiger, da die Gemeinden keinen einheitlichen Standard dafür haben, was in die XML-Datei gehört und was auf dem gedruckten Hilfsdokument erscheint. Die vollständige Liste der Felder in der obigen Anatomietabelle (CNPJ Leistungserbringer/-empfänger, LC-116-Code, ISS-Aufschlüsselung, NFS-e-Nummer, RPS-Nummer) ist in der Regel im PDF enthalten. Falls Sie jedoch Zugriff auf die XML-Datei haben, nutzen Sie diese – sie garantiert 100 % Feldabdeckung und eliminiert OCR-bedingte Ungenauigkeiten.

Funktioniert die Extraktion mit NFS-e-Dokumenten aus jeder brasilianischen Stadt?

Die semantische Extraktion liest Felder durch Verständnis des Dokumentinhalts, nicht durch Anpassung an das Layout einer bestimmten Stadt. Sie funktioniert mit NFS-e aus São Paulo, Rio de Janeiro, Belo Horizonte, Porto Alegre oder jeder anderen Gemeinde, ohne dass eine stadt-spezifische Vorlage erforderlich ist. Die Extraktionsgenauigkeit bei handschriftlichen NFS-e-Dokumenten – die selten sind (fast alle NFS-e werden maschinell erstellt) – ist jedoch geringer als bei gedruckten oder digitalen Dokumenten. Handschrifterkennung funktioniert, ist aber von Natur aus weniger genau als das Lesen von gedrucktem Text.

Was ist mit einbehaltener ISS – wie gehe ich mit der Steuerabführungspflicht um?

Extrahieren Sie das Feld „ISS Retido na Fonte“ als eigene Spalte. Jede Rechnung, bei der dieses Feld „Sim“ (oder „Ja“) lautet, sollte an Ihren Steuer-Compliance-Workflow weitergeleitet werden und nicht als Standard-Kreditoreneintrag verbucht werden. Der ISS-Satz und die ISS-Bemessungsgrundlage auf der Rechnung geben den abzuführenden Betrag an; die Gemeinde des Leistungserbringers gibt an, wohin die Abführung erfolgt. Das Extraktionstool liefert Ihnen die Daten. Die Steuerabführung selbst ist ein separater Compliance-Schritt, den Ihre Buchhaltungs- oder Steuerabteilung über das Zahlungssystem der jeweiligen Stadtverwaltung durchführen muss.

Kann ich NFS-e-Dokumente zusammen mit regulären internationalen Rechnungen stapelweise verarbeiten?

Ja. Wenn Ihre Spaltendefinitionen breit genug sind, um beide Dokumenttypen abzudecken (z. B. „Rechnungsnummer“, „Lieferantenname“, „Gesamtbetrag"), können Sie brasilianische NFS-e-Dokumente in dieselbe Stapelverarbeitung wie internationale Rechnungen aufnehmen. Die Extraktions-Engine liest jedes Dokument unabhängig und füllt die Felder, die sie findet. Für NFS-e-spezifische Felder — wie den Dienstleistungscode (LC 116) oder den ISS-Betrag — bleiben diese Spalten bei nicht-brasilianischen Rechnungen leer, was erwartet wird und keine Fehler verursacht.

Wie wirkt sich die Steuerreform 2026 auf die NFS-e-Feldextraktion aus?

Die Reform ändert nicht die Funktionsweise der Extraktion — sie ändert, welche Felder auf zukünftigen NFS-e-Dokumenten erscheinen. Wenn die Stadtverwaltungen ihre Layouts aktualisieren, um IBS- und CBS-Felder zusätzlich zu oder anstelle von ISS aufzunehmen, müssen Sie Ihre Spaltendefinitionen um die neuen Feldnamen erweitern. Der Extraktionsansatz bleibt derselbe: Fügen Sie den neuen Spaltennamen hinzu, und die KI findet den entsprechenden Wert. Der schrittweise Übergang bis 2033 bedeutet, dass Sie während der Übergangszeit wahrscheinlich Dokumente mit alten und neuen Steuerfeldern verarbeiten werden.

Benötige ich eine brasilianische Steuernummer (CNPJ), um diesen Extraktionsansatz zu nutzen?

Nein. Die Datenextraktion aus einer erhaltenen NFS-e ist eine Dokumentverarbeitungsaufgabe, keine Steuererklärung. Sie benötigen keine CNPJ, um Daten aus einer NFS-e-PDF oder -XML in eine Tabelle zu extrahieren. Die CNPJ-Felder auf dem Dokument identifizieren den Dienstleistungserbringer und den Dienstleistungsempfänger; das Extraktionstool liest sie als Datenpunkte und platziert sie in Ihren Ausgabespalten — es interagiert nicht mit einem kommunalen Steuersystem.

Von der Einzeldokument-Erfassung zur Stapelverarbeitung

Die NFS-e wurde entwickelt, um die Steuererhebung für die Regierung effizient zu gestalten — und das tut sie. Jede in Brasilien ausgestellte Dienstleistungsrechnung wird von einer kommunalen Steuerbehörde validiert, bevor sie bei Ihnen ankommt, was bedeutet, dass die Daten bereits auf Konsistenz geprüft wurden. Die Ineffizienz liegt vollständig auf der Empfängerseite: Der AP-Sachbearbeiter tippt Felder ab, die eine Maschine bereits verifiziert hat, aus einem Dokument, das je nach Stadt variiert, in eine Tabelle, die für die Steuerabstimmung korrekt sein muss.

Semantische Extraktion verändert die Empfängerseite dieser Gleichung. Die Felder sind bereits vorhanden, bereits validiert, bereits maschinenlesbar (oder fast). Sie in einem Stapel in Ihre Tabelle zu bringen, ist eine Workflow-Entscheidung, kein technischer Durchbruch. Testen Sie es mit Ihrem nächsten Stapel von NFS-e-Dokumenten — sehen Sie, ob die Zeit pro Dokument von der 3-Minuten-Markierung auf die Sekunden sinkt, die es braucht, um Ihre Spalten einmal zu definieren und die Extraktion laufen zu lassen.