{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-estabelecimentos-comerciais/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Serviço portuário","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":"serviço-portuário","__idx":0},"children":["Serviço portuário"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Quem é você."]}," Você opera uma área portuária concessionada — a cobrança é gerada pela entrada ou saída de veículos de carga, passageiros ou de apoio logístico na área sob sua jurisdição."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Problema."]}," Cobrança de acesso portuário envolve múltiplos tipos de veículo, CNPJ transportador, horário de pico e regras tarifárias complexas. Processamento manual é lento e gera fila no acesso."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Solução Movvia."]}," Você publica a cobrança na entrada ou saída do veículo. A rede de liquidantes permite pagamento automático vinculado ao CNPJ transportador — sem dinheiro em espécie na portaria."]},{"$$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 no momento de entrada ou saída do veículo na área portuária."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identificação por placa (veículo) e opcionalmente CNPJ do transportador via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Regras de horário de pico e categoria tarifária configuradas no onboarding."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}," suporta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tipo_operacao"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cnpj_transportador"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numero_dta"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terminal"]}," para integração com sistemas de controle portuário."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Liquidação confirmada via webhook — portão liberado após ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pe.passagem.paga"]}," ou no fluxo pós-pago (faturamento mensal ao transportador)."]}]},{"$$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-na-entrada","__idx":3},"children":["Passo 1 — Publicar a cobrança na entrada"]},{"$$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\": \"PORTO-2026-00198\",\n  \"placa\": \"JKL0M12\",\n  \"valor\": 85.00,\n  \"tipo\": \"ACESSO_PORTUARIO\",\n  \"localCobranca\": \"Terminal de Paranaguá — Portão 3\",\n  \"capturadoEm\": \"2026-04-23T06:30:00Z\",\n  \"metadata\": {\n    \"tipo_operacao\": \"ENTRADA\",\n    \"cnpj_transportador\": \"12345678000190\",\n    \"numero_dta\": \"DTA-2026-00998\",\n    \"terminal\": \"APPA-T3\"\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\": \"PORTO-2026-00198\",\n  \"valorLiquidado\": 85.00,\n  \"liquidanteId\": \"liq_frota_ss\",\n  \"liquidadoEm\": \"2026-04-23T06:30:04Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passo-3--consultar-cobranças-por-cnpj-transportador","__idx":5},"children":["Passo 3 — Consultar cobranças por CNPJ transportador"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /ec-api/v1/passagens?desde=2026-04-01&metadata.cnpj_transportador=12345678000190\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":["Ticket médio portuário é significativamente maior que pedágio convencional. A taxa Movvia é percentual sobre o volume liquidado, com modelo enterprise disponível para grandes terminais. Repasse em D+0 ou D+1 conforme contrato. Para faturamento mensal por CNPJ transportador, consulte o modelo de cobrança consolidada no onboarding."]},{"$$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":"Serviço portuário","id":"serviço-portuário","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 na entrada","id":"passo-1--publicar-a-cobrança-na-entrada","depth":3},{"value":"Passo 2 — Receber confirmação de pagamento","id":"passo-2--receber-confirmação-de-pagamento","depth":3},{"value":"Passo 3 — Consultar cobranças por CNPJ transportador","id":"passo-3--consultar-cobranças-por-cnpj-transportador","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":"Serviço portuário — Estabelecimentos Comerciais Movvia","description":"Como operadores de áreas portuárias concessionadas publicam cobranças de entrada e saída de veículos via plataforma EC Movvia.","seo":{"title":"Serviço portuário"}},"lastModified":"2026-04-25T18:15:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/estabelecimentos-comerciais/casos-de-uso/portuario","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}