Criação de Lote para Cessão de Ativos

📄 Cessão de Ativos

Um lote de cessão de ativos representa um agrupador lógico que reúne diversos ativos (tokens TIDC) adquiridos por um fundo de investimento. Ele permite registrar de forma agrupada a aquisição de recebíveis, facilitando tanto o controle operacional quanto a auditoria da carteira adquirida.

A rota a seguir cria um novo lote de ativos destinado à cessão, agrupando múltiplos recebíveis adquiridos em uma única operação de entrada. Retorna o identificador único do lote criado, permitindo a associação dos ativos adquiridos de forma paralela e assíncrona.

🔄 Criação de Lote de Cessão

Schema de Cessão

{
  "fund_id": "cb5582a5-e429-4f6f-9c8c-2c1a9b7c1e94",
  "batch_state": "CLOSED",
  "contracts": [
    {
      "id": "005499761-223",
      "emission_date": "2024-11-01",
      "coobligation": false,
      "type": "CCB",
      "originator": {
        "document": "56089773000173",
        "name": "Peak"
      },
      "assignor": {
        "document": "56089773000173",
        "name": "Peak"
      },
      "debtor": {
        "document": "56089773000173",
        "name": "Jaqueline Krohling Eich",
        "address": {
          "cep": "01000000",
          "line": "RUA DO SACADO"
        },
        "sector": "Bancario"
      },
      "assets": [
        {
          "id": "005499761-22301",
          "acquisition_value": 28303.16,
          "nominal_value": 35894.07,
          "due_date": "2022-11-01",
          "index": "CDI",
          "acquisition_date": "2024-11-08",
          "asset_sector": null,
          "installment_number": 1
        }           
      ],
      "total_installments": 24      
    }
  ],
  "payments": [
    {
      "bank_code": "1",
      "agency_code": "1",
      "agency_digit": "1",
      "account_code": "1",
      "account_digit": "1",
      "recipient_document": "62444655000106",
      "recipient_name": "NOME DO CEDENTE",
      "value": 123.45
    }
  ]
}

📝 Descrição dos Campos

fund_id: Identificador ULID do fundo adquirente que está realizando a cessão.
batch_state: Estado atual do lote. Pode ser OPEN ou CLOSED.

🔗 contracts

Lista de contratos com ativos adquiridos pelo fundo:

id: Identificador do contrato.
total_installments: Quantidade total de parcelas do contrato.
emission_date: Data de emissão do contrato.
coobligation: Indica se há coobrigação no contrato.
type: Tipo do contrato (ex: CCB, NP).

▶ originator

document: CNPJ do originador.
name: Nome da instituição originadora.

▶ assignor

document: CNPJ do cedente.
name: Nome do cedente.

▶ debtor

document: CPF ou CNPJ do devedor.
name: Nome completo do devedor.
address.cep: CEP do endereço do devedor.
address.line: Endereço do devedor.
sector: Setor de atuação do devedor.

▶ assets

id: Identificador do ativo (recebível).
acquisition_value: Valor pago pelo fundo na aquisição.
nominal_value: Valor de face (valor original) do ativo.
due_date: Data de vencimento do ativo.
index: Índice de correção monetária (ex: CDI, IPCA).
acquisition_date: Data de aquisição do ativo.
asset_sector: Setor do ativo (opcional).
installment_number: Número da parcela adquirida.

💳 payments

Pagamentos efetuados aos cedentes:

bank_code: Código do banco do cedente.
agency_code: Código da agência bancária.
agency_digit: Dígito da agência bancária.
account_code: Número da conta bancária.
account_digit: Dígito da conta bancária.
recipient_document: CPF ou CNPJ do recebedor.
recipient_name: Nome do recebedor.
value: Valor pago ao cedente referente à cessão.

✅ Retorno Esperado

{
  "batch_id": "cb5582a5-e429-4f6f-9c8c-2c1a9b7c1e94",
  "type": "ASSIGNMENT",
  "timestamp": "2025-05-14T15:27:00.000",
  "status": "CLOSED"
}

batch_id: Identificador do lote de cessão criado.
type: Tipo da operação (ASSIGNMENT).
timestamp: Momento em que a operação foi registrada.
status: Estado atual do lote.