{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-estabelecimentos-comerciais/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Balsa e travessia","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":"balsa-e-travessia","__idx":0},"children":["Balsa e travessia"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Quem é você."]}," Você opera uma travessia de balsa ou ferry intermunicipal — a cobrança é gerada quando o veículo embarca."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Problema."]}," Cobrança em dinheiro em espécie no embarque causa filas, troco e risco operacional. Meios digitais exigem terminal próprio ou integração por concessão."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Solução Movvia."]}," Você publica a cobrança no embarque. O motorista paga no app enquanto espera na fila ou ainda no terminal. Você recebe a confirmação antes da partida."]},{"$$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 veículo é registrado na fila ou no embarque."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["TTL definido no onboarding com margem para a duração da travessia."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Se a travessia for cancelada (condições climáticas, manutenção), você cancela a cobrança via API antes da liquidação ou solicita estorno após."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Liquidação confirmada via webhook antes da partida — sem perda de receita por falta de troco."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Campo ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["metadata"]}," suporta ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tipo_veiculo"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sentido"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numero_viagem"]}," para reconciliação com o sistema de controle da balsa."]}]},{"$$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-no-embarque","__idx":3},"children":["Passo 1 — Publicar a cobrança no embarque"]},{"$$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\": \"BALSA-2026-00812\",\n  \"placa\": \"MNO3P45\",\n  \"valor\": 35.00,\n  \"tipo\": \"EMBARQUE_BALSA\",\n  \"localCobranca\": \"Terminal de Guaratuba — PR\",\n  \"capturadoEm\": \"2026-04-23T07:05:00Z\",\n  \"metadata\": { \"numero_viagem\": \"V-0041\", \"sentido\": \"Guaratuba-Matinhos\", \"tipo_veiculo\": \"PASSEIO\" }\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passo-2--receber-liquidação-antes-da-partida","__idx":4},"children":["Passo 2 — Receber liquidação antes da partida"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"evento\": \"pe.passagem.paga\",\n  \"referenciaExterna\": \"BALSA-2026-00812\",\n  \"valorLiquidado\": 35.00,\n  \"liquidanteId\": \"liq_carteira_xy\",\n  \"liquidadoEm\": \"2026-04-23T07:08:14Z\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"passo-3--cancelar-se-a-travessia-não-ocorrer","__idx":5},"children":["Passo 3 — Cancelar se a travessia não ocorrer"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"DELETE /ec-api/v1/passagens/cob_balsa_id\nAuthorization: Basic {credencial_ec}\nx-ec-id: {ec_id}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Se já liquidada, use o fluxo de estorno com ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["motivo: \"COBRANCA_INDEVIDA\""]},"."]},{"$$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 de travessia varia por porte do veículo e rota. A taxa Movvia é percentual sobre o volume liquidado, negociada conforme ticket médio e volume mensal. Repasse em D+1 é o padrão para operadoras de balsa."]},{"$$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":"Balsa e travessia","id":"balsa-e-travessia","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 no embarque","id":"passo-1--publicar-a-cobrança-no-embarque","depth":3},{"value":"Passo 2 — Receber liquidação antes da partida","id":"passo-2--receber-liquidação-antes-da-partida","depth":3},{"value":"Passo 3 — Cancelar se a travessia não ocorrer","id":"passo-3--cancelar-se-a-travessia-não-ocorrer","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":"Balsa e travessia — Estabelecimentos Comerciais Movvia","description":"Como operadoras de balsa e travessia intermunicipal publicam cobranças por embarque e gerenciam reembolsos via plataforma EC Movvia.","seo":{"title":"Balsa e travessia"}},"lastModified":"2026-04-25T18:15:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/estabelecimentos-comerciais/casos-de-uso/balsa","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}