So extrahieren Sie brasilianische CT-e
Frachtdaten in Excel

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

Ein brasilianischer Logistikbetrieb, der monatlich 500 CT-e-Dokumente erhält – ein typisches Volumen für einen mittelständischen Hersteller, der im Südosten und in der Region Zentral-West ausliefert – erzeugt rund 7.500 einzelne Datenpunkte, die in ein Frachtkostenbuch oder ERP übertragen werden 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 Zielgemeinde sowie die ICMS (Warenverkehrssteuer)-Aufschlüsselung – all dies sind Eingabewerte für die Frachtkostenzuordnung, die Spediteur-Leistungsanalyse und die Steuergutschriften-Rückgewinnung.

In der Praxis werden diese 7.500 Datenpunkte manuell von einem Frachtanalysten eingegeben, der jedes DACTE öffnet, das Feld findet und es in eine Tabellenzeile tippt. Bei etwa 90 Sekunden pro Dokument für einen erfahrenen Tippenden – 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. Das ist noch vor jeder Validierung, vor jedem Abgleich mit der zugehörigen 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 SEFAZ (staatliche Steuerbehörde) die Anforderungen an elektronische Pflichtdokumente ausweitet. Automatisierung beim Extraktionsschritt – die Umwandlung der visuellen DACTE-Daten in Tabellenzeilen ohne manuelles Tippen – ist der Unterschied zwischen einem Logistikteam, das jede Frachtkostenposition erfasst, und einem, das nur die Positionen 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 Logistikteams verfolgen sollten

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

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

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

Der folgende Arbeitsablauf konvertiert DACTE-PDFs oder -Bilder mithilfe der Benutzerdefinierten Spaltenextraktion in strukturierte Tabellenzeilen – Sie definieren die gewünschten Spalten, und die KI findet jeden Wert auf der gedruckten Seite, indem sie versteht, was das Feld bedeutet, und nicht, wo es sich befindet. 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, verarbeitet die Extraktion 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, ist derselbe Extraktionsablauf über das Google-Tabellen-Add-on verfügbar, das Zeilen direkt in die aktive Tabelle schreibt, ohne den Schritt „Herunterladen und Importieren“.

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 pro Spediteur, keine Wartung, wenn ein Spediteur sein DACTE-Layout aktualisiert.

Abgleich von CT-e-Frachtkosten mit NF-e-Einkaufskosten

Das CT-e existiert neben dem NF-e – ersteres dokumentiert die Transportdienstleistung, letzteres die Waren selbst. Für eine umfassende Sicht auf die gesamten Einstandskosten müssen Logistikteams die Frachtgebühr jedes CT-e mit dem Produktwert des entsprechenden NF-e abgleichen. Dieser Abgleich ist der Punkt, an dem manuelle Prozesse am häufigsten scheitern, da CT-e und NF-e über verschiedene Kanäle eintreffen (der Spediteur sendet das CT-e; der Lieferant sendet das NF-e) und oft zu unterschiedlichen Zeiten (das NF-e wird ausgestellt, wenn die Ware das Werk verlässt; das CT-e kann nach der Lieferung ausgestellt werden).

In der Praxis erfolgt der Abgleich über den NF-e-Zugriffsschlüssel, auf den das CT-e verweist. Jedes CT-e-XML enthält die Chave de Acesso des NF-e, das es transportiert (sofern zum Zeitpunkt der Ausstellung bekannt). Das 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 von SVERWEIS oder XVERWEIS über die Zugriffsschlüsselspalte zusammenführen – und so eine einzige Tabelle erstellen, die für jede Sendung den Warenwert aus dem NF-e neben den Frachtkosten aus dem CT-e zeigt.

Der Zugriffsschlüssel ist eine 44-stellige Zahl, die dem gleichen UF-AAAA-MMM-XXXXXXXXXXX-XX-XXXXXXXXXXXXX-Format folgt, das auch bei NF-e-Dokumenten verwendet wird. Da beide Dokumenttypen dieselbe Zugriffsschlüsselstruktur verwenden, erzeugt eine kombinierte Extraktion – bei der der Zugriffsschlüssel sowohl aus CT-e- als auch aus NF-e-DACTEs in dasselbe Ausgabeformat übernommen wird – einen verknüpfbaren Datensatz ohne manuelles Querverweisen.

Für Teams, die bereits NF-e-Daten in Excel extrahieren, ist das Hinzufügen der CT-e-Extraktion zum selben Workflow eine Frage der Definition eines zweiten Spaltensatzes. 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, und jedes dient einem anderen Zweck für die Kostenverfolgung:

Für Frachtkosten- und ICMS-Details pro Sendung ist das DACTE des CT-e die richtige Extraktionsquelle. Das 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.