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 planilha para importação dos pedidos
Objetivo:
Preparar a planilha que será utilizada na validação do processo tradicional de importação de pedidos, utilizando o modelo disponibilizado pelo próprio sistema.
Pré-condição:
O usuário deve possuir acesso ao módulo de Vendas e à funcionalidade de Importação de pedidos por Excel.
Resultado Esperado:
O modelo da planilha deve ser disponibilizado pelo sistema e permitir o preenchimento dos dados necessários para posterior importação do pedido.
Passo a passo:
- Acessar o módulo Vendas.
- Acessar Orçamentos/Pedidos > Importação de pedidos por excel.
- Na tela Importação de Pedidos por Excel, clicar em Baixar modelo de planilha.
- Abrir a planilha disponibilizada pelo sistema.
- Preencher ou alterar os dados da planilha conforme o pedido que será utilizado no teste.
- Informar dados válidos para os campos obrigatórios do processo.
- 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.
- Conferir as informações preenchidas.
- Salvar a planilha para utilizá-la no cenário de importaçã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: Importar a planilha e validar a geração do pedido
Objetivo:
Validar que a planilha preparada anteriormente possa ser importada pelo processo tradicional, realizando corretamente o processamento e a geração do pedido no sistema.
Pré-condição:
A planilha deve ter sido preparada conforme o Cenário 01, utilizando o modelo disponibilizado pelo próprio sistema e contendo dados válidos para importação.
Resultado Esperado:
A planilha deve ser importada e processada sem erros. Após o processamento, o sistema deve gerar o pedido correspondente aos dados informados no arquivo, permitindo sua continuidade no processo de faturamento.
Passo a passo:
- Acessar o módulo Vendas.
- Acessar Orçamentos/Pedidos > Importação de pedidos por excel.
- No campo Tipo de Pedido, selecionar o tipo correspondente ao processo que será realizado.
- Na seção Importação de Excel de pedidos, clicar em Adicionar Arquivos.
- Localizar e selecionar a planilha preparada no Cenário 01.
- Confirmar que o arquivo selecionado foi apresentado na tela.
- Após o carregamento do arquivo, clicar em Confirmar para iniciar o processamento da importação.
- Acessar Vendas > Orçamentos/Pedidos > Monitoramento de Processos Excel.
- Localizar o processamento referente à importação realizada.
- Acessar a lupa correspondente ao processamento para consultar seu resultado.
- Confirmar que a importação foi concluída sem erros.
- Conferir a mensagem apresentada pelo processamento e identificar o número do pedido gerado.
- Acessar Vendas > Orçamentos/Pedidos > Emissão/Alteração.
- Localizar o pedido gerado pela importação.
- Abrir o pedido e conferir os dados importados, incluindo cliente, itens, quantidades, valores e demais informações preenchidas na planilha.
- Confirmar que o pedido foi criado corretamente e está disponível para continuidade 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:
- 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.