# 客户收货方关系维护接口

# 客户收货方关系维护接口

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

{
    "cm_id": "CUS888888",
    "cm_waiqin_365_id": "8221381756885490457",
    "cm_code": "T001",
    "cm_receive_info": [
                              {
                                  "cm_waiqin_365_id": "7320222111236541",
                                  "cm_id": "CUS9999",
                                  "cm_code": "T002"
                              },
                              {
                                  "cm_waiqin_365_id": "7320222111236542",
                                  "cm_id": "CUS9992",
                                  "cm_code": "T003"
                             }
                  ]
}

参数说明:

参数 类型 必填 说明
cm_id VARCHAR(32) 第三方系统客户唯一标识,与客户外勤365唯一标识、客户编码不能同时为空。cm_id、cm_waiqin_365_id、cm_code如果同时存在,优先级依次降低
cm_waiqin_365_id VARCHAR(100) 客户外勤365唯一标识,与第三方系统客户唯一标识、客户编码不能同时为空
cm_code VARCHAR(32) 客户编码,与第三方系统客户唯一标识、客户外勤365唯一标识不能同时为空。有效字符详见附录:有效字符说明 (opens new window)
cm_receive_info[].cm_waiqin_365_id VARCHAR(32) 收货方外勤365唯一标识,与收货方第三方系统客户唯一标识、收货方编码不能同时为空。cm_receive_info[].cm_waiqin_365_id与cm_receive_info[].cm_id、cm_receive_info[].cm_code不能同时为空
cm_receive_info[].cm_id VARCHAR(32) 收货方第三方系统客户唯一标识,与收货方外勤365唯一标识、收货方编码不能同时为空
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 } 在线调试 (opens new window)
请求包体:

{
    "cm_waiqin_365_id": "4819212417121810405",
    "code": "CUS888888",
    "source_code": "8259172096596891009"
}

参数说明:

参数 类型 必填 说明
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 } 在线调试 (opens new window)
请求包体:

{
    "cm_waiqin_365_id": "4819212417121810405",
    "code": "CUS888888",
    "source_code": "8259172096596891009"
}

参数说明:

参数 类型 必填 说明
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) 来源于第三方系统的客户唯一标识