OS 102833 - MELHORIA - DOC. ELETRONICO - TRAVA DE SEGURANÇA | MDF-E

Objetivo:

Esta alteração tem por objetivo validar o ajuste realizado“Trava nano rotina Devolução de NFencerramento do RecebimentoMDF-e” no módulo Doc. Eletrônico, garantindo que:

• Seja possível devolver umaque NFo sistema só permita encerrar um MDF-e quando o usuário digitar o número ou a chave de entradaum comdocumento destaquefiscal vinculado (NF-e ou CT-e), como controle de acondicionamentoconferência e ID de acondicionamento;

• A devolução funcione corretamente quando a operação movimentar estoque (CFOP/CIO que movimenta estoque);

• Não ocorra mais erro de integridade (foreign key) na gravaçãoantes da NF de devoluçfinalização;o.

• O pedido interno gerado para emissão da NF de devolução aceite corretamente o acondicionamento e ID;

• O destaque de acondicionamento seja exibido corretamente na tela e gravado na NF gerada.

Situação reportada:

• Usuário reporta que ao tentar efetuar a devolução de uma NF de recebimento que possuía:

  • Produto com acondicionamento;

  • ID de acondicionamento vinculado;

  • Operação que movimentava estoque;

  O sistema apresentava erro de integridade na geração da NF.

  Erro apresentado:
  

  

Causa identificada

A versão anterior do sistema:

• Não estava preparada para montar a devolução considerando o acondicionamento e ID do acondicionamento;

• O pedido interno utilizado para emissão da NF de devolução não aceitava o vínculo com acondicionamento;

• Gerava erro de integridade ao gravar a NF.

Premissas:

• Necessário o ambiente estar atualizado com a versão FaturamentoDoc. Eletrônico de número 132726XXXX ou superior;
  

Teste realizado após a atualização

Cenário 1:01 Identificar— ouExibir gerartrava NFno encerramento do MDF-e (modal com exigência de entrada com acondicionamento e movimentação de estoquedocumento)

ObjetivoPassos

1. Acessar Menu > MDF-e > Encerrar.

2. Selecionar um MDF-e na listagem.

3. Acionar o comando/ícone de Encerrar do cenário
   MDF-e selecionado.

   
   

GarantirResultado que exista uma NF de entrada com:esperado

• ProdutoO acondicionado;sistema deve abrir a modal “Confirma?”, exibindo a orientação: “Digite o número de um documento vinculado ao MDF-e para encerrá-lo!” e um campo para digitação.

• IDDeve deexistir acondicionamento;

• Movimentaçopção deSim/Não estoque.para prosseguir ou cancelar.

Resultado esperado:Evidência

• NF1.PNG com(tela produtolistagem) que possua+ Acond.

• Campo Id. Acond.2.PNG preenchido.

  (modal

• Operação que movimentou estoque

• NF identificada com produto acondicionado.

• Estoque movimentado corretamente no recebimento.“Confirma?”).

---

Cenário 02 –— AcessarBloquear rotinaencerramento deao devoluçãoconfirmar desem NF de recebimentodigitar

PassoPassos

1. Repetir os passos do Cenário 01 até abrir a passomodal.

2. 01 - Acessar módulo Menu: Faturamento → Notas Fiscais → DevoluçãNão →preencher Deo Recebimento
   campo de documento (deixar em branco).

3. Clicar em Sim.

   02

- Selecionar a NF localizada no cenário anterior
Filtrar pelo número da nota.

Resultado esperado:esperado

• NFO listadasistema corretamente.deve bloquear o encerramento.

• PermiteDeve avançarapresentar mensagem de validação informando que é obrigatório digitar um documento vinculado (toast/alert).

• O MDF-e não deve ser enviado para próximaencerramento etapa.na SEFAZ.

• A modal deve permanecer aberta ou ser reaberta mantendo a exigência (conforme comportamento implementado).

Evidência (a coletar no teste)

• Print do retorno exibido ao confirmar em branco (ex.: “Informe/Digite o número do documento vinculado…”).

---

Cenário 03 –— ValidarBloquear exibiçãoencerramento doao Acondicionamentodigitar nanúmero/chave telaNÃO devinculada devoluçãoao MDF-e

01Passos

-

Avançar
1. até Step 4/4 – Itens

   Abrir a seremmodal devolvidos
   de encerramento (Cenário 01).

2. Digitar um número ou chave que não pertença a nenhum CT-e/NF-e vinculado ao MDF-e selecionado.

3. VerificarClicar colunas:em Sim.

Resultado esperado

• O sistema deve Acond.bloquear o processo.

• Id.Deve Acond.

  apresentar
a

• Quantidade entregue

• Quantidade devolvida
  

Resultado esperado:

• A colunamensagem: Acond.“Número é exibida.

• O Id. Acond. aparece corretamente.

• Quantidade disponívelinválido para devolução correta.documento vinculado ao MDF-e!”

• Não ocorredeve erroprosseguir aocom carregarenvio osde itens.encerramento para SEFAZ.

---

Cenário 04 –— EfetuarPermitir devoluçãoencerramento comao movimentaçãodigitar número de estoqueCT-e vinculado

01Passos

-

1. Abrir a modal de encerramento (Cenário 01) para um MDF-e que possua CT-e(s) vinculado(s).

2. Digitar o número/código do CT-e vinculado.

3. Clicar em:em Finalizar
   Sim.

   

---

Resultado esperado:esperado

• ✅O NFsistema dedeve devoluçãvalidar o geradanúmero comdigitado sucesso;encontrando correspondência em algum CT-e vinculado.

• ✅Deve Mensagemprosseguir apresentada:para Notaa Fiscalrotina XXXXde daencerramento Série(envio Xdo foievento geradapara com sucesso!SEFAZ).

• ❌Deve NÃOapresentar ocorre erroretorno de integridade;

  processamento
(sucesso
• ou

  ❌ Nãrejeição ocorreSEFAZ), erromas não pode bloquear por validação de foreign key.vínculo.

Evidência

• Print da modal preenchida (similar ao 5.PNG) + print do retorno do processamento (sucesso ou retorno SEFAZ).

---

Cenário 05 –— ValidarPermitir NFencerramento geradaao digitar número de NF-e vinculada

01 - Acessar: Faturamento → Consulta Nota Fiscal
Passos

1. 02 - Localizar NF gerada. Filtrar por emissão/data.

   03 - Abrir a NFmodal de encerramento (Cenário 01) para um MDF-e acessarque aba:possua Itens
   NF-e(s) vinculada(s).

2. Digitar o número da NF-e vinculada.

3. Clicar em Sim.

   ---

Validar:Resultado esperado

• CFOP/CIOO utilizadosistema movimentadeve estoque;validar o número digitado encontrando correspondência em alguma NF-e vinculada.

• ProdutoDeve correto;prosseguir para a rotina de encerramento (envio do evento para SEFAZ).

• QuantidadeDeve correta;apresentar retorno do processamento (sucesso ou rejeição SEFAZ), sem bloqueio de validação.

Acondicionamento exibido;Evidência

• IDPrint deda acondicionamentomodal mantido;

  preenchida
+
• retorno

  Estoquedo movimentadoprocessamento corretamente.(dashboard/toast).

---

Cenário 06 — Permitir encerramento ao digitar a CHAVE (CT-e ou NF-e) vinculada

Passos

1. Abrir a modal de encerramento (Cenário 01).

2. Digitar a chave completa (CT-e ou NF-e) de um documento vinculado ao MDF-e.

3. Clicar em Sim.

Resultado esperado:esperado

• ItemO devolvidosistema comdeve destaqueaceitar de:chave e validar vínculo (documento pertence ao MDF-e).

• Deve prosseguir para rotina de encerramento e apresentar retorno SEFAZ (sucesso/rejeição).

Evidência

• ✅Print Acondicionamentoda modal com chave informada + retorno do processamento.

---

Cenário 07 — MDF-e com múltiplos documentos vinculados (CT-e e/ou NF-e)

Passos

1. Selecionar um MDF-e que possua mais de um documento vinculado (mesmo tipo ou misto).

2. ✅Abrir IDmodal de acondicionamentoencerramento.

3. Testar três tentativas:

   • 3.1 Digitar o número/chave do Documento A (vinculado) e confirmar.

   • 3.2 Repetir com o Documento B (também vinculado) e confirmar.

   • 3.3 Digitar um terceiro número/chave não vinculado e confirmar.

Resultado esperado

• Estoque3.1 atualizadoe corretamente.3.2: deve prosseguir ao encerramento (validação “encontrou algum vinculado”).

• Nenhum3.3: errodeve bloquear com “Número inválido para o documento vinculado ao MDF-e!”

Evidência

• Prints das 3 tentativas (principalmente do bloqueio e de integridadepelo registrado.menos 1 tentativa válida).

---

Cenário 08 — Validar situação reportada: MDF-e já encerrado (duplicidade de evento)

Passos

1. Selecionar um MDF-e que já tenha sido encerrado anteriormente (ou simular encerrando e tentando encerrar novamente).

2. Abrir modal de encerramento.

3. Digitar número/chave de documento vinculado.

4. Confirmar em Sim.

Resultado esperado

• A validação de vínculo deve passar (sistema prossegue para rotina).

• A SEFAZ deve retornar rejeição compatível com duplicidade (ex.: Evento 107 – Rejeição: Duplicidade de evento), indicando que a trava não impede o envio quando o documento é válido, e sim apenas garante a conferência.

• O sistema deve exibir o retorno ao usuário.

Evidência

• 5.PNG (número digitado) + 6.PNG (toast retorno SEFAZ “Duplicidade de evento…”).

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