Asset registration succeeded

This event occurs when an asset is registered with Pismo.

Type: object
Domain: assets
Event: asset_registration_success
Version: 1

|
asset required

Title: Object representing the registered asset.
Type: object

id required

Title: Asset ID
Description: Unique asset identifier defined by client. This is part of the asset identifier on the Pismo platform. It can be used to make redemptions and cancellations.
Type: string
Example:
d0855c6b-b037-4dce-94c5-7a6ffc1800a3

asset_type required

Title: Asset type
Description: Financial instrument type
Type: string
Must be one of the following:
cdb
rdb

issuer_id required

Title: Issuer ID
Description: Cetip code of registrator of asset. This is part of the asset identifier on the Pismo platform. It needs to be in every API call. An organization can have multiple issuer IDs.
Type: string
Example:
12345678

registration_mode required

Title: Registration mode
Description: Registration mode of asset. When single, asset has only one quota. When many, it can be filled with any number of quotas based on issued_units.
Type: string
Example:
single
many

issuing_date required

Title: Issuing date
Description: Date asset was effectively issued by client
Type: string
Format: date
Example:
2020-12-01

maturity_date required

Title: Issuing date
Description: Date asset expires, finishing issued_units cycle
Type: string
Format: date
Example:
2022-12-01

issued_units required

Title: Issued units
Description: Number of units asset can support. When single, this number should reflect the entire quota. When many, it should reflect the number of units available for purchase in the asset.
Type: number
Format: double
Example:
100.0

unit_value required

Title: Unit value
Description: Value of the asset's units
Type: number
Format: double
Example:
1.0

index_type required

Title: Index type
Description: Daily accrual calculations are be based on the index type. For example, "di" for DI rate or "pre" for prefixed rate.
Type: string
Must be one of the following:
di
pre
vpc
ipca
monthdi

index_rate required

Title: Index rate
Description: How much the asset accrues per day
Type: number
Format: double
Example:
1.0

currency required

Title: Currency
Description: ISO 4217 currency code
Type: string
Example:
986

isin_code

Title: ISIN code
Description: International Securities Identification Number (ISIN) of asset
Type: string or null
Example:
pismo1234

early_redemption_terms required

Title: Early redemption terms
Description: Identifies an asset that has a different calculation condition at redemption time. If "yes" , additional_data.early_redemption_attributes must be set.
Type: string
Must be one of the following:
yes
no

additional_data

Title: Custom additional information for the asset
Type: object or null

early_redemption_attributes

Title: List of early redemption attributes
Description: Custom redemption conditions
Type: array

date required

Title: Date
Description: Custom date to be considered
Type: string
Format: date
Example:
2021-02-01

interest_rate

Title: Interest rate
Description: Interest rate to be considered until date established
Type: number
Format: double
Example:
1.09

floating_rate required

Title: Floating rate
Description: Floating rate to be considered until date established
Type: number
Format: double
Example:
1.18

quota required

Title: Quota registered
Type: object

id required

Title: Quota ID
Description: Unique quota identifier
Type: string
Example:
99999999-9999-9999-9999-999999999999

customer_name required

Title: Customer name
Description: Name of asset quota owner. Can be a company or an individual.
Type: string
Example:
Lorem ipsum

customer_document_number required

Title: Customer document number
Description: Number of asset quota owner's legal document
Type: string
Example:
00000000012

type required

Title: Entity type
Description: Legal nature of asset quota owner
Type: string
Must be one of the following:
natural
legal

purchased_units required

Title: Purchased quota units
Description: Number of quota units purchased by asset quota owner
Type: number
Format: double
Example:
100.0

deposit_number

Title: Deposit number of the asset quota
Description: Optional attribute provided by customer when registering asset quota on Pismo platform
Type: number or null
Format: int
Example:
999999999

operation_code

Title: Operation code
Description: Optional attribute generated when registering asset quota on Pismo platform
Type: string or null
Example:
202404110000000900

created_at required

Title: Created date
Description: Creation date of asset on Pismo platform
Type: string
Format: date-time
Example:
2020-12-29T19:48:25

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "title": "Asset registration succeeded",
    "description": "This event occurs when an asset is registered with Pismo.",
    "required": [
        "asset",
        "quota",
        "created_at"
    ],
    "properties": {
        "asset": {
            "type": "object",
            "title": "Object representing the registered asset.",
            "required": [
                "id",
                "asset_type",
                "issuer_id",
                "registration_mode",
                "issuing_date",
                "maturity_date",
                "issued_units",
                "unit_value",
                "index_type",
                "index_rate",
                "currency",
                "early_redemption_terms"
            ],
            "properties": {
                "id": {
                    "type": "string",
                    "title": "Asset ID",
                    "description": "Unique asset identifier defined by client. This is part of the asset identifier on the Pismo platform. It can be used to make redemptions and cancellations.",
                    "examples": [
                        "d0855c6b-b037-4dce-94c5-7a6ffc1800a3"
                    ]
                },
                "asset_type": {
                    "type": "string",
                    "title": "Asset type",
                    "description": "Financial instrument type",
                    "enum": [
                        "cdb",
                        "rdb"
                    ]
                },
                "issuer_id": {
                    "type": "string",
                    "title": "Issuer ID",
                    "description": "Cetip code of registrator of asset. This is part of the asset identifier on the Pismo platform. It needs to be in every API call. An organization can have multiple issuer IDs.",
                    "examples": [
                        "12345678"
                    ]
                },
                "registration_mode": {
                    "type": "string",
                    "title": "Registration mode",
                    "description": "Registration mode of asset. When `single`, asset has only one quota. When `many`, it can be filled with any number of quotas based on `issued_units`.",
                    "examples": [
                        "single",
                        "many"
                    ]
                },
                "issuing_date": {
                    "type": "string",
                    "title": "Issuing date",
                    "description": "Date asset was effectively issued by client",
                    "format": "date",
                    "examples": [
                        "2020-12-01"
                    ]
                },
                "maturity_date": {
                    "type": "string",
                    "title": "Issuing date",
                    "description": "Date asset expires, finishing `issued_units` cycle",
                    "format": "date",
                    "examples": [
                        "2022-12-01"
                    ]
                },
                "issued_units": {
                    "type": "number",
                    "title": "Issued units",
                    "description": "Number of units asset can support. When `single`, this number should reflect the entire quota. When `many`, it should reflect the number of units available for purchase in the asset.",
                    "format": "double",
                    "examples": [
                        100.0
                    ]
                },
                "unit_value": {
                    "type": "number",
                    "title": "Unit value",
                    "description": "Value of the asset's units",
                    "format": "double",
                    "examples": [
                        1.0
                    ]
                },
                "index_type": {
                    "type": "string",
                    "title": "Index type",
                    "description": "Daily accrual calculations are be based on the index type. For example, \"di\" for DI rate or \"pre\" for prefixed rate.",
                    "enum": [
                        "di",
                        "pre",
                        "vpc",
                        "ipca",
                        "monthdi"
                    ]
                },
                "index_rate": {
                    "type": "number",
                    "title": "Index rate",
                    "description": "How much the asset accrues per day",
                    "format": "double",
                    "examples": [
                        1.0
                    ]
                },
                "currency": {
                    "type": "string",
                    "title": "Currency",
                    "description": "ISO 4217 currency code",
                    "examples": [
                        "986"
                    ]
                },
                "isin_code": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "title": "ISIN code",
                    "description": "International Securities Identification Number (ISIN) of asset",
                    "examples": [
                        "pismo1234"
                    ]
                },
                "early_redemption_terms": {
                    "type": "string",
                    "title": "Early redemption terms",
                    "description": "Identifies an asset that has a different calculation condition at redemption time. If \"yes\" , `additional_data.early_redemption_attributes` must be set.",
                    "enum": [
                        "yes",
                        "no"
                    ]
                },
                "additional_data": {
                    "type": [
                        "object",
                        "null"
                    ],
                    "title": "Custom additional information for the asset",
                    "properties": {
                        "early_redemption_attributes": {
                            "type": "array",
                            "title": "List of early redemption attributes",
                            "items": {
                                "$ref": "#/definitions/early_redemption_attributes"
                            }
                        }
                    }
                }
            }
        },
        "quota": {
            "type": "object",
            "title": "Quota registered",
            "required": [
                "id",
                "customer_name",
                "customer_document_number",
                "type",
                "purchased_units"
            ],
            "properties": {
                "id": {
                    "type": "string",
                    "title": "Quota ID",
                    "description": "Unique quota identifier",
                    "examples": [
                        "99999999-9999-9999-9999-999999999999"
                    ]
                },
                "customer_name": {
                    "type": "string",
                    "title": "Customer name",
                    "description": "Name of asset quota owner. Can be a company or an individual.",
                    "examples": [
                        "Lorem ipsum"
                    ]
                },
                "customer_document_number": {
                    "type": "string",
                    "title": "Customer document number",
                    "description": "Number of asset quota owner's legal document",
                    "examples": [
                        "00000000012"
                    ]
                },
                "type": {
                    "type": "string",
                    "title": "Entity type",
                    "description": "Legal nature of asset quota owner",
                    "enum": [
                        "natural",
                        "legal"
                    ]
                },
                "purchased_units": {
                    "type": "number",
                    "title": "Purchased quota units",
                    "description": "Number of quota units purchased by asset quota owner",
                    "format": "double",
                    "examples": [
                        100.0
                    ]
                },
                "deposit_number": {
                    "type": [
                        "number",
                        "null"
                    ],
                    "title": "Deposit number of the asset quota",
                    "description": "Optional attribute provided by customer when registering asset quota on Pismo platform",
                    "format": "int",
                    "examples": [
                        999999999
                    ]
                },
                "operation_code": {
                    "type": [
                        "string",
                        "null"
                    ],
                    "title": "Operation code",
                    "description": "Optional attribute generated when registering asset quota on Pismo platform",
                    "examples": [
                        "202404110000000900"
                    ]
                }
            }
        },
        "created_at": {
            "type": "string",
            "title": "Created date",
            "description": "Creation date of asset on Pismo platform",
            "format": "date-time",
            "examples": [
                "2020-12-29T19:48:25"
            ]
        }
    },
    "definitions": {
        "early_redemption_attributes": {
            "type": "object",
            "title": "Early redemption attributes",
            "required": [
                "date",
                "floating_rate"
            ],
            "description": "Custom redemption conditions",
            "properties": {
                "date": {
                    "type": "string",
                    "format": "date",
                    "title": "Date",
                    "description": "Custom date to be considered",
                    "examples": [
                        "2021-02-01"
                    ]
                },
                "interest_rate": {
                    "type": "number",
                    "format": "double",
                    "title": "Interest rate",
                    "description": "Interest rate to be considered until date established",
                    "examples": [
                        1.09
                    ]
                },
                "floating_rate": {
                    "type": "number",
                    "format": "double",
                    "title": "Floating rate",
                    "description": "Floating rate to be considered until date established",
                    "examples": [
                        1.18
                    ]
                }
            }
        }
    }
}
{
    "asset": {
        "id": "d0855c6b-b037-4dce-94c5-7a6ffc1800a3",
        "asset_type": "cdb",
        "issuer_id": "12345678",
        "registration_mode": "single",
        "issuing_date": "2020-12-01",
        "maturity_date": "2022-12-01",
        "issued_units": 100.0,
        "unit_value": 1.0,
        "index_type": "di",
        "index_rate": 1.0,
        "currency": "986",
        "isin_code": "pismo1234",
        "early_redemption_terms": "yes",
        "additional_data": {
            "early_redemption_attributes": {
                "date": "2021-02-01",
                "interest_rate": 1.09,
                "floating_rate": 1.18
            }
        }
    },
    "quota": {
        "id": "99999999-9999-9999-9999-999999999999",
        "customer_name": "Lorem ipsum",
        "customer_document_number": "00000000012",
        "type": "natural",
        "purchased_units": 100.0,
        "deposit_number": 999999999,
        "operation_code": "202404110000000900"
    },
    "created_at": "2020-12-29T19:48:25"
}