Reconciliação no painel

Para: Fin — Conferido em 2026-10-18.

A tela Reconciliação mostra o fechamento de cada dia (UTC) e moeda, deixa você baixar o mesmo arquivo da API pública, compara o dia com o seu livro e organiza o tratamento das divergências. Ela prova que o livro do Dracma bate com o seu. Ela não prova que o dinheiro está na conta do PSP.

O que é

O relatório do dia é o mesmo da API (GET /v1/reconciliation): os itens liquidados no dia UTC, os totais, o digest e a assinatura. A tela acrescenta a conferência com o seu livro e o tratamento das divergências. As regras do relatório (tipos de item, totais, digest, assinatura) estão em Reconciliação (API); o roteiro financeiro está em Reconciliar com o seu livro.

Quem vê: Administrador do tenant, Financeiro e Auditor. Quem importa o seu livro e trata divergências: só o Financeiro. O Revisor não abre a tela.

Os dias são UTC, e a tela diz isso. Um dia fecha em D+1 às 02:00 UTC (23:00 de Brasília): antes disso o painel mostra "O dia … ainda está aberto: o relatório sai a partir das 02:00 UTC do dia seguinte."

Quando usar

  • Todo dia, para fechar o dia anterior com o seu livro.
  • Antes do go-live, para provar pelo menos um dia inteiro reconciliado (veja Checklist de go-live).
  • Quando o financeiro precisa de um arquivo assinado do dia, para auditoria externa.

Como fazer

Ver o dia

  1. Abra Reconciliação no menu Plataforma. O painel abre o dia mais recente já fechado.
  2. Use o formulário Dia (UTC) e Moeda para trocar de dia.
  3. A seção Últimos dias lista os últimos 10 dias com:
Coluna O que mostra
Dia (UTC) A data; clique para abrir.
Estado Aberto, Fechado ou Indisponível.
Itens Quantos itens o dia tem.
Depósitos pagos O total dos depósitos pagos no dia.
Saques pagos O total dos saques pagos no dia.
Divergências abertas Quantas divergências ainda esperam tratamento.

O cartão Dia … · moeda traz os totais Depósitos pagos, Saques pagos, Estornos, Chargebacks e Tarifas, a contagem por tipo de item (Depósito, Saque, Estorno, Chargeback, Tarifa, Devolução, Recall, Recebimento) e o digest (sha256) do dia. Em Itens do dia aparecem os 200 primeiros itens (item, tipo, estado, valor e quando foi liquidado); o resto sai pela exportação.

O Dracma não desconta tarifa nos valores que credita, por isso a linha Tarifas vem zerada. Veja Tarifas.

Exportar

Os botões Exportar CSV e Exportar JSON baixam o arquivo do dia, idêntico ao da API pública. O digest e a assinatura do arquivo vão nos cabeçalhos da resposta de download (Dracma-Digest e Dracma-Signature), para você provar a origem. Para exportar, o dia precisa estar fechado; dia aberto responde "Dia ainda aberto."

Conferir com o seu livro

O Financeiro envia o livro do operador do mesmo dia e moeda e o painel compara.

  1. Monte um CSV com as colunas:
    • kind: deposit, withdrawal, refund ou chargeback;
    • external_id: o identificador do seu sistema;
    • amount: inteiro na menor unidade, como na API (1000 = R$ 10,00).

O separador pode ser vírgula ou ponto e vírgula. Linhas repetidas do mesmo item são somadas. O limite da tela é de 900 KB e 20 mil linhas. 2. Em Conferir com o livro do operador, escolha o arquivo e clique em Pré-visualizar. O painel compara sem gravar nada e mostra "N linha(s) no livro × M item(ns) no Dracma: tudo bate" ou o número de divergências, com as primeiras. 3. Se o arquivo tiver linhas inválidas, a prévia lista linha, campo e motivo (até 20) e não deixa registrar. Corrija e envie de novo. 4. Quando a prévia estiver correta, clique em Registrar conferência. As divergências passam a existir na lista do dia.

O arquivo não é guardado: o painel registra só o resultado da conferência, com o nome do arquivo, o número de linhas e a soma de verificação, e a ação fica na Auditoria.

Tipos de divergência:

Situação Significa
No Dracma e não no livro do operador O Dracma tem o item e o seu livro não.
No livro do operador e não no Dracma O seu livro tem o item e o Dracma não.
Valor diferente Os dois têm o item, com valores diferentes.

Só os tipos que você consegue conferir pelo external_id entram (depósito, saque, estorno e chargeback). Tarifas, devoluções e recebimentos não entram na comparação.

Tratar as divergências

A seção Divergências do dia mostra cada uma com a situação, o item, o valor no Dracma, o valor no livro, o estado e o dono. Estados: Aberta, Com dono, Resolvida e Sumiu na reconferência (a divergência deixou de existir quando você enviou o livro de novo).

  1. Definir dono: informe o identificador (UUID) de uma pessoa com permissão para reconciliar; o campo já vem com o seu. Não pede confirmação recente.
  2. Resolver: escolha uma resolução, escreva o motivo (de 10 a 1000 caracteres) e clique em Resolver. É preciso confirmação recente.

Resoluções: Diferença aceita, Corrigido no Dracma, Corrigido no livro do operador e Incidente aberto.

Enviar o livro do mesmo dia outra vez reconfere: as divergências que continuam mantêm dono e tratamento; as que sumiram viram Sumiu na reconferência. Quando a conferência registra divergências, o alerta "Divergência de reconciliação" avisa a equipe (veja Alertas e e-mails).

O que o painel não prova

Não disponível

A conferência automática com o extrato de cada PSP não está disponível: o Dracma não importa nem guarda esse extrato. A tela diz: "Enquanto isso, confira pelo livro do operador abaixo; o tratamento de divergências é o mesmo." O relatório prova o livro do Dracma, não o saldo nem o extrato no banco ou no PSP. Para conferir o banco, compare o extrato do PSP com o seu livro por fora do painel.

O limiar de alerta de caixa baixo fica em Saldos e caixa.

Exemplos

Livro do operador de um dia, com dados fictícios:

kind,external_id,amount
deposit,dep-ext-0001,20000
deposit,dep-ext-0002,5000
withdrawal,wdr-ext-0001,150000
refund,dep-ext-0001,2000

Se os demais itens batem e o Dracma tiver, no mesmo dia, o depósito dep-ext-0003 de 3000, o saque wdr-ext-0001 de 150500 e nenhum estorno, a prévia mostra três divergências:

Situação Item No Dracma No livro
No Dracma e não no livro do operador Depósito dep-ext-0003 R$ 30,00 —
Valor diferente Saque wdr-ext-0001 R$ 1.505,00 R$ 1.500,00
No livro do operador e não no Dracma Estorno dep-ext-0001 — R$ 20,00

Erros e casos de borda

Mensagem Causa O que fazer
"Este dia ainda está aberto: a reconciliação sai a partir das 02:00 UTC do dia seguinte." day_open. Volte depois das 02:00 UTC.
"Arquivo grande demais (até 900 KB e 20 mil linhas)." payload_too_large. Divida o arquivo por tipo de item.
"O arquivo tem linhas inválidas. Corrija e envie de novo." import_invalid: coluna ausente, tipo desconhecido, valor que não é inteiro. Veja a lista de linhas da prévia.
"Escolha um arquivo CSV válido." / "O arquivo está vazio." Arquivo ausente ou vazio. Escolha o arquivo certo.
"Data inválida." / "Moeda inválida." Filtro fora do padrão. Use AAAA-MM-DD e a moeda da operação.
"O dono deve ser o identificador (UUID) de um usuário com permissão de conciliar." Dono inválido. Use o UUID de um Financeiro.
"Escolha o tipo de resolução." / "Escreva um motivo de 10 a 1000 caracteres." Resolução incompleta. Complete.
"Esta divergência já foi encerrada." invalid_state_transition. Recarregue.
"Divergência não encontrada nesta operação." Identificador de outra operação. Recarregue.
"Confirme com o fator forte para concluir." step_up_required ao resolver. Use Confirmar identidade agora.
"Serviço indisponível no momento. Tente de novo em instantes." O livro do Dracma não respondeu. Repita em instantes.

Casos de borda:

  • Dia com mais de 20 mil itens. O painel não monta o dia: use a API paginada.
  • Fuso. Um depósito pago às 22:00 de Brasília cai no dia UTC seguinte. Reconcilie sempre por dia UTC.
  • Livro com outros tipos de linha. Remova tarifas, devoluções e recebimentos do CSV: só os quatro tipos conferíveis são aceitos.

Veja também