Consulta de Comprovante de Transação

Este endpoint permite obter o comprovante (PDF + metadados) de uma das TEDs executadas pela QI Tech para uma integralização. Em um ciclo de integralização (pagamento do investidor → tarifas → desembolso) podem ser geradas múltiplas TEDs — você escolhe qual delas quer pelo parâmetro transaction_type.

Quando houver mais de uma TED do mesmo tipo para a mesma integralização (por exemplo, vários extraordinary_event_payment), o endpoint retorna apenas a mais recente. Para listar todas, utilize Consulta de Transações da Integralização.

---

Consulta de Comprovante (GET)

Request

ENDPOINT

/account_liquidation/integralization/INTEGRALIZATION-KEY/transaction_receipt

MÉTODO

GET

Path Params

Campo	Tipo	Descrição	Caracteres
INTEGRALIZATION-KEY	string	Chave única da integralização (UUID v4).	36

Query Params

Campo	Tipo	Descrição	Obrigatório
transaction_type	string	Tipo da TED a ser consultada. Enumeradores transaction_type	Sim

---

Response

STATUS

200

Response Body

{
    "transaction_key": "46804f32-101e-4702-8fbc-c2dbc4c2caec",
    "transaction_amount": 12345.67,
    "transaction_status": "settled",
    "pdf_encoded_string": "JVBERi0xLi4u..."
}

---

Response Body Params

Campo	Tipo	Descrição
transaction_key	string	Chave única da TED no BaaS — mesmo valor retornado por consulta-transacoes-integralizacao.
transaction_amount	number	Valor da TED conforme registrado pela QI Tech.
transaction_status	string	Status da TED no BaaS (ex.: settled, paid).
pdf_encoded_string	string	Comprovante bancário em base64. Decodifique para obter o PDF.

---

Enumeradores transaction_type

Enum	Descrição
disbursement	TED de desembolso do valor líquido para a conta bancária do emissor.
bookkeeping_fee_internal	TED para a QI CTVM referente à tarifa de escrituração interna.
bookkeeping_fee_external	TED para a conta de escrituração externa do cliente.
structuring_fee	TED para a conta de estruturação do cliente.
extraordinary_event_payment	TED para um investidor referente a um evento extraordinário de liquidação.

---

Erros

HTTP	Código	Quando ocorre
400	HTTPMissingParam	Parâmetro transaction_type não foi informado.
400	HTTPInvalidParam	transaction_type não corresponde a nenhum dos valores permitidos.
404	ACL000004 (IntegralizationTransactionNotFound)	Não existe TED do tipo informado para essa integralização, OU a integralização nunca foi liquidada (sem TEDs).

observação

O 404 com ACL000004 é retornado de forma idêntica em todos os cenários (chave inexistente, integralização nunca liquidada, ou tipo de TED ausente) — por design, não diferenciamos os casos. Se precisar saber se a integralização existe, liste suas transações primeiro.