Skip to content
/
Prefeitura e zona azul
Last updated

Prefeitura e zona azul

Quem é você. Você é uma prefeitura, secretaria de mobilidade ou empresa gestora de zona azul (estacionamento rotativo público regulado por poder público municipal).

Problema. Cobrança de zona azul por tíquete físico ou app proprietário tem baixa adesão, fraude de tíquete e custo operacional alto. Cidadão não quer baixar mais um app.

Solução Movvia. Você publica a cobrança de zona azul como EC. A Movvia distribui para toda a rede — o cidadão paga no app que já usa (banco, carteira digital) sem precisar de um app da prefeitura.

Como encaixa no seu produto

  • Cobrança publicada quando o agente de trânsito ou o próprio cidadão registra a ocupação da vaga (integração com app de gestão ou terminal de rua).
  • TTL definido conforme duração máxima da zona azul (ex.: 2h).
  • Campo metadata suporta logradouro, numero_vaga, zona, periodo para geração de relatório de arrecadação municipal.
  • Repasse integrado ao sistema de arrecadação municipal via extrato API (D+1 ou agendado semanal/quinzenal).
  • Regime de cobrança pública: a Movvia emite NF apenas sobre a taxa — o valor arrecadado vai direto para a subconta EC da prefeitura.

Fluxo

Passo 1 — Publicar a cobrança de zona azul

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

{
  "referenciaExterna": "ZA-CURITIBA-2026-099234",
  "placa": "GHI7J89",
  "valor": 4.00,
  "tipo": "ZONA_AZUL",
  "localCobranca": "Rua XV de Novembro, 400 — Curitiba",
  "capturadoEm": "2026-04-23T10:00:00Z",
  "metadata": {
    "numero_vaga": "XV-042",
    "zona": "central",
    "periodo": "2h",
    "municipio": "Curitiba"
  }
}

Passo 2 — Receber confirmação de pagamento

{
  "evento": "pe.passagem.paga",
  "referenciaExterna": "ZA-CURITIBA-2026-099234",
  "valorLiquidado": 4.00,
  "liquidanteId": "liq_banco_rr",
  "liquidadoEm": "2026-04-23T10:04:17Z"
}

Passo 3 — Gerar relatório de arrecadação

GET /ec-api/v1/extrato?desde=2026-04-01&ate=2026-04-30&tipo=ZONA_AZUL
Authorization: Basic {credencial_ec}
x-ec-id: {ec_id}

Modelo de receita típico

Para poder público, o modelo comercial é tipicamente definido via licitação ou adesão a contrato-quadro. A taxa Movvia recai sobre o volume liquidado. Consulte comercial@movvia.com.br para o modelo específico de prefeituras.

Próximo passo

Previous page
Next page