Perfil financeiro da PJ (F1)

O perfil financeiro reúne as fontes Open Finance de uma mesma PJ (identificada pelo CNPJ) e publica indicadores de caixa e de consumo com a evidência de cada número. Esta página descreve o contrato das rotas da F1. Todos os exemplos usam dados sintéticos do sandbox PJ.

O módulo fica desligado por padrão. Enquanto a chave CONSOLIDATED_INTELLIGENCE_ENABLED estiver desligada, nenhuma rota desta página existe e todas respondem 404. Sem uma versão de cálculo ativa (FINANCIAL_PROFILE_CALCULATION_VERSION), as leituras devolvem result_status: "unavailable" e o pedido de análise responde 503.

O que entra e o que fica fora da F1

Entra na F1	Fica fora da F1
Pedido e acompanhamento da análise	Carga de títulos do ERP
Resumo, métricas e evidências	Upload CSV
Recorrências e rejeição de recorrência	Conciliação entre título e movimento
Revisão da classificação de um movimento	Alertas
Leitura do `sync-schedule` (medição)	Previsão de caixa e diagnóstico de liquidez

Criar o perfil e vincular itens não faz parte das rotas desta fase. Console, eventos de webhook, rota de leitura do histórico de revisões e billing também ficam fora.

A F2 acrescenta carga de títulos do ERP por API e upload CSV (Títulos do ERP, guia CSV), conciliação (Conciliação assistida), diagnóstico de liquidez, sincronização por perfil e alertas (Liquidez e alertas) e eventos de webhook. Previsão de caixa continua fora.

Regras comuns

Autenticação: todas as rotas exigem o header X-API-KEY da aplicação. Sem token, a resposta é 403. Um perfil de outra aplicação responde 404 NOT_FOUND, como os demais recursos.
Valores: todo valor monetário é string decimal, no padrão da API Contas 2.5.1 (transactionAmount: até 15 dígitos inteiros e de 2 a 4 casas, como "1000.0400"). Nunca é número JSON. Some com tipo decimal: "0.10" + "0.20" = "0.30". Com float64, essa soma não fecha. Moeda segue ^[A-Z]{3}$. O consolidado é em BRL.
Instantes: campos como as_of, computed_at e observed_at são UTC com Z, como o transactionDateTime da API Contas.
Janela civil: dias e meses são civis em America/Sao_Paulo. O instante 2026-03-01T02:30:00.000Z cai no dia civil 2026-02-28. Toda janela tem início inclusivo e fim exclusivo e termina, no máximo, à meia-noite do dia de referência. O dia corrente fica de fora.
Realizado: só movimento com completedAuthorisedPaymentType = TRANSACAO_EFETIVADA entra nos indicadores. LANCAMENTO_FUTURO e TRANSACAO_PROCESSANDO ficam fora, com motivo. A direção vem de creditDebitType (CREDITO é entrada e DEBITO é saída), nunca do sinal do valor.
Duas perspectivas: caixa (contas BANK) e consumo (compras de cartão). O pagamento da fatura não entra no consumo. A transferência entre contas da própria PJ é neutralizada.
Sem chamada nova à instituição: o cálculo e todas as rotas leem só o banco da Malvo. Nenhuma rota pede saldo, dispara sync ou chama a instituição.
Erros: o corpo segue o envelope padrão (code, message, codeDescription, requestId). Veja Erros.

Consentimento diferente de `AUTHORISED`

Uma fonte só entra no cálculo se estiver vinculada ao perfil, com titularidade comprovada pelo CNPJ e com consentimento AUTHORISED dentro do prazo, com ACCOUNTS_READ e ACCOUNTS_BALANCES_READ. Consentimento REVOKED, EXPIRED, REJECTED, CONSUMED, AWAITING_AUTHORISATION ou vencido deixa a fonte fora, com o motivo consent_not_authorised. Nenhum resultado novo usa essa fonte:

Leituras (summary, metrics, evidence, recurrences): o resultado publicado antes da mudança deixa de ser servido. A resposta é 200 sem números, com o motivo e os estados.
Análise: se nenhuma fonte for elegível, nada é publicado e o pedido termina em failed com failure_reason: "no_eligible_source". Se o consentimento mudar no meio do cálculo, o pedido vira superseded e um pedido novo é registrado.
Revisão de classificação: a rota responde 403 SOURCE_NOT_AUTHORISED e não grava nada.

Leitura depois de revogar o consentimento da única fonte:

Leitura com fonte revogada

{
  "financial_profile_id": "0b7c1d2e-0000-4000-8000-00000000f001",
  "analysis_id": null,
  "calculation_id": null,
  "data_version": null,
  "calculation_version": null,
  "computed_at": null,
  "window": null,
  "currency": "BRL",
  "states": {
    "processing": "queued",
    "authorization": "revoked",
    "coverage": "insufficient",
    "freshness": "unknown"
  },
  "result_status": "unavailable",
  "unavailable_reason": "result_outdated",
  "sources": [],
  "exclusions": [],
  "bank_position_skew": null,
  "skew_within_limit": null,
  "own_cash_available": null,
  "summary_window": null,
  "available_windows": []
}

A mudança do consentimento registra um recálculo (processing: "queued"). Quando ele termina sem fonte elegível, processing passa a failed. Revisão de classificação de um movimento dessa fonte:

403 SOURCE_NOT_AUTHORISED

{
  "code": 403,
  "message": "Transaction source is not authorised for this financial profile",
  "codeDescription": "SOURCE_NOT_AUTHORISED",
  "requestId": "req-sintetico-0001"
}

Envelope das leituras

summary, metrics, evidence e recurrences começam pelo mesmo envelope:

Campo	Tipo	Notas
`financial_profile_id`	string	Id do perfil
`analysis_id`, `calculation_id`	string ou `null`	Pedido e cálculo que geraram o resultado
`data_version`	string ou `null`	Hash do estado das fontes usado no cálculo
`calculation_version`	string ou `null`	Regra de cálculo (`v1`)
`computed_at`	instante UTC ou `null`	Quando o resultado foi publicado
`window`	objeto ou `null`	`reference_date` (dia civil), `as_of` (UTC) e `timezone` (`America/Sao_Paulo`)
`currency`	string	`BRL`
`states`	objeto	`processing` (`queued`, `processing`, `ready`, `failed`), `authorization` (`active`, `restricted`, `revoked`), `coverage` (`sufficient`, `partial`, `insufficient`) e `freshness` (`unknown` na F1)
`result_status`	string	`available` ou `unavailable`
`unavailable_reason`	string	Só quando indisponível: `no_result`, `result_outdated`, `calculation_version_mismatch` ou `calculation_version_unavailable`
`sources`	array	Todas as fontes, incluídas e excluídas, com `decision`, `reason`, `consent_status`, `observed_at` e contas
`exclusions`	array	Fontes e contas fora do cálculo, com o motivo
`bank_position_skew`	objeto ou `null`	Posição de saldo mais antiga e mais recente, diferença em segundos e limite de 2 horas
`skew_within_limit`	boolean ou `null`	`false` acima de 2 horas; `null` sem resultado

Motivos de fonte excluída: consent_not_authorised, missing_account_permission, holder_under_review e unlinked. Motivos de conta fora do caixa próprio: not_bank_account, unsupported_currency, credit_limit_not_separated, balance_not_observed e invalid_amount.

Análise

`POST /financial-profiles/{id}/analyses`

Pede um cálculo novo. Não espera o resultado: devolve 202 com o pedido. O cálculo roda em segundo plano e lê só o banco. Existe um pedido pendente por perfil; um pedido novo enquanto outro está pendente devolve o mesmo pedido.

curl -s -X POST https://api.malvo.io/financial-profiles/0b7c1d2e-0000-4000-8000-00000000f001/analyses \
  -H "X-API-KEY: $MALVO_API_KEY"

202 Accepted

{
  "analysis_id": "0b7c1d2e-0000-4000-8000-00000000a001",
  "financial_profile_id": "0b7c1d2e-0000-4000-8000-00000000f001",
  "status": "pending",
  "trigger": "api",
  "calculation_version": "v1",
  "data_version": null,
  "calculation_id": null,
  "failure_reason": null,
  "attempts": 0,
  "requested_at": "2026-03-01T02:28:00Z",
  "not_before": "2026-03-01T02:28:00Z",
  "started_at": null,
  "finished_at": null
}

Situação	Resposta
Sem versão de cálculo ativa	`503 CALCULATION_VERSION_UNAVAILABLE`, nada é gravado
Perfil inexistente ou de outra aplicação	`404 NOT_FOUND`

`GET /financial-profiles/{id}/analyses/{analysisId}`

Estado do pedido: pending, processing, published, superseded ou failed. Quando publicado, traz data_version e calculation_id. trigger diz a origem: api, sync_finished, source_linked, source_unlinked, consent_changed, revalidation ou classification_revised. A F2 acrescenta profile_sync_cycle, obligation_import, obligation_source_activity e payment_match.

Pedido publicado

{
  "analysis_id": "0b7c1d2e-0000-4000-8000-00000000a001",
  "financial_profile_id": "0b7c1d2e-0000-4000-8000-00000000f001",
  "status": "published",
  "trigger": "api",
  "calculation_version": "v1",
  "data_version": "sha256-sintetico-d1",
  "calculation_id": "0b7c1d2e-0000-4000-8000-00000000c001",
  "failure_reason": null,
  "attempts": 1,
  "requested_at": "2026-03-01T02:28:00Z",
  "not_before": "2026-03-01T02:28:00Z",
  "started_at": "2026-03-01T02:29:10Z",
  "finished_at": "2026-03-01T02:30:00Z"
}

Pedido de outro perfil ou inexistente: 404 NOT_FOUND.

Resumo

`GET /financial-profiles/{id}/summary`

Envelope, caixa próprio disponível e a janela rolling_30d. available_windows lista as janelas que estão em metrics. O caixa próprio disponível soma o último saldo observado das contas BANK em BRL das fontes incluídas. No Open Finance, ele vem do availableAmount da API Contas 2.5.1, que pode ser negativo e não inclui cheque especial, aplicação automática nem reserva. Exemplo: "1000.0400" + "0.2000" = "1000.2400".

summary 200 OK

{
  "financial_profile_id": "0b7c1d2e-0000-4000-8000-00000000f001",
  "analysis_id": "0b7c1d2e-0000-4000-8000-00000000a001",
  "calculation_id": "0b7c1d2e-0000-4000-8000-00000000c001",
  "data_version": "sha256-sintetico-d1",
  "calculation_version": "v1",
  "computed_at": "2026-03-01T02:30:00Z",
  "window": {
    "reference_date": "2026-02-28",
    "as_of": "2026-03-01T02:30:00Z",
    "timezone": "America/Sao_Paulo"
  },
  "currency": "BRL",
  "states": {
    "processing": "ready",
    "authorization": "active",
    "coverage": "sufficient",
    "freshness": "unknown"
  },
  "result_status": "available",
  "sources": [
    {
      "source_id": "0b7c1d2e-0000-4000-8000-00000000s001",
      "item_id": "0b7c1d2e-0000-4000-8000-00000000i001",
      "consent_status": "AUTHORISED",
      "link_status": "linked",
      "decision": "included",
      "observed_at": "2026-03-01T01:10:00Z",
      "accounts": [
        {
          "account_id": "0b7c1d2e-0000-4000-8000-0000000ac001",
          "type": "BANK",
          "subtype": "CHECKING_ACCOUNT",
          "currency": "BRL",
          "cash_decision": "included",
          "observed_at": "2026-03-01T01:10:00Z"
        },
        {
          "account_id": "0b7c1d2e-0000-4000-8000-0000000ac003",
          "type": "BANK",
          "subtype": "SAVINGS_ACCOUNT",
          "currency": "BRL",
          "cash_decision": "included",
          "observed_at": "2026-03-01T01:40:00Z"
        }
      ]
    }
  ],
  "exclusions": [],
  "bank_position_skew": {
    "oldest_observed_at": "2026-03-01T01:10:00Z",
    "newest_observed_at": "2026-03-01T01:40:00Z",
    "seconds": 1800,
    "limit_seconds": 7200,
    "within_limit": true
  },
  "skew_within_limit": true,
  "own_cash_available": {
    "id": "own_cash_available",
    "value": "1000.2400",
    "unit": "BRL",
    "definition": "Soma do saldo disponível próprio das contas bancárias elegíveis, em BRL, sem limite de crédito e sem valores bloqueados.",
    "formula": "soma(availableAmount) das contas BANK de fontes elegíveis em BRL cujo saldo vem separado do limite",
    "composition": [{ "key": "accounts", "value": "1000.2400", "count": 2 }],
    "exclusions": [],
    "quality": {
      "status": "complete",
      "partial_period": false,
      "comparable": true,
      "review_required": 0,
      "excluded_accounts": 0,
      "accounts_without_history": 0
    },
    "evidence_ref": "own_cash_available"
  },
  "summary_window": {
    "id": "rolling_30d",
    "kind": "rolling",
    "start": "2026-01-29",
    "end": "2026-02-28",
    "partial": false,
    "comparable": true,
    "metrics": [
      {
        "id": "net_cash_generation",
        "value": "520.30",
        "unit": "BRL",
        "definition": "Entradas bancárias observadas menos saídas bancárias observadas, na mesma perspectiva e janela. Não equivale a lucro.",
        "formula": "bank_inflows_observed − bank_outflows_observed",
        "composition": [
          { "key": "bank_inflows_observed", "value": "1500.30", "count": 4 },
          { "key": "bank_outflows_observed", "value": "980.00", "count": 6 }
        ],
        "exclusions": [],
        "quality": {
          "status": "complete",
          "partial_period": false,
          "comparable": true,
          "review_required": 0,
          "excluded_accounts": 0,
          "accounts_without_history": 0
        },
        "evidence_ref": "rolling_30d.net_cash_generation"
      }
    ]
  },
  "available_windows": ["rolling_30d", "rolling_90d", "month_2026-01", "month_2026-02"]
}

summary_window.metrics traz as cinco métricas da janela e available_windows lista todas as janelas. O exemplo mostra só parte delas para encurtar.

Métricas

`GET /financial-profiles/{id}/metrics?window=&metric=`

Envelope, caixa próprio, janelas e séries mensais. window e metric podem se repetir e filtram a resposta.

Janela	Período
`rolling_30d`, `rolling_90d`	Os 30 ou 90 dias civis completos antes do dia de referência
`month_AAAA-MM`	Cada um dos 12 meses civis completos anteriores ao mês corrente
`month_AAAA-MM` do mês corrente	Do dia 1 até o dia de referência, exclusive, com `partial: true` e `comparable: false`

Métrica	Fórmula
`bank_inflows_observed`	Entradas realizadas de conta, sem transferência própria e sem estorno neutralizado, com composição por natureza
`operational_receipts`	Entradas realizadas de conta com natureza `operational`
`bank_outflows_observed`	Saídas realizadas de conta, sem transferência própria e sem estorno neutralizado
`net_cash_generation`	`bank_inflows_observed − bank_outflows_observed`
`consumption_expense`	Compras de cartão realizadas; o pagamento da fatura não entra

Crédito tomado (OPERACAO_CREDITO) e resgate (RESGATE_APLIC_FINANCEIRA) aparecem na composição das entradas, fora de operational_receipts. Cada métrica traz id, value (string decimal ou null), unit, definition, formula, composition, exclusions (contagem por motivo), quality e evidence_ref. Valor nulo vem com unavailable_reason: insufficient_history, no_cash_source, no_card_source ou no_transactions. Nenhuma lacuna é preenchida. A série mensal tem um ponto por mês. A comparação usa só os dois últimos meses completos (difference_between_complete_months); o mês parcial nunca entra.

curl -s "https://api.malvo.io/financial-profiles/0b7c1d2e-0000-4000-8000-00000000f001/metrics?window=rolling_30d&metric=bank_inflows_observed" \
  -H "X-API-KEY: $MALVO_API_KEY"

metrics 200 OK (trecho depois do envelope)

{
  "windows": [
    {
      "id": "rolling_30d",
      "kind": "rolling",
      "start": "2026-01-29",
      "end": "2026-02-28",
      "partial": false,
      "comparable": true,
      "metrics": [
        {
          "id": "bank_inflows_observed",
          "value": "1500.30",
          "unit": "BRL",
          "definition": "Créditos efetivados em BRL nas contas bancárias elegíveis, com composição por natureza. Não representam renda nem receita por si só.",
          "formula": "soma(magnitude) dos movimentos de conta realizados com direção entrada, exceto internal_transfer, reversed e reversal",
          "composition": [
            { "key": "operational", "value": "1200.10", "count": 3 },
            { "key": "investment_redemption", "value": "300.20", "count": 1 }
          ],
          "exclusions": [
            { "reason": "internal_transfer_neutralized", "count": 2 },
            { "reason": "outside_window", "count": 5 }
          ],
          "quality": {
            "status": "complete",
            "partial_period": false,
            "comparable": true,
            "review_required": 0,
            "excluded_accounts": 0,
            "accounts_without_history": 0
          },
          "evidence_ref": "rolling_30d.bank_inflows_observed"
        }
      ]
    }
  ],
  "series": [
    {
      "metric_id": "bank_inflows_observed",
      "unit": "BRL",
      "points": [
        { "month": "2025-12", "value": "1400.00", "partial": false, "quality": "complete" },
        { "month": "2026-01", "value": "1480.00", "partial": false, "quality": "complete" },
        { "month": "2026-02", "value": "1350.30", "partial": true, "quality": "partial", "reason": "partial_period" }
      ],
      "comparison": {
        "method": "difference_between_complete_months",
        "from": "2025-12",
        "to": "2026-01",
        "delta": "80.00"
      }
    }
  ]
}

Evidências

`GET /financial-profiles/{id}/evidence?metric=&kind=&decision=&page=&pageSize=`

Envelope e a linhagem paginada do resultado publicado: uma linha por fonte (kind: source), por saldo (balance) e por movimento (movement). Filtros: metric (no formato janela.métrica, igual a evidence_ref), kind e decision (included ou excluded). pageSize padrão 20, máximo 500.

evidence 200 OK (trecho depois do envelope)

{
  "total": 1,
  "total_pages": 1,
  "page": 1,
  "results": [
    {
      "id": 101,
      "kind": "movement",
      "source_id": "0b7c1d2e-0000-4000-8000-00000000s001",
      "item_id": "0b7c1d2e-0000-4000-8000-00000000i001",
      "account_id": "0b7c1d2e-0000-4000-8000-0000000ac001",
      "consent_id": "urn:sandbox:consent:pj-0001",
      "consent_status": "AUTHORISED",
      "transaction_id": "0b7c1d2e-0000-4000-8000-0000000t0001",
      "field": "transaction_amount",
      "currency": "BRL",
      "value": "300.20",
      "reference": "0b7c1d2e-0000-4000-8000-0000000t0001",
      "observed_at": "2026-02-10T13:00:00Z",
      "decision": "included",
      "reasons": [],
      "nature": "investment_redemption",
      "direction": "inflow",
      "perspective": "cash",
      "metrics": ["rolling_30d.bank_inflows_observed"]
    }
  ]
}

Recorrências

`GET /financial-profiles/{id}/recurrences?status=&flow=&periodicity=`

Envelope, parameters, recurrences e discarded. Filtros: status (suggested ou rejected), flow (expense ou receipt) e periodicity. Na v1 só monthly está ligada: mínimo de 3 ocorrências, tolerância de ±5 dias e de ±20% no valor. O grupo combina conta, produto, direção, moeda e contraparte (documento quando identificável; senão, a descrição normalizada). O nível de evidência é regra, não probabilidade: low (3 ocorrências), medium (4 ou 5, ou 6+ com valor variável ou só pela descrição) e high (6+, valor fixo e contraparte identificada). Entrada recorrente não é renda comprovada.

recurrences 200 OK (trecho depois do envelope)

{
  "parameters": {
    "min_occurrences": 3,
    "amount_tolerance_percent": 20,
    "periodicities": [{ "name": "monthly", "months": 1, "day_tolerance": 5 }]
  },
  "recurrences": [
    {
      "id": "rec_0123456789abcdef01234567",
      "flow": "expense",
      "direction": "outflow",
      "product": "credit_card",
      "account_id": "0b7c1d2e-0000-4000-8000-0000000ac002",
      "currency": "BRL",
      "grouping_basis": "description",
      "label": "assinatura software erp",
      "periodicity": "monthly",
      "day_tolerance": 5,
      "occurrence_count": 3,
      "occurrences": [
        { "transaction_id": "0b7c1d2e-0000-4000-8000-0000000t0011", "date": "2025-12-03", "amount": "59.00" },
        { "transaction_id": "0b7c1d2e-0000-4000-8000-0000000t0012", "date": "2026-01-03", "amount": "59.00" },
        { "transaction_id": "0b7c1d2e-0000-4000-8000-0000000t0013", "date": "2026-02-03", "amount": "59.00" }
      ],
      "amount_variation": { "min": "59.00", "max": "59.00", "last": "59.00", "fixed": true, "tolerance_percent": 20 },
      "next_window": { "expected": "2026-03-03", "start": "2026-02-26", "end": "2026-03-08" },
      "evidence": {
        "level": "low",
        "reasons": ["minimum_occurrences", "regular_interval", "fixed_amount", "description_only"]
      },
      "status": "suggested",
      "rejection": null
    }
  ],
  "discarded": [{ "reason": "insufficient_occurrences", "count": 4 }]
}

Motivos de descarte: insufficient_occurrences, irregular_pattern, lapsed e no_grouping_key.

`POST /financial-profiles/{id}/recurrences/{recurrenceId}/rejections`

Rejeita uma recorrência sugerida, com escopo, autoria e versão. A primeira rejeição devolve 201; a mesma rejeição repetida devolve a existente com 200.

Campo	Valores
`scope`	`pattern` (vale para este padrão nos cálculos seguintes) ou `calculation` (só no cálculo atual)
`reason`	`not_recurring`, `wrong_grouping`, `ended` ou `other`
`actor`	Identificador do operador na aplicação, de 1 a 128 caracteres

Corpo da rejeição

{ "scope": "pattern", "reason": "not_recurring", "actor": "operador-sintetico" }

Rejeição 201 Created

{
  "id": "0b7c1d2e-0000-4000-8000-00000000r001",
  "recurrence_id": "rec_0123456789abcdef01234567",
  "scope": "pattern",
  "reason": "not_recurring",
  "application_id": "0b7c1d2e-0000-4000-8000-0000000app01",
  "actor": "operador-sintetico",
  "calculation_id": "0b7c1d2e-0000-4000-8000-00000000c001",
  "calculation_version": "v1",
  "data_version": "sha256-sintetico-d1",
  "rejected_at": "2026-03-01T03:00:00Z"
}

Situação	Resposta
Sem resultado publicado atual (inclusive depois de o consentimento sair de `AUTHORISED`)	`409 RESULT_UNAVAILABLE`
Recorrência fora do resultado atual	`404 NOT_FOUND`
Corpo inválido	`400 VALIDATION_ERROR`

Revisão de classificação

`POST /financial-profiles/{id}/transactions/{transactionId}/classification-revisions`

Troca a natureza de um movimento de conta (perspectiva caixa), com autoria, motivo e versões. A transação de origem não muda: a revisão fica num histórico só de inserção, e a cadeia de versões (0 → 1 → 2) fica inteira.

Campo	Valores
`nature`	`operational`, `own_transfer_unmatched`, `credit_disbursement` ou `investment_redemption`
`reason`	`own_account_not_linked`, `counterparty_identified`, `provider_type_incorrect` ou `other`
`actor`	Quem revisou na aplicação, de 1 a 128 caracteres
`previous_version`	Obrigatório. A versão que o revisor viu: `0` é a classificação automática, e cada revisão soma 1

Corpo da revisão

{
  "nature": "own_transfer_unmatched",
  "reason": "own_account_not_linked",
  "actor": "operador-sintetico",
  "previous_version": 0
}

Revisão 201 Created

{
  "id": "0b7c1d2e-0000-4000-8000-00000000v001",
  "financial_profile_id": "0b7c1d2e-0000-4000-8000-00000000f001",
  "transaction_id": "0b7c1d2e-0000-4000-8000-0000000t0021",
  "application_id": "0b7c1d2e-0000-4000-8000-0000000app01",
  "actor": "operador-sintetico",
  "reason": "own_account_not_linked",
  "previous": { "version": 0, "nature": "operational" },
  "current": { "version": 1, "nature": "own_transfer_unmatched" },
  "recalculation_request_id": "0b7c1d2e-0000-4000-8000-00000000a002",
  "revised_at": "2026-03-01T03:05:00Z"
}

Com versão de cálculo ativa, a revisão registra um pedido de recálculo (trigger: classification_revised), e o resultado anterior passa a result_outdated até o novo cálculo. Sem versão ativa, a revisão fica gravada e recalculation_request_id vem null. A revisão exige que a fonte do movimento esteja vinculada e elegível no momento do pedido, com consentimento AUTHORISED dentro do prazo que tenha também ACCOUNTS_TRANSACTIONS_READ, porque a rota lê e altera a classificação de um movimento.

Situação	Resposta	Grava
Sem token da aplicação	`403`	Nada
Perfil de outra aplicação	`404 NOT_FOUND`	Nada
Transação fora das fontes do perfil	`404 TRANSACTION_NOT_FOUND`	Nada
Fonte desvinculada, em revisão de titular, com consentimento diferente de `AUTHORISED`, vencido ou sem permissão de contas, saldos ou transações	`403 SOURCE_NOT_AUTHORISED`	Nada
`previous_version` diferente da versão atual	`409 CLASSIFICATION_VERSION_CONFLICT`	Nada
Compra ou crédito de cartão, ou lado de par neutralizado	`422 CLASSIFICATION_NOT_REVISABLE`	Nada
Natureza igual à atual	`422 CLASSIFICATION_UNCHANGED`	Nada
Corpo inválido	`400 VALIDATION_ERROR`	Nada

Horário de sync do perfil

`GET /financial-profiles/{id}/sync-schedule`

Mostra o horário que cada item teria com o sync por perfil e mede quantas execuções a mais isso custaria. A rota só lê: não dispara sync, não pede saldo e não chama a instituição. O sync por perfil fica atrás da chave FINANCIAL_PROFILE_SYNC_SCHEDULE_ENABLED, desligada por padrão. Desligada, cada item segue o próprio horário de hoje (schedule_basis: "item") e o motor de sync não muda. Ligada ou não, o teto continua em três execuções por dia por item (max_daily_runs_per_item: 3). O perfil usa a maior frequência entre os seus itens, sem passar desse teto. Com três execuções por dia, cada conta faz até 93 leituras de saldo num mês de 31 dias, abaixo do piso de 420 chamadas/mês para saldos (Manual de APIs v7.0, seção 5.2, item V). Os horários (slots, no formato HH:MM) estão em UTC (timezone: "UTC"), diferente da janela civil dos indicadores. accounts traz a última posição de cada conta, com o id do saldo e o instante, nunca o valor.

sync-schedule 200 OK

{
  "financial_profile_id": "0b7c1d2e-0000-4000-8000-00000000f001",
  "profile_schedule_enabled": false,
  "timezone": "UTC",
  "generated_at": "2026-03-01T03:10:00Z",
  "profile": {
    "frequency": 3,
    "slots": ["02:11", "10:11", "18:11"],
    "next_run_at": "2026-03-01T10:11:00Z"
  },
  "items": [
    {
      "source_id": "0b7c1d2e-0000-4000-8000-00000000s001",
      "item_id": "0b7c1d2e-0000-4000-8000-00000000i001",
      "link_status": "linked",
      "schedule_basis": "item",
      "item_frequency": 1,
      "frequency": 1,
      "slots": ["07:42"],
      "next_run_at": "2026-03-01T07:42:00Z",
      "additional_daily_runs": 0
    },
    {
      "source_id": "0b7c1d2e-0000-4000-8000-00000000s002",
      "item_id": "0b7c1d2e-0000-4000-8000-00000000i002",
      "link_status": "linked",
      "schedule_basis": "item",
      "item_frequency": 3,
      "frequency": 3,
      "slots": ["01:05", "09:05", "17:05"],
      "next_run_at": "2026-03-01T09:05:00Z",
      "additional_daily_runs": 0
    }
  ],
  "accounts": [
    {
      "account_id": "0b7c1d2e-0000-4000-8000-0000000ac001",
      "item_id": "0b7c1d2e-0000-4000-8000-00000000i001",
      "type": "BANK",
      "balance_reference": "9001",
      "last_position_at": "2026-03-01T01:10:00Z"
    }
  ],
  "measurement": {
    "additional_daily_runs": 0,
    "additional_daily_runs_if_enabled": 2,
    "max_daily_runs_per_item": 3
  }
}

schedule_basis vale item, financial_profile ou auto_sync_disabled. No exemplo, com a chave ligada, o item de frequência 1 passaria a seguir os horários do perfil, com 2 execuções a mais por dia, e o de frequência 3 não mudaria. Na F2, a mesma rota traz também position_at, position_basis e captured_at por conta, a defasagem atual (position_skew), o último ciclo do perfil (cycle) e a política de reexecução (policy). Veja Sincronização por perfil.

Base normativa

API Contas, Open Finance Brasil, api_accounts_-_open_finance_brasil/2.5.1.yaml, info.version 2.5.1, lida em 11/10/2026: creditDebitType, completedAuthorisedPaymentType (TRANSACAO_EFETIVADA, LANCAMENTO_FUTURO, TRANSACAO_PROCESSANDO), type, transactionAmount em string decimal, moeda ^[A-Z]{3}$, transactionDateTime em UTC, availableAmount e leitura só com consentimento AUTHORISED.
IN BCB nº 615, de 6 de maio de 2025, art. 1º e art. 3º (vigência em 1º de julho de 2025), e Manual de APIs v7.0, seção 5.2, item V: piso de 420 chamadas/mês para saldos. As rotas da F1 não fazem chamada nova.
A janela civil em America/Sao_Paulo, as duas perspectivas e a transferência própria são regra de produto da Malvo, não norma do Banco Central. O instante oficial continua o UTC da API Contas.
Lei nº 13.709/2018 (LGPD), art. 6º, I e III: a linhagem guarda só o que explica o número, e revisão e rejeição guardam só o identificador do operador.

Comece aqui

Conceitos

Connect Widget

Webhooks

Guias

Conta & Dashboard

Sandbox & Suporte

Perfil financeiro da PJ (F1)

O que entra e o que fica fora da F1

Regras comuns

Consentimento diferente de `AUTHORISED`

Envelope das leituras

Análise

`POST /financial-profiles/{id}/analyses`

`GET /financial-profiles/{id}/analyses/{analysisId}`

Resumo

`GET /financial-profiles/{id}/summary`

Métricas

`GET /financial-profiles/{id}/metrics?window=&metric=`

Evidências

`GET /financial-profiles/{id}/evidence?metric=&kind=&decision=&page=&pageSize=`

Recorrências

`GET /financial-profiles/{id}/recurrences?status=&flow=&periodicity=`

`POST /financial-profiles/{id}/recurrences/{recurrenceId}/rejections`

Revisão de classificação

`POST /financial-profiles/{id}/transactions/{transactionId}/classification-revisions`

Horário de sync do perfil

`GET /financial-profiles/{id}/sync-schedule`

Base normativa

​O que entra e o que fica fora da F1

​Regras comuns

​Consentimento diferente de AUTHORISED

​Envelope das leituras

​Análise

​POST /financial-profiles/{id}/analyses

​GET /financial-profiles/{id}/analyses/{analysisId}

​Resumo

​GET /financial-profiles/{id}/summary

​Métricas

​GET /financial-profiles/{id}/metrics?window=&metric=

​Evidências

​GET /financial-profiles/{id}/evidence?metric=&kind=&decision=&page=&pageSize=

​Recorrências

​GET /financial-profiles/{id}/recurrences?status=&flow=&periodicity=

​POST /financial-profiles/{id}/recurrences/{recurrenceId}/rejections

​Revisão de classificação

​POST /financial-profiles/{id}/transactions/{transactionId}/classification-revisions

​Horário de sync do perfil

​GET /financial-profiles/{id}/sync-schedule

​Base normativa

O que entra e o que fica fora da F1

Regras comuns

Consentimento diferente de `AUTHORISED`

Envelope das leituras

Análise

`POST /financial-profiles/{id}/analyses`

`GET /financial-profiles/{id}/analyses/{analysisId}`

Resumo

`GET /financial-profiles/{id}/summary`

Métricas

`GET /financial-profiles/{id}/metrics?window=&metric=`

Evidências

`GET /financial-profiles/{id}/evidence?metric=&kind=&decision=&page=&pageSize=`

Recorrências

`GET /financial-profiles/{id}/recurrences?status=&flow=&periodicity=`

`POST /financial-profiles/{id}/recurrences/{recurrenceId}/rejections`

Revisão de classificação

`POST /financial-profiles/{id}/transactions/{transactionId}/classification-revisions`

Horário de sync do perfil

`GET /financial-profiles/{id}/sync-schedule`

Base normativa