Documentos da Cessão
Recupera os links para download do Termo de Cessão — tanto a versão original quanto a versão assinada. Este endpoint fica disponível a partir do momento em que o Termo é gerado, ou seja, após o lote atingir o status pending_assignment_term_signature.
Após receber o webhook com status pending_assignment_term_signature, utilize este endpoint para obter o link do Termo de Cessão e acompanhar se a assinatura já foi concluída.
Request
Path params
| Parâmetro | Tipo | Descrição |
|---|---|---|
fund_class_key | string | Chave única do fundo (UUID). |
assignment_configuration_key | string | Chave da configuração de cessão (UUID). |
assignment_external_id | string | O external_id informado na criação do lote. |
Response
{
"assignment_term_url": "https://storage.example.com/term/abc123.pdf",
"signed_assignment_term_url": "https://storage.example.com/term/abc123_signed.pdf"
}
Atributos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
assignment_term_url | string | URL que direciona para o download do termo. |
signed_assignment_term_url | string | null | URL para o Termo de Cessão assinado. Retorna null enquanto o documento ainda não tiver sido assinado por todas as partes. |
O campo signed_assignment_term_url será null enquanto o Termo de Cessão ainda não tiver sido assinado por todas as partes envolvidas. Após a conclusão da assinatura, o lote avançará para o status pending_payment e um webhook será enviado.
Link de Assinatura
Recupera o link para acesso à interface de assinatura do Termo de Cessão na CertifiQI, além de informações sobre os lotes e o link para download do documento. Este endpoint fica disponível a partir do momento em que o Termo é gerado, ou seja, após o lote atingir o status pending_assignment_term_signature.
Request
Path params
| Parâmetro | Tipo | Descrição |
|---|---|---|
fund_class_key | string | Chave única do fundo (UUID). |
assignment_configuration_key | string | Chave da configuração de cessão (UUID). |
assignment_external_id | string | O external_id informado na criação do lote. |
Response
{
"batches": [
{
"name": "Termo de Cessão - Lote 001",
"document_type": "assignment_term",
"status": "pending",
"document_key": "doc-uuid-example",
"related_parties": [...]
}
],
"signature_url": "https://certifiqi.com/events/{external_batch_group_key}",
"download_url": "https://storage.example.com/term/abc123.pdf"
}
Atributos da resposta
| Campo | Tipo | Descrição |
|---|---|---|
batches | array | Lista de lotes vinculados ao Termo de Cessão. |
batches[].name | string | Nome do lote. |
batches[].document_type | string | Tipo do documento (ex: assignment_term, duplicata). |
batches[].status | string | Status atual da assinatura do lote. |
batches[].document_key | string | Chave identificadora do documento. |
batches[].related_parties | array | Partes envolvidas na assinatura do lote. |
signature_url | string | URL para acesso à interface de assinatura na CertifiQI. |
download_url | string | URL pré-assinada para download do Termo de Cessão. |
O campo download_url aponta para o documento original (não assinado) enquanto o lote estiver no status pending_assignment_term_signature. Após a conclusão da assinatura por todas as partes, passa a apontar para o Termo de Cessão assinado.