管理投资

一方提供资本,另一方提供工作,利润按商定比例分割,损失落在资本上。

不对称是关键所在,失去投资企业资金的经理会失去投入其中的工程,并因无钱而离开;投资方会失去资金,结果都不是惩罚——这是双方实际同意的风险划分. API 执行它: record_loss 永远不要碰经理人那一边的分类账,经理人的利润份额不是过着不好的一年的手续费.

基础路径 : /api/v1/pfp/managed-investments · 宗教读物: 穆达拉巴

---

两项任务

mandate_type	经理可以
restricted (默认)	只在申报领域和申报范围内投资 business_restrictions
unrestricted	自行决定投资

business_restrictions 是一个字符串列表,并在授权时予以考虑。 restricted 这是一份协议的记录,而不是一个执行机制——平台储存并报告;它不审查针对该协议的个别投资。

---

状态

draft ──submit──> under_review ──review──> review_passed
  │                    │                        │
  │                    └──reject──> rejected    │
  │                                             │
  └──────────────── fund ───────────────────────┘
                      │
                      v
                   funded ──activate──> active
                      │                    │
                      └────── complete ────┴──> completed
                                           │
                             loss wipes out │ current_value
                                           v
                                      liquidated

状态	含义
draft	记录的术语
under_review	提交供核准
review_passed	兹附上结论。
rejected	终端。 需要 a reason
funded	交给经理的资本
active	经理负责经营企业,可以记录损益
completed	按期解决
liquidated	都城被消灭了

completed 和 liquidated 失去资本的冒险与实行期限和定居的冒险并不相同,如果崩溃,则失败的合同与任何基于地位的报告的成功合同是分不开的。

没有 liquidate 终点:平台集 liquidated 它本身, 记录损失驱动器的时刻 current_value 改为零。 actual_end_date 设置在同一时间。

在世俗的阅读中 fund 可达从 draft (a) 与《公约》有关的其他事项; review_passed.

---

创建合同

POST /api/v1/pfp/managed-investments

{
  "customer_id": "8f2a1c44-0b6e-4d51-9a3f-1c8e5b7d2a90",
  "region": "RU",
  "currency": "RUB",
  "capital_amount": "2000000000",
  "business_type": "Wholesale distribution of building materials",
  "business_description": "Regional distribution across Tatarstan and Mari El",
  "mandate_type": "restricted",
  "business_restrictions": ["No trade financing", "No FX positions"],
  "profit_sharing_ratio": { "bank": 30, "customer": 70 },
  "term_months": 24,
  "reporting_frequency": "quarterly"
}

外地	类型	要求数	说明
customer_id	uuid	✅	经理
region	string	✅	合同区
currency	string	✅	ISO 4217
capital_amount	string	✅	最小货币单位,由 bank 边
business_type	string	✅	经理会经营的生意
profit_sharing_ratio	object	✅	{"bank": n, "customer": m}整个百分比, 必须是总和 100
term_months	integer	✅	1–120
mandate_type	enum	—	restricted （默认） | unrestricted
business_restrictions	array	—	字符串
business_description	string	—	免费文本
reporting_frequency	enum	—	monthly | quarterly | semi_annually | annually
metadata	object	—	返回未动

在示例中注意比例: 管理者接受 70 利润的%同时不贡献资本。这对这个产品来说是正常的 — 管理者的贡献就是工作,它是按利润份额定价的。

---

生命周期过渡

POST /api/v1/pfp/managed-investments/{id}/submit     # no body
POST /api/v1/pfp/managed-investments/{id}/review     # approved_by required
POST /api/v1/pfp/managed-investments/{id}/reject     # reason required
POST /api/v1/pfp/managed-investments/{id}/fund       # no body
POST /api/v1/pfp/managed-investments/{id}/activate   # no body

fund 记录显示首都已被移交。 activate 管理者已经开始交易的记录——利润和损失只接收自 active.

---

利润

POST /api/v1/pfp/managed-investments/{id}/profit

{
  "gross_profit": "180000000",
  "period_end_date": "2026-12-31"
}

需要两个字段,毛利润由 profit_sharing_ratio 和 经理的股权通过分类账的账号移动到它上 日期 period_end_date 这不是纸面上的应计。

历史的每个分布附件 :

{
  "profit_distributions": [
    {
      "date": "2026-12-31",
      "gross_profit": "180000000",
      "bank_share": "54000000",
      "customer_share": "126000000"
    }
  ]
}

current_value ——投资人的地位 ——由投资人的份额而不是毛额增长.

零是正当的报告。 赚不到钱的时期仍未结束: 发送 "0" 否定的毛利润被拒绝——损失是不同的算术的转变。

---

损失

POST /api/v1/pfp/managed-investments/{id}/loss

{
  "amount": "40000000",
  "period_end_date": "2027-03-31"
}

损失适用于: current_value ——面临风险的资本——和 盖住了它。您不能损失超过投资。大于剩余价值的损失按实际存在的价值入账,以及 current_value 改为零而不是负。

经理一方未受影响,以前分配的利润股份没有爪子,也没有对经理产生任何债务。

历史进入了 metadata.losses ——不进入自己的领域,不像. profit_distributions:

{
  "metadata": {
    "losses": [
      { "date": "2027-03-31", "loss_amount": "40000000", "new_value": "1960000000" }
    ]
  }
}

与利润不同的是,零损失被拒绝:没有记录.

损失还使报告日期提前,与利润分配日期完全相同,因损失而结束的时期仍然是报告的时期。

---

按期解决

POST /api/v1/pfp/managed-investments/{id}/complete

{ "final_value": "2200000000" }

可从 funded 和 active设置 actual_end_date,写 current_value to final_value,并将结算记录在 metadata.final_settlement:

{
  "final_settlement": {
    "returned_to_bank": "2014000000",
    "total_profit": "180000000",
    "total_loss": "40000000"
  }
}

returned_to_bank is capital_amount + bank_profit_share − total_loss ——资本回扣,加上投资者累计利润份额,减去承担的损失.

---

列表和读取

GET /api/v1/pfp/managed-investments

查询参数	数值
status	以上任何状态
region	合同区
type	restricted | unrestricted
customer_id	uuid (英语).
env	test | prod

GET /api/v1/pfp/managed-investments/{id}