{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-estabelecimentos-comerciais/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Reconciliaçã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":"reconciliação","__idx":0},"children":["Reconciliação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A reconciliação garante que o que você publicou, o que foi liquidado, o que foi estornado e o que você recebeu formam um quadro consistente entre seu sistema e a Movvia."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"campo-âncora-referenciaexterna","__idx":1},"children":["Campo-âncora: referenciaExterna"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Toda cobrança publicada carrega ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenciaExterna"]}," — campo definido por você, imutável após a criação. É o elo entre a Movvia e o seu sistema de origem."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenciaExterna"]}," para:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Buscar o status atual de uma cobrança específica."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cruzar o extrato Movvia com o ledger interno."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Identificar cobranças liquidadas que ainda não geraram repasse (dentro do ciclo)."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fluxo-de-reconciliação-diária","__idx":2},"children":["Fluxo de reconciliação diária"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-puxe-o-extrato-do-dia","__idx":3},"children":["1. Puxe o extrato do dia"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /ec-api/v1/extrato?desde=2026-04-23&ate=2026-04-23\nAuthorization: Basic {credencial_ec}\nx-ec-id: {ec_id}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Cada linha do extrato contém:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"tipo\": \"CREDITO\",\n  \"referenciaExterna\": \"PASS-2026-0009871\",\n  \"passagemId\": \"cob_9f2c7e1a\",\n  \"valor\": 12.50,\n  \"liquidanteId\": \"liq_banco_xyz\",\n  \"ocorridoEm\": \"2026-04-23T14:35:22Z\",\n  \"cicloRepasse\": \"2026-04-23\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tipos possíveis: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDITO"]}," (liquidação), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DEBITO"]}," (estorno), ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REPASSE"]}," (transferência para sua conta bancária)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-cruce-com-o-seu-ledger","__idx":4},"children":["2. Cruce com o seu ledger"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para cada linha de ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CREDITO"]},", verifique se a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenciaExterna"]}," existe no seu sistema com status equivalente a liquidada."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Divergências comuns:"]},{"$$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":"Situação"},"children":["Situação"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Causa provável"},"children":["Causa provável"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Ação"},"children":["Ação"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CREDITO na Movvia, não encontrado no seu sistema"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Webhook de liquidação não processado"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Busque a cobrança por ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["referenciaExterna"]}," e atualize o status local"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No seu sistema como liquidada, sem CREDITO na Movvia"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Liquidação pendente no ciclo"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Aguarde o fechamento do ciclo ou consulte o status da cobrança"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DEBITO sem estorno no seu sistema"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Estorno da Movvia automático"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Registre o estorno localmente com o ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passagemId"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-confirme-os-repasses","__idx":5},"children":["3. Confirme os repasses"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /ec-api/v1/repasses?desde=2026-04-01&ate=2026-04-30\nAuthorization: Basic {credencial_ec}\nx-ec-id: {ec_id}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para cada repasse ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CONFIRMADO"]},", verifique se o depósito bancário correspondente foi recebido na conta cadastrada."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Para ver as cobranças que compõem um repasse:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /ec-api/v1/repasses/{repasseId}/passagens\nAuthorization: Basic {credencial_ec}\nx-ec-id: {ec_id}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"paginação","__idx":6},"children":["Paginação"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["O extrato pode ter muitas linhas. Use os parâmetros ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["page"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pageSize"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /ec-api/v1/extrato?desde=2026-04-01&pageSize=500&page=2\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Limite máximo por página: 1000 linhas."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"automatizando-a-reconciliação","__idx":7},"children":["Automatizando a reconciliação"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"Webhook como trigger"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Em vez de puxar o extrato periodicamente, configure webhooks para ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pe.passagem.paga"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pe.passagem.estornada"]}," e ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pe.repasse.confirmado"]},". Seu sistema reage a eventos em vez de polear a API."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Isso reduz latência (você sabe da liquidação em segundos) e o número de chamadas à API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"próximo-passo","__idx":8},"children":["Próximo passo"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/estabelecimentos-comerciais/guides/disputas-estornos"},"children":["Disputas e estornos"]}," — como estornos afetam o extrato e o repasse."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/estabelecimentos-comerciais/tutorials/publicar-primeira-cobranca"},"children":["Publicar primeira cobrança"]}," — validar o fluxo completo em sandbox."]}]}]},"headings":[{"value":"Reconciliação","id":"reconciliação","depth":1},{"value":"Campo-âncora: referenciaExterna","id":"campo-âncora-referenciaexterna","depth":2},{"value":"Fluxo de reconciliação diária","id":"fluxo-de-reconciliação-diária","depth":2},{"value":"1. Puxe o extrato do dia","id":"1-puxe-o-extrato-do-dia","depth":3},{"value":"2. Cruce com o seu ledger","id":"2-cruce-com-o-seu-ledger","depth":3},{"value":"3. Confirme os repasses","id":"3-confirme-os-repasses","depth":3},{"value":"Paginação","id":"paginação","depth":2},{"value":"Automatizando a reconciliação","id":"automatizando-a-reconciliação","depth":2},{"value":"Próximo passo","id":"próximo-passo","depth":2}],"frontmatter":{"title":"Reconciliação — Estabelecimentos Comerciais Movvia","description":"Como cruzar cobranças publicadas, repasses recebidos e estornos no sistema do EC com os dados da API Movvia.","seo":{"title":"Reconciliação"}},"lastModified":"2026-04-25T18:15:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/estabelecimentos-comerciais/guides/reconciliacao","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}