Commercial Paper Operation Registration

This endpoint allows creating a new commercial paper operation based on financial and investor data.

---

Request

ENDPOINT

/commercial_paper/operation

METHOD

POST

Request Body

{
    "issuer_key": "48e2c597-f2ca-487e-9f06-2b628ecb831e",
    "issuer_bank_account": {
        "account_number": "4464541",
        "account_digit": "3",
        "account_branch": "0001",
        "financial_institution_code_number": "329",
        "financial_institution_ispb": "32402502",
        "account_type": "checking"
    },
    "investors": [
        {
            "investor_key": "70b1b638-ca56-4eb3-9a88-2fd5ffd077a7",
            "subscription_percentage": 100,
            "bank_account": {
                "account_number": "33400254",
                "account_digit": "3",
                "account_branch": "0001",
                "financial_institution_code_number": "329",
                "financial_institution_ispb": "32402502",
                "account_type": "checking"
            }
        }
    ],
    "issue_date": "2025-01-23",
    "financial": {
        "interest_type": "pre_price_days",
        "financial_base_date": "2025-01-23",
        "released_amount": 1000000,
        "number_of_installments": 5,
        "prefixed_interest_rate": {
            "interest_base": "calendar_days_365",
            "monthly_rate": 0.05
        },
        "fine_delay_rate": {
            "interest_base": "calendar_days_365",
            "monthly_rate": 0.01
        },
        "contract_fine_rate": 0.02,
        "fees": [
            {
                "amount": 5,
                "amount_type": "percentage",
                "fee_type": "implementation_fee"
            }
        ]
    }
}

Request Body Params

Field	Type	Description	Max Characters
issuer_key *	string	Unique issuer key.	-
issuer_bank_account *	object	Issuer bank account.	issuer_bank_account Object
investors *	array	List of involved investors.	investors Object
issue_date *	string	Operation issue date (format "YYYY-MM-DD").	-
financial *	object	Operation financial data.	financial Object

issuer_bank_account Object

Field	Type	Description
account_number *	string	Bank account number.
account_digit *	string	Bank account digit.
account_branch *	string	Bank account branch.
financial_institution_code_number *	string	Financial institution code.
financial_institution_ispb *	string	Financial institution ISPB code.
account_type *	string	Account type (checking, savings).

investors Object

Field	Type	Description
investor_key *	string	Unique investor key.
subscription_percentage *	number	Subscription percentage.
bank_account *	object	Investor bank account.

financial Object

Field	Type	Description
interest_type *	string	Interest type.
financial_base_date *	string	Financial base date (format "YYYY-MM-DD").
released_amount *	number	Released amount.
number_of_installments *	integer	Number of installments.
prefixed_interest_rate *	object	Prefixed interest rate.
fine_delay_rate *	object	Delay fine rate.
contract_fine_rate *	number	Contractual fine in percentage.
fees	array	List of fees.

Response

STATUS

201

Response Body

{
    "tenant_key": "1d29d606-649a-487f-af1c-c0f5cb3e9814",
    "operation_key": "a846cc4a-b542-4f66-9823-b6d5458bd127",
    "operation_status": "in_filling",
    "issuer_key": "48e2c597-f2ca-487e-9f06-2b628ecb831e",
    "issuer_name": "Dynamic Enterprises",
    "issuer_document_number": "28980395000155",
    "financial": {
        ...
    }
}

Response Body Params

Field	Type	Description
tenant_key *	string	Unique tenant key.
operation_key *	string	Unique operation key.
operation_status *	string	Operation status.
issuer_key *	string	Unique issuer key.
issuer_name *	string	Issuer name.
issuer_document_number *	string	Issuer document.
financial *	object	financial Object

financial Object Response

Field	Type	Description	Max Characters
financial_base_date *	string	Operation financial base date (format "YYYY-MM-DD").	-
issue_amount *	number	Total issued amount of the operation.	-
released_amount *	number	Net amount released in the operation.	-
issue_quantity *	integer	Total quantity of units issued.	-
unit_price *	number	Unit price of the issuance.	-
cet *	number	Total Effective Cost (CET) in percentage.	-
annual_cet *	number	Annual CET in percentage.	-
number_of_installments *	integer	Total number of installments.	-
prefixed_interest_rate *	object	Object containing prefixed interest rate details.	prefixed_interest_rate Object
fees	array	List of fees associated with the operation.	fees Object
installments	array	List of installment details generated in the operation.	installments Object
fine_delay_rate *	object	Object containing delay fine details.	fine_delay_rate Object
contract_fine_rate *	number	Contractual fine applied in percentage.	-

prefixed_interest_rate Object

Field	Type	Description	Max Characters
interest_base *	string	Calculation base for interest.	interest_base Enumerators
monthly_rate *	number	Applied monthly interest rate.	-
daily_rate *	number	Applied daily interest rate.	-
annual_rate *	number	Applied annual interest rate.	-

fees Object

Field	Type	Description	Max Characters
amount *	number	Percentage value of the fee.	-
fee_amount *	number	Monetary value corresponding to the fee.	-
amount_type *	string	Type of fee value.	amount_type Enumerators
fee_type *	string	Type of fee.	fee_type Enumerators
type *	string	Fee recipient.	fee_recipient Enumerators

installments Object

Field	Type	Description
installment_number *	integer	Installment number.
workdays *	integer	Business days until installment due date.
calendar_days *	integer	Calendar days until installment due date.
principal_amortization_amount *	number	Principal amortized amount.
principal_amortization_unit_price *	number	Amortized amount per unit.
interest_amount *	number	Interest amount applied in the installment.
amount *	number	Total installment amount.
due_date *	string	Installment due date (format "YYYY-MM-DD").