So extrahieren Sie brasilianische CT-e
Frachtdaten in Excel

Warum die CT-e-Datenextraktion für die Logistikkostenverfolgung wichtig ist

Ein brasilianischer Logistikbetrieb, der monatlich 500 CT-e-Dokumente erhält – ein typisches Volumen für einen mittelständischen Hersteller, der in den Regionen Südosten und Mittelwesten ausliefert – generiert rund 7.500 einzelne Datenpunkte, die in ein Frachtkostenbuch oder ERP gelangen müssen. Jedes CT-e enthält die CNPJ (Unternehmenssteuernummer) des Spediteurs, den Dienstleistungswert (valor do serviço), das Bruttogewicht (peso bruto), die Ursprungs- und Zielgemeinden sowie die ICMS (Warenverkehrssteuer)-Aufschlüsselung – allesamt Eingaben für die Frachtkostenzuordnung, die Spediteurleistungsanalyse und die Steuergutschriftenrückgewinnung.

In der Praxis werden diese 7.500 Datenpunkte manuell von einem Frachtanalysten eingegeben, der jedes DACTE (Documento Auxiliar do Conhecimento de Transporte Eletrônico) öffnet, das Feld findet und es in eine Tabellenzeile eintippt. Bei etwa 90 Sekunden pro Dokument für einen erfahrenen Schreibkraft – die Seite nach jedem Feld durchsuchen, auf Lesbarkeitsprobleme prüfen, zwischen Dokument und Tabelle wechseln – verbrauchen 500 CT-e-Dokumente 12,5 Stunden Dateneingabe pro Monat. Und das vor jeder Validierung, vor jedem Abgleich mit der entsprechenden Einkaufsrechnung und vor jeder Untersuchung der unvermeidlichen Abweichungen zwischen dem, was die XML-Datei des Spediteurs deklariert, und dem, was das gedruckte DACTE zeigt.

Die brasilianische Logistikinfrastruktur verarbeitet jährlich über 300 Millionen CT-e-Dokumente, und die Zahl wächst weiter, da die SEFAZ (staatliche Steuerbehörde) die Anforderungen an elektronische Dokumente ausweitet. Die Automatisierung des Extraktionsschritts – die Umwandlung der visuellen Daten des DACTE in Tabellenzeilen ohne manuelles Abtippen – ist der Unterschied zwischen einem Logistikteam, das jede Frachtkostenposition erfasst, und einem, das nur die erfasst, die es in die Tabelle geschafft haben.

Was ist ein CT-e und welche Daten enthält er?

Der Conhecimento de Transporte Eletrônico (CT-e, Modell 57) ist das obligatorische elektronische Frachtdokument Brasiliens, das von den staatlichen Steuerbehörden (SEFAZ) im gleichen digitalen Autorisierungsrahmen wie die NF-e verwaltet wird. Der CT-e wurde 2007 eingeführt und bis 2013 schrittweise für alle Frachtführer verpflichtend. Er ersetzte ein papierbasiertes System mit mehrfachen Frachtformularen, das eine Steuerdurchsetzung bei Transportdienstleistungen im großen Maßstab nahezu unmöglich machte.

Im Gegensatz zu einem traditionellen Konnossement in den meisten Ländern ist der CT-e kein Wertpapier – er kann nicht indossiert oder übertragen werden. Wie die Schifffahrtskanzlei Proinde erklärt, fungiert er gleichzeitig als Nachweis des Beförderungsvertrags, als Empfangsbestätigung der Warenlieferung und als Steuerbeleg für Dienstleistungen. Der benannte Empfänger übergibt das Dokument nicht im Austausch gegen die Ware, da der CT-e den Empfänger bereits bei der Ausstellung identifiziert und kein Risiko einer Falschlieferung besteht.

Das physische Dokument, das die Sendung begleitet – und das Ihr Logistikteam am wahrscheinlichsten in der Hand hat – ist der DACTE (Documento Auxiliar do Conhecimento de Transporte Eletrônico). Dies ist eine gedruckte oder als PDF vorliegende Zusammenfassung, die einen Teil der CT-e-XML-Daten, einen 44-stelligen Zugriffsschlüssel (Chave de Acesso) und einen QR-Code oder Barcode zur Authentifizierung auf dem CT-e-Portal enthält. Die Aufgabe des DACTE ist es, die Ware für Kontrollen zu begleiten; er selbst ist kein Steuerdokument, aber er ist die Informationsquelle, mit der die meisten Logistikteams arbeiten.

Für ein umfassenderes Verständnis, wie der CT-e in Brasiliens Ökosystem elektronischer Dokumente passt – neben der NF-e (Produktrechnung), NFS-e (Dienstleistungsrechnung) und MDF-e (elektronisches Frachtmanifest) – lesen Sie den Leitfaden für Einsteiger zur Nota Fiscal Eletrônica (NF-e), der den für alle brasilianischen Steuerdokumente gemeinsamen SEFAZ-Autorisierungsablauf behandelt.

Wichtige CT-e-Felder, die jedes Logistikteam erfassen sollte

Der DACTE enthält je nach Layoutversion des Spediteurs zwischen 30 und 50 sichtbare Datenpunkte. Für die Logistikkostenerfassung bilden die folgenden Felder die Kernspalten eines Frachtkostenjournals:

Diese 14 Felder stellen den minimalen, aber ausreichenden Satz für ein CT-e-Frachtkostenjournal dar. Die Erweiterung des Spaltensatzes um berechnete Spalten – wie z. B. „Frachtkosten pro kg (Dienstleistungswert ÷ Bruttogewicht)“ – liefert Benchmark-Daten, die mit jeder verarbeiteten Charge an Wert gewinnen.

So extrahieren Sie CT-e-Daten nach Excel: Schritt für Schritt

Der folgende Workflow wandelt DACTE-PDFs oder -Bilder mithilfe der Benutzerdefinierten Spaltenextraktion in strukturierte Tabellenzeilen um – Sie legen die gewünschten Spalten fest, und die KI findet jeden Wert auf der gedruckten Seite, indem sie die Bedeutung des Feldes versteht, nicht seine Position. Dies ist derselbe Mechanismus, der im Leitfaden zur NF-e-zu-Excel-Extraktion beschrieben wird, angepasst für CT-e-Frachtdokumente.

Schritt 1: DACTE-PDF oder -Bild hochladen

Beginnen Sie mit der rohen DACTE-Datei – einem vom Spediteur bereitgestellten PDF-Anhang, einem eingescannten Ausdruck oder einem Foto des Dokuments, das die Sendung begleitete. Das Extraktionstool akzeptiert PDF, JPG, PNG und WebP. Für beste Ergebnisse verwenden Sie ein sauberes PDF oder einen gut ausgeleuchteten Scan mit mindestens 300 DPI. Fotos von DACTE-Dokumenten, die bei schlechten Lichtverhältnissen oder in schrägen Winkeln aufgenommen wurden, können die Feldebene-Genauigkeit verringern – obwohl das KI-Visionsmodell moderate Schräglagen und Lichtschwankungen ausgleicht, die bei einer traditionellen OCR-Vorlage zu einem vollständigen Fehlschlag führen würden.

Das Hochladen mehrerer DACTE-Dateien in einem einzigen Batch ist der praktische Arbeitsablauf für jedes Team, das mehr als eine Handvoll Sendungen pro Tag verarbeitet. Die Batch-Upload-Oberfläche akzeptiert mehrere Dateien gleichzeitig und reiht sie unter demselben Batch-Namen ein, sodass ein Frachtanalyst, der 40 CT-e-Dokumente bearbeitet, alle auf einmal hochladen kann, anstatt für jedes einzelne einen neuen Upload-Dialog öffnen zu müssen.

Schritt 2: Definieren Sie die zu extrahierenden Spalten

Geben Sie die Feldnamen ein, die den benötigten CT-e-Daten entsprechen. Diese werden zu den Spaltenüberschriften Ihrer Ausgabetabelle. Die KI liest die DACTE-Seite und lokalisiert jeden Wert anhand seiner semantischen Bedeutung – „ICMS (Warenverkehrssteuer)“ wird gefunden, unabhängig davon, ob er in einem Seitenfeld, einer Fußzeilentabelle oder einer Positionsspalte erscheint, da das Modell versteht, was ICMS ist, und es in jeder Layoutposition erkennt.

Ein typischer Satz von Spaltendefinitionen für das CT-e-Fracht-Tracking:

Diese 14 Spalten erfassen die im vorherigen Abschnitt besprochenen Mindest-Kostentracking-Datenpunkte. Sie können berechnete Spalten direkt im Spaltennamen hinzufügen – zum Beispiel Frachtkosten pro kg (Valor do Serviço ÷ Peso Bruto) –, damit die KI die Stückfrachtkosten während der Extraktion berechnet, wodurch der nachgelagerte Excel-Formelschritt entfällt. Dies ist einer der drei Modi der Benutzerdefinierten Spaltenextraktion, die in der Produktdokumentation beschrieben werden: direkte Extraktion für Felder, die im Dokument vorhanden sind, abgeleitete Spalten für Informationen, die abgeleitet werden müssen (wie z. B. die Frachtkategorie basierend auf den NCM-Codes), und berechnete Spalten für arithmetische Operationen mit extrahierten Werten.

Schritt 3: Verarbeiten und nach Excel exportieren

Sobald die Spalten definiert sind, extrahiert die Verarbeitung alle Dokumente im Batch und erzeugt eine einzige Excel-Datei mit einer Zeile pro CT-e. Die Kopfzeilen der Ausgabetabelle entsprechen exakt Ihren Spaltendefinitionen – „Dienstleistungswert (Valor do Serviço)“ erscheint als Spaltenname, und jede Zeile enthält den aus dem entsprechenden DACTE extrahierten Wert.

Die extrahierten Daten können als Excel (XLSX) oder CSV heruntergeladen werden. Für Teams, die Google Tabellen verwenden, steht derselbe Extraktionsablauf über das Google-Tabellen-Add-on zur Verfügung, das Zeilen direkt in die aktive Tabelle schreibt, ohne den Schritt des Herunterladens und Importierens.

Speichern Sie nach dem ersten Batch die Spaltendefinitionen als Vorlage. Jeder weitere Batch von CT-e-Dokumenten – ob vom selben Spediteur oder einem anderen – verwendet dieselbe Vorlage. Die KI passt sich automatisch an das DACTE-Layout jedes Spediteurs an, sodass ein CT-e von JSL und eines von Braspress, die die ICMS-Daten an unterschiedlichen Tabellenpositionen platzieren, beide mit denselben Spaltendefinitionen gelesen werden. Dies ist die praktische Bedeutung der Extraktion ohne Vorlage: keine Einrichtung von Vorlagen pro Spediteur, kein Wartungsaufwand, wenn ein Spediteur sein DACTE-Layout aktualisiert.

Abgleich der CT-e-Frachtkosten mit den NF-e-Einkaufskosten

Der CT-e existiert parallel zum NF-e – ersterer dokumentiert die Transportdienstleistung, letzterer die Waren selbst. Für eine umfassende Sicht auf die gesamten Einstandskosten müssen Logistikteams die Frachtgebühr jedes CT-e mit dem entsprechenden Warenwert des NF-e abgleichen. Dieser Abgleich ist der Punkt, an dem manuelle Prozesse am häufigsten scheitern, da der CT-e und der NF-e über unterschiedliche Kanäle eingehen (der Spediteur sendet den CT-e; der Lieferant sendet den NF-e) und oft zu unterschiedlichen Zeiten (der NF-e wird beim Verlassen der Ware ausgestellt; der CT-e kann nach der Lieferung ausgestellt werden).

In der Praxis erfolgt der Abgleich mithilfe des NF-e-Zugriffsschlüssels, auf den der CT-e verweist. Jedes CT-e-XML enthält die Chave de Acesso des NF-e, das es transportiert (falls zum Zeitpunkt der Ausstellung bekannt). Der DACTE kann diesen Verweis im Abschnitt „Referenzierte Dokumente“ anzeigen. Durch die Extraktion sowohl des eigenen Zugriffsschlüssels des CT-e als auch des referenzierten NF-e-Zugriffsschlüssels kann ein Frachtanalyst die beiden Datensätze in Excel mithilfe eines SVERWEIS oder XVERWEIS in der Zugriffsschlüsselspalte zusammenführen – und so eine einzige Tabelle erstellen, die für jede Sendung den Warenwert aus dem NF-e zusammen mit den Frachtkosten aus dem CT-e anzeigt.

Der Zugriffsschlüssel ist eine 44-stellige Zahl, die dem gleichen Format UF-AAAA-MMM-XXXXXXXXXXX-XX-XXXXXXXXXXXXX folgt, das auch von NF-e-Dokumenten verwendet wird. Da beide Dokumenttypen dieselbe Zugriffsschlüsselstruktur verwenden, erzeugt ein kombinierter Extrakt – der den Zugriffsschlüssel sowohl aus CT-e- als auch aus NF-e-DACTEs im selben Ausgabeformat zieht – einen verknüpfbaren Datensatz ohne manuelles Querverweisen.

Für Teams, die bereits NF-e-Daten nach Excel extrahieren, ist das Hinzufügen der CT-e-Extraktion zum selben Workflow nur eine Frage der Definition eines zweiten Satzes von Spalten. Die beiden Ausgabetabellen – eine für Warenwerte (aus NF-e) und eine für Frachtkosten (aus CT-e) – werden zu Eingaben für eine vierteljährliche Landed-Cost-Analyse, die jede Sendung umfasst, nicht nur die, die vor dem Monatsabschluss manuell erfasst wurden.

CT-e vs. MDF-e vs. DACTE: Welches Dokument sollten Sie extrahieren?

Brasilien verwendet drei eng verwandte elektronische Dokumente für den Frachttransport, die jeweils einem anderen Zweck für die Kostenverfolgung dienen:

Für Frachtkosten- und ICMS-Details pro Sendung ist der DACTE des CT-e die richtige Extraktionsquelle. Der MDF-e deckt Ladungen ab, die ein Fahrzeug teilen, und kann bestätigen, welche CT-e-Dokumente auf derselben Fahrt waren, aber die Kostenpositionen befinden sich in den einzelnen CT-e-Dokumenten.

Häufig gestellte Fragen

Kann ich Daten aus der CT-e-XML-Datei anstelle des DACTE extrahieren?

Ja. Wenn Ihr Spediteur die CT-e-XML-Datei (typischerweise im Standard-CT-e-4.0-Schema) bereitstellt, enthält die XML alle strukturierten Felder und kann programmatisch geparst werden. Der in diesem Artikel beschriebene DACTE-Extraktionsansatz ist für das übliche Szenario konzipiert, in dem das Logistikteam einen ausgedruckten DACTE oder ein PDF anstelle einer XML-Datei erhält. Wenn Sie die XML haben, können Sie auch einen Screenshot oder Ausdruck ihrer visuellen Darstellung hochladen – die KI liest sie auf die gleiche Weise. Der Vorteil des XML-Parsings ist kein Genauigkeitsverlust (die Daten sind bereits strukturiert); der Nachteil ist, dass nicht jeder Spediteur die XML dem Empfänger zur Verfügung stellt und nicht jedes Logistiksystem Roh-XML ohne ein Integrationsprojekt verarbeiten kann.

Kann ich die extrahierten CT-e-Daten für die ICMS-Steuergutschrift bei eingehenden Frachtkosten verwenden?

Ja, unter bestimmten Bedingungen. Die ICMS auf eingehende Fracht – ICMS, die auf Frachtdienstleistungen für Rohstoffe oder zum Weiterverkauf bestimmte Waren gezahlt wird – kann im Rahmen des brasilianischen nicht-kumulativen ICMS-Systems anrechenbar sein. Der extrahierte ICMS-Betrag (vICMS) aus dem CT-e liefert die Grundlage für diese Berechnung. Die Anrechenbarkeit hängt jedoch vom Steuerregime des empfangenden Unternehmens (Lucro Real vs. Lucro Presumido), dem CFOP-Code der Transaktion und der Art der Waren ab. Die Extraktion liefert Ihnen die ICMS-Werte; Ihr Steuerteam bestimmt, welche erstattungsfähig sind. Ein häufiger Anwendungsfall ist die Extraktion sowohl der CT-e-ICMS als auch der NF-e-ICMS in dasselbe Kostenhauptbuch, gefolgt von der Anwendung unterschiedlicher Rückerstattungsprozentsätze pro CFOP-Code in Excel.

Benötige ich eine andere Extraktionsvorlage für jedes DACTE-Layout verschiedener Spediteure?

Nein. Die KI liest nach semantischer Bedeutung, nicht nach Layout-Position. Ein CT-e von JSL platziert die Spediteur-CNPJ in einem anderen Block als einer von Rodonaves, aber da das Modell versteht, was „CNPJ do Emitente“ im Kontext eines Frachtdokuments bedeutet, findet es den korrekten Wert unabhängig von der Position. Dies ist der grundlegende Unterschied zwischen der Extraktion ohne Vorlage und der vorlagenbasierten OCR: Sie definieren einen Satz von Spalten für CT-e-Dokumente, und dieselbe Definition funktioniert über jedes DACTE-Layout jedes Spediteurs hinweg.

Was ist, wenn mein DACTE handschriftliche Anmerkungen oder Korrekturen enthält?

Das KI-Vision-Modell liest Handschrift genauso wie Druckschrift – indem es den visuellen Inhalt kontextuell versteht, nicht durch den Abgleich von Zeichenformen. Handschriftliche Anmerkungen auf einem DACTE (wie eine korrigierte Lieferadresse, ein berichtigtes Gewicht oder eine Unterschrift) werden zusammen mit den gedruckten Daten extrahiert. Die Genauigkeit bei Handschrift hängt von der Leserlichkeit ab: Notizen in Druckbuchstaben mit Kugelschreiber auf sauberem Hintergrund werden zuverlässig extrahiert; verschmierte Bleistiftnotizen über gedrucktem Text können weniger genau sein. Der praktische Ansatz ist, die extrahierten gedruckten Felder als primäre Datenquelle zu nutzen und handschriftliche Anmerkungen als ergänzende Informationen zu behandeln, die gegen die offizielle XML des Spediteurs verifiziert werden sollten.

Wie viele CT-e-Dokumente kann ich in einem einzigen Batch verarbeiten?

Es gibt kein Limit pro Batch für die Anzahl der Dateien. Die praktische Einschränkung ist die Upload-Größe und das gesamte Seitenkontingent des Tarifs. Ein einzelnes CT-e DACTE umfasst typischerweise 1–2 Seiten. Ein Team, das 500 CT-e-Dokumente pro Monat im Pro-Tarif (1.500 Seiten/Monat) verarbeitet, hat noch Kapazität für andere Dokumenttypen. Die Batch-Ausgabe fasst alle verarbeiteten Dokumente in einer Excel-Datei zusammen – eine Zeile pro CT-e – sodass die Skalierung von 50 auf 500 Dokumente pro Batch die Gesamtverarbeitungszeit, nicht aber die Arbeitsschritte ändert.

Wie gleiche ich CT-e-Frachtkosten mit den entsprechenden NF-e-Kaufwerten ab?

Verwenden Sie den im CT-e referenzierten NF-e-Zugriffsschlüssel. Die meisten CT-e-Dokumente listen die Chave de Acesso der von ihnen transportierten NF-e in einem Abschnitt „documentos referenciados“ auf. Extrahieren Sie den referenzierten Zugriffsschlüssel aus jedem CT-e und den Zugriffsschlüssel aus jeder NF-e als separate Spalten in Ihrer Extraktionsausgabe. Führen Sie dann einen XVERWEIS (Excel) oder SVERWEIS zwischen den beiden Tabellen durch, wobei der Zugriffsschlüssel als gemeinsamer Identifikator dient. Dies ergibt eine kombinierte Ansicht, die sowohl den Warenwert (aus der NF-e) als auch die Frachtkosten (aus dem CT-e) für jede Sendung anzeigt – das sind Ihre gesamten Landedkosten pro Einheit.

Kann ich englische Spaltennamen verwenden, um Daten aus portugiesischsprachigen DACTE-Dokumenten zu extrahieren?

Ja. Sie können Ihre Spaltennamen auf Englisch definieren – „Carrier CNPJ“, „Service Value“, „Gross Weight (kg)“ – und die KI findet die entsprechenden portugiesischsprachigen Werte auf dem DACTE. Das Extraktionsmodell versteht mehrsprachige Dokumente und ordnet die Spaltensemantik der Inhaltssprache des Dokuments zu. Die Kopfzeilen der Ausgabetabelle sind auf Englisch (Ihre Spaltennamen), während die extrahierten Werte im ursprünglichen Format des Dokuments bleiben. Dies ist besonders nützlich für internationale Logistikteams, deren Kostenbuch auf Englisch geführt wird, die Quelldokumente jedoch auf Portugiesisch vorliegen.