Pular para o conteúdo principal

Criação do Lote de Cessão

Este é o primeiro passo do fluxo de cessão de direitos creditórios. A criação do lote (assignment) reserva um agrupamento onde os ativos que serão cedidos ao fundo serão inseridos nas etapas seguintes.

Pré-requisitos

Antes de criar um lote, você precisa ter em mãos:

  • A fund_class_key — chave única do fundo cessionário.
  • A assignment_configuration_key — chave única da configuração de cessão, obtida na Homologação de Cedente.

Essas duas chaves compõem os endpoints utilizados em todos os endpoints desta API:

/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}

Para mais detalhes sobre o fluxo completo, consulte o Manual de Cessão de Direitos Creditórios.

Request​

ENDPOINT
/trade_receivables/fund_class/{fund_class_key}/assignment_configuration/{assignment_configuration_key}/assignment
MÉTODO
POST
Request Body
{
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "assignment_date": "2024-04-01"
}

Atributos do body​

CampoTipoObrigatoriedadeDescrição
external_idstringobrigatórioChave única de identificação deste lote no sistema do parceiro integrador. Deve ser única — o sistema não permitirá a criação de dois lotes com o mesmo identificador. Máximo de 50 caracteres.
assignment_datestringopcionalData da cessão no formato YYYY-MM-DD. Quando informada, deve corresponder à data contábil do fundo (accounting_date). Se não informada, será utilizada a data contábil vigente.

Response​

STATUS
201
Response Body
{
    "assignment_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "external_id": "931e9437-d025-41ab-bb53-6b94e10fd361",
    "status": "pending_assets_insertion"
}

Atributos da resposta​

CampoTipoDescrição
assignment_keystringIdentificador único do lote gerado pela QI Tech (UUID).
external_idstringA mesma chave externa fornecida na requisição.
statusstringStatus inicial do lote. Sempre retorna pending_assets_insertion, indicando que o lote está pronto para receber ativos.

Possíveis erros​

STATUS
404
Configuração de cessão não encontrada

A combinação de fund_class_key e assignment_configuration_key informada não corresponde a nenhuma configuração de cessão. Verifique se as chaves estão corretas e se o contrato de cessão já foi homologado na etapa de Homologação de Cedente.

{
  "title": "AssignmentConfiguration was not found",
  "description": "AssignmentConfiguration was not found",
  "translation": "Configuração de cessão não foi encontrada",
  "code": "TRC000016"
}
STATUS
400
Data de cessão inválida

A data informada no campo assignment_date não corresponde à data contábil atual do fundo. Cada fundo possui uma data contábil vigente, e a data da cessão precisa ser igual a essa data. Verifique a data contábil vigente do fundo ou omita o campo assignment_date para que o sistema utilize a data automaticamente.

{
  "title": "Invalid assignment date.",
  "description": "Given assignment date is different from fund accounting date.",
  "translation": "Data de cessão fornecida diferente da data do fundo.",
  "code": "TRC000083"
}
STATUS
400
External ID duplicado

Já existe um lote cadastrado com o external_id informado. Cada lote deve ter um identificador único no sistema. Gere um novo external_id e tente novamente.

{
  "title": "Already Exists This External Id",
  "description": "Already Exists This External Id",
  "translation": "Já existe lote com esse external_id",
  "code": "TRC000041"
}

Próximos passos​

Após criar o lote, o fluxo continua com:

  1. Inserção dos ativos — adicione os ativos (CCBs, duplicatas, etc.) que serão cedidos ao fundo.
  2. Envio dos documentos — envie a documentação exigida para cada ativo aprovado na elegibilidade.
  3. Encerramento da inserção — sinalize que todos os ativos foram inseridos para que o lote siga para a análise de elegibilidade.