Mensagens do painel

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

Quando uma ação do painel falha, a tela mostra uma mensagem curta em português. Esta página reúne as mensagens mais comuns, a causa e o que fazer. As mensagens próprias de cada tela também estão na seção "Erros e casos de borda" da página dela.

O que é

O painel traduz a resposta do Dracma em um texto fixo: ele nunca mostra o texto cru de um erro, nem repete o que você digitou. Por trás de cada mensagem há um código, que é o mesmo que o suporte vai pedir. Os códigos seguem a família de status:

Status Quando
400 Dados fora do formato (validation_failed). A tela diz qual campo.
401 Falta confirmação recente de identidade (step_up_required) ou a sessão expirou.
403 Seu papel não permite (forbidden).
404 O item não existe nesta operação ou você não pode vê-lo (not_found).
409 O estado mudou ou a regra de aprovação barrou (self_review_forbidden, already_voted, invalid_state_transition e outros).
410 O prazo passou (reveal_expired, already_revealed, gone).
503 Um serviço de que a tela depende não respondeu (service_unavailable).

Quando usar

Use esta página quando uma ação falhar, para achar a causa e o próximo passo. Se a sua mensagem não estiver aqui, procure na página da tela ou acione o suporte.

Como funciona

Confirmação, permissão e sessão

Mensagem Código Causa O que fazer
"Confirme com o fator forte para concluir." step_up_required A ação exige passkey ou aplicativo autenticador confirmados nos últimos 5 minutos. Use Confirmar identidade agora e repita.
"Sem permissão para esta ação." forbidden Seu papel não permite a ação. Peça a quem tem o papel (veja Equipe e papéis).
"Não encontrado. O item não existe ou você não tem acesso a ele." not_found Operação ou item de outro tenant, sem permissão, ou inexistente. Confira a operação no seletor e o seu papel.
"Você ainda não tem acesso a nenhuma operação. Peça ao administrador do seu tenant." — Sua conta existe, mas sem papel em nenhuma operação. Peça a um Administrador que conceda um pacote.
"O login foi cancelado ou recusado." / "O pedido de login expirou. Tente de novo." — O login foi interrompido. Clique em Entrar e refaça.
"Sua sessão expirou. Entre de novo." — Sessão encerrada. Entre de novo.

Aprovação de outra pessoa

Mensagem Código Causa O que fazer
"Quem pediu não pode aprovar o próprio pedido." self_review_forbidden Quem propôs tentou votar. Peça a outra pessoa.
"Você já votou neste pedido." already_voted Voto repetido. Nenhuma.
"Este item já foi decidido." / "Este pedido já foi encerrado ou não aceita essa ação agora." invalid_state_transition Outra pessoa decidiu antes, o prazo passou, ou o pedido foi cancelado. Recarregue a página.
"Escreva um motivo de 10 a 1000 caracteres." motivo_invalido Todo voto, proposta e cancelamento exige motivo. Escreva o motivo.
"Não é possível remover o último administrador do tenant." last_admin A remoção deixaria o tenant sem Administrador. Conceda o pacote a outra pessoa antes. Veja Equipe e papéis.

Chaves, IPs e operações

Mensagem Código Causa O que fazer
"A operação já tem 2 chaves ativas. Revogue uma antes de criar outra." key_limit_reached Limite de 2 chaves ativas. Veja Chaves de API.
"O prazo para revelar a chave venceu." reveal_expired Passaram 24 horas desde que a chave nasceu. Peça outra chave.
"A chave já foi mostrada e não pode ser mostrada de novo." already_revealed O segredo é exibido uma vez. Peça outra chave.
"Não há segredo a revelar: já foi mostrado, a janela venceu ou o pedido não é seu." not_found Mesma família, na tela de chaves. Peça outra chave.
"Este IP já está na lista." already_exists Entrada repetida. Nenhuma. Veja IPs do conector.
"IP ou CIDR inválido (IPv4 de /24 a /32, IPv6 de /56 a /128)." cidr_invalido Formato ou tamanho de rede fora do aceito. Corrija.
"Já existe um tenant com esse nome." / "Já existe uma operação com esse nome neste tenant." tenant_exists / operation_exists Nome em uso (a unicidade vale para todo o Dracma). Escolha outro nome.
"Este tipo de operação não é permitido neste ambiente." environment_not_allowed Teste em produção ou Real onde não é habilitado. Veja Tenants e operações.
"Executor indisponível agora" service_unavailable O serviço de gateways não respondeu. Repita em instantes.

Webhooks e cobrança de teste

Mensagem Código Causa O que fazer
"O teste de URL só existe em operações sandbox." / "Simular pagamento só existe em operações sandbox." sandbox_only Ação só da operação de Teste. Use a operação de Teste.
"URL inválida: use https, sem usuário e senha na URL." url_invalida URL fora do formato. Veja Webhooks no painel.
"A api recusou os dados enviados. Confira os campos." validation_failed A checagem de URL, motivo ou pagador falhou. Revise os campos.
"A operação exige dados adicionais do pagador (por exemplo e-mail). Confira os campos." requisitos A operação exige um dado que a tela não preencheu. Preencha ou use a API. Veja Cobrança de teste.
"O serviço de webhooks está indisponível agora." service_unavailable O serviço de entrega não respondeu. Repita em instantes.

Revisão, regras e reconciliação

Mensagem Código Causa O que fazer
"Não foi possível concluir a ação." ao Aceitar um depósito accept_not_allowed O depósito está em revisão por valor pago diferente (AMOUNT_MISMATCH): aceitar é proibido. Use Devolver. Veja Revisão.
"A regra mudou desde que você abriu a tela. Recarregue a página e refaça a edição." etag_mismatch Outra mudança entrou em vigor. Recarregue. Veja Regras, listas e emergência.
"Marque que leu o relatório da simulação para propor um afrouxamento." dry_run_ack_obrigatorio Falta a caixa na mudança relaxante. Marque a caixa.
"Este dia ainda está aberto: a reconciliação sai a partir das 02:00 UTC do dia seguinte." day_open O dia UTC ainda não fechou. Volte depois das 02:00 UTC. Veja Reconciliação no painel.
"Arquivo grande demais (até 900 KB e 20 mil linhas)." payload_too_large O CSV passou do limite. Divida o arquivo.
"O arquivo tem linhas inválidas. Corrija e envie de novo." import_invalid Linhas fora do formato. Veja a lista de linhas da prévia.
"Este arquivo já foi baixado ou expirou." gone Download único ou prazo vencido. Peça outra exportação. Veja Relatórios.
"O arquivo ainda não está pronto." export_not_ready A exportação está na fila. Recarregue em instantes.
"Exportação assinada indisponível neste ambiente: a chave de assinatura não está configurada." audit_signing_unavailable Sem chave de assinatura no ambiente. Acione o suporte. Veja Auditoria.
"O estado mudou e a ação não vale mais. Recarregue a página." conflict Outra pessoa mudou o item. Recarregue.

Falhas gerais

Mensagem Causa O que fazer
"Serviço indisponível agora. Tente de novo em instantes." Um serviço de que a tela depende (autorização, livro, entrega) não respondeu (service_unavailable). Repita em instantes.
"Não foi possível concluir a ação." Erro sem texto próprio. Repita; se persistir, acione o suporte.
"Atualizando a página…" A página foi aberta antes de uma atualização do painel. Aguarde: ela recarrega sozinha.
"Algo deu errado. Não foi possível concluir. Tente de novo." Falha inesperada. Use Tentar de novo; se persistir, acione o suporte.

Exemplos

Você pede uma chave e a tela responde "Pedido de chave enviado. Precisa da aprovação de outra pessoa e do time-lock de 24 h." Isso não é um erro: é a confirmação de que o pedido foi aberto. Em seguida outro Administrador aprova e, 24 horas depois, a chave nasce.

Você tenta aprovar o seu próprio pedido e vê "Quem pediu não pode aprovar o próprio pedido." (self_review_forbidden). A correção é pedir a outra pessoa.

Erros e casos de borda

  • Mensagem genérica. "Não foi possível concluir a ação." aparece quando o código não tem texto próprio. Repita uma vez; se persistir, acione o suporte.
  • Erro depois de uma ação que parecia ter funcionado. Confira na Auditoria: se o registro da ação está lá com ok, ela foi concluída. Recusas aparecem como refused:<motivo>.
  • O que enviar ao suporte. O nome da operação, a tela, a mensagem exata, o horário em UTC e o trace_id da linha da Auditoria, quando houver. Nunca envie o segredo de uma chave.

Veja também