ブラジルのCT-e
運送データをExcelに抽出

物流コスト管理におけるCT-eデータ抽出の重要性

ブラジルの物流事業者が毎月500件のCT-e文書を受け取る場合——南東部と中西部地域に製品を配送する中規模メーカーにとって標準的な量——約7,500件の個別データポイントが運賃原価台帳やERPに到達する必要があります。各CT-eには、運送業者のCNPJ（法人納税者登録番号）、サービス価額（valor do serviço）、総重量（peso bruto）、発地/着地の市町村、およびICMS（商品流通サービス税）の内訳が含まれており、これらはすべて運賃原価配分、運送業者パフォーマンス分析、税額控除回収のインプットとなります。

実際には、これら7,500件のデータポイントは、各DACTE（Documento Auxiliar do Conhecimento de Transporte Eletrônico）を開き、フィールドを見つけ、スプレッドシートの行に入力する運賃アナリストによって手動で入力されます。経験豊富なタイピストで1文書あたり約90秒——各フィールドをページ上で探し、判読性の問題を確認し、文書とスプレッドシートを切り替える——500件のCT-e文書は、月に12.5時間のデータ入力時間を消費します。これは、検証、対応する購入請求書との照合、運送業者のXMLが宣言する内容と印刷されたDACTEに表示される内容との間で避けられない不一致の調査の前の段階です。

ブラジルの物流インフラは年間3億件以上のCT-e文書を処理しており、SEFAZ（州財務局）が電子文書義務要件を拡大するにつれて、その数は増え続けています。抽出段階での自動化——手動入力なしでDACTEの視覚データをスプレッドシートの行に変換すること——は、すべての運賃コストを追跡する物流チームと、スプレッドシートに入力されたものだけを追跡するチームとの違いを生み出します。

CT-eとは？どのようなデータを含むのか？

Conhecimento de Transporte Eletrônico（CT-e、モデル57）は、ブラジルで義務化されている電子運送書類であり、NF-eと同じデジタル許可フレームワークのもと、州税務当局（SEFAZ）によって管理されています。2007年に導入され、2013年までにすべての貨物運送業者に対して段階的に義務化されたCT-eは、運送サービスに対する税務執行の大規模な監査をほぼ不可能にしていた複写式運送書類の紙ベースのシステムに取って代わりました。

多くの国における従来の船荷証券とは異なり、CT-eは権原証券ではありません。つまり、裏書や譲渡はできません。海事法律事務所Proindeが説明するように、これは運送契約の証拠、貨物の受領証、そしてサービスの税務請求書として同時に機能します。記載された荷受人は商品と引き換えに書類を引き渡す必要はありません。なぜなら、CT-eは発行時に受取人を特定しており、誤配送のリスクがないからです。

実際に貨物とともに移動する物理的な書類、つまり物流チームが最も頻繁に扱う書類は、DACTE（Documento Auxiliar do Conhecimento de Transporte Eletrônico）です。これは、CT-e XMLデータの一部、44桁のアクセスキー（chave de acesso）、およびCT-eポータルで認証するためのQRコードまたはバーコードを含む、印刷物またはPDFのサマリーです。DACTEの役割は、貨物に添付されて検査を受けることです。それ自体は税務書類ではありませんが、ほとんどの物流チームが業務で使用する情報源です。

CT-eがブラジルの電子文書エコシステムにおいて、NF-e（製品請求書）、NFS-e（サービス請求書）、MDF-e（電子運送マニフェスト）とともにどのように位置づけられるかについては、Nota Fiscal Eletrônica（NF-e）初心者ガイドをご参照ください。このガイドでは、すべてのブラジル税務書類に共通するSEFAZの許可フローについて説明しています。

物流チームが追跡すべきCT-eの主要項目

DACTEには、運送業者のレイアウトバージョンに応じて30〜50の表示データ項目が含まれています。物流コスト追跡の観点では、以下の項目が運賃原価台帳の主要列を構成します。

これら14項目は、CT-e運賃原価台帳の最小限の構成セットです。「1kgあたりの運賃（サービス価額 ÷ 総重量）」などの計算列を追加して列セットを拡張すると、バッチ処理のたびに価値が高まるベンチマークデータが生成されます。

CT-eデータをExcelに抽出する方法：ステップバイステップ

以下のワークフローは、カスタム列抽出を使用してDACTEのPDFまたは画像を構造化されたスプレッドシートの行に変換します。抽出したい列を定義すると、AIがフィールドの意味を理解して印刷ページ上の各値を特定します（位置ではなく意味に基づいて）。これはNF-eからExcelへの抽出ガイドで説明されているのと同じ仕組みで、CT-e運送書類用に適用したものです。

ステップ1：DACTEのPDFまたは画像をアップロード

まず、運送業者から提供された生のDACTEファイル（添付のPDF、スキャンした印刷物、または貨物に添付された書類の写真）を用意します。抽出ツールはPDF、JPG、PNG、WebPに対応しています。最良の結果を得るには、鮮明なPDFまたは300 DPI以上の明るい場所でスキャンしたものを使用してください。照明が不十分だったり斜めから撮影したDACTE書類の写真は、フィールドレベルの精度を低下させる可能性があります。ただし、AIビジョンモデルは、従来のOCRテンプレートでは完全に失敗するような中程度の傾きや照明の変動を補正します。

1日に複数の貨物を処理するチームにとって、複数のDACTEファイルを一度にバッチアップロードするのが実用的なワークフローです。バッチアップロードインターフェースは複数のファイルを同時に受け付け、同じバッチ名でキューに入れます。そのため、40件のCT-e書類を処理する貨物アナリストは、1件ごとに新しいアップロードダイアログを開くことなく、すべてを一度にアップロードできます。

ステップ2：抽出する列を定義

必要なCT-eデータに対応するフィールド名を入力します。これらが出力スプレッドシートの列ヘッダーになります。AIはDACTEページを読み取り、各値をその意味に基づいて特定します。「ICMS」は、サイドバーのボックス、フッターの表、明細列のいずれに表示されても、モデルがICMSを理解し、あらゆるレイアウト位置で認識するため、確実に見つけ出します。

CT-e貨物追跡における典型的な列定義のセットは次のとおりです。

これら14の列は、前のセクションで説明した最小限のコスト追跡データポイントを網羅します。列名に直接計算列を追加することもできます。例えば、単位重量あたりの運賃（Valor do Serviço ÷ Peso Bruto）と指定すれば、抽出中にAIが単位運賃を計算し、抽出後のExcelでの数式作成ステップを省けます。これは、製品ドキュメントに記載されているカスタム列抽出の3つのモードのうちの1つです。すなわち、書類上に存在するフィールドの直接抽出、NCMコードに基づく貨物カテゴリなど推測が必要な情報のための推論列、そして抽出値に対する算術演算のための計算列です。

ステップ3：処理してExcelにエクスポート

列を定義すると、抽出処理がバッチ内のすべての文書を処理し、CT-eごとに1行を含む単一のExcelファイルを生成します。出力テーブルのヘッダーは列定義と完全に一致します。「サービス価額（Valor do Serviço）」が列名として表示され、各行には対応するDACTEから抽出された値が含まれます。

抽出されたデータはExcel（XLSX）またはCSVとしてダウンロードできます。Google スプレッドシートを使用するチーム向けには、Google スプレッドシートのアドオンを通じて同じ抽出フローが利用可能で、ダウンロードとインポートの手順を経ずに、行をアクティブなスプレッドシートに直接書き込みます。

最初のバッチの後、列定義をテンプレートとして保存します。その後のCT-e文書のバッチはすべて—同じ運送業者からのものでも、別の運送業者からのものでも—同じテンプレートを再利用します。AIは各運送業者のDACTEレイアウトに自動的に適応するため、ICMS（商品流通サービス税）データを異なるテーブル位置に配置するJSLのCT-eとBraspressのCT-eの両方が、同じ列定義で読み取られます。これがテンプレート不要の抽出の実際的な意味です：運送業者ごとのテンプレート設定が不要で、運送業者がDACTEレイアウトを更新してもメンテナンスが不要です。

CT-e運賃とNF-e購入コストの照合

CT-eはNF-eと並行して存在します—前者は輸送サービスを文書化し、後者は商品自体を文書化します。総輸入原価を包括的に把握するには、物流チームが各CT-eの運賃を対応するNF-eの商品価額と照合する必要があります。この照合は、手動プロセスが最も頻繁に失敗するポイントです。CT-eとNF-eは異なるチャネル（運送業者がCT-eを送信し、サプライヤーがNF-eを送信）を通じて届き、多くの場合異なるタイミング（NF-eは商品が出荷される際に発行され、CT-eは配達後に発行されることがあります）で届くためです。

実際には、照合はCT-eが参照するNF-eのアクセスキーを使用して行われます。すべてのCT-e XMLには、輸送するNF-eのアクセスキー（発行時に既知の場合）が含まれています。DACTEはこの参照を「参照文書」セクションに表示する場合があります。CT-e自体のアクセスキーと参照されたNF-eのアクセスキーの両方を抽出することで、運賃アナリストはExcelでアクセスキー列に対してVLOOKUPまたはXLOOKUPを使用して2つのデータセットを結合できます—各輸送について、NF-eからの商品価額とCT-eからの運賃コストを並べて表示する単一のスプレッドシートを作成できます。

アクセスキーは、NF-e文書と同じUF-AAAA-MMM-XXXXXXXXXXX-XX-XXXXXXXXXXXXX形式に従う44桁の番号です。両方の文書タイプが同じアクセスキー構造を使用しているため、CT-eとNF-eのDACTEの両方からアクセスキーを同じ出力形式に抽出する結合抽出により、手動での相互参照なしで結合可能なデータセットが生成されます。

すでにNF-eデータをExcelに抽出しているチームにとって、同じワークフローにCT-e抽出を追加することは、2番目の列セットを定義するだけの問題です。2つの出力スプレッドシート（NF-eからの商品価額用とCT-eからの運賃用）は、月末締め前に手動で入力されたものだけでなく、すべての出荷を含む四半期ごとの着地原価分析への入力になります。

CT-e vs. MDF-e vs. DACTE：どの文書を抽出すべきか？

ブラジルでは、貨物輸送に関連する3つの電子文書が密接に関連して使用されており、それぞれがコスト追跡において異なる目的を果たします：

輸送ごとの運賃とICMS（商品流通サービス税）の詳細については、CT-eのDACTEが適切な抽出ソースです。MDF-eは車両を共有する貨物をカバーし、同じ輸送にどのCT-e文書が含まれていたかを確認できますが、コスト明細項目は個々のCT-e文書に含まれています。

よくある質問

DACTEではなく、CT-eのXMLファイルからデータを抽出できますか？

はい、可能です。運送業者がCT-eのXMLファイル（通常は標準のCT-e 4.0スキーマ）を提供する場合、XMLにはすべての構造化フィールドが含まれており、プログラムで解析できます。この記事で説明するDACTE抽出アプローチは、物流チームがXMLファイルではなく、印刷されたDACTEやPDFを受け取る一般的なシナリオ向けに設計されています。XMLをお持ちの場合は、その視覚的表現のスクリーンショットや印刷物をアップロードすることもできます。AIは同様に読み取ります。XML解析の利点は、精度の損失がゼロであること（データがすでに構造化されているため）です。欠点は、すべての運送業者が荷受人にXMLを提供するわけではなく、またすべての物流システムが統合プロジェクトなしで生のXMLを処理できるわけではないことです。

抽出したCT-eデータを、入荷運賃のICMS（商品流通サービス税）控除に使用できますか？

条件付きで可能です。入荷運賃ICMS、つまり原材料や転売目的の商品に対する運送サービスに支払われるICMSは、ブラジルの非累積ICMS制度の下で控除対象となる場合があります。CT-eから抽出されたICMS額（vICMS）は、この計算の基礎数値を提供します。ただし、控除の可否は、受領企業の税制（ルクロ・レアル（実利益課税制度）かルクロ・プレズミード（推定利益課税制度）か）、取引のCFOP（税務操作コード）、および商品の性質に依存します。抽出によってICMSの値が得られますが、どの部分が還付可能かは税務チームが判断します。一般的なユースケースは、CT-eのICMSとNF-eのICMSの両方を同じ原価台帳に抽出し、ExcelでCFOPコードごとに異なる還元率を適用することです。

運送業者ごとに異なるDACTEレイアウト用の抽出テンプレートが必要ですか？

いいえ、必要ありません。AIはレイアウト上の位置ではなく、意味的な内容に基づいて読み取ります。JSLのCT-eでは運送業者のCNPJ（法人納税者登録番号）がRodonavesのものとは異なるブロックに配置されていますが、モデルが運送書類の文脈で「CNPJ do Emitente」の意味を理解しているため、位置に関係なく正しい値を見つけ出します。これがテンプレート不要の抽出とテンプレートベースのOCRとの根本的な違いです。CT-e文書用に1セットの列を定義すれば、その同じ定義がどの運送業者のDACTEレイアウトでも機能します。

DACTEに手書きの注釈や修正がある場合はどうなりますか？

AIビジョンモデルは、文字の形状を照合するのではなく、視覚的な内容を文脈に沿って理解することで、手書き文字も印刷文字と同様に読み取ります。DACTE（Documento Auxiliar do Conhecimento de Transporte Eletrônico）上の手書きの注釈（修正された配送先住所、訂正された重量、署名など）は、印刷されたデータとともに抽出されます。手書き文字の精度は判読性に依存します。背景がきれいな状態でペン書きされたブロック体の大文字のメモは確実に抽出されますが、印刷文字の上に鉛筆で書かれた擦れた注釈は精度が低下する可能性があります。実用的なアプローチとしては、抽出された印刷フィールドを主要なデータソースとして使用し、手書きの注釈は運送業者の公式XMLと照合して確認すべき補足情報として扱うことです。

1回のバッチで処理できるCT-e文書の数はいくつですか？

ファイル数にバッチあたりの制限はありません。実際の制約は、アップロードサイズとプランの総ページ許容量です。1つのCT-e DACTEは通常1～2ページです。Proプラン（月1,500ページ）で月に500件のCT-e文書を処理するチームは、他の文書タイプにも容量を割り当てることができます。バッチ出力では、処理されたすべての文書が1つのExcelファイルにマージされ、CT-eごとに1行が作成されるため、バッチあたりの文書数を50から500に増やしても、ワークフローの手順は変わらず、総処理時間のみが変化します。

CT-eの運送費を、対応するNF-eの購入額とどのように照合しますか？

CT-eで参照されているNF-eのアクセスキー（Chave de Acesso）を使用します。ほとんどのCT-e文書は、「参照文書」セクションに、輸送するNF-eのアクセスキーを記載しています。各CT-eから参照されているアクセスキーを、各NF-eからのアクセスキーとともに、抽出出力の別々の列として抽出します。次に、アクセスキーを共通の識別子として、2つのスプレッドシート間でXLOOKUP（Excel）またはVLOOKUPを実行します。これにより、各出荷について、商品価額（NF-eから）と運送費（CT-eから）の両方を表示する結合ビューが生成され、これがユニットあたりの総輸入原価となります。

ポルトガル語のDACTE文書からデータを抽出する際に、英語の列名を使用できますか？

はい。列名を英語で定義できます（例：「Carrier CNPJ」「Service Value」「Gross Weight (kg)」）。AIはDACTE上で対応するポルトガル語の値を自動的に見つけます。抽出モデルは多言語文書を理解し、列の意味を文書の内容言語にマッピングします。出力されるスプレッドシートのヘッダーは英語（指定した列名）のままですが、抽出された値は文書の元の形式で保持されます。これは、原価台帳が英語で管理されているものの、元文書がポルトガル語である国際物流チームにとって特に有用です。