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 ferramentaplanilha para execuçimportação dasdos APIspedidos

Objetivo:
Preparar a ferramentaplanilha que será utilizada nosna testes para permitir a execuçvalidação dasdo requisiçõesprocesso tradicional de geraçimportação, transmissão ede cancelamentopedidos, dautilizando NF-e.o modelo disponibilizado pelo próprio sistema.

Pré-condição:
PossuirO usuário deve possuir acesso ao ambientemódulo de testesVendas e aoà arquivofuncionalidade de configuraçImportação disponibilizadode parapedidos execuçãopor das APIs.Excel.

Resultado Esperado:
AsO requisiçõesmodelo necessáriasda devemplanilha deve ser importadasdisponibilizado corretamente,pelo configuradassistema e permitir o preenchimento dos dados necessários para posterior importação ambientedo e estar disponíveis para execução.pedido.

Passo a passo:

1. AbrirAcessar a ferramenta utilizada para execução dasmódulo APIs.Vendas.
   

   

   
   
2. Acessar Orçamentos/Pedidos > Importação de pedidos por excel.
   

   

   
   
3. Na tela Importação de Pedidos por Excel, clicar em Baixar modelo de planilha.
   

   

   
   
4. Abrir a opçãplanilha disponibilizada pelo sistema.
5. Preencher ou alterar os dados da planilha conforme o pedido que será utilizado no teste.
6. Informar dados válidos para os campos obrigatórios do processo.
7. Nos campos destinados ao endereço de e-mail, informar um e-mail válido e ao qual o responsável pelo teste possua acesso, pois posteriormente será necessário validar o recebimento dos documentos da NF-e.
8. Conferir as informações preenchidas.
9. Salvar a planilha para utilizá-la no cenário de importação.
10. Selecionar

    

    o arquivo de configuração disponibilizado para os testes.
11. Confirmar a importação.
12. Caso seja apresentada mensagem informando que a coleção já existe, optar por importar uma cópia para não substituir configurações anteriores.
13. Confirmar que as requisições referentes ao processo foram disponibilizadas.
14. Alterar os endereços configurados localmente para os endereços correspondentes ao ambiente de QA.
15. Configurar a autenticação necessária para execução das requisições.
16. Repetir a configuração para todas as requisições que serão utilizadas.
17. 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: GerarImportar pedidoa planilha e NF-evalidar pora meiogeração dado APIpedido

Objetivo:
Validar que osa dadosplanilha enviadospreparada pelaanteriormente integraçãpossa ser importada pelo processo tradicional, realizando corretamente o sejamprocessamento processados corretamente, permitindoe a criaçgeração do pedido e da respectiva NF-e no sistema.

Pré-condição:
A ferramenta de testesplanilha deve estarter configuradasido preparada conforme o Cenário 01, utilizando o modelo disponibilizado pelo próprio sistema e oscontendo dados utilizados na requisição devem ser válidos para o ambiente.importação.

Resultado Esperado:
A requisiçãoplanilha deve ser importada e processada sem erro,erros. retornandoApós a confirmação daprocessamento, geração esistema osdeve númerosgerar correspondentes aoo pedido ecorrespondente àaos NF-e.

dados

O pedido e a nota fiscal devem ser localizadosinformados no sistemaarquivo, compermitindo ossua mesmoscontinuidade dadosno enviadosprocesso pelade integração.faturamento.

Passo a passo:

1. Acessar a requisição responsávelmódulo pela geração do pedido e da NF-e.Vendas.
2. Acessar Orçamentos/Pedidos > Importação corpode pedidos por excel.
   
3. No campo Tipo de Pedido, selecionar o tipo correspondente ao processo que será realizado.
4. Na seção Importação de Excel de pedidos, clicar em Adicionar Arquivos.
5. Localizar e selecionar a planilha preparada no Cenário 01.
6. Confirmar que o arquivo selecionado foi apresentado na tela.
7. Após o carregamento do arquivo, clicar em Confirmar para iniciar o processamento da requisiçimportação.

   

8. InformarAcessar ouVendas ajustar> osOrçamentos/Pedidos dados> necessáriosMonitoramento de Processos Excel.
9. Localizar o processamento referente à importação realizada.
10. Acessar a lupa correspondente ao processamento para oconsultar teste.seu resultado.
11. Conferir as informações de cliente, produtos, quantidades, valores e demais dados obrigatórios.
12. Enviar a requisição.
13. Conferir o retorno apresentado.
14. ValidarConfirmar que a geraçimportação foi concluída comsem sucesso.erros.
15. Conferir a mensagem apresentada pelo processamento e identificar o número do pedido retornado.
16. Conferir o número da NF-e retornado.
17. Validar que não foi apresentada mensagem de erro.
18. Acessar o módulo de Faturamento.gerado.
19. Acessar Notas FiscaisVendas > ConsultaOrçamentos/Pedidos Nota> FiscalEmissão/Alteração.
20. PesquisarLocalizar o pedido gerado pela NF-e gerada.importação.
21. Abrir ao consultapedido dae nota.
conferir
22. Conferiros asdados importados, incluindo cliente, itens, quantidades, valores e demais informações geraispreenchidas dana NF-e.
23. Conferir os totais.
24. Conferir as informações de transporte.
25. Conferir as informações de pagamento.
26. Conferir os itens.
27. Conferir o pedido relacionado.planilha.
28. Confirmar que oso dadospedido existentesfoi nocriado sistemacorretamente correspondeme àsestá informaçõesdisponível enviadaspara pelacontinuidade integração.do processo de faturamento.

---

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:

1. Utilizar os dados retornados na geração da NF-e.
2. Acessar a requisição responsável pela transmissão.
3. Atualizar o corpo da requisição com os identificadores correspondentes ao pedido e à NF-e gerada.
4. Enviar a requisição.
5. Conferir o retorno apresentado.
6. Validar que a transmissão foi concluída com sucesso.
7. Conferir a chave de acesso retornada.
8. Confirmar que não foi apresentada mensagem de erro.
9. Acessar o módulo de Faturamento.
10. Acessar Notas Fiscais > Consulta Nota Fiscal.
11. Pesquisar pela NF-e.
12. Confirmar que a nota apresenta a situação correspondente à transmissão.
13. Abrir a consulta da NF-e.
14. Conferir a chave de acesso.
15. Conferir o protocolo de autorização.
16. 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:

1. Copiar a chave de acesso retornada na transmissão.
2. Acessar o ambiente de consulta de NF-e de homologação da SEFAZ.
3. Informar a chave de acesso.
4. Realizar a consulta.
5. Conferir o número da NF-e.
6. Conferir a série.
7. Conferir os dados do emitente.
8. Conferir os dados do destinatário.
9. Conferir os produtos.
10. Conferir os valores da nota.
11. Comparar as informações apresentadas pela SEFAZ com os dados existentes no sistema.
12. 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:

1. Após a transmissão, conferir o retorno da integração referente ao envio de e-mail.
2. Confirmar que o envio foi indicado como realizado com sucesso.
3. Acessar a caixa de e-mail utilizada no teste.
4. Localizar a mensagem correspondente à NF-e.
5. Conferir o número da nota apresentado no conteúdo da mensagem.
6. Conferir a chave de acesso.
7. Conferir os arquivos anexados.
8. Validar a presença do XML da NF-e.
9. Validar a presença do documento auxiliar da NF-e.
10. 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:

1. Acessar a requisição destinada ao cancelamento.
2. Informar o número do pedido correspondente à NF-e utilizada no teste.
3. Informar o motivo do cancelamento, quando solicitado.
4. Enviar a requisição.
5. Conferir o retorno apresentado.
6. Validar que a operação foi processada com sucesso.
7. Confirmar que não foi apresentada mensagem de erro referente ao cancelamento interno.
8. Acessar o módulo de Faturamento.
9. Acessar Notas Fiscais > Consulta Nota Fiscal.
10. Pesquisar pela NF-e utilizada no teste.
11. 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:

1. Acessar novamente a requisição responsável pela transmissão.
2. Informar os dados correspondentes ao pedido e à NF-e cancelada.
3. Enviar a requisição.
4. Conferir o retorno apresentado.
5. Validar que a transmissão do cancelamento foi concluída com sucesso.
6. Confirmar que não foi apresentada mensagem de erro.
7. Confirmar que o retorno referente à transmissão apresenta sucesso.
8. Utilizar a chave de acesso da NF-e.
9. Acessar o ambiente de homologação da SEFAZ.
10. Consultar novamente a NF-e.
11. 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:

1. Acessar o módulo de Vendas.
2. Acessar a rotina Importação de pedidos por Excel.
3. Baixar o modelo da planilha.
4. Preencher os dados necessários para o teste.
5. Informar um endereço eletrônico que possa ser acessado durante a validação.
6. Salvar a planilha.
7. Retornar à rotina de importação.
8. Adicionar o arquivo preenchido.
9. Iniciar o upload.
10. Confirmar a importação.
11. Acessar o monitoramento de processamento.
12. Localizar a execução correspondente à importação.
13. Abrir os detalhes do processamento.
14. Confirmar que o pedido foi gerado sem erro.
15. Acessar o módulo de Faturamento.
16. Localizar o pedido criado.
17. Selecionar o pedido para faturamento.
18. Gerar a NF-e.
19. Confirmar que o processamento da nota foi concluído com sucesso.
20. Acessar o módulo de Documento Eletrônico.
21. Localizar a NF-e.
22. Transmitir a nota no ambiente de homologação.
23. Confirmar a autorização da NF-e.
24. Realizar o envio dos documentos por e-mail.
25. Confirmar o recebimento da mensagem e dos anexos.
26. Realizar o cancelamento da NF-e e do pedido.
27. Transmitir o cancelamento.
28. 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:

1. Gerar um pedido e uma NF-e utilizando a integração via API.
2. Concluir a transmissão e autorização da NF-e.
3. Gerar outro pedido utilizando o processo tradicional de importação por planilha.
4. Gerar e transmitir a respectiva NF-e.
5. Consultar os dois documentos no sistema.
6. Conferir os dados dos pedidos.
7. Conferir clientes, itens, quantidades, valores e informações fiscais.
8. Conferir as chaves de acesso e protocolos quando aplicável.
9. Confirmar que o método utilizado para geração não alterou indevidamente as regras do processo.
10. 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.