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.
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:
# 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"No modo FILTRADO, o volume de eventos é proporcional ao número de placas cadastradas. Adequado para controlar custos em bases menores.
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.
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.
| 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 |
O modo é definido no onboarding. Para alterar, entre em contato com comercial@movvia.com.br. A mudança leva até 1 dia útil e não causa downtime.