# 客户付款方信息接口

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

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/customerPayer/v1/addCustomerPayer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
	"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[].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 } 在线调试 (opens new window)
请求包体:

{
    "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[].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 } 在线调试 (opens new window)
请求包体:

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