# Ajuste de vencimentos para reconsumo VC Digital

Base:
- `https://icms.vcnodigital.com`

Objetivo:
- alinhar o reconsumo do VC Digital com a nova semântica de vencimentos
- separar o que já foi corrigido no SaaS do que ainda exige reconsumo no portal

## Situação consolidada em 2026-03-15

Origem da análise:
- backfill do `vencimento_original`
- conferência remota por `company_key + guia + parcela`
- conferência remota adicional por `guia + parcela`
- varredura local de evidências em:
  - `reports/runs/*.json`
  - `captures/queue_progress_*.json`
  - `captures/extratos/*`
  - pasta local de `DARES`

Resultado:
- `90` guias históricas tiveram `vencimento_original` corrigido no SaaS
- `68` já estavam corretas
- `20` ficaram fora do banco remoto no primeiro backfill

## Realinhamento adicional em 2026-03-16

Origem da analise:
- reconstrucao do catalogo local a partir de `reports/guia_artifact_catalog.json.bak_reset_gt_20260315_125111`
- consolidacao dos `reports/runs/*.json` mais recentes por `empresa + guia + parcela`

Resultado adicional:
- `20` guias unicas tinham `vencimento_lista = 31/03/2026`, mas estavam gravadas com data operacional menor; agora o catalogo local prioriza `31/03/2026`
- `12` guias unicas de `02/2026` ja possuem evidencia real de emissao para `31/03/2026`
- `77` entradas do catalogo local foram corrigidas ou deixadas pendentes de republicacao

Regra nova para consumo:
- se `availableDueDates` contiver o proprio `vencimentoOriginal`, o VC Digital deve considerar essa data como vencedora
- se a guia original vier de `02/2026` e `31/03/2026` estiver disponivel, a versao vencida deve ser substituida pela emitida para `31/03/2026`
- quando a mesma guia voltar com `artifactId` novo, o documento antigo deve ser descartado

Tratamento adicional:
- desses `20`, `2` já foram reingeridos com sucesso usando artefatos locais confiáveis
- restam `18` para reconsumo real no portal

## Guias já tratadas agora

### 1. Reingestão local completa

- empresa: `00000006416632 - E ROMUALDO DA SILVA`
- guia: `20261600006925`
- parcela: `00`
- vencimento original publicado: `2026-02-27`
- artefatos reenviados:
  - `guia_pdf`
  - `extrato_pdf`
  - `extrato_json`
  - `extrato_screenshot`

### 2. Reingestão local parcial

- empresa: `00000005295807 - 32.920.253 ELESSANDRA DA SILVA FONSECA`
- guia: `20240302255479`
- parcela: `00`
- vencimento original publicado: `2024-09-30`
- artefatos reenviados:
  - `guia_pdf`

## Fila restante

Arquivo autoritativo:
- `GET /docs/vc-digital-vencimentos-ajuste.json`

Resumo atual:
- `18` itens
- todos classificados como `RECONSUMO_PORTAL_COMPLETO`

Distribuição por empresa:
- `11` itens: `00000001709011 - DROGARIAS HIPER POPULAR BURITIS LTDA`
- `4` itens: `00000005382921 - RESTAURANTE CHURRASCARIA E LANCHONETE JL LTDA`
- `1` item: `00000004823044 - M. F. BARROS LTDA`
- `1` item: `00000006020313 - M D SILVA DOS SANTOS`
- `1` item: `00000006416632 - E ROMUALDO DA SILVA`

## O que o time do VC Digital deve fazer

1. Reconsumir as guias que voltarem a aparecer após nova captura do portal.
2. Tratar `dueDate` como alias de `dueDateReal`.
3. Usar estes campos como fonte:
   - `vencimentoOriginal`
   - `vencimentoEmitido`
   - `dueDateReal`
   - `dueDateSource`
   - `recalculada`
4. Quando o mesmo `numeroDocumento + parcela` reaparecer com dados atualizados, substituir a versão anterior.
5. Para qualquer demanda de guia vencida ou reimportacao, acionar primeiro o job local em `POST /api/internal/orchestrator/jobs` e consumir a API fiscal so depois da conclusao.

## Regra operacional de vencimento

- se `recalculada = false`:
  - consumir `dueDateReal = vencimentoOriginal`
- se `recalculada = true`:
  - consumir `dueDateReal = vencimentoEmitido`

Origem declarada:
- `LISTA_SEFIN`
- `EMISSAO_CONFIRMADA`
- `EMISSAO_RECALCULADA`
- `EMISSAO_SEM_BASE_LISTA`

## Referências publicadas

- `GET /docs/vc-digital.md`
- `GET /docs/vc-digital-example-response.json`
- `GET /docs/vc-digital-vencimentos-ajuste.md`
- `GET /docs/vc-digital-vencimentos-ajuste.json`