> ## 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 (Histórias)

> Histórias de Usuário para Importação e NF-e

# Histórias de Usuário: OmniDom Importação XML

### 📌 Épico Identificado

* **Nome do épico:** Processamento, Conciliação e Entrada de NF-e Inteligente
* **Objetivo de negócio:** Consolidar e automatizar o processo de recebimento de mercadorias. Através de leituras XML, a ferramenta deve dar a opção ágil de gerar produtos virgens ou engordar o estoque de prateleira já cadastrado minimizando erros humanos de digitação na ERP.
* **Módulo/sistema identificado:** Importação de Dados & Fluxo NF-e / OmniDom BackOffice

***

### 📖 Histórias de Usuário

**HU1: Motor de Upload e Fila Assíncrona de Importações XML**

* **Como** Usuário de Recebimento
* **Quero** acessar a página central para arrastar/enviar notas fiscais XML no formato drag-and-drop
* **Para que** elas sejam absorvidas pelo sistema, entrando num grid histórico e me mostrando quando estão prontas para passar a ser conciliadas pelo usuário humano.
* **Prioridade sugerida:** Alta
* **Estimativa de complexidade:** G

**✅ Critérios de Aceitação**

* **CA1:** Dado que eu seleciono "Via Arquivo" e arrasto a nota / Quando solto e rodo / Então ela se enfileira no painel histórico demonstrando status animado até a finalização do *parser* JSON. (Visível nas telas)

**📋 Regras de Negócio Relacionadas**

* **RN1:** Proteção de Bloqueio em Background
  * O sistema nunca bloqueará a *Thread* do FrontEnd no browser, enfileirando como Worker no back e retornando a mudança de estado na UI suavemente. (Processos pesados).

***

**HU2: Modal Completo de Gestão e Conciliação Homem-Máquina**

* **Como** Conferente Especialista Logístico
* **Quero** abrir um modal de revisão contendo todos os itens da nota fiscal e ditar o que vai acontecer com cada linha (se criaremos um ID novo; se somaremos com algo existente via Matcher; ou ignoraremos pro completo o material de insumo restrito).
* **Para que** eu tenha poder absoluto sobre auditoria de catálogo e não crie produtos sujos / lixo redundante no cadastro principal.
* **Prioridade sugerida:** Alta
* **Estimativa de complexidade:** GG

**✅ Critérios de Aceitação**

* **CA2:** Dado que aperto no botão mágico de "Vincular" um item / Quando aciono a barra pesquisadora de catálogo geral que abriu / Então escolho meu pneu e o sistema cruza os códigos pra aplicar saldo final. (Visível nas telas)
* **CA3:** Dado que uso CAs de caixas em checkbox / Quando determino uma "Ação em Lote" (Ignorar tudo) / Então agilizo todo o comportamento das linhas para aquele estado imposto. (Visível)

***

**HU3: Declaração Obrigatória do Galpão de Distribuição Alvo**

* **Como** Gestor Administrativo
* **Quero** obrigar que toda a grade revisada no fluxo da nota fiscal aponte obrigatoriamente para qual "Depósito" da Omni a remessa recaiu
* **Para que** a conciliação bata os custos unitários perfeitamente contra os ativos patrimoniais sob responsabilidade tática exata sem ter saldo "fantasma".
* **Prioridade sugerida:** Alta
* **Estimativa de complexidade:** P

**✅ Critérios de Aceitação**

* **CA4:** Dado que terminei tudo no modal da etapa final e não marquei Depot / Quando pressiono "Confirmar Importação" / Então o sistema previne meu submit e destaca o campo requisitado de Depósito Destino superior.

**📋 Regras de Negócio Relacionadas**

* **RN2:** Amarração Fiscal vs Física
  * Estoque virtual só converte em válido se houver localização mapeada na malha.

***

### 🗂️ Backlog Sugerido

| ID  | História                                                         | Prioridade | Tamanho |
| --- | ---------------------------------------------------------------- | ---------- | ------- |
| HU1 | Motor de Upload e Fila Assíncrona de Arquivos XML                | Alta       | G       |
| HU2 | Modal Base Completo de Gestão e Conciliação Homem-Máquina        | Alta       | GG      |
| HU3 | Exigência Declaratória do Galpão de Distribuição Alvo (Dropdown) | Alta       | P       |

***

### 📝 Definition of Ready

* ✅ Critérios de aceitação definidos e tangíveis.
* ✅ Regras de negócio primordiais mapeadas nas dependências logísticas.
* ✅ Interface visual clara atestada em layout/protótipo via vídeo do painel.
* ⬜ Documentação de API de Background Workers (`Job / Queue`).