跳转到主内容

租赁

房主购买资产,保有产权,并租借出其用途,租借是用来使用已经存在和拥有的事物的,而不是为了时间经过一笔钱。

所有权不是一种形式:它涉及成本、保险、大修、资产被毁坏的风险——只要所有权人拥有所有权,这些风险就与所有权人同在; API 租赁合同中,用户承担所有者的所有成本,而所有者则不承担抵押品的贷款,这是租赁词汇中描述的。

基础路径 : /api/v1/pfp/leases · 宗教读物: 伊贾拉

两种表格​

lease_type结尾购买选项
operating资产归主人了无
finance给承租人的产权证强制性 -- -- purchase_option_price 创建时需要

表格决定了哪些结局是合法的。 operating 租赁不能通过所有权转让而终止,a finance 租赁不能通过返还而结束——通过返还而结束融资租赁将剥夺承租人已经向它支付的购买权。 API 拒绝两者。

选择 finance 套装 purchase_option to true 自动制作 purchase_option_price 要求和正数。

状态​

draft ──submit──> under_review ──review──> review_passed
  │                    │                        │
  │                    └──reject──> rejected    │
  │                                             │
  └──────────── acquire ────────────────────────┘
                    │
                    v
             asset_acquired ──activate──> active
                                            │
                 ┌──────────────────────────┼──────────────────┐
                 │ (finance)                │ (operating)      │
                 v                          v                  v
          transfer_pending ──transfer──> completed         terminated
                                              ^
                                              └── return (operating)
状态含义
draft记录的术语
under_review提交供核准
review_passed兹附上结论。
rejected终端。 需要 a reason
asset_acquired所有权人拥有所有权和所有权文件
active资产与承租人同在;租金在运行
transfer_pending仅融资租赁——期限届满,产权转让正在正规化.
completed返回(经营)或转移(金融)
terminated提前结束。 reason

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

创建租赁​

POST /api/v1/pfp/leases
{
  "customer_id": "8f2a1c44-0b6e-4d51-9a3f-1c8e5b7d2a90",
  "region": "RU",
  "currency": "RUB",
  "lease_type": "finance",
  "asset_type": "equipment",
  "asset_description": "CNC milling machine DMG MORI CMX 1100 V",
  "asset_cost": "1450000000",
  "lease_term_months": 48,
  "monthly_rental": "3600000",
  "advance_rental": "7200000",
  "security_deposit": "10000000",
  "residual_value": "290000000",
  "purchase_option_price": "290000000",
  "asset_location": "Kazan, Industrial Park B"
}
外地类型要求数说明
customer_iduuid✅承租人
regionstring✅合同区
lease_typeenum✅operating | finance
asset_descriptionstring✅资产必须存在并在签署时可以识别
asset_coststring✅最小货币单位,0以上
lease_term_monthsinteger✅1–240 期间 30 天数
monthly_rentalstring✅最小货币单位,0以上
purchase_option_pricestring有条件需要时间 lease_type is finance
asset_typeenum—vehicle | equipment | real_estate | aircraft | vessel | machinery
advance_rentalstring—预付,加上应付总额
security_depositstring—持有,不是租金
residual_valuestring—期末预期值
asset_serial_number, asset_location, asset_specifications——确定具体事项
currency, product_id, metadata——

资产必须可以识别。 asset_description 必须是实质性的——任何十个字符或更短的字符都被拒绝。这不是寻衅滋事:租出一个未指明的未来对象是一种赌注,而不是租赁,而这种产品是为其建造的法域的合同是无效的。 asset_serial_number 和 asset_location 确定具体的事情。

total_rentals_due 来源 : monthly_rental × lease_term_months + advance_rental.

获取资产​

POST /api/v1/pfp/leases/{id}/acquire
{
  "ownership_documents": ["purchase-invoice-8812.pdf", "customs-decl-4471.pdf"],
  "asset_serial_number": "DMG-CMX1100V-2026-0417",
  "asset_registration": "RU-EQ-2026-88120",
  "insurance_policy": "SOGAZ-EQ-2026-11904",
  "insurance_expires": "2027-09-01"
}

ownership_documents is 所需经费 ——非空列表。这是记录所有者实际拥有该东西的过渡,它不会接受空手.

draft or review_passed → asset_acquired.

交出来开始​

POST /api/v1/pfp/leases/{id}/activate
{ "delivery_date": "2026-09-15" }

delivery_date 是可选的,但默认为今天。 租赁期和整个付款时间表从中计算 ——租金从承租人取得资产时开始,而不是从合同签订时开始.

asset_acquired → active.

时间表​

激活时生成的,第一行坠落 之后一个时期 开工日期,不在此列:已经使用一个月的租金。

{
  "payment_schedule": [
    { "payment_number": 1, "due_date": "2026-10-15", "amount": "3600000", "status": "pending" },
    { "payment_number": 2, "due_date": "2026-11-14", "amount": "3600000", "status": "pending" }
  ]
}

期间为 30 日数,因此到期日期相对于日历是漂移的。每行都带满 monthly_rental 与分期销售不同的是,这里没有分期销售,因此没有四舍五入的剩余部分。 monthly_rental × lease_term_months; advance_rental 如果有的话,就放在上面,不是排行表。

管理租赁​

收到租金​

POST /api/v1/pfp/leases/{id}/payment
{ "amount": "3600000" }

添加到 total_rentals_paid 并推进时间表。

拖欠款​

POST /api/v1/pfp/leases/{id}/arrears
{ "amount": "7200000" }

记录逾期款项。 零是一个有效的价值 并清除犯罪 ——这是产品家族中唯一接受的量字段. "0" (^(0|[1-9]\d*)$ 而不是 ^[1-9]\d*$).

与分期付款销售一样,记录欠款并不增加欠款。

业主费用​

POST /api/v1/pfp/leases/{id}/expense
{
  "amount": "4500000",
  "description": "Spindle bearing replacement, works order 2211",
  "type": "maintenance"
}

这是一种使业主成为业主的过渡,保险费、大修、法定检查——按产权而不是按使用权计算的费用。

description is 需要且不得为空白 对承租人来说,没有说明目的的费用是没有道理的,正是这一理由将所有人的费用与悄悄地转给承租人的费用区别开来。 type 默认为 maintenance.

累计支出 total_owner_expenses 并列于 owner_expenses.

终止租约​

可用的结尾取决于 lease_type.

业务租赁——回报​

POST /api/v1/pfp/leases/{id}/return

无身. active → completed,以及 return_date 被设定为今天 拒绝融资租赁。

融资租赁——所有权转让​

两个步骤,因为结束的术语和完成的文件不是同一天。

POST /api/v1/pfp/leases/{id}/transfer_pending

无身. active → transfer_pending拒绝经营租赁。

POST /api/v1/pfp/leases/{id}/transfer

没有尸体,把合同搬到 completed 组合 transfer_date.

两项条件都得到了执行,这两项条件都是:

  • 租赁必须是 finance 租赁。
  • 租金必须全额支付。 If total_rentals_paid 未达到 total_rentals_due,拒绝转账,答复中列出了未清金额:
{
  "error": "unprocessable_entity",
  "details": {
    "total_rentals_paid": ["аренда выплачена не полностью: остаток 7200000"]
  }
}

transfer 可以从两者中达到 active 和 transfer_pending,所以中间步骤可以跳过 当文件的立即。

提前终止​

POST /api/v1/pfp/leases/{id}/terminate
{ "reason": "Lessee ceased operations" }

只有一个 active 租赁可以终止。通过转让或返回而已完成的租赁不能移到 terminated 这将抹去事实上发生的结局的记录。

列表和读取​

GET /api/v1/pfp/leases
查询参数数值
status以上任何状态
region合同区
typeoperating | finance
customer_iduuid (英语).
arrearstrue ——目前拖欠的只有现行租约.
ending_in_days整数——只有期限在N日以内的现行租赁
envtest | prod

最后两项是用于业务审查的: ?arrears=true 给出收藏队列, ?ending_in_days=60 给予租借权 需要展期或转移决定 本季度。

GET /api/v1/pfp/leases/{id}