证书问题
许多持有者资助一项资产并分享其产生的收入,每份证书都是真实事物——租赁的建筑物、车队、分期付款销售组合——中不可分割的份额,而不是对发行人提出的本金加利息索赔。
区别出现在三个地方 API 执行 :
- 这一问题必须得到支持。
underlying_asset_value不得小于total_value。您不能发布更多的文件, 其背后有资产。 - 分配是收入,不是优惠券.
POST /profit将资产实际所得除以未结凭证。一个无所得的期间将不分配任何资产,并且没有遗留的应计负债。 - 失败有名. 错失的分发并非无声无息地与制作的分发无异:
POST /default存在,默认的问题也这么说。
基础路径 : /api/v1/pfp/certificate-issues · 宗教读物: 苏库克语Name
备份类型
backing_type 列出证书分享收入的合同名称:
| 数值 | 证书由 |
|---|---|
lease | 租赁资产的租金收入 |
managed_investment | 一个有管理的企业的利润 |
partnership | 在一个合资企业中的股份 |
installment_sale | 分期付款应收款组合 |
manufacturing | 在建资产,分阶段支付 |
forward_purchase | 货物现在已支付,以后交付 |
状态
draft ──submit──> under_review ──review──> review_passed
│ │ │
│ └──reject──> rejected │
│ │
└──────────── offering ───────────────────────┘
│
v
offering ──subscribe──> (holders record subscriptions)
│
close_subscription (optional)
v
subscribed
│ activate ← also reachable directly from offering
v
active ──mature──> matured ──redeem──> redeemed
│ │
│ └──default──> defaulted
├──redeem_early──> redeemed
└──default──> defaulted
| 状态 | 含义 |
|---|---|
draft | 记录的术语 |
under_review | 提交供核准 |
review_passed | 兹附上结论。 |
rejected | 终端。 需要 a reason |
offering | 订阅窗口已打开 |
subscribed | 窗口关闭, 尚未放置 |
active | 已放置; 证书尚未完成并有收益 |
matured | 到期日期已经到来 |
redeemed | 买回;所有阵地关闭 |
defaulted | 义务未履行。 reason |
在世俗的阅读中 offering 可达从 draft (a) 与《公约》有关的其他事项; review_passed.
创建问题
POST /api/v1/pfp/certificate-issues
{
"name": "Kazan Logistics Park — Series A",
"region": "RU",
"currency": "RUB",
"backing_type": "lease",
"underlying_asset": "Logistics complex, 12 400 m², Kazan, lease to Magnit until 2032",
"underlying_asset_type": "real_estate",
"underlying_asset_value": "1800000000",
"total_value": "1500000000",
"certificate_value": "1000000",
"expected_yield": 9,
"maturity_months": 60,
"min_subscription": 5,
"max_subscription": 300,
"profit_distribution_frequency": "quarterly",
"redemption_mode": "bullet",
"early_redemption_allowed": true,
"early_redemption_penalty": "20000"
}
| 外地 | 类型 | 要求数 | 说明 |
|---|---|---|---|
name | string | ✅ | 问题名称 |
region | string | ✅ | 问题区域 |
backing_type | enum | ✅ | 参见上表 |
underlying_asset | string | ✅ | 说明, 超过 10 字符 |
underlying_asset_value | string | ✅ | 最小货币单位。 起码是的 total_value |
total_value | string | ✅ | 最小货币单位。 ** 必须除以 certificate_value 没错** |
certificate_value | string | ✅ | 小单元——一个证书的面值 |
expected_yield | integer | ✅ | 整个百分比, 1–50 |
maturity_months | integer | ✅ | 1–360 |
min_subscription | integer | — | 每份申请的最低证书 |
max_subscription | integer | — | ** 每名持单人最高限额**,在所有应用程序中 |
profit_distribution_frequency | enum | — | monthly | quarterly | semi_annually | annually |
redemption_mode | enum | — | bullet | amortizing | callable |
early_redemption_allowed | boolean | — | 盖茨 redeem_early |
early_redemption_penalty | string | — | 小单位 |
subscription_start, subscription_end | date | — | 也可设定为 offering |
originator_id, spv_id, product_id | uuid | — | |
underlying_asset_type, metadata | — | — |
certificates_total 生成为 total_value / certificate_value,而师必须准确.
问题代码
每次发行都有 isin 字段。它不是真正的 ISIN。 真正的 ISIN 由国家编号机构分配，平台不会自行编造或将内部代码冒充为 ISIN。这里的代码为十六个字符，而 ISO 6166 规定 ISIN 必须为十二个字符，因此不会与正式分配的标识符混淆：
RUCRT4A7F1C9E2B3
│ │ │ └── Luhn check digit
│ │ └── ten random hex characters
│ └── three characters naming the reading: CRT secular, SKK religious
└── two-character region code
内部使用。如果列出问题,请用真实的 ISIN 从编号机构。
正在运行订阅
打开窗口
POST /api/v1/pfp/certificate-issues/{id}/offering
{ "subscription_start": "2026-09-01", "subscription_end": "2026-10-15" }
两个日期都需要。 draft or review_passed → offering.
记录订阅
POST /api/v1/pfp/certificate-issues/{id}/subscribe
{ "investor_id": "b7d1e044-92a3-4c58-8f10-3ea6c9d27b45", "certificates": 50 }
检查了六个条件,按此顺序:
certificates必须是正整数。- 问题必须解决
offering——草案,到期或赎回的问题不接受认购. - ** 今天必须是在订阅窗口内。** 关闭的窗口拒绝。
certificates必须是至少min_subscription.max_subscription检查持有者的总位置,而不是反对单一申请。在上限上,每个申请两个都被拒绝,因为它们共同超过上限。错误名称为持有者已持有多少。certificates不得超过尚未订阅的部分。
关闭窗口( 可选)
POST /api/v1/pfp/certificate-issues/{id}/close_subscription
无身. offering → subscribed 如果没有人订阅,则拒绝。
这一步骤是可选的——它存在,因此收集申请和将问题放在报告之间有差距。 activate 直接接受来自 offering 也一样。
摆放问题
POST /api/v1/pfp/certificate-issues/{id}/activate
{ "issue_date": "2026-10-20" }
issue_date 是可选的,但默认为今天。如果没有订阅,则被拒绝 。 无法放置一个没有持有人的问题。 sets certificates_outstanding 从所订阅的日期算起,并计算到期日期。
offering or subscribed → active.
分配收入
POST /api/v1/pfp/certificate-issues/{id}/profit
{ "total_profit": "33750000", "period_end_date": "2026-12-31" }
仅来自 active。金额除以 certificates_outstanding,并录制:
{
"profit_distributions": [
{
"date": "2026-12-31",
"total_profit": "33750000",
"per_certificate": "22500",
"certificates_outstanding": 1500
}
],
"total_profit_distributed": "33750000",
"actual_yield": 9,
"next_distribution_date": "2027-03-31"
}
actual_yield 每次分发都是重算的:这是问题实际支付的费用,与 expected_yield两者均占全部百分比。当它们出现分歧时,第二个数字是真实的数字。
零和负数额均被拒绝。 period_end_date 是可选的,但默认为今天。
结束一个问题
成熟度
POST /api/v1/pfp/certificate-issues/{id}/mature
无身. active → matured, 只有在到期日期实际到来时. . . . . . .
赎罪
POST /api/v1/pfp/certificate-issues/{id}/redeem
{ "redemption_date": "2031-10-20" }
仅来自 matured。关闭每个持有者的位置和装置 certificates_outstanding 改为零。
早期救赎
POST /api/v1/pfp/certificate-issues/{id}/redeem_early
{ "redemption_date": "2029-06-01" }
仅来自 active,以及 只有在 early_redemption_allowed 设定为创建。否则:
{
"error": "unprocessable_entity",
"details": {
"early_redemption_allowed": ["досрочный выкуп условиями не предусмотрен"]
}
}
默认
POST /api/v1/pfp/certificate-issues/{id}/default
{ "reason": "Lessee insolvent; no rental income since 2028-04" }
备查 active 从 matured 问题可能在其期限之前失效,或无法偿还赎回金。 metadata.default_reason.
列表和读取
GET /api/v1/pfp/certificate-issues
| 查询参数 | 数值 |
|---|---|
status | 以上任何状态 |
region | 问题区域 |
type | 任何 backing_type |
investor_id | uuid——持有者有订阅权的问题 |
env | test | prod |
GET /api/v1/pfp/certificate-issues/{id}