完全ガイド:ブラジルNF-e抽出

すべてのブラジルNF-e XMLには、500以上の構造化データフィールドが含まれています。これには、ICMSやPIS/COFINSのクレジット回収を左右する明細行ごとの税内訳も含まれます。しかし、ほとんどのAPチームは20未満しか抽出していません。本ガイドは、NF-e XMLを実際に使える表計算データに変換するための完全リファレンスです。フィールドマッピング表、州ペア別のICMS税率検証、CSTおよびCFOPコードのリファレンス、ICMS-STの処理、そして2026年のデュアルスキーマ移行に必要な実践的ステップを網羅しています。

手入力をやめよう — AIに読み取らせるだけ
画像やPDFをアップロード — 10秒で構造化データに
今すぐ試す →
Hero illustration titled Brazilian NF-e Extraction: Complete XML Field Mapping & Tax Guide with three flat vector icons for Portuguese XML tag paths, four taxes per line item, and the 44-digit access key.

主なポイント

  1. NF-e XMLには500以上の構造化データフィールドが含まれていますが、ほとんどのAPチームは20未満しか抽出しておらず、ICMSのクレジット回収やPIS/COFINSの仕入税額追跡が完全に見えなくなっています。
  2. ボトルネックはデータの有無ではありません。XMLは政府によって検証済みです。問題は、各明細行に4つの独立した税ツリー(ICMS、IPI、PIS、COFINS)がネストされており、それぞれに10以上のCSTコードバリアントがあり、ゼロ値がクレジットポジションにとって何を意味するかが変わることです。
  3. 4つの税分岐すべてを1回のパスでマッピングする1つのセマンティック抽出テンプレートがあれば、すべてのNF-eが不透明なXMLファイルから透明なクレジット回収ツールに変わります。BRL 100,000の請求書で1つの誤った制度前提は、BRL 9,250の回収漏れクレジットにつながります。

ブラジルのNF-eからのデータ抽出は、通常の請求書からのデータ抽出とは根本的に異なります。PDF形式の標準的な請求書では、視覚的なレイアウトからフィールドを読み取るためにOCRまたはAIベースの文書理解が必要です。NF-eはXMLファイルとして届きます — 設計上機械可読であり、その構造は、記載された商品が倉庫を出ることを許可される前に、ブラジルの州税務当局であるSEFAZによって400以上の自動ルールに対して検証されています。

課題はデータの可用性ではありません。データの複雑さです。欧州のPeppol BIS請求書は約100のXML要素を使用します。レイアウトバージョン4.0のNF-eは、複数のネストされたレベルにまたがる500以上の構造化要素グループを持ち、各明細行に4つの独立した税計算ブランチがあり、それぞれが独自の税務状況コード、課税ベース計算、税率、クレジットルールを使用しています。データは完全です — しかし、それを正しく抽出するには、各フィールドが何を意味し、他のフィールドとどのように関連しているかを理解する必要があります。

このガイドは実務リファレンスとして設計されています。NF-e抽出ワークフローを初めて設定する場合は、セクション2のステップバイステップのワークフローから始めてください。すでに抽出パイプラインを運用していて、特定のICMS税率を検証したり、CFOPコードを調べたりする必要がある場合は、セクション3から6のリファレンス表に進んでください。各セクションは独立して使用できますが、全体の価値は完全な全体像にあります。つまり、どのフィールドを抽出するか、それらが正しいことをどのように検証するか、NF-eがキャンセルイベントや contingency indicator とともに届いた場合にどうするかを知ることです。

NF-eにまったく不慣れな方は、抽出の詳細に入る前に、Nota Fiscal Eletrônicaの初心者ガイドから始めてください。このガイドは、DANFEとXMLの基本的な違い、SEFAZの承認プロセス、および4つの主要な税金を理解していることを前提とし、そのデータを正しく抽出することに焦点を当てています。

NF-e抽出が通常の請求書抽出と異なる理由

NF-e抽出の仕組みと、標準的な請求書抽出アプローチ(PDFをアップロードし、列を定義し、データを取得する)が問題の一部しか解決しない理由を定義する3つの構造的な違いがあります。

1. ソースはXMLであり、視覚的なドキュメントではない。 通常の請求書抽出は読み取りの問題です。AIまたはOCRシステムはページ上のテキストを特定し、どの文字列が請求書番号かを認識し、正しい列にマッピングする必要があります。NF-e抽出はパースとマッピングの問題です。データはすでに機械可読なタグに入っていますが、XML構造はポルトガル語のタグ名(発行者は<emit>、受領者は<dest>、税は<imposto>)を使用し、税制によって異なる深くネストされた階層を持っています。抽出の課題は「データを見つける」ことから「正しいXMLパスを各出力列にマッピングする」ことへと移ります。

2. 税構造は多次元である。 1つのNF-e明細行には、最大4つの独立した税計算が含まれます — ICMS(州レベル、CSTコードに応じて10以上のバリアント)、IPI(連邦消費税、製品依存)、PIS、COFINS(連邦社会貢献税)。各税には独自の計算基礎、税率、CST(税務状況コード)、およびクレジット適格性ルールがあります。1つの税率が行全体に適用されるEUのVAT請求書とは異なり、NF-e明細行には個別の<ICMS>、<IPI>、<PIS>、<COFINS>サブグループが含まれ、それぞれ異なる課税ベースを持つ可能性があります。合計のみを抽出すると、各税クレジットが正しく計算されたかを決定する詳細を見落とします。

3. 抽出ワークフローは発行後のイベントを考慮する必要がある。 NF-eは24時間以内にキャンセルできます。特定のフィールドを修正するCarta de Correção(CC-e)を受け取ることがあります。SEFAZに到達できなかった場合、 contingencyモードで発行されることがあります。受領者側のイベントであるmanifestação do destinatárioをトリガーします — これは買い手が受領を確認し、取引を承認し、または拒否する法的義務です。完全な抽出パイプラインは、これらのイベント駆動型の変更を処理する必要があり、初期XMLを抽出して終わりにするだけでは不十分です。キャンセルとcontingencyルールがAPワークフローに与える影響の詳細については、NF-e処理の複雑さの分析をご覧ください。

これらの3つの違いは、NF-e抽出が「ポルトガル語のフィールド名を持つ請求書抽出」ではないことを意味します。それは独自のカテゴリです — ドキュメントOCRよりもEDIパースに近いですが、税の複雑さはほとんどのEDI標準を桁違いに超えています。独自の構造的複雑さを持つ他の主要なラテンアメリカの電子請求書システムについては、メキシコCFDI抽出の完全ガイドをご覧ください。

完全なNF-e抽出ワークフロー:ステップバイステップ

手動、スクリプトベース、AI駆動のいずれであっても、エンドツーエンドのNF-e抽出ワークフローは同じ論理的な順序に従います。各ステップは特定の出力を生成し、それが次のステップに引き継がれます。

1

XMLを収集する — DANFEだけでは不十分

すべてのNF-e取引はXMLファイルを生成します。サプライヤーがDANFEしか送付していない場合は、DANFEに印刷された44桁のアクセスキーを使用して、発行州のSEFAZポータルから完全なXMLをダウンロードしてください。ブラジル法はサプライヤーにXMLの提供を義務付けており、抽出と義務である5年間のアーカイブの両方にXMLが必要です。原本のXMLは受領したままの状態で保存してください — 変更するとデジタル署名が無効になり、監査証跡が破損します。

2

アクセスキーとSEFAZステータスを検証する

データを処理する前に、NF-eが有効であることを確認してください。<chNFe>要素から44桁のchave de acessoを抽出し、SEFAZのWebサービスまたはポータルに照会します。ステータスが「Autorizada」(承認済み)であることを確認してください — 「Cancelada」(取消済み)や「Denegada」(拒否)ではないことを確認します。NF-eは発行後24時間以内に取消される可能性があるため、このステップはスクリプトやツールベースのワークフローで自動化する必要があります。抽出時点でアクセスキーを検証することで、法的効力を失ったドキュメントを処理することを防げます。

3

XML構造をグループに解析する

NF-e XMLには予測可能なトップレベル構造があります。主要な要素グループは次のとおりです:<ide>(ドキュメント識別)、<emit>(発行者/サプライヤー)、<dest>(受領者/あなた)、<det>(明細行 — 製品ごとに繰り返し)、<total>(請求書合計 — 税種別ごとに1つ)、<transp>(輸送/運賃)、<cobr>(支払/請求)、<infAdic>(追加情報)。抽出スクリプトまたはツールは各グループを個別に解析し、明細行レベルで結果を結合する必要があります。

4

参照テーブルを使用してフィールドを出力列にマッピングする

スプレッドシートやERPインポートファイルに必要な各フィールドについて、正確なXMLパス、期待されるデータ型、および必要な変換(日付をISO形式に、金額を小数点以下2桁の小数に、CNPJ文字列はゼロ埋めを保持)を特定してください。以下のセクション3のフィールドマッピング参照を使用してください。このステップでの重要な区別:ヘッダーレベルのフィールド(NF-eごとに1回抽出)と明細行フィールド(各<det>要素ごとに抽出)を分離します。出力構造はこれを反映する必要があります:請求書ごとに1行のヘッダーテーブルと、請求書ごとに複数行の明細行テーブルです。

5

参照データと税計算を照合する

NF-e XMLには、自社ではなくサプライヤーの税計算が含まれています。抽出ワークフローには検証チェックを組み込む必要があります。ICMS税率は、起点州と宛先州の組み合わせに対する正しい税率と一致しているか?IPI税率は製品のNCMコード範囲に対応しているか?CSTコードはCFOPが示す取引タイプと整合しているか?本ガイドのセクション4に、これらのチェックに必要な参照テーブルを掲載しています。不一致があればレビュー用にフラグを立て、不一致の税データをERPに無言でインポートしないでください。

6

エクスポート、アーカイブ、イベントの監視

構造化データをERPまたはスプレッドシートにエクスポートします。元のXML(受信したまま、一切変更せず)と抽出結果の両方をアーカイブしてください。その後、監視プロセスを設定します。抽出したNF-eドキュメントのSEFAZステータスを抽出から48時間後に再確認し、取消や訂正イベントを捕捉します。サプライヤーは通知なしに24時間以内にNF-eを取消できます。すでに取消されたNF-eからデータを抽出してERPに転記していた場合、逆仕訳記録を作成する必要があります。自動化ツールならこの監視ステップを処理できますが、人手のチームはしばしば見落とします。

NF-e XMLフィールドマッピングリファレンス

以下の表は、必須のNF-e XMLパスをスプレッドシートの列にマッピングしたものです。フィールドは重要度別に評価されています:Critical(基本的な処理に必須)、Important(税務検証とクレジット回収に必要)、Niche(通関やSPED申告など特定のシナリオで必要)。すべてのパスは標準のNF-e XML名前空間を基準としています。

ヘッダーフィールド(請求書ごとに1行)

出力列XMLパス(<nfeProc>/<NFe>/<infNFe>を基準)値の例重要度
アクセスキー(Chave de Acesso)@Id(「NFe」プレフィックスを削除)または<ide>/<cNF>とプレフィックスの組み合わせ35200600012345000106550010000012341012345678Critical
NF-e番号<ide>/<nNF>1234Critical
NF-eシリーズ<ide>/<serie>1Critical
発行日<ide>/<dhEmi>2026-06-15T14:30:00-03:00Critical
SEFAZ認証プロトコル<ide>/<nProt>135260001234567Critical
発行タイプ<ide>/<tpEmis>1(通常)、2-6(緊急時)Important
サプライヤーCNPJ<emit>/<CNPJ>00.000.000/0001-91Critical
サプライヤー法人名<emit>/<xNome>Fornecedor Exemplo LtdaCritical
サプライヤー州登録番号<emit>/<IE>123.456.789.110Important
サプライヤー州(IBGEコード)<emit>/<enderEmit>/<cUF>35(São Paulo)、33(Rio de Janeiro)Critical
購入者CNPJ<dest>/<CNPJ>00.000.000/0002-82Critical
購入者州(IBGEコード)<dest>/<enderDest>/<cUF>31(Minas Gerais)Critical
NF-e合計金額<total>/<ICMSTot>/<vNF>12500.00Critical
ICMS合計額<total>/<ICMSTot>/<vICMS>1500.00重要
ICMS-ST合計額<total>/<ICMSTot>/<vST>450.00重要
IPI合計額<total>/<ICMSTot>/<vIPI>625.00重要
PIS合計額<total>/<ICMSTot>/<vPIS>206.25重要
COFINS合計額<total>/<ICMSTot>/<vCOFINS>950.00重要
割引額<total>/<ICMSTot>/<vDesc>250.00ニッチ
運送費<total>/<ICMSTot>/<vFrete>350.00重要
保険料<total>/<ICMSTot>/<vSeg>50.00ニッチ
支払・請求情報<cobr>/<dup>/<dVenc>(期日)および <vDup>(金額)2026-07-15 / 12500.00重要
CFOP(ヘッダーレベル — 通常は最初の明細行から)<det>[1]/<prod>/<CFOP>2101重要
操作の性質<ide>/<natOp>Venda de mercadoria adquirida de terceirosニッチ

明細行フィールド(製品行ごとに1行)

<infNFe>内の各<det>要素は1つの製品行を表します。nItem属性は行番号(1始まり)を示します。以下のフィールドは各<det>ごとに繰り返されます:

出力列XMLパス(<det>ごと)重要度
行番号@nItemCritical
製品コード(サプライヤー内部コード)<prod>/<cProd>Important
製品説明<prod>/<xProd>Critical
NCMコード(8桁の製品分類)<prod>/<NCM>Critical
CFOPコード(4桁の税務操作)<prod>/<CFOP>Critical
CST — ICMS税務状況コード<imposto>/<ICMS>/<ICMS00>/<CST>(サブグループにより異なる)Critical
数量<prod>/<qCom>Critical
単価<prod>/<vUnCom>Critical
行合計(総額)<prod>/<vProd>Critical
ICMS課税標準(BC ICMS)<imposto>/<ICMS>/<ICMS00>/<vBC>Important
ICMS税率(%)<imposto>/<ICMS>/<ICMS00>/<pICMS>Important
ICMS額<imposto>/<ICMS>/<ICMS00>/<vICMS>Critical
ICMS-ST課税標準(該当する場合)<imposto>/<ICMS>/<ICMSST>/<vBCST>Important
ICMS-ST額(該当する場合)<imposto>/<ICMS>/<ICMSST>/<vICMSST>Important
IPI課税標準<imposto>/<IPI>/<IPITrib>/<vBC>Important
IPI税率(%)<imposto>/<IPI>/<IPITrib>/<pIPI>重要
IPI金額<imposto>/<IPI>/<IPITrib>/<vIPI>重要
PIS課税標準<imposto>/<PIS>/<PISAliq>/<vBC>重要
PIS税率(%)<imposto>/<PIS>/<PISAliq>/<pPIS>重要
PIS金額<imposto>/<PIS>/<PISAliq>/<vPIS>重要
COFINS課税標準<imposto>/<COFINS>/<COFINSAliq>/<vBC>重要
COFINS税率(%)<imposto>/<COFINS>/<COFINSAliq>/<pCOFINS>重要
COFINS金額<imposto>/<COFINS>/<COFINSAliq>/<vCOFINS>重要
UOM(数量単位)<prod>/<uCom>ニッチ
GTIN/EAN(製品バーコード)<prod>/<cEAN>ニッチ
EX TIPI(IPI免税コード)<prod>/<EXTIPI>ニッチ

ICMSサブグループに関する重要な注意:<imposto>内のICMS XMLパスはCSTコードによって異なります。通常課税のICMSは<ICMS00>サブグループを使用します。その他のCSTコードでは、<ICMS10>(課税+ST)、<ICMS20>(軽減課税標準)、<ICMS30>(通常ICMS免除のST)、<ICMS40>(免除)、<ICMS51>(繰延)、<ICMS60>(徴収済み)、<ICMS90>(その他)、<ICMSPart>(DIFAL — 州間税率差額)、<ICMSST>(税額代替)を使用します。抽出マッピングは<ICMS00>だけでなく、これらすべてのバリアントを処理する必要があります。

税務検証:抽出した数値を確認する方法

NF-e XMLにはサプライヤー自身の税計算が含まれており、それが誤っている可能性があります。SEFAZはXML構造が完全であり、基本的な算術が整合していることを検証しますが、origin-destinationの組み合わせに対して正しいICMS税率が使用されたか、またはIPI税率がNCMコードの公式TIPI税率と一致するかは検証しません。これらは買い手であるあなたの責任であり、ブラジルのAPにおいて回収可能な過払いの最も一般的な原因です。

州ペア別のICMS州間税率検証

州間取引のICMS税率は、origin州(サプライヤーが出荷する州)とdestination州(あなたの法人が所在する州)によって決まります。この表を使用して、NF-eのICMS税率が州ペアの正しい税率と一致するか検証してください:

Origin州Destination州標準ICMS税率備考
南東/南部のいずれかの州(SP、RJ、MG、ES、PR、SC、RS)南東/南部のいずれかの州12%南東/南部地域内の標準州間税率
南東/南部のいずれかの州北部/北東/中西部のいずれかの州7%発展途上地域への軽減税率(Art. 2, I, LC 87/96)
北部/北東/中西部のいずれかの州いずれかの州(南東/南部を含む)12%発展途上地域からの標準出荷税率
いずれかの州いずれかの州(外国産含有率40%超の輸入品)4%Resolução Senado 13/2012 — 輸入含有率が40%を超える製品に適用
供給州 = 受領州(州内)同一州17%–22%州により異なる:SP=18%、RJ=20%、MG=18%、PR=19%、RS=17%など
「州ペアに対してICMS税率を確認」と題された棒グラフ。輸入品40%超で4%、南東から北部/北東へ7%、南東から南東へ12%、サンパウロ州内で18%を示す。

NF-eのICMS税率がorigin-destinationの組み合わせ(<emit>/<enderEmit>/<cUF>から<dest>/<enderDest>/<cUF>)の期待税率と一致しない場合は、そのドキュメントをレビュー対象としてフラグを立ててください。税率の不一致はブラジルのサプライヤー請求書で最も一般的なエラーの一つであり、誤った税額控除計算につながる可能性があります。

CSTコード:すべてを変える税務状況コード

CST(Código da Situação Tributária)は、税率だけでなく、税金がどのように適用されたかを示す3桁のコードです。NF-e上のすべてのICMS、IPI、PIS、COFINSの計算には、それぞれ独自のCSTが付随します。CSTの最初の桁は、課税制度の起源を示します(0=国内、1=外国、2=国内コンテンツを含む外国 — 税金によって異なります)。特にICMSの場合、CSTはICMSが課税対象、免税、繰延、代替(ST)、または特別制度を通じて徴収されるかを決定します。3桁のICMS CSTコードは、特定の論理に従います:

CST(ICMS)意味クレジット利用可能?APへの影響
00課税 — 完全なICMS税率が適用はい標準的な購入。vBC、pICMS、vICMSを通常通り抽出します。
10課税 + 税代替(ICMS-ST)はい(通常のICMSのみ)2つのICMS金額:通常とST。両方を抽出 — ST金額はクレジットではありません。
20軽減された計算基礎を持つ課税はい(比例)課税基礎が軽減されます(例:1/3)。vBCフィールドは軽減された基礎を反映します。
30通常のICMSが免税 + STが適用いいえ抽出する通常のICMSはありません。STフィールドのみが存在します。コストにはST金額が含まれます。
40免税 — ICMSは課されないいいえICMS値はありません。行の合計は同じままですが、クレジットは生成されません。
41免税 — 非課税いいえCST 40と同様。抽出またはクレジットするICMSはありません。
51繰延 — ICMSの支払いが後の段階に延期場合によるvICMSがゼロでもvBCとpICMSを抽出 — 繰延は将来のイベントに影響します。
60ICMSは既にサプライヤー(またはチェーンの前のリンク)によって徴収済みいいえ燃料、エネルギー、通信で一般的。ICMSは明細項目ではありません — 上流で支払われました。
70軽減された基礎を持つ課税 + STはい(比例)ハイブリッド:通常のICMSに対する軽減された基礎 + 別個のST金額。両方を抽出する必要があります。
90その他 — 上記に該当しない特別制度場合による手動で確認。NF-eの<infAdic>が制度を説明するはずです。

抽出ワークフローでは、常に税額とともにCSTコードを取得する必要があります — CST 40(免税)の「ゼロICMS」は、CST 00(エラー)の「ゼロICMS」とはまったく異なる状況です。CSTは、ゼロが正当な税務処理なのか、調査が必要なデータギャップなのかを決定します。

IPI、PIS、COFINSの検証

IPIの確認: IPI税率は製品のNCMコードによって決まります。ブラジルはTIPI(Tabela de Incidência do IPI)を公開しており、これはすべてのNCMコードをIPI税率に対応付けた包括的な税率表です。TIPIのスプレッドシート全体を社内で維持することはできませんが(数千件のエントリがあり、Receita Federalによって定期的に更新されます)、高額な明細項目についてはスポットチェックが可能です。NCMを抽出し、そのTIPI税率範囲を調べ、pIPIフィールドが想定範囲内にあることを確認します。IPIのCSTコードも重要です。CST 50はIPIが免税、00は課税を意味します。

PISとCOFINSの確認: これらの連邦負担金は、累積方式または非累積方式のいずれかで適用されます。方式はサプライヤーの税務区分によって決まり、税率と、買い手であるあなたが利用できるクレジットの両方を左右します:

方式PIS税率COFINS税率合計買い手はクレジットを取得できるか?
非累積方式(Lucro Real)1.65%7.6%9.25%はい — 買い手は自身の負担金に対してPISとCOFINSをクレジットできます
累積方式(Lucro Presumido)0.65%3.0%3.65%いいえ — 累積方式では仕入クレジットは発生しません

NF-e上のPIS税率が1.65%でCOFINSが7.6%の場合、サプライヤーは非累積方式であり、PIS/COFINSの仕入クレジットを請求できます。税率が0.65%と3.0%の場合、クレジットは利用できません。サプライヤーのCST(通常、01 = 非累積または02 = 累積)が方式を裏付けます。これらの税率を抽出して検証することは、回収可能な税務ポジションに直接影響します。

実践的な検証ルール: すべてのNF-eについて、明細項目レベルでPIS税率とCOFINS税率を抽出します。合計税率が9.25%であれば、クレジット追跡のためにフラグを立てます。3.65%であれば、サプライヤーの方式を確認し、PIS/COFINSクレジットが適用されないことを記録します。BRL 100,000の請求書で方式を一度誤って想定すると、BRL 9,250のクレジットを逃すことになります — あるいはBRL 5,600を誤って請求することになります。

ICMS税の代替(ICMS-ST):無視できない仕組み

ICMS-ST(Substituição Tributária)は、サプライチェーン全体のICMS徴収責任を最初のリンク(通常は製造業者または輸入業者)に割り当てる仕組みです。チェーン内の各購入者(製造業者 → 卸売業者 → 小売業者)がそれぞれのマージンに対してICMSを支払う代わりに、製造業者がチェーンの開始時点で消費者への推定最終販売価格に基づいてICMSを徴収します。この納税者の「代替」により、徴収ポイントが上流に移行します。

ICMS-STはコストであり仕入税額控除ではないというタイトルの2列比較。回収可能な通常ICMS(CST 00)には緑のチェックバッジ、回収不可能なICMS-ST(CST 10またはCST 30)には琥珀色のバツバッジ。

NF-eドキュメントを処理するAPチームにとって、ICMS-STは2つのシナリオで現れます:

シナリオ1 — 自社がチェーンの中間にある場合(代替納税者から購入)。 製造業者からSTの下で既に購入した卸売業者から商品を購入します。NF-eには通常のICMS(CST 00、通常課税)と別個のICMS-ST額(CST 10、<ICMS10>または<ICMSST>の下)が含まれます。抽出では両方を取得する必要があります:通常のICMSは仕入税額控除であり、ICMS-STは控除ではありません — 上流サプライヤーによって既にSEFAZに納付されたコスト込みの課金です。これを取り戻すことはできません。

シナリオ2 — 自社が最終リンクにある場合(小売業者または直接消費者)。 ST代替納税者であるサプライヤーから購入します。NF-eには単一のICMS-ST額(CST 30 — 通常ICMSは免除、STが適用)が含まれます。チェーン全体のICMSコストがこの1つの金額に埋め込まれています。抽出ではSTフィールドのみを取得し、通常のICMS控除は利用できません。

抽出ワークフローでこれら2つのシナリオを区別するには、CSTコードを確認します:CST 10 = 通常ICMS + ST(部分的な控除が得られます)、CST 30 = STのみ(通常ICMS控除なし)。ICMS-STのXMLパスは別個のサブグループを使用します:ST額には<imposto>/<ICMS>/<ICMSST>/<vICMSST>、ST計算基数には<vBCST>。これらは通常のICMSとは別の列として抽出してください — 決して単一の「ICMS合計」フィールドに合算しないでください。一部のAPチームは通常ICMSとSTを合算して結合金額を計上し、ICMS控除の位置を過大に示して監査指摘を招いています。

CFOPとNCM:コンプライアンスを左右する分類コードの抽出

NF-eの各明細行には、その製品の税務処理を決定する2つのコードが含まれています。これらは任意のメタデータではなく、税務判定ロジックへの入力値です。

CFOPコード早見表(先頭桁による分類)

CFOP(Código Fiscal de Operações e Prestações)は4桁のコードで、先頭桁が取引の方向と性質を示します。受信(買い手側)のNF-e処理でよく遭遇するCFOPコードは、1xxx、2xxx、3xxxの範囲に集中しています:

先頭桁分類一般的な受信コード
1受信 — 同一州内(州内取引)1102 = 再販目的の購入、1101 = 工業化目的の購入、1116 = 使用・消費目的の購入
2受信 — 他州から(州間取引)2101 = 工業化目的の購入、2102 = 再販目的の購入、2116 = 使用・消費目的の購入
3受信 — 海外から(輸入)3101 = 工業化目的の輸入、3102 = 再販目的の輸入、3126 = 使用・消費目的の輸入
5送信(販売)— 買い手側のNF-eにはほとんど出現しない—
6送信・州間 — NF-eを発行する場合のみ該当—
7送信・海外 — 輸出取引—

抽出においてCFOPが重要な理由:CFOPコードは、その取引に適用されるICMSルールを決定します。先頭が1(州内)のCFOPは、ICMS税率が供給元の州の内国税率(17~22%)であるべきことを意味し、州間税率ではありません。先頭が2(州間)のCFOPは、税率が上記の州間税率表と一致すべきことを意味します。CFOPとICMS税率が矛盾している場合 — 例えば、CFOP 1102(州内)にICMS税率12%(州間税率)が適用されている場合 — その請求書には修正が必要な構造的な不一致があります。抽出ワークフローはこれを自動的に検出する必要があります。

NCMコード:IPIと輸入関税を左右する製品分類

NCM(Nomenclatura Comum do Mercosul)は、HS(Harmonized System)に基づく8桁の製品分類コードで、メルコスール固有の2桁が追加されています。形式:NNNN.NN.NN(最初の6桁がHSコード)。NCMコードは以下を決定します:

  • IPI税率:TIPIテーブルを介してマッピングされます。特定の章で始まるNCMの製品は、IPI税率が高くなったり低くなったりします。
  • ICMS-STの適用可否:特定のNCM章は、州をまたぐ義務的なICMS-STプロトコル(convênios)の対象となります。
  • 輸入関税(II):国際的な購入に対する関税。
  • 代替課税税率(例:CONFAZプロトコルに基づく簡素化されたICMS-ST計算)。

抽出時には、NCMは常に先頭のゼロを保持したテキストフィールドとして取得する必要があります。数値に変換しないでください。NCM 8471.30.00(コンピュータ機器)は、数値として扱うと先頭の構造が失われます。NCMは、ワークフローに自動税率検証が含まれる場合、IPI税率を検索するための主キーとしても機能します。

抽出ワークフローにおけるNF-e特殊イベントの処理

NF-eは静的なドキュメントではありません。法的に定義された一連のイベントを通じて、変更、取消、または再発行される可能性があります。完全な抽出ワークフローはこれらのイベントを考慮する必要があります。なぜなら、それらは既に抽出したデータを変更する可能性があるからです。

取消。発行者は、商品が物理的に移動していない場合に限り、認証プロトコルの受領から24時間以内にNF-eを取消すことができます。取消イベントはSEFAZに登録され、同じアクセスキーにリンクされます。24時間経過後は、取消はできません。発行者は税務当局を通じて特別取消を申請するか、クレジットノート(NF-e de devolução)を発行する必要があります。抽出ワークフローでは、抽出時と支払い前にNF-eステータスを確認することが重要な検証です。NF-eドキュメントをプログラムで処理する場合は、SEFAZのConsNFeDestウェブサービスに問い合わせて、買い手が受領したNF-eステータスリストを取得するステータスチェックステップを含めてください。

Carta de Correção(CC-e)。サプライヤーが既に認証されたNF-eのフィールドを修正する必要がある場合(例:製品説明の修正、配送先住所の訂正、支払期日の更新)、CC-eを発行します。これはNF-eのアクセスキーにリンクされた電子的な訂正書簡です。CC-eはXMLを置き換えるものではなく、特定のフィールドを修正するものです。抽出ワークフローでは、NF-eドキュメントを処理する際に、そのアクセスキーに対してCC-eイベントが存在するかどうかを問い合わせる必要があります。ImageToTable.aiのバッチ処理には、抽出されたドキュメントに対して訂正イベントをチェックするオプションが含まれています。なぜなら、サプライヤーがCC-eで支払期日を訂正し、ワークフローが元のXMLの支払期日を使用した場合、誤ったスケジュールで支払うことになるからです。

コンティンジェンシーモード。SEFAZに到達できない場合、サプライヤーはコンティンジェンシーモードでNF-eを発行できます。発行タイプ(<ide>/<tpEmis>)はコンティンジェンシー方法を示します:2 = FS-DA(タイプされたDANFE)、3 = EPEC(事前イベントコンティンジェンシー)、4 = DPEC(電子コンティンジェンシー)、5 = FS-IA(フォームコンティンジェンシー)、6 = SVC(SEFAZ Virtual Contingency — バックアップ認証サーバー)。コンティンジェンシーモードでは、抽出時にNF-eに完全なSEFAZ認証プロトコルが欠けている可能性があります。ワークフローは、コンティンジェンシー発行されたドキュメントをフォローアップ対象としてフラグを立てる必要があります。システムが復旧すると、サプライヤーは完全なNF-eを送信し、最終的なXMLを取得して、フィールドが変更されている場合は再抽出する必要があります。

Manifestação do Destinatário。これは供給側のイベントではなく、買い手の義務です。ブラジル法では、商品の買い手はSEFAZポータルで所定の期限内にイベント応答を登録する必要があります。発行から10日以内に受領を確認し、取引を承認または拒否します。このプロセスはmanifestação do destinatárioと呼ばれ、SEFAZのDF-eプラットフォームで管理されます。manifestaçãoは抽出とは別のコンプライアンス手順ですが、抽出ワークフローでは処理した各NF-eのアクセスキーをmanifestação追跡システムに記録し、コンプライアンス担当が必要なイベントを期限内に申請できるようにすべきです。manifestaçãoを登録しないと、SEFAZは取引が未確認であったとみなし、その供給元からの今後のNF-e発行がブロックされる可能性があります。

これらのイベントタイプとAP業務への影響について詳しくは、NF-e処理の複雑さに関する分析をご覧ください。

抽出方法の比較:どのアプローチが処理量に合うか

NF-eデータを抽出する一般的な方法は4つあり、適切な方法は処理量、技術リソース、そして明細行の税詳細が必要かヘッダー合計だけでよいかによって決まります。

方法仕組み抽出されるフィールド最適な処理量主な制限
手動DANFE入力担当者が印刷されたDANFEを読み、ExcelやERPに入力約20のヘッダーフィールド、明細行の税詳細なし月10件未満すべての税内訳を含むデータの90%を逃す。エラー率が高い
XMLスクリプト(Python、Power Query)カスタムスクリプトがNF-e XMLを解析し、CSV/Excelに抽出すべてのヘッダー+明細行フィールド。事前定義のXPathマッピングが必要月10~100件コーディングスキルが必要。スキーマ更新(2026年のデュアルスキーマ)で壊れる。税検証が組み込まれていない
ERPローカライズモジュール(SAP/Oracle/Dynamics)NF-e XMLを受信しGLに自動転記するブラジル専用ERPモジュール全フィールド、税勘定マッピング、SPED連携月100件以上高コスト(ライセンス+導入)。そのERPがなければ使えない。スキーママッピングが固定的
AIベースの抽出DANFE PDFまたはNF-e XMLをアップロード。AIが解析しユーザー定義の列にマッピングPDFからはDANFEに表示される全フィールド。XMLからは全フィールド月10~500件以上XML解析には、ツールが構造化データ入力に対応している必要がある(視覚的なPDFだけでなく)

NF-eで重要な違いは、抽出方法がDANFEとXMLの両方を扱えるかどうかです。供給元が混在している場合——一部はXMLを直接送信し、他はDANFEを印刷して送付するだけ——両方のソースを一貫して扱える方法が必要です。ImageToTable.aiは両方に対応しています。生のNF-e XMLファイルをDANFE PDFと同じバッチでアップロードし、単一の列テンプレートを定義して、統合されたスプレッドシートを得られます。このツールは前述の可変的なICMSサブグループパスも処理します。スキーマの複雑さによりスクリプトチームが数十のXPathバリエーションを維持せざるを得ない場合、これは大きな利点です。複数のNF-eドキュメントをバッチ処理する実践的な手順については、バッチNF-e処理ガイドをご覧ください。

XML / PDF / JPG AI抽出

ファイルは安全に処理され、保存されません。

2026年の税制改革に向けた抽出ワークフローの準備

「NF-eスキーマは2033年まで2つの税制を併存させる」と題された3ノードのタイムライン。2026年のCBSテストフィールドが0.9%、2027年にCBSが有効化されPISとCOFINSが廃止、2033年にCBSがPISを完全に置き換えることを示す。

ブラジルの憲法修正第132/2023号および補完法第214/2025号は、既存の5つの税を2つの新しい税に置き換える二重VAT制度を導入しました。NF-e抽出において、これは現在解析しているXMLスキーマが、2026年8月から2033年までの移行期間中、旧税フィールドと新税フィールドの両方を保持することを意味します。以下では、抽出レベルで何が変わるのか、そしてそれに対して何をすべきかを説明します。

変わらないもの: XML全体の構造(<ide>、<emit>、<det>、<total>)は同じままです。ヘッダーフィールド、明細行の数量、NCMコード、CFOPコードは影響を受けません。

変わるもの: 各明細行の<imposto>セクションと<total>集計グループに、新しいXML要素グループが追加されます。新しいグループは、既存のICMS、IPI、PIS、COFINSフィールドと並んで、CBS(連邦)とIBS(州・市)の税計算を保持します。移行期間中は、両方のフィールドセットを抽出し、下流システムで両方を利用できるようにする必要があります。

現在の税置き換え先抽出への影響移行スケジュール
PIS(1.65% / 0.65%)CBS(連邦、約8.8%)新しい<CBS>要素が<PIS>と並んで出現します。移行期間中は両方を抽出する必要があります。CBSは2033年までにPISを完全に置き換えます。2026年:CBSテスト項目(税率0.9%)。2027年:CBS稼働、PIS廃止。
COFINS(7.6% / 3.0%)CBS(連邦、約8.8%)PISと同様に、COFINS項目はCBS項目と共存します。PIS+COFINSの合算抽出では、統合されたCBS税率を考慮する必要があります。2027年:COFINS廃止、CBSは完全税率に。
ICMS(州、州内17-22%、州間4-12%)IBS(州/市、約17.7%)vBC、pIBS、vIBSを含む新しい<IBS>要素グループ。ICMSとIBSは品目ごとに共存します。抽出では両方の課税標準を取得する必要があり、これらは異なる場合があります。2026年:IBSテスト項目(税率0.1%)。2029-2032年:IBSが州ごとに段階的に導入され、ICMSを順次置き換え。
IPI(NCMにより0-330%)IS(選択税、変動)ISはIPIを段階的に置き換えます。移行期間中はIPIとISが共存する場合があります。NCMは引き続き製品分類子です。IPI税率は2027年にゼロ化が始まります。2033年までに完全置き換え。

抽出ワークフローを準備するための3つの実践的ステップ:

1

現在のフィールドマップを監査する

抽出テンプレートを確認し、現在ICMS、IPI、PIS、COFINSにマッピングされているすべてのフィールドを特定します。それぞれについて、対応する新税(PIS/COFINSにはCBS、ICMSにはIBS、IPIにはIS)用の並行フィールドを追加します。まだ新しいフィールドを使用していなくても、CBS/IBSフィールドにデータが入るようになったときに抽出出力列が存在し受け入れ準備が整っているよう、スキーマ空間をマッピングしておく必要があります。

2

デュアルスキーマのサンプルNF-eドキュメントでテストする

すでに新しいCBSおよびIBSフィールドを含むNF-e XMLのサンプルをサプライヤーに依頼します(2026年8月1日以降に発行されるすべてのNF-eには両方が含まれます)。これらを抽出パイプラインで処理し、旧税フィールドと新税フィールドが正しく抽出されることを確認します。抽出がスクリプトベースの場合、ICMS用のXPathクエリが誤ってIBS値を取得しないことを確認してください。要素グループの命名パターンは類似しています。

3

デュアルフィールド戦略を決定する

今後7〜8年間、抽出データには旧税フィールドと新税フィールドの両方が含まれます。次のいずれかを決定してください。(a) 出力スプレッドシートで並行する列を維持し、下流のユーザーにどちらを使用するか選択させる、または (b) 特定の列を段階的に導入し、他の列を特定の日付で段階的に廃止する移行タイムラインを実装する。ほとんどのAPチームは移行初期にはオプション (a) を好みます。出力テーブルは長くなりますが、混合レジーム期間中に唯一有効なフィールドを失うリスクを回避できます。

よくある質問

NF-eのフィールドを抽出する際、XML名前空間を処理する必要がありますか?

はい。NF-e XMLは<nfeProc>要素で宣言されたデフォルト名前空間(通常はxmlns="http://www.portalfiscal.inf.br/nfe")を使用します。XPathクエリでは、この名前空間を登録するか(Pythonのlxmlではns = {'nfe': 'http://www.portalfiscal.inf.br/nfe'})、local-name()を使用して回避する必要があります。Power QueryのXMLコネクタはほとんどの場合、名前空間を自動的に処理します。抽出ツールが明示的な名前空間登録を必要とする場合は、正しいURIを使用していることを確認してください。不一致があると、結果セットが警告なしに空になります。

明細行の税額を合計し、ヘッダーの合計と比較すべきですか?

はい — これは実装できる最も価値のある検証チェックの1つです。NF-e XMLは税の合計を<total>/<ICMSTot>に、明細行の詳細を各<det>に保持しています。これらは一致するはずです。明細行の合計とヘッダーの合計の不一致は危険信号です。XML生成時に明細行が省略された、割引が一貫性なく適用された、またはサプライヤーのERPに設定エラーがある可能性があります。すべての抽出バッチの標準ステップとして、明細行の税額をヘッダーの合計と照合してください。

NF-e抽出はSPED報告要件をカバーしますか?

いいえ。SPED(Sistema Público de Escrituração Digital)はブラジルのデジタル簿記申告システムであり、州税用のEFD-ICMS/IPIと連邦拠出金用のEFD-Contribuiçõesがあり、データを特定のSPEDレイアウトでフォーマットし、認定ソフトウェアを通じて提出する必要があります。NF-e抽出は請求書データをスプレッドシートに取り込むものであり、SPED準拠のレコードを生成するものではありません。ただし、NF-eから抽出するデータ(明細行のICMS、PIS、COFINS、CFOP、NCM、CST)は、SPED申告に取り込まれるデータと同じです。抽出ワークフローが明細行レベルで税の詳細を正しく取得していれば、ブラジルの経理チームはそのデータを使用して必要なSPEDレコードを入力でき、ソースドキュメントから再入力する必要はありません。NF-eフィールドからSPEDレイアウト位置へのマッピングは別の変換ステップであり、一部のERPローカライゼーションモジュールが自動的に処理します。

自社がブラジルの複数の州に複数のCNPJを持つ場合はどうなりますか?

大規模な組織ではよくあることです。各CNPJ(ポルトガル語で「estabelecimento」)は税務上別個の法人であり、NF-eの宛先州は商品を受け取ったCNPJに対応します。複数法人の組織でNF-eデータを抽出する場合は、受領者CNPJ(<dest>/<CNPJ>)で抽出出力をフィルタリングし、法人ごとに個別のGLマッピングを維持してください。ICMS税率の検証も法人ごとに異なります — 同じサプライヤーからでも、サンパウロのCNPJに発送された商品とバイーアのCNPJに発送された商品では税率が異なります。ブラジルの州ごとの複雑さへの対応については、手頃なNF-e抽出ガイドをご覧ください。

過去の期間から抽出したデータがある状態でNCMコードが変更された場合はどうなりますか?

NCMコードはReceita Federalによって定期的に更新されます(通常は年1回ですが、Notas Técnicasによる年中調整が行われることもあります)。NCMコードが変更されると、その製品分類のIPI税率も変更される可能性があります。抽出目的では、発行時点でNF-eに記載されているNCMコードを取得する必要があります — それは請求書日付時点で有効だったコードであり、法的に納付すべき税金を決定するものです。遡及分析やSPED調整を行う場合は、現在のNCMリストではなく、元のドキュメントに記録されたNCMを使用してください。

サプライヤーのNF-e XMLに要素の欠落や不正な形式がある場合はどうなりますか?

よくあることです。最も一般的な問題は、<cobr>(請求)グループの欠落、<enderEmit>の住所の不完全さ、または宣言されたCSTコードに対して期待されるスキーマバリアントに従わないICMSサブグループです。抽出ワークフローはこれらを適切に処理する必要があります — 欠落フィールドにはnullまたはプレースホルダーを返し、検証警告をログに記録してください。重要でない欠落要素でハード失敗させないでください。重要なフィールド(アクセスキー、CNPJ、明細合計)については、値の欠落はそのNF-eを明確なエラーメッセージとともにバッチから拒否するトリガーとなるべきです。検証サマリーレポートは不可欠です。欠落または異常なフィールドがあったすべてのNF-eをログに記録し、チームがGLに転記する前に調査できるようにしてください。

DIFAL(州間のICMS税率差)はどのように処理すればよいですか?

DIFAL(Diferencial de Alíquota do ICMS)は、商品が州をまたいで販売され、仕向地州のICMS税率が原産地で支払った州間税率より高い場合に適用されます。買い手は税率差を自分の州に支払う必要があります。NF-e上では、DIFALは<imposto>/<ICMS>配下の<ICMSPart>サブグループで表現されます。このサブグループには、vBC(計算基数)、pICMS(すでに適用された州間税率)、pICMSUf(仕向地州の内国税率)、vICMS(DIFAL額=基数に対する2つの税率の差)が含まれます。DIFAL額は別途抽出し、州固有のICMSクレジットワークフローで処理する必要があります。通常のICMSクレジットには含まれません。

運賃と保険は製品価値とは別に抽出すべきですか?

はい。NF-e XMLは取引を製品価値(vProd)、運賃(vFrete)、保険(vSeg)、その他の費用(vOutro)に分解します。ICMS課税基数には、製品価値+運賃+保険+その他の費用の合計が含まれることがよくありますが、常にそうとは限りません。製品価値のみでICMSが計算される製品もあります。各構成要素を個別に抽出することで、ICMS課税基数が価格構造の理解と一致するかを検証できます。NF-e上で運賃がICMS基数に含まれているのに、ERPモデルが運賃をICMS基数外と想定している場合、解決すべき照合項目が生じます。

AIベースの抽出ツールはNF-e XML全体を処理できますか、それともDANFE PDFのみですか?

ツールによります。ImageToTable.aiのAIベースの抽出は、NF-e XMLファイル(構造化データ)とDANFE PDF(視覚的ドキュメント)の両方を同じバッチで処理できます。XMLをアップロードすると、ツールは構造化要素を直接読み取り(OCR不要)、列テンプレートにマッピングします。DANFE PDFをアップロードすると、AIが視覚的コンテンツを読み取り、表示されているフィールドを抽出します。両方に対応する単一プラットフォームの主な利点は一貫性です。「NF-e Access Key」「ICMS Amount」「CFOP Code」に対して1つの列テンプレートを定義すれば、受け取ったソースドキュメントに応じてツールがそれらを入力します。これにより、XMLベースのサプライヤーとDANFEベースのサプライヤーで別々のワークフローを維持する必要がなくなり、ブラジルのAP業務でよくある分断ポイントが解消されます。

抽出結果もXMLと一緒にアーカイブする必要がありますか?

ブラジル法では、取引が行われた会計年度の末日から5年間、元のNF-e XMLをアーカイブすることが義務付けられています。抽出結果(スプレッドシートやERPの記録)はXMLの代替にはなりません。ただし、生のXMLアーカイブと並行して構造化された抽出結果を保持することは、内部照合や監査対応のためのベストプラクティスです。SEFAZの監査では、元のXML(文書が存在し、適切に承認されていたことを証明するため)と会計記録(データがどのように処理されたかを示すため)の両方を提出する必要が生じる可能性が高いです。アクセスキーを結合キーとして、ソースXMLと抽出結果の両方をリンクされた構造で自動的にアーカイブする抽出ワークフローは、監査準備の時間を大幅に短縮します。コスト効率の良いコンプライアンスの選択肢については、小規模事業者向けNF-e抽出ガイドをご覧ください。

自分のNF-eドキュメントで抽出をテスト

NF-e抽出は理論的な演習ではありません。受け取るすべてのXMLには、完全に構造化され、政府によって検証され、すぐに使えるデータが含まれています。唯一の問題は、ワークフローがERPや財務記録に到達する前に、そのデータを十分に抽出し、正しく検証できるかどうかです。本ガイドのフィールドマップ、税検証表、コードリファレンスが参照レイヤーを提供します。抽出エンジンがドキュメントを処理します。この組み合わせにより、ブラジルNF-eはチームが解析に苦労する不透明なXMLファイルから、自信を持って使用できる透明な財務データソースへと変わります。記帳、クレジット回収、監査防御のために。

📮 contact email: [email protected]