Pular para o conteúdo principal

Testes Client em Nuvem - NF-e

Pré Condições Gerais

  1. Ter integração com APIs de Emissão (linkar com documentação de emissão)
  2. PDV habilitado para emissão de NF-e (Modelo 55)
  3. Ter série específica e numeração baseada na última nota autorizada em homologação
  4. Itens cadastrados com tributação correspondente ao cenário (ICMS OP (Operação Própria) ICMS ST, IBS, CBS)

Sumário

Tabela de Referência de Cenários

Tabela de Referência NF-e (Modelo 55)

IDCenário NF-eFoco da Evidência
NF e_001Autorização NF-e (ICMS)Status "Autorizada" no Portal Fiscal e campos de endereço.
NF e_002NF-e com Frete (CIF/FOB)Presença do grupo de transporte e placa do veículo.
NF e_003Pagamento via Duplicata/BoletoTags de fatura, vencimento e valor das parcelas (Grupo cobr).
NF e_004Autorização com IBS e CBSValidação das tags de tributação da Reforma Tributária.
NF e_005Autorização com referência a NFC-eGrupo NFref preenchido com a chave de acesso do modelo 65.
OBS: Necessário validar se a UF do emissor permite esse referenciamento.
NF e_006Devolução referenciando NFC-eCFOP de devolução e ajuste automático de estoque no PDV.
NF e_007Emissão com DescontoTags de desconto e validação do valor total líquido.
NF e_008Emissão com AcréscimoTags de acréscimo e validação do valor total bruto.
NF e_009Item com Substituição Tributária (ST)CST específico de ST e valores retidos no XML.
NF e_010Pagamento via Cartão (TEF/POS)Grupo PagNFCeList e código de autorização da transação.
NF e_011Rejeição por Cadastro (NCM/CFOP)Mensagem de erro SEFAZ e inutilização automática do número.
NF e_012Rejeição por Data/Hora AtrasadaAlerta de ajuste de horário e desfazimento da venda.
NF e_013Rejeição: Certificado VencidoMensagem de atualização necessária.
NF e_015Rejeição: Numeração DuplicadaAlerta de divergência na sequência de notas.
NF e_016Rejeição: Ambiente DivergenteAlerta de conflito entre URL do Client e tpAmb do PDV.
NF e_017Emissão em Contingência EPECAutorização provisória via evento e reconsulta agendada.
NF e_018Emissão de Carta de Correção (CC-e)Evento vinculado à nota.
NF e_019Emissão de Nota de DébitoFinalidade de emissão (finNFe) configurada para ajuste/débito.
NF e_020Emissão de Nota de CréditoFinalidade de emissão (finNFe) configurada para ajuste/crédito.
NF e_021Emissão de Eventos - Reforma TributáriaEmissão de evento de Emissor e Destinatário vinculado à nota .
NF e_022Contingência: Timeout de ComunicaçãoIdentificação de falha e fila de reconsulta de 30 min.
NF e_023Consulta de NF-eAtualização do status do documento na base do PDV.
NF e_024Monitor: Notas IncompletasCiclo de reconsulta de 30 min e fim no cStat finalizado.
NF e_025Monitor: Retorno M0018Persistência da nota na fila de consulta após erro temporário.
NF e_026Cancelamento NF-e (24h)Protocolo de cancelamento e ajuste de estoque no prazo legal.
NF e_027Inutilização de Número ÚnicoProtocolo de inutilização.
NF e_028Inutilização de RangeRegistro 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_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ê?