Relatórios¶
Para: Fin — Conferido em 2026-10-18.
A tela Relatórios reúne quatro relatórios da operação (transações, decisões, sinais de PLD e VIP e listas), com filtros, pré-visualização e exportação em CSV ou JSON. Por padrão os dados pessoais saem mascarados. Exportar com dados pessoais em claro exige o pedido, a aprovação de outra pessoa e confirmação de identidade, e o arquivo só pode ser baixado uma vez.
O que é¶
Quem usa: Administrador do tenant, Financeiro e Auditor exportam relatórios mascarados. Financeiro e Auditor também pedem e baixam a versão com dados pessoais. O Revisor não abre a tela.
| Relatório | O que traz |
|---|---|
| Transações | Uma linha por depósito ou saque: ID, tipo, estado, método, moeda, valor (menor unidade), referência do jogador e data, mais os dados do documento e do destino (mascarados). |
| Decisões | Um resumo das decisões das regras: contagem por motivo, tipo, modo e estado, a taxa de decisões automáticas e o tempo médio de revisão, e a contagem de decisões por pessoa. |
| Sinais AML | As transações com o sinal de PLD associado, na frente de cada linha. Os parâmetros dos sinais não são expostos. |
| VIP e listas | As listas de bloqueio, de liberação e os VIPs ativos: tipo, identificador, estado, quem propôs, criação e validade. O valor das entradas nunca aparece. |
Limites:
| Item | Valor |
|---|---|
| Período padrão | Últimos 30 dias |
| Período máximo de um relatório | 366 dias |
| Linhas por exportação | 200 mil |
| Pré-visualização | 50 linhas (até 200) |
| Validade do download mascarado | 24 horas |
| Validade do download com dados pessoais | 1 hora |
As datas do filtro são dias UTC. A validade do download conta a partir do momento em que o arquivo fica pronto.
Quando usar¶
- Para enviar ao financeiro ou ao contador o movimento de um período.
- Para auditar quem decidiu o quê (relatório de Decisões).
- Para conferir listas e VIPs ativos.
- Para atender a um pedido regulatório que exige dados pessoais, com a trilha de aprovação.
Para um fechamento diário que bata com o seu livro, use a Reconciliação no painel.
Como fazer¶
Pré-visualizar¶
- Escolha a aba do relatório.
- Preencha os filtros que quiser: De e Até (datas), Estado, Método, Moeda (3 letras, como
BRL) e, só em Transações, Tipo (depositouwithdrawal). - A tela mostra as primeiras linhas, sempre mascaradas, e avisa se o resultado foi truncado.
Se um relatório não puder ser montado (por exemplo, o serviço de regras fora do ar no relatório de listas), a tela mostra uma nota e não finge uma lista vazia.
Exportar mascarado¶
- No bloco Exportar, escolha o Formato (CSV ou JSON) e clique em Pedir exportação. Não pede confirmação recente.
- Um período de até 7 dias é gerado na hora. Períodos maiores entram em fila e ficam prontos em segundo plano: recarregue a página de status.
- A exportação aparece em Minhas exportações (criação, relatório, formato, situação, expiração, linhas e tamanho). Clique na data para abrir a página de status.
- Com a situação Pronto, clique em Baixar.
O arquivo mascarado pode ser baixado mais de uma vez, por quem tem acesso, até expirar (24 horas). Depois disso a situação vira Expirado e a tela mostra "Este arquivo já foi baixado ou expirou." Peça outra exportação.
Situações: Na fila, Gerando, Pronto, Falhou, Expirado e Baixado.
Exportar com dados pessoais¶
Só Financeiro e Auditor veem a opção.
- No bloco Exportar, marque Incluir dados pessoais em claro, escreva o motivo (de 10 a 1000 caracteres) e clique em Pedir exportação. É preciso confirmação recente.
- O pedido aparece em Pedidos com dados pessoais. Outra pessoa (Financeiro ou Auditor) escreve o motivo da decisão e clica em Aprovar ou Recusar, também com confirmação recente. Quem pediu não aprova o próprio pedido. Não há espera de 24 horas.
- Aprovado, o Dracma gera o arquivo, cifrado enquanto está guardado.
- Em Pedidos com dados pessoais, o link Ver a exportação gerada leva à página de status. Só quem pediu baixa, com confirmação recente, uma única vez, em até 1 hora. Depois o arquivo é apagado.
Os campos em claro do relatório de Transações: documento, nome, chave PIX, nome do pagador e documento do pagador. Cada pedido, voto e download fica na Auditoria.
Não disponível
Não há como baixar uma segunda vez um arquivo com dados pessoais, nem outra pessoa baixar o arquivo de quem pediu. Se o arquivo expirou ou foi baixado, abra um novo pedido.
Exemplos¶
Relatório de transações de setembro para o contador, mascarado:
- Aba Transações, De
2026-09-01, Até2026-09-30, MoedaBRL. - Formato CSV, Pedir exportação. Como o período passa de 7 dias, o arquivo vai para a fila.
- Recarregue a página de status até Pronto e clique em Baixar em até 24 horas.
Colunas do CSV de Transações, mascarado: id, kind, status, method, currency, amount, player_ref, created_at, document_masked, destination_masked, payer_document_masked. O amount é inteiro na menor unidade.
Erros e casos de borda¶
| Mensagem | Causa | O que fazer |
|---|---|---|
| "Use datas válidas no período." / "A data inicial não pode ser depois da final." | Datas inexistentes ou invertidas. | Corrija. |
| "Filtro inválido." / "A moeda deve ter 3 letras, como BRL." | Filtro fora do padrão. | Corrija. |
| "Escolha CSV ou JSON." / "Relatório desconhecido." | Parâmetro fora da lista. | Escolha pela tela. |
| "Escreva um motivo de 10 a 1000 caracteres." | Falta o motivo (obrigatório com dados pessoais). | Escreva. |
| "Exportação criada. Ela é gerada em segundo plano." | Sucesso (mascarado). | Acompanhe em Minhas exportações. |
| "Pedido enviado. Precisa da aprovação de outra pessoa antes de gerar o arquivo." | Sucesso (dados pessoais). | Peça a outra pessoa que aprove. |
| "O arquivo ainda não está pronto." | export_not_ready: o job está na fila ou gerando. |
Recarregue em instantes. |
| "Este arquivo já foi baixado ou expirou." | gone. |
Peça outra exportação. |
| "A geração falhou. Peça a exportação de novo." | O job falhou. | Repita. |
| "Quem pediu não pode aprovar o próprio pedido." | self_review_forbidden. |
Peça a outra pessoa. |
| "Você já votou neste pedido." | already_voted. |
Nenhuma. |
| "Confirme com o fator forte para concluir." | step_up_required. |
Use Confirmar identidade agora. |
| "Sem permissão para esta ação." | Seu papel não permite. | Peça a Financeiro ou Auditor. |
Casos de borda:
- Tenant sem Financeiro nem Auditor. Nenhuma exportação com dados pessoais é possível; o Administrador exporta só mascarado.
- Período maior que 366 dias. É recusado; divida em períodos.
- Mais de 200 mil linhas. A geração falha ("A geração falhou. Peça a exportação de novo."). Estreite os filtros e peça de novo.
- Relatório de listas "indisponível". O serviço de regras não respondeu; repita em instantes.