Testes Client 2.0 - NF-e
Pré Condições Gerais
- Ter o Client 2.0 instalado e configurado
- Ter o PDV configurado com o mesmo CNPJ do Client
- PDV habilitado para emissão de NF-e (Modelo 55)
- Ter série específica para emissão de NF-e
- Numeração de notas sincronizada com a última NF-e autorizada em ambiente de homologação
- Itens cadastrados com tributação correspondente ao cenário (ICMS OP -Operação Própria, ICMS ST, IBS, CBS)
Sumário
- Fluxo de Autorização e Tributação
- NF e_001 | Autorização NF-e (ICMS)
- NF e_002 | NF-e com Frete (CIF/FOB)
- NF e_003 | Pagamento via Duplicata/Boleto
- NF e_004 | Autorização com IBS e CBS
- NF e_005 | Autorização com referência a NFC-e
- NF e_006 | Devolução referenciando NFC-e
- NF e_007 | Emissão com Desconto
- NF e_008 | Emissão com Acréscimo
- NF e_009 | Item com Substituição Tributária (ST)
- NF e_010 | Pagamento via Cartão (TEF/POS)
- Cenários de Exceção (Rejeições)
- Contingência, Notas de Ajuste e Resiliência
- Monitores de Consulta Automática
- Gestão (Cancelamento e Inutilização)
Tabela de Referência de Cenários
Tabela de Referência NF-e (Modelo 55)
| ID | Cenário NF-e | Foco da Evidência |
| NF e_001 | Autorização NF-e (ICMS) | Status "Autorizada" no Portal Fiscal e campos de endereço. |
| NF e_002 | NF-e com Frete (CIF/FOB) | Presença do grupo de transporte e placa do veículo. |
| NF e_003 | Pagamento via Duplicata/Boleto | Tags de fatura, vencimento e valor das parcelas (Grupo cobr). |
| NF e_004 | Autorização com IBS e CBS | Validação das tags de tributação da Reforma Tributária. |
| NF e_005 | Autorização com referência a NFC-e | Grupo NFref preenchido com a chave de acesso do modelo 65. OBS: Necessário validar se a UF do emissor permite esse referenciamento. |
| NF e_006 | Devolução referenciando NFC-e | CFOP de devolução e ajuste automático de estoque no PDV. |
| NF e_007 | Emissão com Desconto | Tags de desconto e validação do valor total líquido. |
| NF e_008 | Emissão com Acréscimo | Tags de acréscimo e validação do valor total bruto. |
| NF e_009 | Item com Substituição Tributária (ST) | CST específico de ST e valores retidos no XML. |
| NF e_010 | Pagamento via Cartão (TEF/POS) | Grupo PagNFCeList e código de autorização da transação. |
| NF e_011 | Rejeição por Cadastro (NCM/CFOP) | Mensagem de erro SEFAZ e inutilização automática do número. |
| NF e_012 | Rejeição por Data/Hora Atrasada | Alerta de ajuste de horário e desfazimento da venda. |
| NF e_013 | Rejeição: Certificado Vencido | Mensagem de atualização necessária. |
| NF e_014 | Rejeição: CNPJ Divergente | Alerta de inconsistência entre PDV e Client. |
| NF e_015 | Rejeição: Numeração Duplicada | Alerta de divergência na sequência de notas. |
| NF e_016 | Rejeição: Ambiente Divergente | Alerta de conflito entre URL do Client e tpAmb do PDV. |
| NF e_017 | Emissão em Contingência EPEC | Autorização provisória via evento e reconsulta agendada. |
| NF e_018 | Emissão de Carta de Correção (CC-e) | Evento vinculado à nota. |
| NF e_019 | Emissão de Nota de Débito | Finalidade de emissão (finNFe) configurada para ajuste/débito. |
| NF e_020 | Emissão de Nota de Crédito | Finalidade de emissão (finNFe) configurada para ajuste/crédito. |
| NF e_021 | Emissão de Eventos - Reforma Tributária | Emissão de evento de Emissor e Destinatário vinculado à nota . |
| NF e_022 | Contingência: Timeout de Comunicação | Identificação de falha e fila de reconsulta de 30 min. |
| NF e_023 | Consulta de NF-e | Atualização do status do documento na base do PDV. |
| NF e_024 | Monitor: Notas Incompletas | Ciclo de reconsulta de 30 min e fim no cStat finalizado. |
| NF e_025 | Monitor: Retorno M0018 | Persistência da nota na fila de consulta após erro temporário. |
| NF e_026 | Cancelamento NF-e (24h) | Protocolo de cancelamento e ajuste de estoque no prazo legal. |
| NF e_027 | Inutilização de Número Único | Protocolo de inutilização. |
| NF e_028 | Inutilização de Range | Registro de inutilização de intervalo de números no PDV. |
Fluxo de Autorização e Tributação
NF e_001 | Autorização NF-e (ICMS)
- Ações:
- Registrar item e finalizar venda no PDV para emissão de NF-e.
- Interpretar e armazenar o retorno do JSON de autorização.
- Resultados Esperados:
- NF-e autorizada e impressa conforme manual do DANFE (A4);
- Item com valores de ICMS destacados;
- Documento com Status "Autorizada".
NF e_002 | NF-e com Frete (CIF/FOB)
- Ações:
- Informar a modalidade de frete e os dados da transportadora (CNPJ e Placa do Veículo) no ato da emissão.
- Resultados Esperados:
- XML com o grupo transp preenchido corretamente;
- Valor do frete somado ao total da nota;
- Documento com Status "Autorizada".
NF e_003 | Pagamento via Duplicata/Boleto
- Ações:
- Selecionar forma de pagamento a prazo;
- Informar número da fatura, datas de vencimento e valores das parcelas.
- Resultados Esperados:
- Envio do grupo cobr no JSON;
- Tags de fatura e duplicata preenchidas;
- Documento com Status "Autorizada".
NF e_004 | Autorização com IBS e CBS
- Ações:
- Finalizar venda com item tributado por IBS e CBS.
- Resultados Esperados:
- XML apresentando valores de IBS e CBS;
- Documento com Status "Autorizada".
NF e_005 | Autorização com referência a NFC-e
- Ações:
- Autorizar uma NFC-e;
- Em seguida, emitir uma NF-e referenciando a chave da NFC-e anterior.
- Resultados Esperados:
- Envio do grupo NFref no JSON;
- Documento com Status "Autorizada".
NF e_006 | Devolução referenciando NFC-e
- Pré-condições:
- NFC-e autorizada com prazo de cancelamento expirado (> 30 min).
- Ações:
- Emitir NF-e com CFOP de devolução referenciando a chave da NFC-e.
- Resultados Esperados:
- Ajuste automático de estoque;
- Documento com Status "Autorizada".
NF e_007 | Emissão com Desconto
- Ações:
- Aplicar desconto na nota e validar o valor total subtraído.
- Resultados Esperados:
- Tags de desconto preenchidas;
- Documento com Status "Autorizada".
NF e_008 | Emissão com Acréscimo
- Ações:
- Aplicar acréscimo e validar a soma do total bruto.
- Resultados Esperados:
- Tags de acréscimo preenchidas;
- Documento com Status "Autorizada".
NF e_009 | Item com Substituição Tributária (ST)
- Ações:
- Emitir nota com item sujeito a ICMS ST.
- Resultados Esperados:
- XML com CST específico para ST;
- Documento com Status "Autorizada".
NF e_010 | Pagamento via Cartão (TEF/POS)
- Ações:
- Autorizar transação TEF ou informar código POS;
- Finalizar a nota.
- Resultados Esperados:
- Grupo PagNFCeList preenchido no JSON;
- Documento com Status "Autorizada".
Cenários de Exceção (Rejeições)
NF e_011 | Rejeição por Cadastro (NCM/CFOP)
- Ações:
- Tentar emitir nota com produto contendo NCM ou CFOP inválido.
- Resultados Esperados:
- Mensagem de erro SEFAZ;
- Inutilização automática do número;
- Desfazimento da venda.
NF e_012 | Rejeição por Data/Hora Atrasada
- Ações:
- Atrasar relógio do PDV e tentar emitir a nota.
- Resultados Esperados:
- Rejeição SEFAZ;
- Alerta de ajuste de horário;
- Inutilização automática da nota.
NF e_013 | Rejeição: Certificado Vencido
- Ações:
- Tentar emitir nota com certificado expirado.
- Resultados Esperados:
- Alerta de atualização necessária;
- Venda e pagamentos desfeitos automaticamente.
NF e_014 | Rejeição: CNPJ Divergente
- Ações:
- PDV com CNPJ diferente do cadastrado no Client.
- Resultados Esperados:
- Alerta de divergência cadastral;
- Venda desfeita no PDV.
NF e_015 | Rejeição: Numeração Duplicada
- Ações:
- Tentar emitir nota com número já autorizado.
- Resultados Esperados:
- Alerta de verificação de numeração;
- Venda desfeita.
NF e_016 | Rejeição: Ambiente Divergente
- Ações:
- PDV em Produção (tpAmb 1) e Client apontando para Homologação.
- Resultados Esperados:
- Alerta de configuração de ambiente;
- Venda desfeita.
Contingência, Notas de Ajuste e Resiliência
NF e_017 | Emissão em Contingência EPEC
- Pré-condições:
- Serviço da SEFAZ inoperante (simular com retorno M0020).
- Ações:
- Ao receber erro de envio: pular numeração e forçar a emissão EPEC (Evento Prévio de Emissão em Contingência).
- Resultados Esperados:
- Autorização provisória via evento;
- Agendamento de reconsulta (intervalos de 1h por até 7 dias) para obter a autorização definitiva da nota original.
NF e_018 | Emissão de Carta de Correção (CC-e)
- Ações:
- Solicitar correção de dados (que não envolvam impostos, destinatário ou data) para uma NF-e autorizada.
- Resultados Esperados:
- Envio do evento de CC-e;
- Documento com Status "Autorizada" com evento vinculado.
NF e_019 | Emissão de Nota de Débito
- Ações:
- Emitir NF-e com finalidade de de emissão **(**finNFe = 6) para débito de imposto.
- Resultados Esperados:
- NF-e com status "Autorizada" com a finalidade correta no XML.
NF e_020 | Emissão de Nota de Crédito
- Ações:
- Emitir NF-e com finalidade de emissão (finNFe = 5) para crédito de imposto.
- Resultados Esperados:
- NF-e com status "Autorizada" com a finalidade correta no XML.
NF e_021 | Emissão de Eventos - Reforma Tributária
- Ações:
- Solicitar eventos previstos na Reforma Tributária.
- Resultados Esperados:
- Envio do evento de Emissor quando vinculado a nota de venda;
- Envio de evento de Destinatário quando vinculado a nota de compra.
- Venda com Status "Autorizada" com evento vinculado.
NF e_022 | Contingência: Timeout de Comunicação
- Ações:
- Definir timeout ≤ 1s no PDV.
- Resultados Esperados:
- Identificação de falha;
- Inclusão da nota na fila de reconsulta automática (30 min).
Monitores de Consulta Automática
NF e_023 | Consulta de NF-e
- Ações:
- Acionar a consulta do documento emitido no PDV.
- Resultados Esperados:
- Atualização do status da nota na base de dados do PDV conforme o retorno.
NF e_024| Monitor: Notas Incompletas
- Ações:
- Notas em processo M0020;
- Monitorar consultas automáticas.
- Resultados Esperados:
- Intervalos de 30 min;
- Interrupção ao receber cStat 100, 150, 135 ou 102 (status finalizadores)
NF e_025| Monitor: Retorno M0018
- Ações:
- Monitorar nota que recebeu M0020 seguido de M0018.
- Resultados Esperados:
- Manutenção da nota na fila para novo ciclo de consulta (30 min)
Gestão (Cancelamento e Inutilização)
NF e_026 | Cancelamento NF-e (24h)
- Pré-condições:
- Nota autorizada dentro do prazo de 24 horas.
- Ações:
- Solicitar cancelamento com justificativa.
- Resultados Esperados:
- Ajuste de estoque;
- NF-e com status "Cancelada"
NF e_027 | Inutilização de Número Único
- Ações:
- Solicitar inutilização de numeração não utilizada.
- Resultados Esperados:
- Envio do JSON de inutilização;
- NF-e com status "Inutilizada"
NF e_028 | Inutilização de Range
- Ações:
- Solicitar inutilização de um intervalo de números.
- Resultados Esperados:
- Registro do retorno do Portal Fiscal marcando o range como inutilizado.
Este conteúdo foi útil para você?