> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domsoftware.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Importação (QA)

> Testes de Importação e NF-e

# OmniDom Importação — QA Test Documentation

### 📌 Suíte de Testes

* **Nome da funcionalidade testada:** Fluxo de Importação, Leitura XML e Conciliação
* **Módulo/sistema identificado:** Entrada de Estoque, NF-e / OmniDom BackOffice
* **Pré-condições gerais:** Usuário autorizado no *dashboard*, banco de dados contendo ao menos um "Depósito" já configurado previamente e um "Produto" modelo pré-cadastrado.

***

### 🧪 Casos de Teste

**CT1: Processamento via Arquivo de Novo Lote XML**

* **Tipo:** Positivo
* **Pré-condição:** Aba de "Importação" aberta em "Via Arquivo".
* **Dados de Entrada:** Puxar ou arrastar um arquivo `teste_nfe.xml` válido contendo 1 produto inédito.
* **Passos:**
  1. Arrastar o arquivo na zona de Drop ou selecionar pelo Windows Exporer.
  2. Aguardar o processamento até aparecer listado no histórico.
  3. Clicar em revisar para abrir o Modal de Conciliação de Itens.
* **Resultado Esperado:** O status da linha mostrará que a importação transitou de "Aguardando" para finalizada/pronta para revisão, abrindo o formulário.
* **Critério de Aprovação:** O parser deve conseguir quebrar as linhas XML na grid da UI, exibindo os dados exatos do produto nativo da Nfe.
* **Origem:** Observado nas telas.

**CT2: Validação da Obrigatoriedade do Dropdown de Depósito**

* **Tipo:** Negativo/Borda
* **Pré-condição:** Estar no Modal de Revisão da NF-e, com todos os itens devidamente tipificados (Criar Novo).
* **Dados de Entrada:** Nenhuma seleção aplicada no Campo "Depósito Destino".
* **Passos:**
  1. Deixar o Dropdown em branco ou default "Selecione...".
  2. Tentar confirmar a importação global.
* **Resultado Esperado:** Mensagem impedindo salvar a tabela final e destacando o Dropdown de destinação física.
* **Critério de Aprovação:** Back-end/Front-end não prosseguindo fluxo financeiro/estoque sem âncora geográfica.

**CT3: Vincular a SKU Existente com Busca Dinâmica**

* **Tipo:** Positivo
* **Pré-condição:** Modal de conciliação apresentando item da nota fiscal.
* **Dados de Entrada:** Texto parcial do nome do produto que já está cadastrado ("Creme" p/ Creme Desodorante Nivea).
* **Passos:**
  1. Clicar em "Vincular" na linha do produto importado.
  2. Escrever a query na barra de procura reativa.
  3. Selecionar o produto correspondente carregado no dropdown assíncrono.
* **Resultado Esperado:** UI substitui o fluxo genérico e acopla a imagem/ID do produto mãe.
* **Critério de Aprovação:** Match consolidado no Front.
* **Origem:** Observado nas telas.

**CT4: Utilização do Bulk-Action "Ação em Lote"**

* **Tipo:** Positivo
* **Pré-condição:** Arquivo XML com mais de 3 itens listados.
* **Dados de Entrada:** Clicar no checkbox superior para "Selecionar Todos" ou check duplo.
* **Passos:**
  1. Selecionar Multiplas linhas.
  2. Abrir Menu de Lote e clicar em "Ignorar Selecionados".
* **Resultado Esperado:** Todos os itens selecionados têm suas tags trocadas para status Muted/Ignorado instantaneamente sem precisar ser um por um.
* **Critério de Aprovação:** Desempenho e responsividade do Bulk Edit.
* **Origem:** Estrutura observada na interface.

***

### 📋 Regras de Negócio Testadas

* **RN1: Depósito de Destino Base Obrigatório**
  * Casos de teste relacionados: CT2
* **RN2: Parse de Match Customizado na Base de Produtos**
  * Casos de teste relacionados: CT3
* **RN3: Comutação Assíncrona de Background (Jobs)**
  * Casos de teste relacionados: CT1

***

### ⚠️ Cenários de Exceção

* Tentar realizar *upload* de `.png` ou `.exe` quando o componente restringe apenas a XML, XLSX ou CSV nativos e validáveis. O Upload deve dar Reject.

***

### 📊 Matriz de Cobertura

| Funcionalidade        | CT Positivo | CT Negativo | CT Borda |
| --------------------- | ----------- | ----------- | -------- |
| Upload e Job History  | CT1         | -           | -        |
| Fluxo de Vinculação   | CT3         | -           | -        |
| Obrigatoriedade Local | -           | CT2         | -        |
| Ações em Lote         | CT4         | -           | -        |

***

*Documentação gerada via DocVision Test*
