# Modos de operação

O modo de operação (`MODO_PUBLICACAO`) determina quais passagens geram eventos no seu sistema. É configurado no onboarding e pode ser alterado mediante solicitação.

## FILTRADO (padrão)

Você recebe eventos **apenas** das placas que cadastrou via `POST /placas`.

Indicado para:

- Carteiras digitais e bancos com base de clientes própria.
- Programas de fidelidade que monitoram frota específica.
- Qualquer caso onde você conhece o conjunto de placas de antemão.


Fluxo:


```
POST /placas → cadastrar placa
       ↓
Movvia monitora passagens dessa placa
       ↓
Webhook → seu endpoint (só para placas cadastradas)
```

Gerenciar placas:


```bash
# Cadastrar
curl -X POST https://hml.api.pedagioeletronico.com.br/gestao-webhooks-api/v1/placas \
  -H "Authorization: Basic $MV_KEY" \
  -H "x-parceiro-id: $MV_PARCEIRO_ID" \
  -H "Content-Type: application/json" \
  -d '{"placa":"ABC1D23","metadata":{"cliente_id":"ext_123"}}'

# Remover
curl -X DELETE https://hml.api.pedagioeletronico.com.br/gestao-webhooks-api/v1/placas/ABC1D23 \
  -H "Authorization: Basic $MV_KEY" \
  -H "x-parceiro-id: $MV_PARCEIRO_ID"
```

Volume e custo
No modo FILTRADO, o volume de eventos é proporcional ao número de placas cadastradas. Adequado para controlar custos em bases menores.

## TOTAL

Você recebe eventos de **todas** as passagens capturadas na rede coberta pela Movvia, independentemente de cadastro de placas.

Indicado para:

- Seguradoras que precisam de histórico completo para precificação.
- Plataformas de dados veiculares.
- Casos onde a descoberta de placa acontece no evento, não antes.


Atenção ao volume
O modo TOTAL gera volume significativamente maior de eventos. Dimensione sua infraestrutura de webhook antes de ativar em produção. Discuta com a equipe Movvia no onboarding.

## Comparativo

|  | FILTRADO | TOTAL |
|  --- | --- | --- |
| **Volume de eventos** | Proporcional às placas cadastradas | Toda a rede |
| **Cadastro de placas necessário** | Sim | Não |
| **Casos típicos** | Bancos, carteiras, frotas | Seguradoras, plataformas de dados |
| **Endpoint /placas usado** | Sim | Opcional |
| **Controle de custo** | Direto | Requer planejamento de capacidade |


## Alterar modo

O modo é definido no onboarding. Para alterar, entre em contato com [comercial@movvia.com.br](mailto:comercial@movvia.com.br). A mudança leva até 1 dia útil e não causa downtime.