Relatórios

Gera o relatório regulatório (COAF/SUSEP) a partir do uuid de uma análise já concluída.

`POST /reports`

Execução síncrona: a resposta já traz o relatório completo. Escopo: reports:create

Por norma COAF, a análise-fonte precisa ter sido criada nas últimas 24 horas.

Corpo da requisição

Campo	Tipo	Descrição
`analysis_uuid`	UUID	Análise-fonte, criada há no máximo 24h.
`institution_type`	`banco` \| `seguradora`	Norma aplicável (`banco`=BCB, `seguradora`=SUSEP).
`source`	string	Identificador livre da origem da chamada.
`operation`	object	Opcional. Dados da comunicação COAF/COS que a análise não carrega (instituição comunicante, valores, código de ocorrência, envolvidos, operações relacionadas). Sem isso, o XML é gerado parcialmente a partir dos dados da análise.

{
  "analysis_uuid": "018ffd38-6d94-7c0c-a6dd-2d9690a118f8",
  "institution_type": "banco",
  "source": "meu-sistema"
}

Resposta (`ReportResponse`)

uuid, analysis_uuid, institution_type, result (referências de armazenamento dos artefatos PDF/XML, não o conteúdo embutido). Um relatório retornado com sucesso está sempre completo; falhas não são persistidas.

Erros

Status	Quando
`404`	Análise-fonte não encontrada.
`422`	Corpo inválido, análise-fonte não concluída, ou fora da janela de 24h.
`500`	Falha inesperada (`"O processamento do relatório falhou."`).
`429`	Quota do plano excedida.
`403`	Plano não inclui o recurso (`{"detail": "feature_not_in_plan"}`).

Catálogo completo em Erros.

`POST /reports/{uuid}/paragraphs/regenerate`

Regenera parágrafos produzidos por agente, sem reexecutar o workflow inteiro. Apenas enquadramento_suggestion, legal_basis, coaf_communication_draft são regeneráveis; o resto é rejeitado. Escopo: reports:create.

`GET /reports/{uuid}`

Recupera um relatório já gerado. Escopo: reports:read.

`GET /reports/{uuid}/artifacts/{artifact}`

Baixa o artefato gerado: artifact = xml (COAF/COS) ou pdf. 404 se o relatório não existe ou o artefato nunca foi produzido (ex.: leiaute BCB, não implementado). Escopo: reports:read.

Primeiros passos

Conceitos

`POST /reports`

Corpo da requisição

Resposta (`ReportResponse`)

Erros

`POST /reports/{uuid}/paragraphs/regenerate`

`GET /reports/{uuid}`

`GET /reports/{uuid}/artifacts/{artifact}`

​POST /reports

​Corpo da requisição

​Resposta (ReportResponse)

​Erros

​POST /reports/{uuid}/paragraphs/regenerate

​GET /reports/{uuid}

​GET /reports/{uuid}/artifacts/{artifact}

`POST /reports`

Corpo da requisição

Resposta (`ReportResponse`)

Erros

`POST /reports/{uuid}/paragraphs/regenerate`

`GET /reports/{uuid}`

`GET /reports/{uuid}/artifacts/{artifact}`