Emissor de NF-e e NFC-e com SPED PHP

📋 Introdução à NFC-e

A Nota Fiscal do Consumidor Eletrônica (NFC-e) é um documento digital emitido para registrar operações comerciais presenciais (como vendas em lojas), substituindo a nota fiscal de modelo 1 ou 2 e o cupom fiscal.

🔗 Fluxo da NFC-e

⚙️ Requisitos Obrigatórios

Antes de iniciar o desenvolvimento, é fundamental ter em mãos todos os requisitos legais e técnicos:

🎯 Ambientes de Trabalho

📚 A Biblioteca SPED PHP

🎯 O que a SPED PHP faz?

• ✅ Geração e validação de XMLs
• ✅ Assinatura digital com certificado
• ✅ Comunicação com webservices SEFAZ
• ✅ Consulta e tratamento de retornos
• ✅ Geração de DANFE
• ✅ Cancelamento e inutilização

📦 Estrutura de Pacotes

⚡ Requisitos do Sistema

🔧 Extensões PHP Necessárias

📥 Instalação via Composer

# Instalar o pacote principal
composer require nfephp-org/sped-nfe

# Ou adicionar no composer.json
{
    "require": {
        "nfephp-org/sped-nfe": "^5.0"
    }
}

🔄 Processo de Emissão em 4 Etapas

<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
  <infNFe Id="NFe35150900000000000000650010000000010000000000" versao="4.00">
    <ide>
      <cUF>35</cUF>
      <cNF>00000000</cNF>
      <natOp>VENDA AO CONSUMIDOR</natOp>
      <mod>65</mod>
      <serie>1</serie>
      <nNF>1</nNF>
      <dhEmi>2025-09-25T10:00:00-03:00</dhEmi>
      <tpNF>1</tpNF>
      <idDest>1</idDest>
      <tpAmb>2</tpAmb>
    </ide>
    <!-- ... demais seções -->
  </infNFe>
</NFe>

// Com NFePHP
$nfe->assinarNFe();

// Manualmente (exemplo simplificado)
openssl_pkcs7_sign(
    $xmlFile, 
    $signedFile, 
    $certificate, 
    $privateKey, 
    [], 
    PKCS7_BINARY | PKCS7_DETACHED
);

<protNFe versao="4.00">
  <infProt>
    <tpAmb>2</tpAmb>
    <verAplic>SP_NFCE_4.0</verAplic>
    <chNFe>35240912345678000123650010000001234567890123</chNFe>
    <dhRecbto>2025-09-25T10:05:00-03:00</dhRecbto>
    <nProt>135220000000123</nProt>
    <digVal>Wm9tQWRpZ0hhc2hEYURpZ0hhc2hEYQ==</digVal>
    <cStat>100</cStat>
    <xMotivo>Autorizado o uso da NFC-e</xMotivo>
  </infProt>
</protNFe>

🎯 Resumo do Fluxo para o Usuário

💻 Exemplo Prático de Implementação

📦 Estrutura do Projeto

Primeiro, vamos entender a estrutura de arquivos recomendada:

projeto-nfce/
├── composer.json
├── index.php
├── config/
│   └── config.json
├── src/
│   ├── EmissorNFCe.php
│   └── Database.php
├── certificates/
│   └── certificado.pfx
├── storage/
│   ├── xmls/
│   ├── pdfs/
│   └── logs/
└── vendor/
    └── nfephp-org/

1. Configuração Inicial

{
    "name": "seu-projeto/nfce-emissor",
    "description": "Sistema emissor de NFC-e com PHP",
    "type": "project",
    "require": {
        "nfephp-org/sped-nfe": "^5.0",
        "ext-curl": "*",
        "ext-dom": "*",
        "ext-openssl": "*",
        "ext-soap": "*",
        "ext-zip": "*",
        "ext-json": "*",
        "ext-mbstring": "*"
    },
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

# Instalar dependências
composer install

# Ou se já tem o composer.json, apenas:
composer update

# Verificar extensões PHP necessárias
php -m | grep -E "(curl|dom|openssl|soap|zip|json|mbstring)"

{
    "atualizacao": "2025-09-25 10:00:00",
    "tpAmb": 2,
    "razaosocial": "SUA EMPRESA LTDA",
    "cnpj": "12345678000123",
    "siglaUF": "SP",
    "schemes": "PL_009_V4",
    "versao": "4.00",
    "tokenIBPT": "",
    "CSC": "SEU_CODIGO_CSC",
    "CSCid": "1",
    "pathNFSeFiles": "/var/www/nfse/",
    "pathSalvar": "/var/www/nfe/arquivos/",
    "pathLogo": "/var/www/nfe/logo.png",
    "pathCertificado": "/var/www/nfe/certificates/",
    "certPfx": "certificado.pfx",
    "certPassword": "sua_senha_secreta",
    "certPhrase": "",
    "aProxyConf": {
        "proxyIp": "",
        "proxyPort": "",
        "proxyUser": "",
        "proxyPass": ""
    },
    "aMailConf": {
        "mailAuth": true,
        "mailFrom": "nfe@empresa.com.br",
        "mailSmtp": "smtp.empresa.com.br",
        "mailUser": "nfe@empresa.com.br",
        "mailPass": "sua_senha_email",
        "mailProtocol": "ssl",
        "mailPort": "587",
        "mailFromMail": "nfe@empresa.com.br",
        "mailFromName": "SUA EMPRESA LTDA"
    }
}

-- Tabela de empresas (emitente)
CREATE TABLE empresas (
    id INT PRIMARY KEY AUTO_INCREMENT,
    razao_social VARCHAR(255) NOT NULL,
    nome_fantasia VARCHAR(255),
    cnpj VARCHAR(14) UNIQUE NOT NULL,
    ie VARCHAR(20),
    regime_tributario VARCHAR(1),
    -- ... outros campos
);

-- Tabela de produtos
CREATE TABLE produtos (
    id INT PRIMARY KEY AUTO_INCREMENT,
    codigo VARCHAR(50) UNIQUE NOT NULL,
    descricao VARCHAR(255) NOT NULL,
    ncm VARCHAR(8) NOT NULL,
    cest VARCHAR(7),
    unidade VARCHAR(10) NOT NULL,
    valor DECIMAL(10,2) NOT NULL,
    -- campos fiscais
    origem VARCHAR(1) DEFAULT '0',
    cst_icms VARCHAR(3),
    aliquota_icms DECIMAL(5,2),
    cst_pis VARCHAR(2) DEFAULT '06',
    cst_cofins VARCHAR(2) DEFAULT '06'
);

-- Tabela de NFC-e
CREATE TABLE nfce (
    id INT PRIMARY KEY AUTO_INCREMENT,
    numero INT NOT NULL,
    serie INT DEFAULT 1,
    chave VARCHAR(44) UNIQUE,
    status VARCHAR(20) DEFAULT 'pendente',
    xml_enviado TEXT,
    xml_autorizado TEXT,
    protocolo VARCHAR(50),
    data_emissao DATETIME,
    valor_total DECIMAL(10,2),
    -- ... outros campos
);

2. Classe Principal do Emissor

<?php

namespace App;

use NFePHP\NFe\Tools;
use NFePHP\Common\Certificate;
use Exception;

class EmissorNFCe
{
    private $tools;
    private $config;
    
    public function __construct($configPath)
    {
        $this->carregarConfiguracao($configPath);
        $this->inicializarTools();
    }
    
    private function carregarConfiguracao($configPath)
    {
        if (!file_exists($configPath)) {
            throw new Exception("Arquivo de configuração não encontrado: $configPath");
        }
        
        $this->config = json_decode(file_get_contents($configPath), true);
        
        if (json_last_error() !== JSON_ERROR_NONE) {
            throw new Exception("Erro ao decodificar JSON de configuração: " . json_last_error_msg());
        }
    }
    
    private function inicializarTools()
    {
        $certificate = Certificate::readPfx(
            file_get_contents($this->config['pathCertificado'] . $this->config['certPfx']),
            $this->config['certPassword']
        );
        
        $this->tools = new Tools($this->config, $certificate);
        $this->tools->model('65'); // NFC-e
    }
    
    public function emitir($dadosVenda)
    {
        try {
            // 1. Montar XML
            $xml = $this->montarXML($dadosVenda);
            
            // 2. Assinar
            $xmlAssinado = $this->tools->signNFe($xml);
            
            // 3. Validar
            $this->validarNFe($xmlAssinado);
            
            // 4. Enviar para SEFAZ
            $resp = $this->tools->sefazEnviaLote([$xmlAssinado], $dadosVenda['idLote']);
            
            // 5. Consultar recibo
            $protocolo = $this->consultarRecibo($resp['infRec']['nRec']);
            
            return [
                'sucesso' => true,
                'chave' => $this->tools->getChave(),
                'protocolo' => $protocolo,
                'xml' => $xmlAssinado
            ];
            
        } catch (Exception $e) {
            return [
                'sucesso' => false,
                'erro' => $e->getMessage()
            ];
        }
    }
    
    private function montarXML($dados)
    {
        // Configuração básica
        $this->tools->tagide(
            $dados['cUF'],
            $dados['cNF'],
            $dados['natOp'],
            $dados['mod'],
            $dados['serie'],
            $dados['nNF'],
            $dados['dhEmi'],
            $dados['tpNF'],
            $dados['idDest'],
            $dados['cMunFG'],
            $dados['tpImp'],
            $dados['tpEmis'],
            $dados['tpAmb'],
            $dados['finNFe'],
            $dados['indFinal'],
            $dados['indPres'],
            $dados['procEmi']
        );
        
        // Emitente
        $this->tools->tagemit(
            $this->config['cnpj'],
            $this->config['razaosocial'],
            $this->config['nomefantasia'] ?? '',
            $dados['enderEmit']['xLgr'],
            $dados['enderEmit']['nro'],
            $dados['enderEmit']['xBairro'],
            $dados['enderEmit']['cMun'],
            $dados['enderEmit']['xMun'],
            $dados['enderEmit']['UF'],
            $dados['enderEmit']['CEP'],
            $dados['enderEmit']['cPais'] ?? '1058',
            $dados['enderEmit']['xPais'] ?? 'BRASIL',
            $dados['enderEmit']['fone'] ?? '',
            $this->config['ie'],
            $this->config['crt'] ?? '1'
        );
        
        // Destinatário (opcional para NFC-e)
        if (isset($dados['destinatario'])) {
            $this->tools->tagdest(
                $dados['destinatario']['cnpj'] ?? '',
                $dados['destinatario']['cpf'] ?? '',
                $dados['destinatario']['xNome'] ?? '',
                $dados['destinatario']['enderDest']['xLgr'] ?? '',
                $dados['destinatario']['enderDest']['nro'] ?? '',
                $dados['destinatario']['enderDest']['xBairro'] ?? '',
                $dados['destinatario']['enderDest']['cMun'] ?? '',
                $dados['destinatario']['enderDest']['xMun'] ?? '',
                $dados['destinatario']['enderDest']['UF'] ?? '',
                $dados['destinatario']['enderDest']['CEP'] ?? '',
                $dados['destinatario']['enderDest']['cPais'] ?? '1058',
                $dados['destinatario']['enderDest']['xPais'] ?? 'BRASIL',
                $dados['destinatario']['enderDest']['fone'] ?? '',
                $dados['destinatario']['indIEDest'] ?? '9',
                $dados['destinatario']['IE'] ?? ''
            );
        } else {
            // Consumidor não identificado
            $this->tools->tagdest('', '', 'CONSUMIDOR NÃO IDENTIFICADO');
        }
        
        // Produtos
        foreach ($dados['produtos'] as $item) {
            $this->tools->tagprod(
                $item['cProd'],
                $item['cEAN'] ?? 'SEM GTIN',
                $item['xProd'],
                $item['NCM'],
                $item['CEST'] ?? '',
                $item['CFOP'],
                $item['uCom'],
                $item['qCom'],
                $item['vUnCom'],
                $item['vProd'],
                $item['cEANTrib'] ?? 'SEM GTIN',
                $item['uTrib'],
                $item['qTrib'],
                $item['vUnTrib'],
                $item['indTot'] ?? '1'
            );
            
            // Impostos
            $this->tools->tagICMS(
                $item['imposto']['ICMS']['orig'] ?? '0',
                $item['imposto']['ICMS']['CST'] ?? '',
                $item['imposto']['ICMS']['CSOSN'] ?? '102',
                $item['imposto']['ICMS']['modBC'] ?? '0',
                $item['imposto']['ICMS']['vBC'] ?? '0.00',
                $item['imposto']['ICMS']['pICMS'] ?? '0.00',
                $item['imposto']['ICMS']['vICMS'] ?? '0.00'
            );
        }
        
        // Pagamento
        $this->tools->tagpag($dados['pagamento']['tPag'], $dados['pagamento']['vPag']);
        
        return $this->tools->getXML();
    }
    
    private function validarNFe($xml)
    {
        // Validação contra schema XSD
        $this->tools->validar($xml);
    }
    
    private function consultarRecibo($numeroRecibo)
    {
        // Aguardar processamento
        sleep(5);
        
        $attempts = 0;
        while ($attempts < 10) {
            $resp = $this->tools->sefazConsultaRecibo($numeroRecibo);
            
            if ($resp['cStat'] == '104') {
                // Lote em processamento, aguardar
                sleep(3);
                $attempts++;
                continue;
            }
            
            if ($resp['cStat'] == '100') {
                return $resp['nProt']; // Nota autorizada
            }
            
            if ($resp['cStat'] == '101' || $resp['cStat'] == '110') {
                throw new Exception("Nota cancelada ou denegada: " . $resp['xMotivo']);
            }
            
            // Outros status de erro
            throw new Exception("Erro na consulta: " . $resp['xMotivo']);
        }
        
        throw new Exception("Tempo limite excedido para consulta do recibo");
    }
}

3. Exemplo de Uso

<?php
require_once 'vendor/autoload.php';
use App\EmissorNFCe;

try {
    // Inicializar emissor
    $emissor = new EmissorNFCe('config/config.json');
    
    // Dados da venda
    $dadosVenda = [
        'idLote' => 1,
        'cUF' => '35',
        'cNF' => rand(10000000, 99999999),
        'natOp' => 'VENDA AO CONSUMIDOR',
        'mod' => '65',
        'serie' => '1',
        'nNF' => '1',
        'dhEmi' => date('c'),
        'tpNF' => '1',
        'idDest' => '1',
        'cMunFG' => '3520509',
        'tpImp' => '4',
        'tpEmis' => '1',
        'tpAmb' => '2',
        'finNFe' => '1',
        'indFinal' => '1',
        'indPres' => '1',
        'procEmi' => '0',
        
        'enderEmit' => [
            'xLgr' => 'Rua Exemplo',
            'nro' => '123',
            'xBairro' => 'Centro',
            'cMun' => '3520509',
            'xMun' => 'Indaiatuba',
            'UF' => 'SP',
            'CEP' => '13330000',
            'fone' => '19999999999'
        ],
        
        'produtos' => [
            [
                'cProd' => '001',
                'xProd' => 'Produto de Exemplo',
                'NCM' => '39269090',
                'CFOP' => '5102',
                'uCom' => 'UN',
                'qCom' => '1.0000',
                'vUnCom' => '50.00',
                'vProd' => '50.00',
                'uTrib' => 'UN',
                'qTrib' => '1.0000',
                'vUnTrib' => '50.00',
                'imposto' => [
                    'ICMS' => [
                        'orig' => '0',
                        'CSOSN' => '102'
                    ]
                ]
            ]
        ],
        
        'pagamento' => [
            'tPag' => '01', // Dinheiro
            'vPag' => '50.00'
        ]
    ];
    
    // Emitir NFC-e
    $resultado = $emissor->emitir($dadosVenda);
    
    if ($resultado['sucesso']) {
        echo "✅ NFC-e emitida com sucesso!";
        echo "Chave: " . $resultado['chave'];
        echo "Protocolo: " . $resultado['protocolo'];
        
        // Salvar XML no banco de dados
        salvarNFCeNoBanco($resultado);
        
    } else {
        echo "❌ Erro na emissão: " . $resultado['erro'];
    }
    
} catch (Exception $e) {
    echo "❌ Erro: " . $e->getMessage();
}

function salvarNFCeNoBanco($resultado) {
    // Implementar lógica de salvamento no banco
    // Exemplo com PDO:
    /*
    $pdo = new PDO('mysql:host=localhost;dbname=nfce', 'usuario', 'senha');
    $stmt = $pdo->prepare("INSERT INTO nfce (chave, protocolo, xml_autorizado, status) VALUES (?, ?, ?, 'autorizada')");
    $stmt->execute([$resultado['chave'], $resultado['protocolo'], $resultado['xml']]);
    */
}
?>

4. Tratamento de Erros Comuns

👥 Cadastros Necessários para o Sistema

{
  "empresa": {
    "razao_social": "EMPRESA EXEMPLO LTDA",
    "nome_fantasia": "LOJA EXEMPLO",
    "cnpj": "12345678000123",
    "ie": "123456789112",
    "regime_tributario": "1",
    "endereco": {
      "logradouro": "Rua Central",
      "numero": "100",
      "bairro": "Centro",
      "cidade": "Indaiatuba",
      "uf": "SP",
      "cep": "13330000"
    },
    "contato": {
      "telefone": "19999999999",
      "email": "contato@empresa.com.br"
    }
  }
}

{
  "atualizacao": "2025-09-25 10:00:00",
  "tpAmb": 2,
  "razaosocial": "EMPRESA EXEMPLO LTDA",
  "cnpj": "12345678000123",
  "siglaUF": "SP",
  "pathSalvar": "/var/www/nfe/arquivos/",
  "certPfx": "/var/www/nfe/certificado.pfx",
  "certPassword": "senha_secreta",
  "certPhrase": "",
  "CSC": "CODIGO_CSC_NFCE",
  "CSCid": "1",
  "aProxyConf": {
    "proxyIp": "",
    "proxyPort": "",
    "proxyUser": "",
    "proxyPass": ""
  }
}

📄 Modelos de XML - NFe e NFC-e

<?xml version="1.0" encoding="UTF-8"?>
<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
  <infNFe Id="NFe35240912345678000123550010000001234567890123" versao="4.00">

    <!-- Identificação -->
    <ide>
      <cUF>35</cUF>
      <cNF>12345678</cNF>
      <natOp>VENDA DE MERCADORIA</natOp>
      <mod>55</mod>
      <serie>1</serie>
      <nNF>1234</nNF>
      <dhEmi>2025-09-24T16:00:00-03:00</dhEmi>
      <tpNF>1</tpNF>
      <idDest>1</idDest>
      <cMunFG>3520509</cMunFG>
      <tpImp>1</tpImp>
      <tpEmis>1</tpEmis>
      <cDV>3</cDV>
      <tpAmb>2</tpAmb>
      <finNFe>1</finNFe>
      <indFinal>1</indFinal>
      <indPres>1</indPres>
      <procEmi>0</procEmi>
      <verProc>1.0</verProc>
    </ide>

    <!-- Emitente -->
    <emit>
      <CNPJ>12345678000123</CNPJ>
      <xNome>EMPRESA EXEMPLO LTDA</xNome>
      <xFant>EMPRESA EXEMPLO</xFant>
      <enderEmit>
        <xLgr>Rua Central</xLgr>
        <nro>100</nro>
        <xBairro>Centro</xBairro>
        <cMun>3520509</cMun>
        <xMun>Indaiatuba</xMun>
        <UF>SP</UF>
        <CEP>13330000</CEP>
        <cPais>1058</cPais>
        <xPais>BRASIL</xPais>
        <fone>19999999999</fone>
      </enderEmit>
      <IE>123456789112</IE>
      <CRT>1</CRT>
    </emit>

    <!-- Destinatário -->
    <dest>
      <CPF>12345678901</CPF>
      <xNome>JOÃO DA SILVA</xNome>
      <enderDest>
        <xLgr>Av. Brasil</xLgr>
        <nro>500</nro>
        <xBairro>Jardim</xBairro>
        <cMun>3520509</cMun>
        <xMun>Indaiatuba</xMun>
        <UF>SP</UF>
        <CEP>13330000</CEP>
        <cPais>1058</cPais>
        <xPais>BRASIL</xPais>
        <fone>19988887777</fone>
      </enderDest>
      <indIEDest>9</indIEDest>
    </dest>

    <!-- Produto -->
    <det nItem="1">
      <prod>
        <cProd>001</cProd>
        <cEAN>SEM GTIN</cEAN>
        <xProd>Produto Exemplo</xProd>
        <NCM>39269090</NCM>
        <CFOP>5102</CFOP>
        <uCom>UN</uCom>
        <qCom>1.0000</qCom>
        <vUnCom>100.00</vUnCom>
        <vProd>100.00</vProd>
        <cEANTrib>SEM GTIN</cEANTrib>
        <uTrib>UN</uTrib>
        <qTrib>1.0000</qTrib>
        <vUnTrib>100.00</vUnTrib>
        <indTot>1</indTot>
      </prod>
      <imposto>
        <ICMS>
          <ICMSSN102>
            <orig>0</orig>
            <CSOSN>102</CSOSN>
          </ICMSSN102>
        </ICMS>
        <PIS>
          <PISNT><CST>06</CST></PISNT>
        </PIS>
        <COFINS>
          <COFINSNT><CST>06</CST></COFINSNT>
        </COFINS>
      </imposto>
    </det>

    <!-- Totais -->
    <total>
      <ICMSTot>
        <vBC>0.00</vBC>
        <vICMS>0.00</vICMS>
        <vICMSDeson>0.00</vICMSDeson>
        <vFCP>0.00</vFCP>
        <vBCST>0.00</vBCST>
        <vST>0.00</vST>
        <vFCPST>0.00</vFCPST>
        <vFCPSTRet>0.00</vFCPSTRet>
        <vProd>100.00</vProd>
        <vFrete>0.00</vFrete>
        <vSeg>0.00</vSeg>
        <vDesc>0.00</vDesc>
        <vII>0.00</vII>
        <vIPI>0.00</vIPI>
        <vIPIDevol>0.00</vIPIDevol>
        <vPIS>0.00</vPIS>
        <vCOFINS>0.00</vCOFINS>
        <vOutro>0.00</vOutro>
        <vNF>100.00</vNF>
      </ICMSTot>
    </total>

    <!-- Transporte -->
    <transp>
      <modFrete>9</modFrete>
    </transp>

    <!-- Pagamento -->
    <pag>
      <detPag>
        <tPag>01</tPag>
        <vPag>100.00</vPag>
      </detPag>
    </pag>

    <!-- Informações Adicionais -->
    <infAdic>
      <infCpl>Documento emitido em ambiente de homologação - SEM VALOR FISCAL</infCpl>
    </infAdic>

    <!-- Responsável Técnico -->
    <infRespTec>
      <CNPJ>12345678000123</CNPJ>
      <xContato>SUPORTE SISTEMA</xContato>
      <email>suporte@empresa.com.br</email>
      <fone>19999999999</fone>
    </infRespTec>

  </infNFe>
</NFe>

<?xml version="1.0" encoding="UTF-8"?>
<NFe xmlns="http://www.portalfiscal.inf.br/nfe">
  <infNFe Id="NFe35240912345678000123650010000001234567890123" versao="4.00">

    <!-- Identificação -->
    <ide>
      <cUF>35</cUF>
      <cNF>87654321</cNF>
      <natOp>VENDA AO CONSUMIDOR</natOp>
      <mod>65</mod>
      <serie>1</serie>
      <nNF>2345</nNF>
      <dhEmi>2025-09-24T16:00:00-03:00</dhEmi>
      <tpNF>1</tpNF>
      <idDest>1</idDest>
      <cMunFG>3520509</cMunFG>
      <tpImp>4</tpImp>
      <tpEmis>1</tpEmis>
      <cDV>3</cDV>
      <tpAmb>2</tpAmb>
      <finNFe>1</finNFe>
      <indFinal>1</indFinal>
      <indPres>1</indPres>
      <procEmi>0</procEmi>
      <verProc>1.0</verProc>
    </ide>

    <!-- Emitente -->
    <emit>
      <CNPJ>12345678000123</CNPJ>
      <xNome>EMPRESA EXEMPLO LTDA</xNome>
      <xFant>EMPRESA EXEMPLO</xFant>
      <enderEmit>
        <xLgr>Rua Central</xLgr>
        <nro>100</nro>
        <xBairro>Centro</xBairro>
        <cMun>3520509</cMun>
        <xMun>Indaiatuba</xMun>
        <UF>SP</UF>
        <CEP>13330000</CEP>
        <cPais>1058</cPais>
        <xPais>BRASIL</xPais>
        <fone>19999999999</fone>
      </enderEmit>
      <IE>123456789112</IE>
      <CRT>1</CRT>
    </emit>

    <!-- Destinatário (opcional na NFC-e) -->
    <dest>
      <xNome>CONSUMIDOR NÃO IDENTIFICADO</xNome>
    </dest>

    <!-- Produto -->
    <det nItem="1">
      <prod>
        <cProd>001</cProd>
        <cEAN>SEM GTIN</cEAN>
        <xProd>Produto Teste NFCe</xProd>
        <NCM>39269090</NCM>
        <CFOP>5102</CFOP>
        <uCom>UN</uCom>
        <qCom>1.0000</qCom>
        <vUnCom>50.00</vUnCom>
        <vProd>50.00</vProd>
        <cEANTrib>SEM GTIN</cEANTrib>
        <uTrib>UN</uTrib>
        <qTrib>1.0000</qTrib>
        <vUnTrib>50.00</vUnTrib>
        <indTot>1</indTot>
      </prod>
      <imposto>
        <ICMS>
          <ICMSSN102>
            <orig>0</orig>
            <CSOSN>102</CSOSN>
          </ICMSSN102>
        </ICMS>
        <PIS><PISNT><CST>06</CST></PISNT></PIS>
        <COFINS><COFINSNT><CST>06</CST></COFINSNT></COFINS>
      </imposto>
    </det>

    <!-- Totais -->
    <total>
      <ICMSTot>
        <vBC>0.00</vBC>
        <vICMS>0.00</vICMS>
        <vProd>50.00</vProd>
        <vNF>50.00</vNF>
      </ICMSTot>
    </total>

    <!-- Transporte -->
    <transp>
      <modFrete>9</modFrete>
    </transp>

    <!-- Pagamento -->
    <pag>
      <detPag>
        <tPag>01</tPag>
        <vPag>50.00</vPag>
      </detPag>
    </pag>

    <!-- Informações Suplementares: QRCode -->
    <infNFeSupl>
      <qrCode>
        https://www.sefaz.sp.gov.br/nfce/qrcode?p=35240912345678000123650010000001234567890123|2|1|XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
      </qrCode>
    </infNFeSupl>

    <infRespTec>
      <CNPJ>12345678000123</CNPJ>
      <xContato>SUPORTE SISTEMA</xContato>
      <email>suporte@empresa.com.br</email>
      <fone>19999999999</fone>
    </infRespTec>

  </infNFe>
</NFe>

<?xml version="1.0" encoding="UTF-8"?>
<nfeProc xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">

  <!-- NFe completa -->
  <NFe xmlns="http://www.portalfiscal.inf.br/nfe">
    <infNFe Id="NFe35240912345678000123550010000001234567890123" versao="4.00">
      <!-- Conteúdo completo da NFe -->
    </infNFe>
  </NFe>

  <!-- Protocolo de Autorização -->
  <protNFe versao="4.00">
    <infProt>
      <tpAmb>2</tpAmb>
      <verAplic>SP_NFE_4.0</verAplic>
      <chNFe>35240912345678000123550010000001234567890123</chNFe>
      <dhRecbto>2025-09-24T16:05:00-03:00</dhRecbto>
      <nProt>135220000000000</nProt>
      <digVal>Wm9tQWRpZ0hhc2hEYURpZ0hhc2hEYQ==</digVal>
      <cStat>100</cStat>
      <xMotivo>Autorizado o uso da NF-e</xMotivo>
    </infProt>
  </protNFe>

</nfeProc>

<?xml version="1.0" encoding="UTF-8"?>
<nfeProc xmlns="http://www.portalfiscal.inf.br/nfe" versao="4.00">

  <!-- NFC-e completa -->
  <NFe xmlns="http://www.portalfiscal.inf.br/nfe">
    <infNFe Id="NFe35240912345678000123650010000001234567890123" versao="4.00">
      <!-- Conteúdo completo da NFC-e -->
    </infNFe>
  </NFe>

  <!-- Protocolo de Autorização -->
  <protNFe versao="4.00">
    <infProt>
      <tpAmb>2</tpAmb>
      <verAplic>SP_NFCE_4.0</verAplic>
      <chNFe>35240912345678000123650010000001234567890123</chNFe>
      <dhRecbto>2025-09-24T16:05:00-03:00</dhRecbto>
      <nProt>135220000000001</nProt>
      <digVal>VmFsZURpZ0hhc2hEYURpZ0hhc2hEYQ==</digVal>
      <cStat>100</cStat>
      <xMotivo>Autorizado o uso da NFC-e</xMotivo>
    </infProt>
  </protNFe>

</nfeProc>

💡 Considerações Finais e Melhores Práticas

🎯 Pontos Críticos de Atenção

🛠️ Arquitetura Recomendada para Produção

🔧 Checklist para Ir para Produção

🚨 Erros Comuns e Suas Soluções

🔗 Recursos e Suporte