Credit Rights Assignment

This section documents the APIs that enable the Credit Rights Assignment process for Investment Funds administered by QI CTVM. The flow covers everything from assignment batch creation to asset inclusion in the fund's portfolio.

Full Manual

For an in-depth understanding of the business rules and product, see the Credit Rights Assignment Manual. We recommend reading it alongside the routes provided here.

Prerequisites

• To access these services, contact integracao.dtvm@qitech.com.br to enable access to the Sandbox (Staging) and Production environments.
• You will need the fund_class_key (fund key) and the assignment_configuration_key (assignment configuration key), obtained during Assignor Onboarding.
• To query available assignment configurations, use the Assignment Configuration Listing endpoint.

Assignment Flow

The diagram below illustrates the steps in the assignment flow:

Step by Step

1. Batch Creation

Create an assignment batch with a unique identifier (external_id). The batch is the container for all assets that will be assigned to the fund.

Access batch creation documentation

2. Asset Insertion

Add assets (CCBs, invoices, etc.) to the created batch. Each asset must be inserted individually with its operation information, installments, and borrower data.

Access asset insertion documentation

3. Document Submission

For each asset inserted, send the documents required by the product (contract, invoice, etc.). The asset only proceeds in the pipeline after all required documents have been submitted.

Access document submission documentation

4. Insertion Closure

Signal that all assets have been inserted in the batch. The system will wait for individual analysis of each asset before proceeding with the eligibility of the batch as a whole.

Access closure documentation

5. Manager Approval

After the batch eligibility is approved, the fund manager reviews and approves or rejects the batch. If approved, the Assignment Term will be generated automatically.

Access approval documentation

6. Signature, Payment, and Portfolio Inclusion

The final steps are automated: the Assignment Term is signed by all parties, payment is made to the assignor, and assets are included in the fund's portfolio. Track progress through batch webhooks.

Substitution Batches

The substitution flow follows the same steps as the assignment flow, with an additional step: before inserting the assets to be purchased, it is necessary to insert the assets that will be repurchased by the assignor.

1. Batch creation
2. Repurchase asset insertion — Access documentation
3. Insertion of assets to be purchased
4. Insertion closure