Skip to content
/
Estacionamento
Last updated

Estacionamento

Quem é você. Você opera um estacionamento rotativo público ou privado — a cobrança é calculada pelo tempo de permanência do veículo.

Problema. Cobrança por tempo exige que o motorista pague ao sair, quando já passou pelo processo de retirada do veículo. Maquininha pode falhar, troco é problema, e cancelamentos por saída antecipada geram atrito.

Solução Movvia. Você publica o ticket quando o veículo entra (com valor estimado) e confirma o valor final na saída. O motorista paga no app antes mesmo de chegar ao caixa.

Como encaixa no seu produto

  • Cobrança publicada na entrada com valor inicial ou máximo estimado.
  • Valor final atualizado via PATCH /ec/cobrancas/{id} quando o veículo registra saída.
  • Tolerância mínima configurada no onboarding: cobranças canceladas antes da tolerância não geram débito.
  • Campo metadata suporta vaga, zona, entrada_em e saida_em para reconciliação com o sistema do estacionamento.
  • Liquidação pode ocorrer antes (pré-pago estimado) ou na confirmação de saída (pós-pago exato).

Fluxo

Passo 1 — Publicar o ticket na entrada

POST /ec-api/v1/passagens
Authorization: Basic {credencial_ec}
x-ec-id: {ec_id}
Content-Type: application/json

{
  "referenciaExterna": "ESTAC-2026-03347",
  "placa": "DEF4G56",
  "valor": 20.00,
  "tipo": "ESTACIONAMENTO",
  "localCobranca": "Estacionamento Central — Curitiba",
  "capturadoEm": "2026-04-23T09:00:00Z",
  "metadata": { "vaga": "A-42", "zona": "coberta", "entrada_em": "2026-04-23T09:00:00Z" }
}

Passo 2 — Atualizar o valor na saída

PATCH /ec-api/v1/passagens/cob_estac_id
Authorization: Basic {credencial_ec}
x-ec-id: {ec_id}
Content-Type: application/json

{
  "valor": 15.00,
  "metadata": { "saida_em": "2026-04-23T10:30:00Z" }
}

Passo 3 — Receber liquidação

{
  "evento": "pe.passagem.paga",
  "referenciaExterna": "ESTAC-2026-03347",
  "valorLiquidado": 15.00,
  "liquidanteId": "liq_banco_pq",
  "liquidadoEm": "2026-04-23T10:31:05Z"
}

Modelo de receita típico

Ticket médio de estacionamento é menor que pedágio — a taxa Movvia é negociada com base no volume mensal de tickets. Repasse em D+1 é padrão para estacionamentos. Para redes de estacionamento com alto volume (shopping, aeroporto), consultar plano enterprise.

Próximo passo

Previous page
Next page