Exige a permissão
can-generate-report. A resposta sai na hora; os dados chegam depois, quando as fontes respondem. O relatório continua o mesmo: nenhum relatório novo é criado.Quando usar
Use quando o relatório terminou com falha parcial. O webhookREPORT_FINISHED avisa isso em data.content.errors.sections, com o título das seções afetadas (por exemplo, Processos).
Parâmetros
Não há corpo. Envie a requisição sem body.
Como obter o sectionId
O sectionId é o id de cada item de sections[] em GET /v2/report/{id}. Ele muda de relatório para relatório. Para achar a seção certa, compare type.title com o título que veio em errors.sections, ou type.value com o tipo que você guarda. Mais detalhes em Consultar Seção por ID.
O que é reprocessado
1
A seção é reservada
Só uma reexecução por seção de cada vez. Um segundo pedido enquanto a primeira está em curso recebe
409. Se a reexecução anterior ficou mais de 10 minutos sem nenhuma atualização, a seção é liberada e aceita um pedido novo.2
Só as fontes com erro voltam a rodar
Entram as fontes da seção que registraram erro no processamento do relatório. Fontes que responderam bem não são consultadas de novo. Se nenhuma fonte da seção falhou, a rota responde
400.3
O estado de erro é limpo
Os erros dessas fontes saem da seção e de qualquer outra seção do relatório que dependa das mesmas fontes. O relatório volta a ficar em processamento (
reportProgress.isFinalized: false).4
As fontes são consultadas de novo
Cada fonte roda uma vez, com a mesma credencial de bureau da política do relatório. Não há nova tentativa automática: se a fonte falhar outra vez, você pode pedir o reprocessamento de novo.
Webhooks
Se o relatório foi criado com webhook cadastrado, o reprocessamento gera eventos de novo:
Detalhes do envelope em Criar Webhook.
Resposta
Erros
Todas as respostas de erro seguem o formato
{ "code": 409, "message": "..." }.