v10 API文档函数公共接口周期比例模型

获取周期比例

方法概览

项目	内容
文档类型	PHP 类方法
方法标识	`app\common\model\ProductDurationRatioModel::indexRatio`
所属业务	公共接口
来源模块/系统	周期比例模型

功能说明

获取周期比例

调用示例

$product_id = 1;
$result = (new \app\common\model\ProductDurationRatioModel())->indexRatio($product_id);

参数

参数	类型	必填	默认值	校验规则	说明
`product_id`	`int`	是	—	require	商品ID

返回值

返回项	类型	说明
`[].id`	`int`	关联周期表ID
`[].name`	`string`	周期名称
`[].num`	`string`	周期时长
`[].unit`	`string`	周期单位(hour=小时,day=天,month=月)
`[].ratio`	`float`	周期比例
`[].price_factor`	`float`	价格系数

正常返回

{
  "id": 1,
  "name": "示例名称",
  "num": "string",
  "unit": "string",
  "ratio": 0.01,
  "price_factor": 0.01
}

异常情况

异常类型	说明
`Throwable`	调用失败时由具体实现抛出异常，异常信息以运行时结果为准。

保存周期比例

智简魔方业务系统 PHP 方法 saveRatio() 用于保存商品周期价格比例。调用时需提供商品 ID，以及以周期 ID 为键、比例为值的映射对象；方法通过状态码和消息说明保存周期比例是否成功，供价格周期配置和联调核验使用。

计算自动填充

智简魔方业务系统 PHP 方法 autoFill() 根据商品 ID 和各周期价格计算缺失价格，可同时处理按需价格。调用后返回处理状态、提示信息、以周期 ID 为键的填充价格映射及按需价格，适合价格配置自动补全。

本页目录

方法概览功能说明调用示例参数返回值正常返回异常情况