# Prontidão da Integração VC Digital

- gerado em: `2026-03-11 21:30:58`
- controladoras: `2`
- empresas: `142`
- controladoras sem `Company ID VC`: `2`
- empresas sem `CNPJ` no cadastro mestre: `140`

## Pronto para consumo

- API interna publicada
- token separado por controladora
- resposta com `company`, `controladora`, `numeroDocumento`, `dueDate`, `valorTotal`, `recalculada`, `documents[]`, `downloadUrl` e `viewerUrl`
- DARE e extrato expostos separadamente dentro de `documents[]`

## Pendências reais antes da produção completa

### Controladoras sem `Company ID VC`
- Wns contabilidade | CNPJ 33070690000104
- 38.105.035 ERLAN DOS SANTOS ARAUJO | CNPJ 38105035000168

### Empresas ainda sem CNPJ no ICMS SaaS
- total atual: `140`
- isso afeta o vínculo `companyId + cnpj` no VC Digital
- enquanto o CNPJ não existir no cadastro mestre, o endpoint pode devolver `company.cnpj = ""`

## Próximo passo para a WNS

1. preencher `Company ID VC` da WNS
2. entregar o token da controladora WNS ao outro programador
3. iniciar cursor em `GET /api/internal/fiscal-documents/upload-events?bootstrap=1`
4. consumir incremental em `GET /api/internal/fiscal-documents/upload-events?after_id=<cursor>&ready_only=1`
5. quando houver evento novo, consultar `GET /api/internal/fiscal-documents?pending_only=1`
6. baixar `documents[].downloadUrl` ou abrir `documents[].viewerUrl`
7. marcar cada artefato concluído em `POST /api/internal/fiscal-documents/mark-exported`
8. após envio ou falha no WhatsApp do cliente, registrar retorno em `POST /api/internal/fiscal-documents/mark-delivered`