Saltar para o conteúdo principal
DELETE
Elimine um relatório regulamentar de forma permanente.

​
O que é eliminado

O relatório, a narrativa copiada, os motivos e os restantes campos do relatório, as suas ligações a transações, e o XML e o PDF do goAML gerados. Todas as versões guardadas desses ficheiros são eliminadas. O relatório deixa de aparecer nas listas de relatórios, e os URLs de transferência já emitidos deixam de funcionar. O caso, as transações, as pessoas e as empresas não são eliminados. O relatório não leva consigo os dados deles. A eliminação é permanente e irreversível.

​
Confirmação

Um relatório em rascunho ou validado é eliminado sem corpo de pedido. Para eliminar um relatório finalizado, é necessária uma confirmação explícita:
Sem essa confirmação, um relatório finalizado devolve 400 e nada é eliminado.

​
Se os ficheiros não puderem ser eliminados neste momento

Um 503 com code: report_storage_unavailable significa que os ficheiros do relatório não puderam ser eliminados neste momento. O relatório continua no mesmo sítio, por isso repita o pedido. Um 409 com code: report_deletion_pending significa que já existe uma eliminação deste relatório em curso: repita o pedido para a concluir.

​
Resolver uma eliminação bloqueada

Se a eliminação de uma pessoa, empresa, transação, caso ou sessão devolver 409 com code: in_filed_report, a resposta indica os relatórios que contêm os dados. Elimine cada um desses relatórios aqui e, depois, repita a eliminação bloqueada.

​
Relacionados

Autorizações

​
x-api-key
string
header
obrigatório

A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está incorreta, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

​
organization_id
string<uuid>
obrigatório

UUID da organização.

​
application_id
string<uuid>
obrigatório

UUID da aplicação.

​
report_uuid
string<uuid>
obrigatório

UUID do relatório.

Exemplo:

"5ec00000-0000-4000-8000-000000000007"

Corpo

application/json

Obrigatório apenas para um relatório finalizado.

​
confirm_delete
boolean

Defina como true para confirmar que um relatório finalizado e os respetivos ficheiros gerados são eliminados permanentemente.

Resposta

Relatório eliminado, incluindo os seus ficheiros gerados.

Última modificação em 7 de novembro de 2026