客户收货方关系维护接口

客户收货方关系维护接口

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/customer/v1/maintainCmReceiverRelation/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
    "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) 第三方系统客户唯一标识,cm_id、cm_waiqin_365_id、cm_code不能都为空;
cm_waiqin_365_id VARCHAR(100) 客户外勤365唯一标识
cm_code VARCHAR(32) 客户编码,有效字符详见附录:有效字符说明
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) 收货方第三方系统客户唯一标识
cm_receive_info[].cm_code VARCHAR(32) 收货方编码,有效字符详见附录:有效字符说明

返回结果:

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

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

客户收货方关系查询接口

根据收货方客户查询发货方客户

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/customer/v1/queryCmReceiverRelation/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
    "code": "CUS888888"
}

参数说明:

参数 类型 必填 说明
code VARCHAR(32) 客户编码;

返回结果:

{
     "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) 客户第三方唯一标识编码,来源于第三方系统的唯一标识