OS 105182 - MELHORIA - NOTA FISCAL DE VENDA DE SEMINOVOS
Objetivo:
A solicitação tem como objetivo disponibilizar uma nova forma de integração para o processo de emissão de Nota Fiscal Eletrônica de venda de seminovos, permitindo que um sistema externo realize, por meio de APIs, as operações de geração da NF-e, transmissão/autorização junto à SEFAZ e cancelamento da nota fiscal.
A nova integração tem como objetivo automatizar o processo atualmente realizado por meio da importação de planilhas, possibilitando que as informações sejam enviadas diretamente ao sistema responsável pelo faturamento.
Mesmo com a disponibilização das APIs, o processo tradicional de importação por planilha deverá continuar disponível e funcionando normalmente, mantendo as parametrizações e rotinas já existentes.
Para validação da integração, as chamadas às APIs serão simuladas por meio de uma ferramenta de testes, permitindo conferir os dados enviados, os retornos recebidos e os reflexos de cada operação dentro do sistema.
Os testes deverão ser realizados em pelo menos dois ambientes/clientes, sempre que estes estiverem aptos à execução das operações fiscais necessárias.
Premissas:
- Necessário o ambiente estar atualizado com as versões:
- Doc. Eletrônico de número XXXX ou superior;
- Faturamento de número XXXX ou superior;
Teste realizado após a atualização.
Cenário 01: Preparar a ferramenta para execução das APIs
Objetivo:
Preparar a ferramenta utilizada nos testes para permitir a execução das requisições de geração, transmissão e cancelamento da NF-e.
Pré-condição:
Possuir acesso ao ambiente de testes e ao arquivo de configuração disponibilizado para execução das APIs.
Resultado Esperado:
As requisições necessárias devem ser importadas corretamente, configuradas para o ambiente de QA e estar disponíveis para execução.
Passo a passo:
- Abrir a ferramenta utilizada para execução das APIs.
- Acessar a opção de importação.
- Selecionar o arquivo de configuração disponibilizado para os testes.
- Confirmar a importação.
- Caso seja apresentada mensagem informando que a coleção já existe, optar por importar uma cópia para não substituir configurações anteriores.
- Confirmar que as requisições referentes ao processo foram disponibilizadas.
- Alterar os endereços configurados localmente para os endereços correspondentes ao ambiente de QA.
- Configurar a autenticação necessária para execução das requisições.
- Repetir a configuração para todas as requisições que serão utilizadas.
- Confirmar que as requisições estão prontas para execução.
Atenção: Dados técnicos de autenticação, tokens e endereços internos não devem ser apresentados na documentação destinada ao cliente.
Cenário 02: Gerar pedido e NF-e por meio da API
Objetivo:
Validar que os dados enviados pela integração sejam processados corretamente, permitindo a criação do pedido e da respectiva NF-e no sistema.
Pré-condição:
A ferramenta de testes deve estar configurada e os dados utilizados na requisição devem ser válidos para o ambiente.
Resultado Esperado:
A requisição deve ser processada sem erro, retornando a confirmação da geração e os números correspondentes ao pedido e à NF-e.
O pedido e a nota fiscal devem ser localizados no sistema com os mesmos dados enviados pela integração.
Passo a passo:
- Acessar a requisição responsável pela geração do pedido e da NF-e.
- Acessar o corpo da requisição.
- Informar ou ajustar os dados necessários para o teste.
- Conferir as informações de cliente, produtos, quantidades, valores e demais dados obrigatórios.
- Enviar a requisição.
- Conferir o retorno apresentado.
- Validar que a geração foi concluída com sucesso.
- Conferir o número do pedido retornado.
- Conferir o número da NF-e retornado.
- Validar que não foi apresentada mensagem de erro.
- Acessar o módulo de Faturamento.
- Acessar Notas Fiscais > Consulta Nota Fiscal.
- Pesquisar pela NF-e gerada.
- Abrir a consulta da nota.
- Conferir as informações gerais da NF-e.
- Conferir os totais.
- Conferir as informações de transporte.
- Conferir as informações de pagamento.
- Conferir os itens.
- Conferir o pedido relacionado.
- Confirmar que os dados existentes no sistema correspondem às informações enviadas pela integração.
Cenário 03: Transmitir e autorizar a NF-e por meio da API
Objetivo:
Validar que uma NF-e previamente gerada possa ser transmitida eletronicamente e autorizada pela SEFAZ por meio da integração.
Pré-condição:
Deve existir uma NF-e gerada com sucesso e disponível para transmissão.
Resultado Esperado:
A requisição deve concluir a transmissão sem erro, retornando a confirmação da operação e a chave de acesso da NF-e.
A nota deverá permanecer disponível no sistema com as informações correspondentes à autorização.
Passo a passo:
- Utilizar os dados retornados na geração da NF-e.
- Acessar a requisição responsável pela transmissão.
- Atualizar o corpo da requisição com os identificadores correspondentes ao pedido e à NF-e gerada.
- Enviar a requisição.
- Conferir o retorno apresentado.
- Validar que a transmissão foi concluída com sucesso.
- Conferir a chave de acesso retornada.
- Confirmar que não foi apresentada mensagem de erro.
- Acessar o módulo de Faturamento.
- Acessar Notas Fiscais > Consulta Nota Fiscal.
- Pesquisar pela NF-e.
- Confirmar que a nota apresenta a situação correspondente à transmissão.
- Abrir a consulta da NF-e.
- Conferir a chave de acesso.
- Conferir o protocolo de autorização.
- Confirmar que os demais dados da nota permaneceram corretos após a transmissão.
Cenário 04: Validar a NF-e autorizada no ambiente da SEFAZ
Objetivo:
Confirmar que a NF-e transmitida pela integração tenha sido efetivamente registrada e autorizada no ambiente fiscal de homologação.
Pré-condição:
A NF-e deve ter sido transmitida com sucesso e possuir chave de acesso.
Resultado Esperado:
A consulta realizada no ambiente de homologação da SEFAZ deve localizar a NF-e e apresentar dados correspondentes ao documento gerado pelo sistema.
Passo a passo:
- Copiar a chave de acesso retornada na transmissão.
- Acessar o ambiente de consulta de NF-e de homologação da SEFAZ.
- Informar a chave de acesso.
- Realizar a consulta.
- Conferir o número da NF-e.
- Conferir a série.
- Conferir os dados do emitente.
- Conferir os dados do destinatário.
- Conferir os produtos.
- Conferir os valores da nota.
- Comparar as informações apresentadas pela SEFAZ com os dados existentes no sistema.
- Confirmar que se referem ao mesmo documento fiscal.
Cenário 05: Validar o envio dos documentos da NF-e por e-mail
Objetivo:
Validar que os documentos fiscais sejam enviados corretamente ao endereço eletrônico informado no processo.
Pré-condição:
A NF-e deve ter sido transmitida e autorizada com sucesso e possuir um endereço eletrônico válido para recebimento.
Resultado Esperado:
O e-mail deve ser enviado com sucesso, contendo as informações correspondentes à NF-e e os respectivos documentos fiscais anexados.
Passo a passo:
- Após a transmissão, conferir o retorno da integração referente ao envio de e-mail.
- Confirmar que o envio foi indicado como realizado com sucesso.
- Acessar a caixa de e-mail utilizada no teste.
- Localizar a mensagem correspondente à NF-e.
- Conferir o número da nota apresentado no conteúdo da mensagem.
- Conferir a chave de acesso.
- Conferir os arquivos anexados.
- Validar a presença do XML da NF-e.
- Validar a presença do documento auxiliar da NF-e.
- Confirmar que os arquivos correspondem à nota processada.
Cenário 06: Cancelar o pedido e a NF-e no sistema por meio da API
Objetivo:
Validar a primeira etapa do cancelamento, garantindo que a integração consiga solicitar corretamente o cancelamento do pedido e da nota fiscal dentro do sistema.
Pré-condição:
Deve existir uma NF-e previamente gerada e autorizada.
Resultado Esperado:
A requisição deve ser processada sem erro, indicando que o cancelamento interno foi realizado com sucesso.
A nota fiscal deverá apresentar a situação correspondente ao cancelamento no sistema.
Passo a passo:
- Acessar a requisição destinada ao cancelamento.
- Informar o número do pedido correspondente à NF-e utilizada no teste.
- Informar o motivo do cancelamento, quando solicitado.
- Enviar a requisição.
- Conferir o retorno apresentado.
- Validar que a operação foi processada com sucesso.
- Confirmar que não foi apresentada mensagem de erro referente ao cancelamento interno.
- Acessar o módulo de Faturamento.
- Acessar Notas Fiscais > Consulta Nota Fiscal.
- Pesquisar pela NF-e utilizada no teste.
- Confirmar que o documento apresenta a situação de cancelado no sistema.
Cenário 07: Transmitir o cancelamento da NF-e para a SEFAZ
Objetivo:
Validar que o cancelamento realizado no sistema seja transmitido corretamente para a SEFAZ por meio da integração.
Pré-condição:
A NF-e deve estar autorizada e o cancelamento interno deve ter sido realizado com sucesso.
Resultado Esperado:
A chamada de transmissão do cancelamento não deve apresentar erro e o retorno referente à transmissão deve indicar sucesso.
Após a conclusão do processo, o cancelamento deverá estar registrado também no ambiente da SEFAZ.
Passo a passo:
- Acessar novamente a requisição responsável pela transmissão.
- Informar os dados correspondentes ao pedido e à NF-e cancelada.
- Enviar a requisição.
- Conferir o retorno apresentado.
- Validar que a transmissão do cancelamento foi concluída com sucesso.
- Confirmar que não foi apresentada mensagem de erro.
- Confirmar que o retorno referente à transmissão apresenta sucesso.
- Utilizar a chave de acesso da NF-e.
- Acessar o ambiente de homologação da SEFAZ.
- Consultar novamente a NF-e.
- Confirmar que o evento de cancelamento foi registrado.
Atenção: Durante o desenvolvimento foi identificada uma ocorrência na rotina de cancelamento eletrônico. A validação deste cenário deverá confirmar que a situação foi corrigida e que o cancelamento pode ser concluído normalmente junto à SEFAZ.
Cenário 08: Validar o processo tradicional de importação por planilha
Objetivo:
Garantir que a disponibilização da integração via API não tenha alterado o processo tradicional já utilizado para geração e processamento das notas fiscais.
Pré-condição:
Possuir o modelo de planilha correspondente à rotina de importação e os cadastros necessários para execução do processo.
Resultado Esperado:
A planilha deve ser importada normalmente, gerando o pedido e permitindo a geração, transmissão, autorização, envio por e-mail e cancelamento da NF-e da mesma forma que ocorria anteriormente à implementação das APIs.
Passo a passo:
- Acessar o módulo de Vendas.
- Acessar a rotina Importação de pedidos por Excel.
- Baixar o modelo da planilha.
- Preencher os dados necessários para o teste.
- Informar um endereço eletrônico que possa ser acessado durante a validação.
- Salvar a planilha.
- Retornar à rotina de importação.
- Adicionar o arquivo preenchido.
- Iniciar o upload.
- Confirmar a importação.
- Acessar o monitoramento de processamento.
- Localizar a execução correspondente à importação.
- Abrir os detalhes do processamento.
- Confirmar que o pedido foi gerado sem erro.
- Acessar o módulo de Faturamento.
- Localizar o pedido criado.
- Selecionar o pedido para faturamento.
- Gerar a NF-e.
- Confirmar que o processamento da nota foi concluído com sucesso.
- Acessar o módulo de Documento Eletrônico.
- Localizar a NF-e.
- Transmitir a nota no ambiente de homologação.
- Confirmar a autorização da NF-e.
- Realizar o envio dos documentos por e-mail.
- Confirmar o recebimento da mensagem e dos anexos.
- Realizar o cancelamento da NF-e e do pedido.
- Transmitir o cancelamento.
- Confirmar que o cancelamento foi registrado corretamente.
Cenário 09: Validar a coexistência do processo via API com o processo tradicional
Objetivo:
Garantir que as duas formas de processamento possam ser utilizadas no mesmo ambiente sem interferência entre elas.
Pré-condição:
As rotinas de integração via API e importação por planilha devem estar disponíveis no ambiente utilizado para os testes.
Resultado Esperado:
Os dois processos devem funcionar normalmente e de forma independente, mantendo as mesmas regras fiscais e operacionais previstas para cada documento.
Passo a passo:
- Gerar um pedido e uma NF-e utilizando a integração via API.
- Concluir a transmissão e autorização da NF-e.
- Gerar outro pedido utilizando o processo tradicional de importação por planilha.
- Gerar e transmitir a respectiva NF-e.
- Consultar os dois documentos no sistema.
- Conferir os dados dos pedidos.
- Conferir clientes, itens, quantidades, valores e informações fiscais.
- Conferir as chaves de acesso e protocolos quando aplicável.
- Confirmar que o método utilizado para geração não alterou indevidamente as regras do processo.
- Repetir a validação em outro ambiente/clientes disponível para os testes.
ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.