# QI Tech — Investment-as-a-Service › 发行

Documentação da QI Tech em texto corrido, para colar em um LLM.
Fonte: https://docs.qitech.com.br
4 página(s).

Índice:
- 发行 - 整合认购 (/zh-Hans/documentation/iaas/emissoes/cadastrar_boleta)
- 资产注册 - 发行 (/zh-Hans/documentation/iaas/emissoes/cadastro_ativo)
- 发行确认 (/zh-Hans/documentation/iaas/emissoes/confirmacao_emissao)
- 简介 (/zh-Hans/documentation/iaas/emissoes/inicio)

---

# 发行 - 整合认购

URL: /zh-Hans/documentation/iaas/emissoes/cadastrar_boleta

---

## 整合认购

使用以下端点，可以开始对某一发行进行整合认购。

### Request

ENDPOINT /trade_security/fund_class/FUND_CLASS_KEY/integralization
MÉTODO POST

```json title="Request Body"
{
 "security_external_id": "a23c006c-befd-40e0-bc3d-fbd2dfbbea5d",
 "bookkeeper_document_number": "00.000.000/0000-00",
 "security_key": "272a394a-e3d0-4484-b00e-e18a4e22bb5e",
 "unit_price": "2.00",
 "number_of_units": "100.00",
 "external_id": "90b679c0-2674-4cad-917a-5c786b0bf992",
 "integralization_date": "2025-05-27",
 "payment": {
   "target_account": {
    "account_branch": "0001",
    "account_digit": "0",
    "account_number": "12345",
    "financial_institution_code": "329",
    "financial_institution_ispb": "32402502"
   }
  }
}

```

### 定义

#### 买入操作

| 字段 | 类型 | 描述 | 必填 |
| ------------------------------| ------ | ------------------------------------------------ | ----------- |
| `security_external_id` | string | 资产的外部标识 | 是* |
| `bookkeeper_document_number` | string | 记账员的 CNPJ 编号 | 是* |
| `security_key` | string | 资产的内部标识键 | 是* |
| `unit_price` | float | 整合认购时的单价 | 是 |
| `number_of_units` | float | 购买的单位数量 | 是 |
| `external_id` | string | 买入操作的外部标识 | 是 |
| `integralization_date` | string | 整合认购日期 | 是 |
| `payment` | dict | 用于清算的[付款](#付款)对象 | 是 |

:::note ⚠️ **重要** ( * )
结构化资产的标识可通过以下两种方式之一进行：

1. 提供 `security_key` 字段**(内部标识键)**；**或**
2. **同时**提供 `security_external_id` 和 `bookkeeper_document_number` 字段。

请求体中必须存在**至少一种标识方式**。若两者均存在，将优先使用内部标识键。
:::

##### 付款

| 字段 | 类型 | 描述 | 必填 |
| ---------------------------- | ------ | --------------------------------------------------- | ----------- |
| `target_account` | string | 用于清算的[银行账户](#银行账户)对象 | 是 |

##### 银行账户

| 字段 | 类型 | 描述 | 必填 |
| ---------------------------- | ------ | --------------------------------------------------- | ----------- |
| `account_branch` | string | 银行账户支行 | 是 |
| `account_digit` | string | 账户校验位 | 是 |
| `account_number` | string | 银行账户号码 | 是 |
| `financial_institution_code` | string | 金融机构代码 | 是 |
| `financial_institution_ispb` | string | 金融机构 ISPB 代码 | 是 |

### Response

STATUS 201

```json title='Response Body'
{
 "integralization_key": "1568b67b-088e-43be-938b-0f817b805f7a",
 "external_id": "90b679c0-2674-4cad-917a-5c786b0bf992",
 "status": "pending_administrator_approval",
}
```

---

# 资产注册 - 发行

URL: /zh-Hans/documentation/iaas/emissoes/cadastro_ativo

---

## 创建 - 商业票据

使用以下端点，可以在结构化资产管理系统中注册一个新票据。

注册的资产初始状态为 **pre_operational**，以便提交与该资产相关的文件。这样可以预先注册资产，只有在正式手续完成后才启用其操作，详情见下一节。

以下列出了各字段的说明及其必填要求和类型。

### Request

ENDPOINT /security/security
MÉTODO POST

```json title='Request Body'
{
    "external_id": "string",
    "asset_type": "commercial_paper",
    "b3_code":"25M000000",
    "isin_code":"BR00ABCDE000",
    "contract_number": "SCR12345",
    "ipoc_code": "string",
    "maturity_date": "YYYY-MM-DD",
    "allowed_managers": ["00.000.000/0000-00", "00.000.000/0000-00", "00.000.000/0000-00"],
    "allowed_consultants": ["00.000.000/0000-00", "00.000.000/0000-00", "00.000.000/0000-00"],
    "issuer_document_number": "00.000.000/0000-00",
    "bookkeeper_document_number": "00.000.000/0000-00",
    "number_of_units": 1,
    "principal_unit_price": 1000000.00,
    "issue_value": 1000000.00,
    "issue_unit_price": 1000000.00,
    "issue_date": "YYYY-MM-DD",
    "amortization_type": "sac",
    "installments": [
        {
            "installment_number": 1,
            "maturity_date": "YYYY-MM-DD",
            "principal_unit_price": 1000000.00,
            "face_unit_price": 1010000.00,
            "amortization_percentage": 1
        }
    ],
    "delay": {
        "fine": {
            "fine_type": "percentage",
            "percentage_value": 0.0
        },
        "interest": {
            "method": "compound",
            "pre_fixed": {
                "monthly_rate": 0.0,
                "calendar_base": "calendar_360"
            }
        }
    },
    "pre_fixed": {
        "monthly_rate": 0.01,
        "calendar_base": "calendar_360"
    },
    "post_fixed": {
        "lag": {
            "amount": 1,
            "reference": "daily"
        },
        "rate": 1,
        "indexer": "di",
        "calendar_base": "workdays"
    }
}

```

## 定义

### 资产对象（请求体）

| 字段 | 类型 | 描述 | 必填 |
| ------------------------------| ------ | ------------------------------------------------ | ----------- |
| `asset_type` | string | 确定[资产类型](#资产类型枚举)的枚举值 | 是 |
| `external_id` | string | 资产的外部标识；用于访问实体的键 | 是 |
| `b3_code` | string | 资产的 Cetip 代码 | 否 |
| `isin_code` | string | ISIN 代码（国际证券识别码） | 否 |
| `ipoc_code` | string | 资产的 IPOC 代码 | 否 |
| `allowed_managers` | list | 有权在发行中操作的基金经理 CNPJ 列表 | 否 |
| `allowed_consultants` | list | 有权在发行中操作的顾问 CNPJ 列表 | 否 |
| `issuer_document_number` | string | 发行人的 CNPJ 或 CPF 编号 | 是 |
| `bookkeeper_document_number` | string | 记账员的 CNPJ 编号 | 是 |
| `number_of_units` | float | 单位数量 | 是 |
| `issue_unit_price` | float | 发行时的单价 | 是 |
| `issue_value` | float | 发行时的资产价值 | 是 |
| `principal_unit_price` | float | 发行时资产的本金单价 | 是 |
| `issue_date` | string | 发行日期，格式为 `YYYY-MM-DD` | 是 |
| `disbursement_date` | string | 放款日期，格式为 `YYYY-MM-DD` | 是 |
| `amortization_type` | string | [摊销类型](#摊销类型枚举)的枚举值 | 是 |
| `contract_number` | string | 合同编号 | 是 |
| `maturity_date` | string | 资产到期日 | 是 |
| `installments` | dict | [分期付款](#分期付款对象)对象 | 是 |
| `delay` | dict | [逾期](#逾期对象)对象 | 是 |
| `pre_fixed` | dict | [固定利率](#固定利率对象)对象 | 是 |
| `post_fixed` | dict | [浮动利率](#浮动利率对象)对象 | 否 |

#### 资产类型枚举

| 枚举值 | 描述 |
|--------------|---------------|
| **commercial_paper** | 商业票据类资产 |
| **debenture** | 债券类资产 |
| **cri** | CRI 类资产 |
| **cra** | CRA 类资产 |

#### 摊销类型枚举

| 枚举值 | 描述 |
|--------------|---------------|
| **sac** | SAC 摊销类型 |
| **price** | Price 摊销类型 |

#### 分期付款对象

| 字段 | 类型 | 描述 | 必填 |
| ------------------------------- | ------ | -------------------------------------------| ----------- |
| `installment_number` | int | 分期编号 | 是 |
| `maturity_date` | string | 到期日，格式为 `YYYY-MM-DD` | 是 |
| `principal_unit_price` | float | 资产的本金单价 | 是 |
| `face_unit_price` | float | 资产的面值单价 | 是 |
| `amortization_percentage` | float | 摊销百分比 | 否 |

#### 逾期对象

| 字段 | 类型 | 描述 | 必填 |
|-|-|-|-|
| `fine` | object | 到期罚款对象。请参见**[逾期罚款对象](#逾期罚款对象)**。 | 是 |
| `interest` | object | 逾期利息对象。请参见**[逾期利息对象](#逾期利息对象)**。 | 是 |

#### 逾期罚款对象

| 字段 | 类型 | 描述 | 必填 |
|-|-|-|-|
| `fine_type` | string | 罚款类型。 | 是 |
| `percentage_value` | number | 若罚款类型为 `percentage`，则为罚款金额。取值范围：0 至 1（对应 0% 至 100%） | 是 |
| `amount` | number | 若罚款类型为 `fixed`，则为罚款金额。 | 是 |

##### 罚款类型枚举

| 枚举值 | 描述 |
|----------------|-------------------------------------------|
| **percentage** | 按分期金额的百分比罚款 |
| **fixed** | 固定罚款金额 |

#### 逾期利息对象

| 字段 | 类型 | 描述 | 必填 |
|-|-|-|-|
| `method` * | string | 请参见**[逾期利息方法枚举](#逾期利息方法枚举)**。 | 是 |
| `pre_fixed` * | object | 请参见**[固定利率对象](#固定利率对象)**。 | 是 |

##### 逾期利息方法枚举

| 枚举值 | 描述 |
|--------------|-----------------------------|
| **compound** | 复利逾期利息 |
| **simple** | 单利逾期利息 |

#### 固定利率对象

| 字段 | 类型 | 描述 | 必填 |
|-|-|-|-|
| `calendar_base` * | string | 所用计算基准。 | 枚举值 |
| `monthly_rate` * | number | 合同月利率。1% 使用 0.01 | 最多 8 位小数 |

#### 浮动利率对象

| 字段 | 类型 | 描述 | 必填 |
|---------------|--------|-----------------------------------------------------|-------------|
| rate | int | 适用的固定利率 | 是 |
| indexer | string | 调整参考指数（di、ipca） | 是 |
| calendar_base | string | 所用历法类型 | 是 |

#### Lag 对象

| 字段 | 类型 | 描述 | 必填 |
|-----------|--------|------------------------------------------------|-------------|
| amount | int | 滞后单位数量 | 是 |
| reference | string | 滞后时间单位 | 是 |

#### 计算基准枚举

| 枚举值 | 描述 |
|--------------|---------------|
| **daily** | 逾期的日计算值 |
| **monthly** | 逾期的月计算值 |

#### 逾期参考枚举

| 枚举值 | 描述 |
|--------------|---------------|
| **workdays** | 工作日（252）计算基准 |
| **calendar_365** | 365 天计算基准 |
| **calendar_360** | 360 天计算基准 |

### Response

STATUS 201

```json title='Response Body'
{
    "security_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "status": "pre_operational",
}
```

---

# 发行确认

URL: /zh-Hans/documentation/iaas/emissoes/confirmacao_emissao

## 确认 - 商业票据

完成所有正式手续并在资产中注册相关文件后，即可审批该资产，表明其已准备好进行后续操作。

值得注意的是，买入操作可以在预运营资产上发起，但在资产发行确认之前，这些操作无法进行清算。

### Request

ENDPOINT /security/security/EXTERNAL_ID/confirm
MÉTODO PUT

```json title="Request Body"
{
 "bookkeeper_document_number": "00.000.000/0000-00"
}

```

| 字段 | 类型 | 描述 | 必填 |
| ------------------------------| ------ | ---------------------------------------------------- | ----------- |
| `bookkeeper_document_number` | string | 用于标识发行的记账员 CNPJ | 是 |

#### 定义

### Response

STATUS 202

```json title='Response Body'
{
    "security_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "status": "active",
}
```

---

# 简介

URL: /zh-Hans/documentation/iaas/emissoes/inicio

发行生态系统负责商业票据、债券、CRI 和 CRA 等资产的创建、买卖及付款。可用功能包括：

- 注册新的预运营资产；
- 确认发行；
- 创建买卖交易单；

本文档提供了如何使用发行系统的详细说明，包括其主要功能和流程。

要开始使用该系统，请浏览本文档中的可用主题，以便更好地了解基金份额模块的各个方面。