{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-estabelecimentos-comerciais/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Prefeitura e zona azul","description":"APIs públicas da Movvia para parceiros, estabelecimentos comerciais e clientes de dados veiculares.","meta":[{"name":"theme-color","content":"#7E3DEE"},{"name":"apple-mobile-web-app-title","content":"Movvia Docs"},{"name":"application-name","content":"Movvia Docs"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"prefeitura-e-zona-azul","__idx":0},"children":["Prefeitura e zona azul"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Quem é você."]}," Você é uma prefeitura, secretaria de mobilidade ou empresa gestora de zona azul (estacionamento rotativo público regulado por poder público municipal)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"como-encaixa-no-seu-produto","__idx":1},"children":["Como encaixa no seu produto"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["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)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["TTL definido conforme duração máxima da zona azul (ex.: 2h)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}," suporta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["logradouro"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numero_vaga"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["zona"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["periodo"]}," para geração de relatório de arrecadação municipal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Repasse integrado ao sistema de arrecadação municipal via extrato API (D+1 ou agendado semanal/quinzenal)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["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."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fluxo","__idx":2},"children":["Fluxo"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passo-1--publicar-a-cobrança-de-zona-azul","__idx":3},"children":["Passo 1 — Publicar a cobrança de zona azul"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"POST /ec-api/v1/passagens\nAuthorization: Basic {credencial_ec}\nx-ec-id: {ec_id}\nContent-Type: application/json\n\n{\n  \"referenciaExterna\": \"ZA-CURITIBA-2026-099234\",\n  \"placa\": \"GHI7J89\",\n  \"valor\": 4.00,\n  \"tipo\": \"ZONA_AZUL\",\n  \"localCobranca\": \"Rua XV de Novembro, 400 — Curitiba\",\n  \"capturadoEm\": \"2026-04-23T10:00:00Z\",\n  \"metadata\": {\n    \"numero_vaga\": \"XV-042\",\n    \"zona\": \"central\",\n    \"periodo\": \"2h\",\n    \"municipio\": \"Curitiba\"\n  }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passo-2--receber-confirmação-de-pagamento","__idx":4},"children":["Passo 2 — Receber confirmação de pagamento"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"evento\": \"pe.passagem.paga\",\n  \"referenciaExterna\": \"ZA-CURITIBA-2026-099234\",\n  \"valorLiquidado\": 4.00,\n  \"liquidanteId\": \"liq_banco_rr\",\n  \"liquidadoEm\": \"2026-04-23T10:04:17Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passo-3--gerar-relatório-de-arrecadação","__idx":5},"children":["Passo 3 — Gerar relatório de arrecadação"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /ec-api/v1/extrato?desde=2026-04-01&ate=2026-04-30&tipo=ZONA_AZUL\nAuthorization: Basic {credencial_ec}\nx-ec-id: {ec_id}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"modelo-de-receita-típico","__idx":6},"children":["Modelo de receita típico"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:comercial@movvia.com.br"},"children":["comercial@movvia.com.br"]}," para o modelo específico de prefeituras."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"próximo-passo","__idx":7},"children":["Próximo passo"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/estabelecimentos-comerciais/tutorials/publicar-primeira-cobranca"},"children":["Publicar primeira cobrança"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/estabelecimentos-comerciais/vision-dados/openapi"},"children":["Referência da API"]}]}]}]},"headings":[{"value":"Prefeitura e zona azul","id":"prefeitura-e-zona-azul","depth":1},{"value":"Como encaixa no seu produto","id":"como-encaixa-no-seu-produto","depth":2},{"value":"Fluxo","id":"fluxo","depth":2},{"value":"Passo 1 — Publicar a cobrança de zona azul","id":"passo-1--publicar-a-cobrança-de-zona-azul","depth":3},{"value":"Passo 2 — Receber confirmação de pagamento","id":"passo-2--receber-confirmação-de-pagamento","depth":3},{"value":"Passo 3 — Gerar relatório de arrecadação","id":"passo-3--gerar-relatório-de-arrecadação","depth":3},{"value":"Modelo de receita típico","id":"modelo-de-receita-típico","depth":2},{"value":"Próximo passo","id":"próximo-passo","depth":2}],"frontmatter":{"title":"Prefeitura e zona azul — Estabelecimentos Comerciais Movvia","description":"Como prefeituras e secretarias de mobilidade publicam cobranças de zona azul e taxas de estacionamento regulado via plataforma EC Movvia.","seo":{"title":"Prefeitura e zona azul"}},"lastModified":"2026-04-25T18:15:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/estabelecimentos-comerciais/casos-de-uso/prefeitura-zona-azul","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}