跳到主要内容

资产注册 - 发行

创建 - 商业票据​

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

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

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

Request​

ENDPOINT
/security/security
MÉTODO
POST
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_typestring确定资产类型的枚举值是
external_idstring资产的外部标识；用于访问实体的键是
b3_codestring资产的 Cetip 代码否
isin_codestringISIN 代码（国际证券识别码）否
ipoc_codestring资产的 IPOC 代码否
allowed_managerslist有权在发行中操作的基金经理 CNPJ 列表否
allowed_consultantslist有权在发行中操作的顾问 CNPJ 列表否
issuer_document_numberstring发行人的 CNPJ 或 CPF 编号是
bookkeeper_document_numberstring记账员的 CNPJ 编号是
number_of_unitsfloat单位数量是
issue_unit_pricefloat发行时的单价是
issue_valuefloat发行时的资产价值是
principal_unit_pricefloat发行时资产的本金单价是
issue_datestring发行日期，格式为 YYYY-MM-DD是
disbursement_datestring放款日期，格式为 YYYY-MM-DD是
amortization_typestring摊销类型的枚举值是
contract_numberstring合同编号是
maturity_datestring资产到期日是
installmentsdict分期付款对象是
delaydict逾期对象是
pre_fixeddict固定利率对象是
post_fixeddict浮动利率对象否

资产类型枚举​

枚举值描述
commercial_paper商业票据类资产
debenture债券类资产
criCRI 类资产
craCRA 类资产

摊销类型枚举​

枚举值描述
sacSAC 摊销类型
pricePrice 摊销类型

分期付款对象​

字段类型描述必填
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%）是
amountnumber若罚款类型为 fixed，则为罚款金额。是
罚款类型枚举​
枚举值描述
percentage按分期金额的百分比罚款
fixed固定罚款金额

逾期利息对象​

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

固定利率对象​

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

浮动利率对象​

字段类型描述必填
rateint适用的固定利率是
indexerstring调整参考指数（di、ipca）是
calendar_basestring所用历法类型是

Lag 对象​

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

计算基准枚举​

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

逾期参考枚举​

枚举值描述
workdays工作日（252）计算基准
calendar_365365 天计算基准
calendar_360360 天计算基准

Response​

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