Testes de NF-e

Módulo: Fiscal Caminho na aplicação: Menu > Fiscal > Testes NF-e Última atualização: 20/04/2026

Para que serve

Permite executar operações com a SEFAZ em ambiente de homologação — sem valor fiscal. Serve para validar o certificado digital, testar a comunicação com o webservice da SEFAZ, emitir NF-e e NFC-e de teste, cancelar, enviar Carta de Correção (CC-e) e inutilizar numeração. Todas as operações passam pelo emissor interno (emissor-nfe) via ACBrLib.

As operações realizadas aqui não têm valor fiscal. Use apenas para validação técnica.

Quem pode usar

Usuários com acesso ao módulo Fiscal, normalmente responsáveis pela configuração fiscal ou suporte técnico.

Como usar (passo a passo)

Selecionar filial e verificar certificado

1. Acesse Menu > Fiscal > Testes NF-e.
2. Selecione a Filial no seletor do topo. O sistema carrega automaticamente o certificado digital vinculado.
3. Verifique se o certificado está com status ativo e com validade dentro do prazo. Se o certificado estiver expirado ou inativo, as operações ficam bloqueadas.

Consultar status da SEFAZ

1. Na aba Status SEFAZ, confirme ou altere a UF (preenchida automaticamente com base na filial).
2. Clique em Consultar Status.
3. O painel Resultado exibe: status, duração da chamada e motivo retornado pela SEFAZ.

Emitir NF-e de teste

1. Na aba Emitir NF-e, selecione um Pedido confirmado da filial (a NF-e é emitida com os dados e impostos do pedido).
2. Confira os detalhes do pedido exibidos (número, data, cliente, totais).
3. Ajuste a Série e a Natureza de Operação se necessário.
4. Clique em Emitir NF-e de Teste.
5. O painel Resultado exibe a chave de acesso, protocolo, data de autorização e permite baixar o XML e o DANFE.

Emitir NFC-e de teste

1. Na aba Emitir NFC-e, preencha número, série, produto, quantidade, valor e forma de pagamento.
2. Clique em Emitir NFC-e de Teste.

Cancelar NF-e

1. Na aba Cancelamento, informe a Chave de Acesso (44 dígitos) e o Protocolo da nota a cancelar.
2. Informe a Justificativa (mínimo 15 caracteres).
3. Clique em Cancelar NF-e.

Enviar Carta de Correção (CC-e)

1. Na aba Carta Correção, informe a chave de acesso, o número de sequência do evento e o texto da correção (mínimo 15 caracteres, máximo 1.000).
2. Clique em Enviar CC-e.

Inutilizar numeração

1. Na aba Inutilização, informe a série e o intervalo de números (inicial e final).
2. Informe a justificativa (mínimo 15 caracteres).
3. Clique em Inutilizar Numeração e confirme o pop-up.

Atenção: a inutilização é irreversível mesmo em homologação.

Campos da tela

Seletor de filial

Campo	Obrigatório	O que preencher	Observações
Filial	Sim	Selecione a filial emissora	O certificado é carregado automaticamente

Aba Status SEFAZ

Campo	Obrigatório	O que preencher	Observações
UF	Sim	Sigla da UF	Preenchida com a UF da filial

Aba Emitir NF-e

Campo	Obrigatório	O que preencher	Observações
Pedido confirmado	Sim	Selecione na lista	Lista pedidos confirmados da filial
Série	Não	Número da série	Padrão: 90 (homologação)
Natureza de Operação	Não	Texto da natureza	Padrão: "Venda de Mercadoria"

Aba Emitir NFC-e

Campo	Obrigatório	O que preencher	Observações
Número	Sim	Número do documento	—
Série	Não	Série da NFC-e	Padrão: 90
Produto / Descrição	Não	Nome do produto	Padrão: "PRODUTO TESTE HOMOLOGACAO"
Qtd	Não	Quantidade	—
Valor Unit.	Não	Valor unitário	—
Forma Pgto	Não	Selecione na lista	Formas conforme tabela SEFAZ
Valor Pago	Não	Valor do pagamento	—

Aba Cancelamento

Campo	Obrigatório	O que preencher	Observações
Chave de Acesso	Sim	44 dígitos	—
Protocolo	Sim	Número do protocolo	—
Justificativa	Sim	Mínimo 15, máximo 255 caracteres	—

Aba Carta Correção

Campo	Obrigatório	O que preencher	Observações
Chave de Acesso	Sim	44 dígitos	—
Sequência	Não	Número da sequência do evento	Padrão: 1
Texto da Correção	Sim	Mínimo 15, máximo 1.000 caracteres	—

Aba Inutilização

Campo	Obrigatório	O que preencher	Observações
Série	Sim	Série a inutilizar	—
Nro Inicial	Sim	Primeiro número do intervalo	—
Nro Final	Sim	Último número do intervalo	—
Justificativa	Sim	Mínimo 15, máximo 255 caracteres	—

Validações e regras

• Todas as operações exigem filial selecionada com certificado digital ativo e dentro da validade.
• A chave de acesso para cancelamento e CC-e deve ter exatamente 44 caracteres.
• A justificativa de cancelamento e inutilização deve ter no mínimo 15 caracteres.
• Enquanto uma operação está em andamento, o botão exibe loading e os demais ficam desabilitados.

Mensagens de erro e o que fazer

Mensagem	Causa	Como resolver
"Selecione uma filial com certificado ativo"	Filial sem certificado ou certificado inativo/vencido	Configure o certificado digital na filial
"Selecione um pedido confirmado"	Botão de emissão NF-e clicado sem pedido	Selecione um pedido na lista
"44 caracteres"	Chave de acesso com tamanho incorreto	Corrija a chave informada
"Erro ao carregar filiais"	Falha na requisição	Verifique a conectividade
"Nenhum certificado digital configurado para esta filial"	Filial sem certificado cadastrado	Configure o certificado no cadastro da filial
⚠️ CONFIRMAR demais mensagens de erro (retornadas pela SEFAZ via cStat/xMotivo)	Rejeição da SEFAZ	Consulte o código cStat e xMotivo no painel de resultado e corrija os dados da NF-e

Integrações e dependências

• Comunica-se com o emissor interno apps/api-dfe-emissor (ACBrLib via FFI) em http://localhost:3001.
• O emissor aciona o webservice SEFAZ em homologação com mTLS usando o certificado A1 da filial (armazenado no S3).
• Carrega pedidos confirmados via testesNFeService.listarPedidosConfirmados.
• Depende de filiaisService (para listar filiais e carregar o certificado).

Dúvidas frequentes

Por que o botão fica desabilitado mesmo com filial selecionada? O certificado precisa estar ativo e com diasParaVencer > 0. Se o certificado estiver expirado, configure um novo no cadastro da filial.

Os pedidos de teste saem da numeração real? Em homologação, a SEFAZ aceita numeração livre na série 90. Os documentos emitidos não têm valor fiscal e não entram no fluxo de estoque ou financeiro.

Posso usar a aba de Cancelamento para cancelar NF-e de produção? Não. Esta tela opera exclusivamente em homologação. Para cancelar NF-e de produção, use o fluxo da NF-e de Entrada ou o módulo de NF-e de saída.

Veja também

• Testes de Boleto CNAB — roteiro irmão para homologar a Trilha B (boleto via ACBrLibBoleto).

Histórico de alterações

Data	Alteração
07/05/2026	Adicionada seção "Veja também" cruzando para o guia de Testes de Boleto CNAB.
20/04/2026	Documento inicial criado.