OS 105182 - MELHORIA - NOTA FISCAL DE VENDA DE SEMINOVOS

Objetivo:

A solicitação tem como objetivo disponibilizar aouma usuárionova aforma 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 doda RelatórioNF-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 Pedidosplanilhas, Agendadospossibilitando no Período também em formato Excel, permitindo consultar, organizar e trabalhar comque as informações dossejam pedidosenviadas agendadosdiretamente ao sistema responsável pelo faturamento.

Mesmo com a disponibilização das APIs, o processo tradicional de formaimportação maispor práticaplanilha deverá continuar disponível e flexível,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 mesmos dados jáenviados, disponibilizadosos noretornos relatóriorecebidos e os reflexos de cada operação dentro do sistema.

Os testes deverão ser realizados em PDFpelo emenos respeitandodois osambientes/clientes, filtrossempre informadosque naestes geraçestiverem aptos à execução.o das operações fiscais necessárias.

Premissas:

• Necessário o ambiente estar atualizado com as versões:
  • SENDDECORDoc. Eletrônico de número 148926XXXX ou superior;
  • Adm. de VendasFaturamento de número 148926XXXX 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:

1. Abrir a ferramenta utilizada para execução das APIs.
2. Acessar a opção de importação.
3. Selecionar o arquivo de configuração disponibilizado para os testes.
4. Confirmar a importação.
5. Caso seja apresentada mensagem informando que a coleção já existe, optar por importar uma cópia para não substituir configurações anteriores.
6. Confirmar que as requisições referentes ao processo foram disponibilizadas.
7. Alterar os endereços configurados localmente para os endereços correspondentes ao ambiente de QA.
8. Configurar a autenticação necessária para execução das requisições.
9. Repetir a configuração para todas as requisições que serão utilizadas.
10. 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 01:02: Gerar pedido e validarNF-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 relatórioambiente.

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:

1. Acessar a requisição responsável pela geração do pedido e da NF-e.
2. Acessar o corpo da requisição.
3. Informar ou ajustar os dados necessários para o teste.
4. Conferir as informações de pedidoscliente, agendadosprodutos, quantidades, valores e demais dados obrigatórios.
5. Enviar a requisição.
6. Conferir o retorno apresentado.
7. Validar que a geração foi concluída com sucesso.
8. Conferir o número do pedido retornado.
9. Conferir o número da NF-e retornado.
10. Validar que não foi apresentada mensagem de erro.
11. Acessar o módulo de Faturamento.
12. Acessar Notas Fiscais > Consulta Nota Fiscal.
13. Pesquisar pela NF-e gerada.
14. Abrir a consulta da nota.
15. Conferir as informações gerais da NF-e.
16. Conferir os totais.
17. Conferir as informações de transporte.
18. Conferir as informações de pagamento.
19. Conferir os itens.
20. Conferir o pedido relacionado.
21. Confirmar que os dados existentes no períodosistema emcorrespondem formatoàs Excel.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:

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 disponibilizaçprimeira etapa do cancelamento, garantindo que a integração daconsiga novasolicitar opçãcorretamente o Excel, a geraçãocancelamento do arquivo conforme os filtros informadospedido e ada apresentaçãonota corretafiscal dasdentro informaçõesdo dos pedidos agendados.sistema.

Pré-condição:
UsuárioDeve deveexistir possuiruma acessoNF-e aopreviamente módulo Administração de Vendasgerada e à funcionalidade Relatório de Pedidos Agendados no Período. Devem existir pedidos agendados no período selecionado para o teste.autorizada.

Resultado Esperado:
OA sistema deve disponibilizar a opçrequisição Excel no campo Tipo do relatório e, após a solicitação da geração, processar o relatório com sucesso e disponibilizar o arquivo para download no Dashboard.

O arquivo deve ser geradoprocessada emsem formatoerro, Excel,indicando permitirque suao aberturacancelamento normalmenteinterno efoi realizado com sucesso.

A nota fiscal deverá apresentar osa pedidos correspondentes aos filtros informados, contendo corretamente as informações do relatório, como Pedido, Cliente, Data do agendamento, Etiqueta, Produto, Quantidade, Endereço de entrega, Carregamento/Responsável e Observaçsituação docorrespondente Endereçoao Adicional,cancelamento quandono aplicável.sistema.

AcessandoPasso a funcionalidade.
passo:

Relatório de Pedidos Agendados no Período.

Na tela principal, informar:

1. UnidadeAcessar Operacionala – UOP que será utilizada no teste;
2. Selecionar requisição tipodestinada deao pedido desejado;cancelamento.
3. Informar o períodonúmero nosdo campospedido correspondente à NF-e utilizada no teste.
4. Informar o motivo do cancelamento, quando solicitado.
5. Enviar a requisição.
6. Conferir o retorno apresentado.
7. Validar que a operação foi processada com sucesso.
8. Confirmar que não foi apresentada mensagem de dataerro doreferente agendamento,ao contemplandocancelamento pedidos existentes.interno.
9. NoAcessar campoo módulo de Faturamento.
10. Acessar TipoNotas doFiscais relatório,> selecionarConsulta aNota nova opção ExcelFiscal.
11. ClicarPesquisar empela NF-e utilizada no teste.
12. Confirmar que o documento apresenta a situação de cancelado no sistema.

---

ImprimirCená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:

AguardarDurante o processamentodesenvolvimento dofoi relatório.identificada Ouma sistemaocorrência direcionarána para o Dashboard.
Localizar o processamento referente ao Relatóriorotina de pedidoscancelamento agendadoseletrônico. noA período e realizar validação downloaddeste docenário arquivo.

 Abrir o arquivo Excel edeverá confirmar que a situação foi geradocorrigida corretamente.e que o cancelamento pode ser concluído normalmente junto à SEFAZ.

---

Cenário 02:08: CompararValidar aso informaçõesprocesso dostradicional relatóriosde PDFimportação epor Excel.planilha

Objetivo:
Garantir que a inclusãdisponibilização doda formatointegração Excelvia API não alteretenha alterado o conteúdoprocesso funcionaltradicional dojá relatórioutilizado para geração e queprocessamento osdas dadosnotas apresentados sejam equivalentes aos disponibilizados no formato PDF já existente.fiscais.

Pré-condição:
DevemPossuir existiro 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 agendadospor Excel.
3. Baixar o modelo da planilha.
4. Preencher os dados necessários para o períodoteste.
selecionado,
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 usuácancelamento da NF-e e do pedido.
27. Transmitir o cancelamento.
28. Confirmar que o cancelamento foi registrado corretamente.

---

Cenário deve09: possuirValidar acessoa àcoexistência geraç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 dosvia relatórios em PDFAPI e Excel.importação por planilha devem estar disponíveis no ambiente utilizado para os testes.

Resultado Esperado:
Os relatóriosdois emprocessos PDFdevem funcionar normalmente e Excelde devemforma apresentarindependente, mantendo as mesmas informações,regras considerandofiscais ose mesmosoperacionais filtrosprevistas depara UOP,cada tipodocumento.

de

Passo a passo:

1. Gerar um pedido e período,uma nãNF-e utilizando a integração ocorrendovia ausência,API.
duplicidade
2. Concluir oua divergênciatransmissão e autorização da NF-e.
3. Gerar outro pedido utilizando o processo tradicional de pedidos ou quantidades em razãimportação dopor formatoplanilha.
selecionado.
4. Gerar

   Acessandoe transmitir a funcionalidade.
   
   

   respectiva

   RelatórioNF-e.

de
5. Consultar Pedidosos Agendadosdois documentos no Período.

   Na tela principal, informar:

   1. Unidade Operacional – UOP que será utilizada no teste;sistema.
   2. SelecionarConferir oos tipodados dedos pedido desejado;pedidos.
   3. InformarConferir oclientes, períodoitens, nosquantidades, campos de data do agendamento, contemplando pedidos existentes.
   4. No campo "Tipo do relatório", selecionar a opção PDF.
   5. Clicar em Imprimir.

   Aguardar o processamento do relatório. O sistema direcionará para o Dashboard.
   Localizar o processamento referente ao Relatório de pedidos agendados no períodovalores e realizar o download do arquivo.

   Abrir o relatório em PDF e o arquivo Excel gerado no cenário anterior.
   Comparar as informações fiscais.

6. Conferir as chaves de pedido,acesso cliente,e dataprotocolos quando aplicável.
7. Confirmar que o método utilizado para geração não alterou indevidamente as regras do agendamento,processo.
etiqueta,
8. Repetir produto, quantidade e endereço de entrega.

   

   

   Atenção:
   A disposição visual das informações pode ser diferente entre o PDF e o Excel. Aa validação deveem consideraroutro aambiente/clientes equivalênciadisponível dospara dados,os etestes.

não necessariamente a mesma formatação visual.

ATENÇÃO: As informações neste documento são meramente ilustrativas e utilizadas apenas para fins de teste.