# 客户收货方关系维护接口
# 客户收货方关系维护接口
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/customer/v1/maintainCmReceiverRelation/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cm_id | VARCHAR(32) | 否 | 第三方系统客户唯一标识，与客户勤策唯一标识、客户编码不能同时为空。cm_id、cm_waiqin_365_id、cm_code如果同时存在，优先级依次降低 |
| cm_waiqin_365_id | VARCHAR(100) | 否 | 客户勤策唯一标识，与第三方系统客户唯一标识、客户编码不能同时为空 |
| cm_code | VARCHAR(32) | 否 | 客户编码，与第三方系统客户唯一标识、客户勤策唯一标识不能同时为空。有效字符详见附录：有效字符说明 (opens new window) |
| cm_receive_info | List | 否 | 收货方信息列表 |
| cm_receive_info.cm_waiqin_365_id | VARCHAR(32) | 否 | 收货方勤策唯一标识，与收货方第三方系统客户唯一标识、收货方编码不能同时为空。cm_receive_info.cm_waiqin_365_id与cm_receive_info.cm_id、cm_receive_info.cm_code不能同时为空 |
| cm_receive_info.cm_id | VARCHAR(32) | 否 | 收货方第三方系统客户唯一标识，与收货方勤策唯一标识、收货方编码不能同时为空 |
| cm_receive_info.cm_code | VARCHAR(32) | 否 | 收货方编码，与收货方第三方系统客户唯一标识、收货方编码不能同时为空。有效字符详见附录：有效字符说明 (opens new window) |
响应示例：
{
"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/customer/v1/queryCmReceiverRelation/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cm_waiqin_365_id | VARCHAR(32) | 否 | 客户ID，与客户编码、来源于第三方客户ID不能同时为空，cm_waiqin_365_id、code、source_code如果同时存在，优先级依次降低 |
| code | VARCHAR(32) | 否 | 客户编码，与客户ID、来源于第三方客户ID不能同时为空 |
| source_code | VARCHAR(32) | 否 | 来源于第三方客户ID，与客户ID、客户编码不能同时为空 |
响应示例：
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"cm_id": "7863150652620035205",
"cm_receive_id": "6763590632640565347",
"cm_name": "苏果夫子庙店",
"cm_code": "CM0001",
"cm_source_code": "T001"
},
{
"cm_id": "7863150652620035206",
"cm_receive_id": "6763590632640565346",
"cm_name": "苏果夫子庙店2",
"cm_code": "CM0002",
"cm_source_code": "T002"
}
]
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cm_id | VARCHAR(32) | 客户唯一标识，有效字符详见附录：编码类型参照表 | |
| cm_receive_id | VARCHAR(100) | 收货方唯一标识，有效字符详见附录：编码类型参照表 | |
| cm_name | VARCHAR(32) | 客户名称 | |
| cm_code | VARCHAR(4000) | 客户编码 | |
| cm_source_code | VARCHAR(4000) | 来源于第三方系统的客户唯一标识 |
# 客户发货方关系查询接口
根据发货方客户查询收货方客户
请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/customer/v1/queryCmReceiverBySuper/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cm_waiqin_365_id | VARCHAR(32) | 否 | 客户ID，与客户编码、来源于第三方客户ID不能同时为空，cm_waiqin_365_id、code、source_code如果同时存在，优先级依次降低 |
| code | VARCHAR(32) | 否 | 客户编码，与客户ID、来源于第三方客户ID不能同时为空 |
| source_code | VARCHAR(32) | 否 | 来源于第三方客户ID，与客户ID、客户编码不能同时为空 |
响应示例：
{
"return_code": "0",
"return_msg": "响应信息",
"msg_id": "{ msg_id }",
"response_data": "<<DATA>>"
}
数据DATA示例:
[
{
"cm_id": "7863150652620035205",
"cm_receive_id": "6763590632640565347",
"cm_name": "苏果夫子庙店",
"cm_code": "CM0001",
"cm_source_code": "T001"
},
{
"cm_id": "7863150652620035206",
"cm_receive_id": "6763590632640565346",
"cm_name": "苏果夫子庙店2",
"cm_code": "CM0002",
"cm_source_code": "T002"
}
]
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| cm_id | VARCHAR(32) | 客户唯一标识，有效字符详见附录：编码类型参照表 | |
| cm_receive_id | VARCHAR(100) | 收货方唯一标识，有效字符详见附录：编码类型参照表 | |
| cm_name | VARCHAR(32) | 客户名称 | |
| cm_code | VARCHAR(4000) | 客户编码 | |
| cm_source_code | VARCHAR(4000) | 来源于第三方系统的客户唯一标识 |