# 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


```http
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


```json
{
  "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


```http
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](mailto:comercial@movvia.com.br) para o modelo específico de prefeituras.

## Próximo passo

- [Publicar primeira cobrança](/estabelecimentos-comerciais/tutorials/publicar-primeira-cobranca)
- [Referência da API](/apis/estabelecimentos-comerciais/vision-dados/openapi)