NFS-e Nacional: 11月までにシステムに統合する方法

NFS-e Nacionalの新しい期限と貴社にとっての変化

NFS-e Nacionalを自社システムに統合する方法を知ることは、サービスプロバイダーや開発者にとって技術的および運用上の優先事項となっています。CGSN決議第191/2026号は、ISSの対象となるサービスを提供するSimples Nacionalを選択している零細企業（ME）および中小企業（EPP）に対する義務化期限の公式延期を、2026年9月1日から同年11月1日に設定しました。個人事業主（MEI）は、2023年9月1日からすでにこの基準を義務的に使用しています。

この変更は、技術的な適応のための猶予を与えることを目的としていますが、スケジュールには注意が必要です。2026年11月1日から12月31日までは移行期間が適用されます。企業は国のシステムを通じて発行を開始しますが、Simples Nacionalの課税規則に従い続け、新しい税金であるIBSとCBSは直ちには適用されません。SimplesにおけるIBSとCBSによる徴収は、2027年1月1日から有効となり、2026年のシステムにおける税制改革のシナリオに統合されます。

この基準の採用により、税務モデルが統一されるため、異なる自治体向けに請求書を発行する業務が簡素化されます。すでに19の州都を含む約3,000の自治体がこの基準を採用しており、これは全国のサービス請求書発行量の約80%に相当します。

主要なポイント

• 最終期限: Simples NacionalのMEおよびEPPは2026年11月1日。
• 移行期間: 2026年11月1日から12月31日まで（IBS/CBSは2027年1月1日からSimplesに適用）。
• 発行方法: Web、モバイルアプリケーション、およびAPI REST経由の統合。
• APIの技術要件: mTLS付きTLS、ICP-Brasil証明書（A1/A3）、XMLDSIGで署名されたUTF-8のXML 1.0、およびBase64でGZip圧縮されたペイロード。

発行方法: ウェブサイト、アプリケーション、それともAPI統合？

国の基準に準拠した請求書の発行は、連邦政府が提供するEmissor Nacionalを通じてのみ、3つの異なる方法で行うことができます。選択は、企業の販売量と運用プロセスの自動化の必要性に直接依存します。

最初の方法は、公式アドレスnfse.gov.br/EmissorNacionalで利用可能なウェブアプリケーションです。2番目の選択肢は公式モバイルアプリケーションです。どちらも無料で、1日の請求書発行量が少ない場合に推奨されますが、各取引で手動入力が必要です。3番目の方法は、API Webを介したERPまたはチェックアウトの直接統合であり、規模の拡大と自動化を必要とする企業に推奨されます。

意思決定を支援するために、国の基準の全体像におけるオプションの比較をご覧ください。

NFS-e Nacional API統合のための技術要件

発行システムをソフトウェアに直接統合するには、公式ドキュメントで規定されている厳格なセキュリティおよびフォーマット仕様を満たす必要があります。通信チャネルは、主要なリクエストでJSON形式のデータを送受信するRESTアーキテクチャ上に構築されています。

サーバーとの安全な接続を確立するには、相互認証（mTLS）付きのTLSプロトコルを使用することが義務付けられています。これは、接続のハンドシェイク中に、システム技術責任者にリンクされた有効なICP-Brasilデジタル証明書（A1またはA3タイプ）をアプリケーションが提示する必要があることを意味します。

税務書類のデータフロー自体には特定の構造が必要です。サービスのペイロードには、UTF-8でエンコードされ、XMLDSIG標準でデジタル署名されたXML 1.0が含まれています。さらに、APIを介して送信する前に、署名されたXMLはGZip形式で圧縮され、Base64文字列に変換される必要があります。

// Exemplo conceitual do fluxo de preparação do payload para a API
import { gzipSync } from 'zlib';

function prepararPayloadNFSe(xmlAssinadoUTF8: string): string {
  // 1. Converter XML para Buffer UTF-8
  const xmlBuffer = Buffer.from(xmlAssinadoUTF8, 'utf-8');
  
  // 2. Compactar o buffer em GZip
  const gzippedBuffer = gzipSync(xmlBuffer);
  
  // 3. Converter para Base64 para envio na requisição JSON
  return gzippedBuffer.toString('base64');
}

ウェブサービスによって提供されるエンドポイントは、税務書類のライフサイクル全体をカバーしています。これには、NFS-eの発行、バッチおよび個別請求書の照会、発行済み書類のキャンセル、税務イベントの受信、およびPDF形式でのDANFSEの自動生成が含まれます。

認定、承認環境、およびスキーマ検証

技術的な認定プロセスでは、アプリケーションの責任者が有効なCNPJと、技術責任者のe-CNPJまたはe-CPFデジタル証明書を所有している必要があります。システム運用中の秘密鍵の保護を確実にするために、資格情報をHSM（Hardware Security Module）または安全なデジタル金庫に保存することを強くお勧めします。

本番環境にリクエストを送信する前に、開発者は別の承認環境にアクセスできます。Portal NFS-eでは、APIクライアントの生成とテストルーティングを容易にするために、SwaggerファイルとYAML仕様が利用可能です。

2025年12月10日以降、政府機関は、技術ノート004バージョン2.0に準拠したIBSCBSグループのフィールドに焦点を当てた制限付き環境を提供しています。この環境では、税制移行の段階で発効する完全な税務構造をシミュレートできます。

スキーマ検証とAPIドキュメントの警告によると、レイアウトのわずかなエラー、必須フィールドの欠落、または無効なデータ型は、操作を即座に中断させます。したがって、ウェブサービスにパッケージを送信する前に、厳格なXMLスキーマ検証レイヤーをローカルに実装することは、発行キューでのブロックを回避するために不可欠なステップです。

11月までの実践的な実装ロードマップ

2026年11月1日の期限までにシステムが問題なく稼働することを確実にするために、以下の4つの実践的なステップで構成されたスケジュールに従うことをお勧めします。

1. デジタル証明書の監査: 貴社または貴社ソフトウェアの顧客が有効なA1/A3 ICP-Brasil証明書を所有しているかを確認し、mTLSアクセスキーを管理するためにデジタル金庫またはHSMを設定してください。
2. スキーマのモデリングと署名: アプリケーション内で、XML 1.0 UTF-8への変換、XMLDSIG署名、GZip圧縮、およびBase64エンコーディングのモジュールを開発してください。
3. 承認環境でのテスト: Portal NFS-eのSwaggerドキュメントを使用し、発行、照会、キャンセル、およびPDF形式でのDANFSE生成をカバーするテストシナリオを実行してください。
4. 移行ルールの検証: IBSCBSグループ（技術ノート004 v2.0）を含む制限付き環境を利用して、データベース構造とAPIが将来の税制変更にすでに備えていることを確認してください。

よくある質問

MEおよびEPPがNFS-e Nacionalを採用する最終期限はいつですか？

Simples Nacionalを選択している零細企業および中小企業の最終期限は2026年11月1日です。この日付は、CGSN決議第191/2026号によって正式に定められ、当初の義務であった2026年9月から変更されました。

MEIは2026年11月に発行システムを変更する必要がありますか？

いいえ、MEIはこの日付で変更を行う必要はありません。個人事業主（MEI）は、2023年9月1日からすでにNFS-eのEmissor Nacionalの基準を使用することが義務付けられています。

National APIに接続するためのセキュリティ要件は何ですか？

APIに接続するには、HTTPSとTLS、および技術責任者のICP-Brasil A1またはA3デジタル証明書を使用した相互認証（mTLS）が必要です。リクエストはJSONで送信され、XMLDSIGで署名され、GZipで圧縮され、Base64でエンコードされたXMLを含むペイロードが必要です。

APIのドキュメントとテスト環境はどこで入手できますか？

公式ドキュメント、Swaggerファイル、およびYAML仕様は、連邦政府のPortal NFS-eで公開されています。このポータルでは、承認環境とコード検証のための制限付き環境が提供されています。

結論

NFS-e Nacionalへの移行は避けられず、2026年11月1日までの期限延長は、慌てることなくコードを整理するための絶好の機会を提供します。国の基準の下で発行を統一することで、複数の地方自治体のレイアウトに対応する複雑さが解消され、今後数年間の税務要件に備えるための構造が整います。

今日の具体的な推奨事項: Portal NFS-eにアクセスし、更新されたAPIのSwagger仕様をダウンロードし、承認環境で企業のデジタル証明書を設定して、最初のテスト実行を行ってください。