# Resincronização das requisições abertas — ENG-2494

O comando consulta individualmente cada saída de requisição do almoxarifado em `stock_ios` no `Exportar_6` do Senior, pelo número ERP (modo E), usando o mesmo job da importação específica da interface. As credenciais, empresa e filial vêm da configuração `integration` da instância. Não depende de um worker: as consultas são executadas sequencialmente no próprio processo Artisan.

## Execução em produção

Na pasta do backend, com o código atualizado e acesso ao ERP:

```bash
php artisan requests:resync-open --dry-run
php artisan requests:resync-open --isolated=1
```

Em uma instalação Docker Compose, execute dentro do serviço PHP:

```bash
docker compose exec app php artisan requests:resync-open --dry-run
docker compose exec app php artisan requests:resync-open --isolated=1
```

`--isolated=1` usa o cache Laravel para impedir duas execuções simultâneas deste comando. Use o mesmo cache entre processos/servidores. Esta trava não bloqueia o sincronizador periódico; evite executá-los simultaneamente para reduzir disputas e carga no ERP. O job mantém a proteção existente contra sobrescrever registros alterados durante a consulta.

## Seleção e comportamento

- Seleciona `stock_ios` do setor `WAREHOUSE`/Almoxarifado (1), tipo `OUTPUT`/Saída (2), motivos `REQUEST` (3) ou `SYNCED_REQUEST` (4). Exclui os status de saída `CONCLUDED` (3) e `CANCELED` (9).
- Inclui saídas sem vínculo em `requests`. Quando existe vínculo, o job sincroniza os itens e recalcula também o status da requisição vinculada; o filtro de status usa a saída, não a requisição.
- Considera saídas existentes no início da execução; carrega 100 por vez, sem carregar toda a base em memória.
- Ignora requisições sem número ERP positivo, de outra empresa/filial ou com envio `queued`/`processing`.
- Saídas duplicadas ou vínculos conflitantes em `requests` com o mesmo número/empresa/filial são reportados como falha e precisam ser revisados.
- Consulta uma requisição por vez, com intervalo padrão de 200 ms. Recalcula os saldos e status pelo fluxo existente, incluindo tratamento de sequências ausentes em uma consulta específica completa. Não recria nem reenvia a requisição ao ERP.
- Cada consulta tem sua própria transação local. Uma falha desfaz as alterações locais daquela consulta, é reportada e não interrompe as seguintes.
- O resumo informa consultas concluídas, não necessariamente status alterados. Uma requisição pode continuar aberta se o ERP ainda retornar saldo pendente.
- Retorna código 1 se houver falhas, 2 para opções inválidas e 0 caso contrário. Ignoradas aparecem no resumo e devem ser revisadas separadamente.
- Os detalhes do job permanecem no canal de log `integration`.

## Teste limitado e retomada

`--stock-io-id` recebe o **ID de `stock_ios`**, não o ID de `requests` nem o número do ERP. A opção anterior `--request-id` foi substituída. Para testar uma saída, confirme seu ID na instância:

```bash
php artisan requests:resync-open --stock-io-id=123 --isolated=1
```

Para retomar após o último ID de `stock_ios` registrado no terminal:

```bash
php artisan requests:resync-open --after-id=123 --isolated=1
```

A retomada não repete falhas anteriores a esse ID. Execute novamente sem `--after-id` ou use `--stock-io-id` para repetir as falhas. Reexecutar o comando consulta novamente o ERP; requisições que passaram a Concluída/Cancelada são excluídas automaticamente. `--chunk` aceita 1 a 1000; `--delay-ms` aceita 0 a 60000 para ajustar a carga.
