API开放平台

TIP

# 客户付款方信息接口

# 新增客户付款方信息接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/customerPayer/v1/addCustomerPayer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"customer_id": "6096907397744528807",
    "customer_code": "CUS001535",
    "cm_payer":[
    	{
    	    "payer_id": "6096907397744528808",
	    	"payer_code":"CUS000004"
    	}
    ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
customer_id VARCHAR(32) 否 勤策客户唯一标识，和客户编码不能同时为空。 customer_id、customer_code如果同时存在优先取customer_id
customer_code VARCHAR(100) 否 客户编码，和勤策客户唯一标识不能同时为空
cm_payer List 否 勤策付款方列表
cm_payer.payer_id VARCHAR(32) 否 勤策付款方客户唯一标识，和付款方编码不能同时为空。payer_id、payer_code如果同时存在优先取payer_id
cm_payer.payer_code VARCHAR(100) 否 付款方编码，和勤策付款方客户唯一标识不能同时为空

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 删除客户付款方信息接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/customerPayer/v1/removeCustomerPayer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "customer_code": "CUS001535",
    "customer_id": "8913445946038614084"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
customer_id VARCHAR(32) 否 勤策客户唯一标识，和客户编码不能同时为空。customer_id、customer_code如果同时存在优先取customer_id
customer_code VARCHAR(100) 否 客户编码，和勤策客户唯一标识不能同时为空
cm_payer List 否 勤策付款方客户列表
cm_payer.payer_id VARCHAR(32) 否 勤策付款方客户唯一标识，和付款方编码不能同时为空。payer_id、payer_code如果同时存在优先取payer_id
cm_payer.payer_code VARCHAR(100) 否 付款方编码，和勤策付款方客户唯一标识不能同时为空

响应示例：

{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 查询客户付款方信息接口

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/customerPayer/v1/queryCustomerPayer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
	"customer_id": "6096907397744528807",
    "customer_code": "CUS001535"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
customer_id VARCHAR(32) 否 勤策客户唯一标识，和客户编码不能同时为空。customer_id、customer_code如果同时存在优先取customer_id
customer_code VARCHAR(100) 否 客户编码，和勤策客户唯一标识不能同时为空

响应示例：

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
        {
            "cm_payer_id": "5742455073132501980",
			"cm_payer_code": "CM008"
        },
        {
            "cm_payer_id": "5742455073132501981",
            "cm_payer_code": "CM001"
        }
]

参数说明：

参数 类型 必填 说明
cm_payer_id VARCHAR(32) 付款方勤策id
cm_payer_code VARCHAR(100) 付款方编码

← 客户开票信息接口 →