# Tarefa 111362 — erro ao tentar finalizar após entrega parcial

Investigação em 19/10/2026 na cópia local da base de produção. Consultas somente para leitura; não houve entrega, sincronização nem alteração de status.

## Estado e histórico confirmado

Tarefa de saída 111362, saída 242411, requisição ERP 87438. Status atual da tarefa: 8 (entregue parcial), `end_date` nulo.

Os registros de `request_logs` de 16/10/2026 estão nesta ordem:

1. 55187: separação iniciada.
2. 55188–55194: separações dos produtos.
3. 55195: **Tarefa de separação concluída: 111362**.
4. 55196, 55198, 55199: entregas dos produtos 1293420, 1293422 e 1293423, respectivamente.
5. 55197: falha de entrega do produto 1293421, código ERP 60030020-U: quantidade solicitada 125, disponível no depósito 001 apenas 75.
6. 55205: nova tentativa de entrega do mesmo produto, com a mesma rejeição de saldo.

| Linha da tarefa | Linha de saída | Quantidade separada | Quantidade entregue | Status da linha |
|---|---:|---:|---:|---|
| 950030 | 1293420 | 1 | 1 | Concluído |
| 950031 | 1293421 | 125 | 0 | Separado |
| 950032 | 1293422 | 250 | 250 | Concluído |
| 950033 | 1293423 | 100 | 100 | Concluído |

As entregas persistidas são 8505, 8506 e 8507. Não há registro de entrega de 125 para a linha 1293421.

A separação foi finalizada antes da tentativa de entrega. A combinação de três linhas concluídas com uma linha separada explica o status entregue parcial. `RequestDeliveryService::processStatusPickingOrder` deixa `end_date` nulo quando a tarefa fica entregue parcial; isso não significa que a separação nunca foi finalizada.

## Fluxo atual

- `RequestDeliveryService::delivery` permite entregar tarefa de saída do almoxarifado apenas quando separada (5) ou entregue parcial (8). Tarefa iniciada (2) é rejeitada antes do envio ao ERP.
- A rejeição parcial do ERP preserva as entregas aceitas e mantém o produto recusado separado, permitindo nova tentativa de entrega.
- `Services/V2/PickingOrderFinishService::finish` aceita finalizar saída do almoxarifado apenas iniciada (2). Uma tarefa entregue parcial (8) recebe a mensagem vista na imagem.
- No mobile, `AlmoxarifadoTarefaSaidas/components/ItemTarefa.tsx` exibe “Continuar” para status 8 porque exclui apenas 3, 5 e 6. Nesse status, abre a execução sem chamar start.
- Em `ExecutarSaida.tsx`, o menu de finalização continua disponível e `handleConcluir` tenta finalizar qualquer status diferente de 1 e 4, incluindo 8. Isso explica a tentativa inválida após entrega parcial.

## Conclusão

Não há evidência de entrega antes do encerramento da separação nesta tarefa. O caso concreto é uma entrega com sucesso parcial no ERP, seguida de acesso indevido à tela de execução/finalização pelo aplicativo. O produto pendente deve ser tratado no fluxo de entrega, após conciliar a disponibilidade de estoque; finalizar a separação novamente não resolve a rejeição do ERP.

A análise estática também identificou ausência de `lockForUpdate` na seleção das tarefas para entrega e na validação inicial da finalização V2. Isso é um ponto de atenção para chamadas simultâneas, mas não comprova nem explica o caso 111362: o histórico já registra a separação concluída antes da entrega.

## Preservação da finalização da separação

A data de `picking_orders.end_date` deve preservar o encerramento da separação. O serviço de entrega apagava essa data em uma entrega parcial e a substituía pelo horário da entrega quando todos os produtos eram entregues.

Ajuste em `RequestDeliveryService::processStatusPickingOrder`: preservar a data existente em qualquer resultado de entrega. O fallback para preencher uma data ausente na conclusão total permanece compatível com o comportamento anterior.

Foi incluído um teste de API que simula um produto entregue e outro recusado pelo ERP; verifica a preservação da data no status entregue parcial e, na tentativa seguinte bem-sucedida, no status concluído.

Para o registro histórico 111362, o arquivo `database/maintenance/repair_eng2848_task_111362_finish_date.sql` recupera a data exata do log 55195, sem alterar o status entregue parcial nem os registros de entrega. O SQL foi validado com rollback e reexecução; nenhum dado foi persistido.

## Contrato da chamada de finalização pelo mobile

A chamada de finalização deve liberar uma tela desatualizada, mesmo que outro dispositivo já tenha encerrado a tarefa. Para saídas do almoxarifado, receber a chamada em outro estado não autoriza refazer a separação: a API deve retornar sucesso sem alterar tarefa, linhas, datas, entregas ou disparar notificações.

O fluxo V2 foi ajustado para consultar o estado atual em transação com bloqueio da tarefa. Apenas uma tarefa iniciada e sem data final é efetivamente processada; os demais estados de uma saída do almoxarifado retornam sucesso sem alterações. As validações que impedem iniciar/reabrir e separar uma tarefa entregue parcial continuam valendo.

A recomendação anterior de impedir a chamada de finalização na tela é substituída por esse contrato: o mobile pode chamar finalizar para sair da tela; o backend não repete os efeitos da operação. Testes de API cobrem os demais estados com e sem data final, e um teste de serviço cobre um objeto iniciado desatualizado cujo registro já está entregue parcial no banco.
