{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-parceiros/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Modos de operação","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":"modos-de-operação","__idx":0},"children":["Modos de operação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O modo de operação (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MODO_PUBLICACAO"]},") determina quais passagens geram eventos no seu sistema. É configurado no onboarding e pode ser alterado mediante solicitação."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"filtrado-padrão","__idx":1},"children":["FILTRADO (padrão)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você recebe eventos ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["apenas"]}," das placas que cadastrou via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /placas"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Indicado para:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Carteiras digitais e bancos com base de clientes própria."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Programas de fidelidade que monitoram frota específica."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Qualquer caso onde você conhece o conjunto de placas de antemão."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fluxo:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"POST /placas → cadastrar placa\n       ↓\nMovvia monitora passagens dessa placa\n       ↓\nWebhook → seu endpoint (só para placas cadastradas)\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Gerenciar placas:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# Cadastrar\ncurl -X POST https://hml.api.pedagioeletronico.com.br/gestao-webhooks-api/v1/placas \\\n  -H \"Authorization: Basic $MV_KEY\" \\\n  -H \"x-parceiro-id: $MV_PARCEIRO_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"placa\":\"ABC1D23\",\"metadata\":{\"cliente_id\":\"ext_123\"}}'\n\n# Remover\ncurl -X DELETE https://hml.api.pedagioeletronico.com.br/gestao-webhooks-api/v1/placas/ABC1D23 \\\n  -H \"Authorization: Basic $MV_KEY\" \\\n  -H \"x-parceiro-id: $MV_PARCEIRO_ID\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Volume e custo"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["No modo FILTRADO, o volume de eventos é proporcional ao número de placas cadastradas. Adequado para controlar custos em bases menores."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"total","__idx":2},"children":["TOTAL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Você recebe eventos de ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["todas"]}," as passagens capturadas na rede coberta pela Movvia, independentemente de cadastro de placas."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Indicado para:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Seguradoras que precisam de histórico completo para precificação."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Plataformas de dados veiculares."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Casos onde a descoberta de placa acontece no evento, não antes."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Atenção ao volume"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O modo TOTAL gera volume significativamente maior de eventos. Dimensione sua infraestrutura de webhook antes de ativar em produção. Discuta com a equipe Movvia no onboarding."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"comparativo","__idx":3},"children":["Comparativo"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":""},"children":[]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"FILTRADO"},"children":["FILTRADO"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"TOTAL"},"children":["TOTAL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Volume de eventos"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Proporcional às placas cadastradas"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toda a rede"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cadastro de placas necessário"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sim"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Não"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Casos típicos"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bancos, carteiras, frotas"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seguradoras, plataformas de dados"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint /placas usado"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sim"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Opcional"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Controle de custo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direto"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requer planejamento de capacidade"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"alterar-modo","__idx":4},"children":["Alterar modo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O modo é definido no onboarding. Para alterar, entre em contato com ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:comercial@movvia.com.br"},"children":["comercial@movvia.com.br"]},". A mudança leva até 1 dia útil e não causa downtime."]}]},"headings":[{"value":"Modos de operação","id":"modos-de-operação","depth":1},{"value":"FILTRADO (padrão)","id":"filtrado-padrão","depth":2},{"value":"TOTAL","id":"total","depth":2},{"value":"Comparativo","id":"comparativo","depth":2},{"value":"Alterar modo","id":"alterar-modo","depth":2}],"frontmatter":{"title":"Modos de operação — Parceiros Movvia","description":"Diferença entre os modos FILTRADO e TOTAL na API de Parceiros Movvia e como cada um afeta o recebimento de eventos.","seo":{"title":"Modos de operação"}},"lastModified":"2026-04-25T15:17:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/parceiros/guides/modos-operacao","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}