Adição de Ativos em Cessão Aberta

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

🔄 Adição de novos ativos no Lote de Cessão

Schema de Cessão

{
  "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

batch_id: ID do lote enviado como parâmetro na URL
batch_state: Estado atual do lote. Pode ser OPEN ou CLOSED.

🔗 contracts

Lista de contratos com ativos adquiridos pelo fundo:

id: Identificador 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).
remuneration_rate_annual_365: Taxa contratual de remuneração anual (base 365 dias).
acquisition_rate_annual_365: Taxa de aquisição anual (base 365 dias).
acquisition_rate_annual_252: Taxa de aquisição anual (base 252 dias úteis).
acquisition_date: Data de aquisição do ativo.
asset_sector: Setor do ativo (opcional).
total_installments: Quantidade total de parcelas do contrato.
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": "REGISTERED"
}

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.