​

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

• 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

• 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)

• 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).

• 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

• 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)

• 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

• 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.

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

​

🗂️ Backlog Sugerido

​

📝 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).