# TMS / ERP de frota

**Quem é você.** Sistema de gestão de transporte (TMS), ERP de frota ou plataforma de frete que gerencia viagens e custos operacionais de frotas B2B.
**Problema.** O custo de pedágio é controlado por TAG física por veículo, reconciliado manualmente no fechamento da viagem, sem integração com o custo da rota planejada.
**Solução Movvia.** Pedágio free flow integrado ao módulo de viagem — cada praça percorrida é capturada, associada à ordem de frete e liquidada dentro do ciclo financeiro da transportadora.

## Como encaixa no seu produto

- Ao cadastrar um veículo na frota, registre a placa via `POST /placas` com referência à ordem de serviço.
- Receba eventos de passagem e associe automaticamente à viagem ativa pelo `metadata`.
- O custo do pedágio entra no custo real da viagem, alimentando o DRE e comparativo planejado vs realizado.
- No encerramento da viagem, confirme todos os pedidos pendentes de uma vez.
- Relatório de pedágios por veículo, rota e período fica disponível para o financeiro via eventos acumulados.


## Fluxo

**Passo 1 — Cadastrar veículo com referência à viagem.**


```bash
curl -X POST "$BASE_URL/placas" \
  -H "Authorization: Basic $MV_KEY" \
  -H "x-parceiro-id: $MV_PARCEIRO_ID" \
  -H "Content-Type: application/json" \
  -d '{"placa":"RST6U78","metadata":{"ordem_frete":"OF-20260424-001","motorista":"José Ferreira"}}'
```

**Passo 2 — Receber passagens durante a viagem.**


```json
{
  "evento": "pe.transacao.recebida",
  "dados": { "placa": "RST6U78", "valor": 18.60, "praca": "Fernão Dias KM 391" }
}
```

**Passo 3 — Confirmar ao encerrar a viagem.**


```bash
curl -X POST "$BASE_URL/pedidos/ped_e5f6g7h8/confirmar" \
  -H "Authorization: Basic $MV_KEY" \
  -H "x-parceiro-id: $MV_PARCEIRO_ID" \
  -H "Content-Type: application/json" \
  -d '{"idempotencyKey":"conf_OF20260424001_encerramento"}'
```

## Modelo de receita típico

Revenue share entre TMS e Movvia sobre o volume liquidado, com o TMS cobrando o pedágio do embarcador dentro do custo de frete. Alternativamente, assinatura mensal por veículo monitorado. Estrutura comercial sob consulta — [comercial@movvia.com.br](mailto:comercial@movvia.com.br).

## Próximo passo

- [Quickstart Parceiros](/parceiros/tutorials/quickstart)
- [Referência da API](/apis/parceiros/openapi)