Listar Feedbacks

---

Introdução

Este recurso lista os feedbacks abertos em torno de uma entidade da análise cadastral. Feedbacks são o canal pelo qual a QI Tech solicita complementos e esclarecimentos durante a análise — tipicamente pendências de PLD/compliance ou dados cadastrais a confirmar.

O feedback não altera o status da análise

Um feedback é aberto na análise de compliance e corre em paralelo a ela: a análise permanece em in_compliance_analysis, não retorna para pending_registry_data e não exige um novo submit. Você responde à mensagem, o feedback é encerrado (closed) e a compliance retoma a avaliação.

Quando o cadastro não reúne os dados mínimos para aprovação, a análise é recusada e uma nova análise precisa ser aberta — não há feedback nesse caso. Veja Ciclo de vida da análise cadastral para a distinção completa.

A abertura de um feedback só é notificada por webhook

Como o status da análise não muda, o único aviso é o investor_registry.feedback_status_change com status: open. Veja Webhooks de feedback.

Request

ENDPOINT

/investor_registry/investor/{investor_key}/feedbacks

MÉTODO

GET

STATUS

200

Query params

Campo	Tipo	Descrição	Obrigatório
origin_type	string	Enumerador de Origin Type	Sim
origin_key	string	Chave da entidade de origem (UUID)	Sim
page	integer	Página (>= 0). Default: 0	Não
limit	integer	Tamanho da página. Default: 100	Não

origin_type e origin_key são obrigatórios

Não existe listagem de todos os feedbacks de um investidor: a consulta é sempre feita por entidade de origem. Para varrer um cadastro, consulte a análise cadastral e itere sobre a própria análise e sobre cada parte relacionada.

Um origin_type fora do enumerador é recusado com IVR000075.

Origin Type

Enumerador	Descrição	O que enviar em origin_key
investor_analysis	Feedback sobre a análise cadastral como um todo	investor_analysis_key
related_party_analysis	Feedback sobre uma parte relacionada específica	external_related_party_key

Não existe origin_type de documento

Feedbacks são abertos sobre a análise ou sobre a parte relacionada, nunca diretamente sobre um documento. Um pedido relacionado a um documento chega como feedback de investor_analysis, com a descrição indicando qual documento motivou o questionamento.

Response

Response Body

{
  "data": [
    {
      "feedback_key": "UUID",
      "description": "O comprovante de residência apresentado tem data superior a 90 dias. Favor esclarecer se o endereço declarado permanece válido.",
      "status": "open",
      "category": "registry_data",
      "type": "automatic",
      "origin_type": "investor_analysis",
      "origin_key": "UUID",
      "data": {},
      "messages": [
        {
          "text": "O comprovante de residência apresentado tem data superior a 90 dias.",
          "datetime": "2026-07-31T21:47:46Z",
          "agent": {
            "username": "analista.qitech",
            "email": "analista@qitech.com.br",
            "user_key": "UUID",
            "agent_type": "internal",
            "agent_key": "UUID"
          }
        }
      ]
    }
  ],
  "is_last_page": true
}

Campo	Tipo	Descrição
feedback_key	string	Identificador do feedback
description	string	Texto do pedido, redigido pela QI Tech
status	string	Enumerador de Feedback Status
category	string	Enumerador de Feedback Category
type	string	automatic (aberto por regra do sistema) ou manual (aberto por um analista)
origin_type	string	Enumerador de Origin Type
origin_key	string	Chave da entidade de origem
data	object	Metadados do feedback
messages	array	Histórico de mensagens — ver Message
is_last_page	boolean	false indica que há mais páginas

Message

Campo	Tipo	Descrição
text	string	Conteúdo da mensagem
datetime	string	Data/hora do envio, em ISO-8601 UTC (2026-07-31T21:47:46Z)
agent	object	Identificação de quem enviou: username, email, user_key, agent_type, agent_key

A resposta não devolve page nem limit

A paginação é sinalizada apenas por is_last_page. Controle o page do seu lado, incrementando enquanto is_last_page for false.

Feedback Status

Enumerador	Descrição
created	Criado, ainda não disponibilizado
open	Aberto — aguarda sua resposta. Bloqueia a conclusão da análise
closed	Encerrado — a resposta foi registrada e o pedido está resolvido

A sua resposta encerra o feedback

Enviar a mensagem com Enviar Mensagem em Feedback move o feedback de open para closed — não é preciso aguardar um analista da QI Tech. Se a resposta não for suficiente, a compliance abre um novo feedback, com um novo feedback_key.

Feedback Category

Enumerador	Descrição
registry_data	Dado cadastral a corrigir ou complementar — ex.: comprovação de qualificação ausente, renda declarada fora da faixa esperada
compliance	Esclarecimento de PLD/compliance, decorrente de indicadores da análise de risco

A categoria indica a natureza do que está sendo pedido — um dado cadastral a esclarecer ou um esclarecimento de PLD. Para a sua integração o tratamento é o mesmo: responder ao ponto apontado com Enviar Mensagem em Feedback, o que encerra o feedback. A análise segue em in_compliance_analysis o tempo todo — não há submit a refazer.