# 09 — Integrações externas

## 1. Brasil API (CNPJ / CEP)

| Campo | Valor |
|-------|-------|
| Finalidade | Consultar dados cadastrais RFB (via agregador) e CEP |
| Sistema externo | brasilapi.com.br |
| Direção | Saída (app → API) |
| Endpoints | `GET /api/cnpj/v1/{cnpj}` · `GET /api/cep/v2/{cep}` |
| Autenticação | Nenhuma (HTTP público) |
| Trigger | `ConsultaSimplesJob`, `PessoaController`, Controllers admin, participantes SPED, rotas `/api/brasil/*` |
| Código | `app/Services/BrasilApiService.php`, `Api/BrasilApiController.php` |
| Classificação | CONFIRMADO |

## 2. Proxy “Gov” Simples

| Campo | Valor |
|-------|-------|
| Finalidade | Normalizar status Simples/MEI |
| Implementação atual | Delega a BrasilApiService (não é OAuth gov.br ainda) |
| Endpoint app | `GET /api/gov/simples/{cnpj}` |
| Código | `GovBrService`, `GovBrController` |
| Doc | `docs/SIMPLES-NACIONAL-CONSULTA.md` |
| Classificação | CONFIRMADO (fonte = Brasil API) |

## 3. Portal SVRS — Classificação Tributária

| Campo | Valor |
|-------|-------|
| Finalidade | Sincronizar catálogo `classtrib_referencia` |
| Sistema | `dfe-portal.svrs.rs.gov.br` (ClassificacaoTributaria) |
| Direção | Saída |
| Auth | Portal público scrape/download; API opcional com certificado (config) |
| Trigger | `SyncClassTribJob` diário 06:00; command `classtrib:sync` |
| Código | `ClassTribSyncService`, `SyncClassTribCommand`, `SyncClassTribJob` |
| Classificação | CONFIRMADO |

## 4. Brevo (e-mail transacional)

| Campo | Valor |
|-------|-------|
| Finalidade | Envio de e-mail de reset de senha |
| Endpoint | `POST https://api.brevo.com/v3/smtp/email` |
| Auth | API Key em config `services.brevo` / env `BREVO_API_KEY` (**não documentar valor**) |
| Trigger | `ForgotPasswordController::sendResetLinkEmail` |
| Classificação | CONFIRMADO |

## 5. Storage local de arquivos SPED

| Campo | Valor |
|-------|-------|
| Finalidade | Persistir uploads |
| Destino | `storage/` via uploads |
| Código | Controllers SPED + `HandlesFileUploads` |
| Classificação | CONFIRMADO |

Não foram encontradas integrações SOAP, WhatsApp, SFTP, ERP externos ou webhooks de entrada no código do núcleo — **NÃO CONFIRMADO** existência.