跳到主要内容

资产注册 - 发行

创建 - 商业票据​

使用以下端点，可以在结构化资产编排系统中注册一张新的票据。

注册的资产初始状态为 pre_operational，以便提交与资产相关的文件。这样可以先预注册资产，待相关手续办理完毕后再启用该资产进行交易，详见下一部分。

以下是各字段的说明，以及其是否必填和类型的详细信息。

Request​

ENDPOINT
/security/security
MÉTODO
POST
Request Body
{
    "external_id": "string",
    "asset_type": "commercial_paper",
    "distribution_type": "private",
    "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"
    }
}

定义​

资产对象（Request Body）​

字段类型描述必填
asset_typestring确定资产类型的枚举值是
distribution_typestring发行方式：public 或 private。是
external_idstring资产的外部标识；用于访问该实体的 key是
b3_codestring资产的 Cetip 代码否
isin_codestringISIN 代码（International Securities Identification Number）否
ipoc_codestring资产的 IPOC 代码否
allowed_managerslist有权在该发行中操作的管理人 CNPJ 列表否
allowed_consultantslist有权在该发行中操作的顾问 CNPJ 列表否
issuer_document_numberstring发行人的 CNPJ 或 CPF是
bookkeeper_document_numberstring登记机构（escriturador）的 CNPJ是
number_of_unitsfloat单位数量是
issue_unit_pricefloat发行时的单价是
issue_valuefloat资产的发行金额是
principal_unit_pricefloat资产发行时的单位本金是
issue_datestring发行日期，格式为 YYYY-MM-DD是
amortization_typestring摊销类型枚举值是
contract_numberstring合同编号是
maturity_datestring资产到期日是
installmentsdict分期对象是
delaydict逾期对象是
pre_fixeddict固定利率对象是
post_fixeddict浮动利率对象否

资产类型枚举值​

枚举值描述
commercial_paper商业票据（Nota Comercial）类资产
debenture债券（Debênture）类资产
criCRI 类资产
craCRA 类资产

摊销类型枚举值​

枚举值描述
sacSAC 摊销
pricePrice 摊销
custom自定义摊销

分期对象​

字段类型描述必填
installment_numberint分期期数是
maturity_datestring到期日，格式为 YYYY-MM-DD是
principal_unit_pricefloat资产的单位本金是
face_unit_pricefloat资产的单位面值是
amortization_percentagefloat摊销比例否

逾期对象​

字段类型描述必填
fineobject到期罚金对象。见 逾期罚金对象。是
interestobject逾期利息对象。见 逾期利息对象。是

逾期罚金对象​

字段类型描述必填
fine_typestring罚金类型。是
percentage_valuenumber罚金类型为 percentage 时的罚金值。取值范围：0 到 1，对应 0 到 100%是（fixed 时也必填）
amountnumber罚金类型为 fixed 时的罚金值。否
罚金类型枚举值​
枚举值描述
percentage按分期金额的百分比计算罚金
fixed固定金额罚金

逾期利息对象​

字段类型描述必填
method *string见 逾期利息计算方法枚举值。是
pre_fixed *object见 固定利率对象。是
逾期利息计算方法枚举值​
枚举值描述
compound复利计算逾期利息
simple单利计算逾期利息

固定利率对象​

字段类型描述必填
calendar_base *string所使用的计算基准。enumerator
monthly_rate *number合同月利率。1% 请使用 0.01最多 8 位小数

浮动利率对象​

字段类型描述必填
rateint适用的固定利率是
indexerstring调整所参照的指数（di、selic、ipca）是
calendar_basestring所采用的日历类型是
lagobject参见 Lag 对象是

Lag 对象​

字段类型描述必填
amountint滞后的单位数量是
referencestring滞后的时间单位是

Lag 参照枚举值​

枚举值描述
daily滞后按天计算
monthly滞后按月计算

计算基准枚举值​

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

Response​

STATUS
201
Response Body
{
    "security_key": "41d6ff41-1dac-4df7-9e50-d15210ec57f3",
    "status": "pre_operational"
}

错误​

状态码代码触发条件
400QIT000001请求体无效：校验失败的字段见 description。

认证、权限和主机相关错误：参见 API 错误。