# 客户金额扩展新增具体金额(适用商贸版)
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/customer_amount/v1/addCustomerAmountExt/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| reqInfo | List | 是 | 列表 |
| reqInfo.cm_id | int8 | 否 | 勤策客户唯一标识,有效字符详见附录：有效字符说明 (opens new window)，与客户编码不能同时为空 |
| reqInfo.cm_code | varchar | 否 | 客户编码，与勤策客户唯一标识不能同时为空 |
| reqInfo.data | List | 是 | 具体金额及其数值列表 |
| data.key | VARCHAR(200) | 是 | 金额字段名称 |
| data.value | VARCHAR(200) | 是 | 该金额类目的具体数值，仅支持数值形式 |
响应示例：
{
"return_code": "0",
"return_msg": "操作成功",
"msg_id": "X0000000001",
"response_data": null
}
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| msg_id | VARCHAR(32) | 是 | 消息ID |
| return_code | VARCHAR(32) | 是 | 响应编码。0：成功，1：失败 |
| return_msg | VARCHAR(100) | 是 | 响应说明 |
# 客户金额扩展外部余额查询接口
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/customer_amount/v1/queryCustomerAmountExt/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page_number | INT | 否 | 页码默认1，每页默认1000条 |
| page_length | INT | 否 | 每页记录条数，默认最大是1000条，可以根据业务数据的大小自行优化调整 |
| cm_id | VARCHAR(32) | 否 | 勤策客户唯一ID |
| cm_code | VARCHAR(32) | 否 | 客户编码，有效字符详见附录：有效字符说明 (opens new window) |
| cm_name | VARCHAR(32) | 否 | 客户名称 |
| create_date | VARCHAR(32) | 否 | 创建日期。格式：yyyy-MM-dd |
| modify_date | VARCHAR(32) | 否 | 修改日期。格式：yyyy-MM-dd |
| after_create_date | VARCHAR(32) | 否 | 创建时间之后。格式：yyyy-MM-dd HH:mm:ss |
| after_modify_date | VARCHAR(32) | 否 | 修改时间之后。格式：yyyy-MM-dd HH:mm:ss |
| start_create_date | VARCHAR(32) | 否 | 创建时间开始。格式：yyyy-MM-dd |
| end_create_date | VARCHAR(32) | 否 | 创建时间结束。格式：yyyy-MM-dd |
| start_modify_date | VARCHAR(32) | 否 | 修改时间开始。格式：yyyy-MM-dd |
| end_modify_date | VARCHAR(32) | 否 | 修改时间结束。格式：yyyy-MM-dd |
响应示例：
{
"return_code": "0",
"return_msg": "操作成功",
"msg_id": "X0000000001",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"id": "5129062275046171899",
"status": "1",
"creator_id": "7278740716358450271",
"create_time": "2019-06-04 16:51:39.0",
"modifyier_id": null,
"modify_time": null,
"code": "STORE2021081201710",
"name": "nnji",
"type_name": "大型超市",
"manager_name": "LiXiaoYu,rk,倪威,齐涛",
"district_name": null,
"cm_credit": "567.00",
"cm_book_amount": "85.00",
"cm_receive": "234.00",
"cm_rebate": "345.00",
"cm_advances": "123.00",
"cm_can_use_credit": "789.00",
"cm_id": "5312939443116802501"
}
]
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | INT8 | 是 | 客户金额ID |
| status | VARCHAR(1) | 是 | 客户金额状态。0：已删除，1：正常 |
| creator_id | INT8 | 是 | 创建人ID |
| create_time | INT8 | 是 | 创建日期。格式：yyyy-mm-dd hh24:mi:ss |
| modifyier_id | INT8 | 是 | 修改人ID |
| modify_time | INT8 | 是 | 修改日期。格式：yyyy-mm-dd hh24:mi:ss |
| name | VARCHAR(100) | 否 | 客户名称 |
| code | VARCHAR(100) | 否 | 客户编码 |
| type_name | VARCHAR(100) | 否 | 客户类型 |
| manager_name | VARCHAR(100) | 否 | 客户经理 |
| district_name | VARCHAR(100) | 否 | 区域名称 |
| cm_credit | numeric(10,2) | 否 | 信用额度 |
| cm_book_amount | NUMERIC(10,2) | 否 | 订货会余额 |
| cm_receive | NUMERIC(10,2) | 否 | 客户应收 |
| cm_rebate | NUMERIC(10,2) | 否 | 返利费用 |
| cm_advances | NUMERIC(10,2) | 否 | 客户预收 |
| cm_can_use_credit | NUMERIC(10,2) | 否 | 客户可用额度 |
| cm_id | INT8 | 否 | 客户ID |