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 corre em paralelo à análise: ela não volta para pending_registry_data e não exige um novo submit. Feedback de dados cadastrais (registry_data) é aberto com a análise em in_manual_analysis; feedback de compliance, com a análise em in_manual_analysis ou in_compliance_analysis. Você responde à mensagem (o feedback passa a answered) e a QI Tech encerra o feedback (closed) quando a resposta resolve o pedido.

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. O webhook é emitido apenas para feedbacks abertos por um analista (type: manual), na abertura e no encerramento. Veja Webhooks de feedback.

Disponível em

Perfil	Host	Permissão exigida
Consultoria	consultant-api	Liberada pelo time de integração

URL base de cada host: Ambientes (Hosts).

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

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

Não envie page nem limit

A rota devolve os primeiros 100 feedbacks da entidade de origem. Hoje os parâmetros page e limit não são tratados corretamente e a chamada com eles falha; is_last_page: false indica que há mais de 100 feedbacks.

Feedback Status

Enumerador	Descrição
created	Estado interno de criação. O feedback é disponibilizado já como open
open	Aberto — aguarda sua resposta
answered	Respondido — sua mensagem foi registrada e aguarda avaliação da QI Tech
closed	Encerrado pela QI Tech — o pedido está resolvido

Responder não encerra o feedback

Enviar a mensagem com Enviar Mensagem em Feedback move o feedback para answered. Quem encerra (closed) é a QI Tech, depois de avaliar a resposta.

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 status da análise não muda por causa do feedback — não há submit a refazer.

Erros

Status	Código	Quando acontece
400	IVR000075	origin_type fora do enumerador
404	IVR000008	Investidor não encontrado

Erros de autenticação, permissão e host: veja Erros da API.