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: objectid 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. Whensingle
, asset has only one quota. Whenmany
, it can be filled with any number of quotas based onissued_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, finishingissued_units
cycle
Type: string
Format: date
Example:
2022-12-01
issued_units required
Title: Issued units
Description: Number of units asset can support. Whensingle
, this number should reflect the entire quota. Whenmany
, 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 nullearly_redemption_attributes
Title: List of early redemption attributes
Description: Custom redemption conditions
Type: arraydate 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: objectid 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"
}
Updated 6 days ago