更新合同金额接口
接口说明
用于更新合同金额(money_sum)与备注(note),支持通过合同 id 或合同号 group_code 定位合同。
当合同已收款(money_get > 0)时,不允许更新合同金额。
请求信息
请求 URL:
http://lbl-open.thinkerx.com/api/lbl/update-contract-money请求方式:
POST
请求参数
| 参数名 | 必选 | 类型 | 说明 | 备注 |
|---|---|---|---|---|
| api_key | 是 | string | 通行证 | |
| id | 条件必选 | int | 合同 id | 与 group_code 二选一 |
| group_code | 条件必选 | string | 合同号 | 与 id 二选一 |
| money_sum | 否 | number | 合同金额 | 若合同已收款则禁止修改 |
| discount | 否 | number | 合同折扣 | 若合同已收款则禁止修改 |
| note | 否 | string | 合同备注 | 可单独修改 |
至少需要传一个可更新字段:
money_sum或note 或 discount。
请求示例
{ "api_key": "xxxxxx", "id": 3166, "money_sum": 100,"discount": 9, "note": "合同金额调整"}按合同号更新:
{ "api_key": "xxxxxx", "group_code": "FG20221011-2", "money_sum": 100}返回示例
{ "status": 0, "message": "更新成功", "data": { "id": 3166, "group_code": "FG20221011-2", "buyer_address": "", "money_sum": 100, "note": "合同金额调整"
}
}返回参数
顶层字段
| 参数名 | 类型 | 说明 | 备注 |
|---|---|---|---|
| status | int | 状态码(0 成功,1 失败) | 建议以 status == 0 作为成功判断 |
| message | string/null | 返回信息 | 失败时为错误原因 |
| data | object | 合同信息 | 成功时返回更新后的部分字段 |
