# ENG-2848 — divergência da nota 327399

Consulta realizada em 19/10/2026. WMS consultado: cópia local de produção, entrada 218626, empresa 1, filial 1, fornecedor 1419, série 2. Investigação somente para leitura; nenhuma sincronização nem correção persistida.

## Resultado

O serviço Senior `ListarMovimentosAlmoxarifado`, filtrado pela chave da nota e sem restringir a data de alteração, retornou 8 movimentos atuais. O WMS tem 16 linhas de produto, duas por código, e mantém os itens de ambas as importações.

| Produto ERP | Linha antiga WMS | Quantidade antiga WMS | Linha posterior WMS | Quantidade posterior WMS | ERP atual (movimento) | Soma importada WMS |
|---|---:|---:|---:|---:|---:|---:|
| 60020009 | 1146728 | 0,05 | 1147057 | 50 | 50 | 50,05 |
| 60020011 | 1146729 | 0,08 | 1147058 | 80 | 80 | 80,08 |
| 60020012 | 1146730 | 0,29 | 1147059 | 288 | 288 | 288,29 |
| 60020013 | 1146731 | 312 | 1147060 | 312 | 312 | 624 |
| 60020019 | 1146732 | 100 | 1147061 | 100 | 100 | 200 |
| 60020118 | 1146733 | 111 | 1147063 | 111 | 111 | 222 |
| 60024622 | 1146734 | 0,01 | 1147064 | 6 | 6 | 6,01 |
| 60024623 | 1146735 | 0,01 | 1147065 | 6 | 6 | 6,01 |

Os valores do ERP acima são quantidades de movimento retornadas pelo serviço usado para importar entradas do almoxarifado. As consultas adicionais ao serviço genérico (E440IPC/E210MVP) e ao serviço de conferência de notas falharam por conexão ao host SOAP. Não foi possível confirmar diretamente QTDREC/QTDEST ou o histórico de estornos do ERP por esses serviços.

## Evidência da duplicação

- Todas as primeiras linhas foram criadas em 24/07/2026; timestamps gravados: `12:00:11`.
- O segundo conjunto foi criado no mesmo dia; timestamps gravados: `13:50:08`.
- Primeiro conjunto: `sequence_movement = 1`.
- Segundo conjunto: `sequence_movement = 3`, exceto 60024622, cuja sequência é 4.
- O serviço atual do ERP retorna exatamente o segundo conjunto de quantidades e sequências, com sequências do item da NF (`seqIpc`) distintas de 1 a 8.
- Nenhuma das 16 integrações locais possui `sequence_invoice_item` gravada.

A versão antiga de `SeniorSyncInputWarehouseJob` procurava a linha por entrada + produto + derivação + `sequence_movement`. A mudança de sequência fazia a consulta deixar de encontrar a linha antiga e executar `StockIOProductStoreService`, criando outro produto e outro item. O código histórico pode ser verificado no commit `f43b0058` e no diff do commit `eabfb40e`, que substituiu a identificação pela sequência do item da nota.

Os dados são consistentes com reimportação após alteração/recriação dos movimentos no ERP, mantendo os registros anteriores no WMS. A duplicação é verificável; o motivo exato da alteração dos movimentos no ERP requer o histórico do ERP.

Alguns valores do primeiro conjunto têm fator 1.000 em relação aos posteriores: `0.05 → 50`, `0.08 → 80`, `0.288 → 288`, `0.006 → 6`. Isso sugere ajuste de quantidade/unidade no lançamento original, mas não comprova sua causa. O WMS arredondou `0.288` para `0.29` e `0.006` para `0.01` ao persistir campos com duas casas decimais.

## Movimentação existente

O item antigo 1572138 do produto 60020019 tem saldo físico 68, embora sua identificação original seja 100. Existe uma transação de saída de 32 em 08/10/2026, id 1233965, com esse item no snapshot. O item posterior 1572348 ainda tem 100; portanto, o saldo físico dos dois itens é 168, enquanto a soma importada é 200.

Não há linhas de `picking_order_products` vinculadas aos 16 produtos dessa entrada na cópia consultada. Isso não significa ausência de movimentações: a saída de 32 está registrada em `transactions`.

## Consequência para a correção

Este caso duplica também `stock_io_products`, além de `items` e identificações. O SQL específico da tarefa 111489 não se aplica. Uma correção desta nota precisa conciliar as oito linhas com os movimentos atuais, preservar a saída de 32 e seus vínculos, e tratar as linhas históricas sem somar o lançamento antigo à quantidade atual.

A lógica atual de identificação por sequência do item da NF previne novas duplicações quando o vínculo já existe. Ela não remove as linhas históricas duplicadas; no fallback legado, a linha da sequência atual pode ser atualizada enquanto a linha antiga permanece.

## SQL corretivo preparado

Arquivo: `database/maintenance/repair_eng2848_invoice_327399.sql`.

A consulta de leitura ao ERP foi repetida em 19/10/2026 e confirmou as oito quantidades e suas sequências de item da NF. O SQL mantém os oito IDs antigos de produto/item, atualiza suas quantidades a partir desse retorno, grava `sequence_invoice_item` e remove os oito registros duplicados posteriores. Manter o item antigo 1572138 preserva a identidade citada no histórico da saída de 32; seu saldo permanece 68, embora a quantidade importada e identificada seja 100.

O SQL foi ensaiado na cópia local com rollback obrigatório. Resultado: oito linhas, sequências de NF de 1 a 8 conforme os produtos do ERP, soma importada 953 e saldo físico 921. A transação histórica 1233965 permaneceu integralmente igual. A reexecução do bloco não duplicou nem alterou os valores novamente. Nenhuma correção foi persistida na base de desenvolvimento.

O arquivo é específico do estado inspecionado da nota 327399. Ele aborta se houver novos produtos, tarefas, movimentações, prioridades ou vínculos incompatíveis. Executar inteiro na mesma conexão, com a sincronização e a movimentação desta entrada suspensas durante a execução. A saída histórica de 32 é preservada; não executar um ajuste adicional que a desconte novamente.
