# 客户付款方信息接口

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

请求方式: 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) 勤策(原外勤365)客户唯一标识,和客户编码不能同时为空。 customer_id、customer_code如果同时存在优先取customer_id
customer_code VARCHAR(100) 客户编码,和勤策(原外勤365)客户唯一标识不能同时为空
cm_payer List 勤策(原外勤365)付款方列表
cm_payer.payer_id VARCHAR(32) 勤策(原外勤365)付款方客户唯一标识,和付款方编码不能同时为空。payer_id、payer_code如果同时存在优先取payer_id
cm_payer.payer_code VARCHAR(100) 付款方编码,和勤策(原外勤365)付款方客户唯一标识不能同时为空

响应示例:

{
    "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",
    "cm_waiqin365_id": "8913445946038614084"
}
说明: 本示例仅供参考。

参数说明:

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

响应示例:

{
    "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) 勤策(原外勤365)客户唯一标识,和客户编码不能同时为空。customer_id、customer_code如果同时存在优先取customer_id
customer_code VARCHAR(100) 客户编码,和勤策(原外勤365)客户唯一标识不能同时为空

响应示例:

{
    "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) 付款方编码