Lastros da Cessão
Visão Geral
O relatório assignment_documents lista os documentos comprobatórios dos ativos de uma cessão específica, com um link de download para cada arquivo. É o relatório usado para arquivar o lastro da operação: uma linha por documento, com a chave do ativo a que ele pertence.
Ele é o complemento da Composição de Ativos da Cessão: aquele traz os valores e características dos ativos cedidos, este traz os arquivos que os comprovam.
O que você precisa informar
| Variável | Obrigatória | Descrição |
|---|---|---|
fund_class_key | sim | Identificador da classe de fundo da cessão. |
external_id | sim | O "seu número" da cessão a consultar. |
Este relatório não recebe data de referência — ele sempre reflete os documentos existentes no momento da geração.
Estrutura do Arquivo
| Atributo | Valor |
|---|---|
| Formato | CSV |
| Encoding | UTF-8 |
| Delimitador | , (vírgula) |
| Cabeçalho | Sim (primeira linha) |
| Nomenclatura | {nome_resumido_fundo}_assignment_documents_{external_id}_{AAAA-MM-DD}.csv |
Duas diferenças em relação aos outros relatórios:
- o identificador da cessão vem antes da data, e não no fim do nome — compare com o
assignment_assets_wallet_composition, que acrescenta oexternal_idno final; - a data no nome é a data de geração do arquivo (fuso de Brasília), não uma data de referência informada por você. Gerar o mesmo relatório em dois dias diferentes produz dois nomes diferentes para o mesmo conteúdo.
Colunas
| Coluna | Tipo | Formato / Exemplo | Descrição |
|---|---|---|---|
assignment_external_id | string | "CESSAO-2026-07-29-001" | Identificador externo da cessão. Igual em todas as linhas do arquivo. |
asset_key | string | "1a2b3c40-0001-4aaa-9111-000000000101" | Chave interna do ativo gerada pela QI Tech (UUID). Repete-se quando o ativo tem mais de um documento. |
asset_external_id | string | "10a20b30-0001-4bbb-9222-000000000201" | Identificador externo do ativo. |
document_key | string | "50e60f70-0001-4fff-9666-000000000601" | Chave interna do documento gerada pela QI Tech (UUID). |
document_type | string (enum) | "ccb", "duplicata_mercantil", "duplicata_servicos", "discounted_contract", "cte", "invoice" | Tipo do documento. Acompanha o tipo do ativo, exceto invoice, que é a nota fiscal do recebível. |
document_url | string | "https://...s3.amazonaws.com/...?X-Amz-Signature=..." | Link de download direto do arquivo. Veja o aviso sobre validade abaixo. |
document_url é uma URL pré-assinada, gerada no momento em que o relatório é produzido e válida por 5 dias (432.000 segundos). Depois disso o link retorna erro e é preciso gerar o relatório novamente para obter links novos.
Não armazene as URLs como referência permanente do documento. Se você precisa guardar o lastro, baixe os arquivos dentro da janela de validade e use document_key como identificador estável do documento.
O que o relatório traz
- Os documentos de todos os ativos da cessão informada, exceto os dos ativos descartados (
discarded) e reprovados (denied). - Uma linha por documento. Um ativo com contrato e nota fiscal aparece em duas linhas, com o mesmo
asset_keyedocument_typediferentes. - Ativos sem documento anexado não aparecem no arquivo.
asset_external_id e asset_key são as chaves de junção com a Composição de Ativos da Cessão. Cruzando os dois arquivos você confere se todo ativo cedido tem o lastro correspondente — um ativo presente na composição e ausente aqui é um ativo sem documento anexado.