客户联系人信息接口

新增客户联系人信息

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

{
   "linkmans": [
        {
            "waiqin365_customer_id":"5896092306461054419",
            "linkman_id":"20190417001",
            "linkman": "张三",
            "linkman_job": "店主",
            "linkman_mobile": "13052125555",
            "linkman_office_tel": "52365895",
            "linkman_fax": "25758545",
            "linkman_sex": "M",
            "linkman_birthday": "1992-10-13",
            "linkman_email": "1259612641@qq.com",
            "linkman_remarks": "测试测试测试",
            "linkman_main": "1",
            "linkman_qq": "qq",
            "linkman_weixin": "微信",
            "linkman_dept": "部门",
            "linkman_intimacy":"一星",
            "linkman_importance":"二星",
            "linkman_decision_relationship":"使用人",
            "exts":[
                      {
                        "linkman_ext_key":"自定义文本框",
                        "linkman_ext_value":"测试用"
                      },{
                        "linkman_ext_key":"自定义",
                        "linkman_ext_value":"测试用"
                      }],
            "open_cus_account": "1",
            "cus_acc_roles": "老板(门店),员工(门店)"
        },{
            "waiqin365_customer_id":"5896092306461054419",
            "linkman_id":"20190417002",
            "linkman": "李四",
            "linkman_job": "店主",
            "linkman_mobile": "13052125555",
            "linkman_office_tel": "52365895",
            "linkman_fax": "25758545",
            "linkman_sex": "M",
            "linkman_birthday": "1992-10-13",
            "linkman_email": "1259612641@qq.com",
            "linkman_remarks": "测试测试测试",
            "linkman_main": "0",
            "linkman_qq": "qq",
            "linkman_weixin": "微信",
            "linkman_dept": "部门"
        }
    ]
}

参数说明:

参数 类型 必填 说明
customer_id VARCHAR(100) 客户唯一标识,来源于第三方系统的唯一客户标识,有效字符详见附录:有效字符说明
waiqin365_customer_id VARCHAR(100) 外勤365客户唯一标识,当customer_idwaiqin365_customer_id同时传入,以本字段为准
linkman_id VARCHAR(32) 联系人唯一ID,来源于第三方。有效字符详见附录:有效字符说明
linkman VARCHAR(32) 联系人姓名
linkman_job VARCHAR(32) 联系人职务
linkman_mobile VARCHAR(32) 联系人手机号
linkman_fax VARCHAR(32) 联系人传真, 如:02544550010
linkman_office_tel VARCHAR(32) 联系人固定电话, 如:02544550010
linkman_sex VARCHAR(1) 联系人性别,M:男 F:女 默认M
linkman_birthday timestamp 联系人生日
linkman_email VARCHAR(100) 联系人电子邮件
linkman_remarks VARCHAR(4000) 联系人备注
linkman_qq VARCHAR(100) 联系人QQ
linkman_weixin VARCHAR(100) 联系人微信
linkman_dept VARCHAR(200) 联系人部门
linkman_main VARCHAR(1) 是否为主联系人,0-否 1-是,默认值:0
linkman_intimacy VARCHAR(100) 联系人亲密度,必须是系统预定义值
linkman_importance VARCHAR(100) 联系人重要程度,必须是系统预定义值
linkman_decision_relationship VARCHAR(100) 联系人决策关系,必须是系统预定义值
exts[].linkman_ext_key VARCHAR(100) 联系人信息扩展字段key值,联系人信息扩展字段需先在外勤365系统客户管理中创建自定义字段。
exts[].linkman_ext_value VARCHAR(4000) 联系人信息扩展字段value值
open_cus_account VARCHAR(1) 是否开通客户账号,1 开通客户账号 0 不开通客户账号;可以不传,不传表示不开通客户账号
cus_acc_roles VARCHAR(4000) 客户账号角色名称,有多个角色用逗号隔开;如果是否开通客户账号的值传"是",则此字段不能为空

返回结果:

{
    "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/linkman/v1/modifyLinkman/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
   "linkmans": [
        {
        	"waiqin365_customer_id":"5896092306461054419",
        	"linkman_id":"20190417001",
            "linkman": "张三001",
            "linkman_job": "店主",
            "linkman_mobile": "15051846373",
            "linkman_office_tel": "52365895",
            "linkman_fax": "25758545",
            "linkman_sex": "M",
            "linkman_birthday": "1992-10-13",
            "linkman_email": "259612641@qq.com",
            "linkman_remarks": "测试测试测试",
            "linkman_main": "1",
            "linkman_qq": "qq",
            "linkman_weixin": "微信",
            "linkman_dept": "部门",
            "linkman_intimacy":"一星",
            "linkman_importance":"二星",
            "linkman_decision_relationship":"使用人",
              "exts":[
              {
                "linkman_ext_key":"自定义文本框",
                "linkman_ext_value":"测试用"
              },{
                "linkman_ext_key":"自定义",
                "linkman_ext_value":"测试用"
              }],
            "open_cus_account": "1",
            "cus_acc_roles": "老板(门店),员工(门店)"
        },{
        	"waiqin365_customer_id":"5896092306461054419",
        	"linkman_id":"20190417002",
            "linkman": "李四002",
            "linkman_job": "店主",
            "linkman_mobile": "15065556821",
            "linkman_office_tel": "52365895",
            "linkman_fax": "25758545",
            "linkman_sex": "M",
            "linkman_birthday": "1992-10-13",
            "linkman_email": "259612641@qq.com",
            "linkman_remarks": "测试测试测试",
            "linkman_main": "1",
            "linkman_qq": "qq",
            "linkman_weixin": "微信",
            "linkman_dept": "部门",
            "open_cus_account": "0"
        }
    ]
}

参数说明:

参数 类型 必填 说明
linkman_id VARCHAR(32) 联系人唯一标识,来源于第三方联系人ID
waiqin365_linkman_id VARCHAR(32) 外勤365联系人唯一ID,若linkman_id与waiqin365_linkman_id同时传入,以本字段为准。
customer_id VARCHAR(32) 外勤365客户唯一ID,来源于第三方客户唯一ID
waiqin365_customer_id VARCHAR(32) 外勤365客户唯一ID,若customer_idwaiqin365_customer_id同时传入,以本字段为准。
linkman_status VARCHAR(1) 联系人状态,0删除、1正常
linkman_job VARCHAR(32) 联系人职务
linkman_mobile VARCHAR(32) 联系人手机号
linkman_office_tel VARCHAR(32) 联系人固定电话
linkman_fax VARCHAR(32) 联系人传真
linkman_email VARCHAR(100) 联系人电子邮件
linkman_sex VARCHAR(1) 联系人性别F女性 M 男性,默认值“M”
linkman_birthday timestamp 联系人生日
linkman_qq VARCHAR(100) 联系人qq
linkman_weixin VARCHAR(100) 联系人微信
linkman_dept VARCHAR(200) 联系人部门
linkman_remarks VARCHAR(4000) 联系人备注
linkman VARCHAR(100) 联系人名称
linkman_main VARCHAR(1) 是否为主联系人,0-否 1-是,默认值:0
linkman_intimacy VARCHAR(100) 联系人亲密度,必须是系统预定义值
linkman_importance VARCHAR(100) 联系人重要程度,必须是系统预定义值
linkman_decision_relationship VARCHAR(100) 联系人决策关系,必须是系统预定义值exts[].linkman_ext_key
exts[].linkman_ext_value VARCHAR(4000) 联系人信息扩展字段value值
open_cus_account VARCHAR(1) 是否开通客户账号,1 开通客户账号 0 不开通客户账号;可以不传,不传表示不开通客户账号
cus_acc_roles VARCHAR(4000) 客户账号角色名称,有多个角色用逗号隔开;如果是否开通客户账号的值传"是",则此字段不能为空

返回结果:

{
    "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/linkman/v1/removeLinkman/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
     "linkman_id": "CM0001",
     "waiqin365_linkman_id":"786272764026566666"
}

参数说明:

参数 类型 必填 说明
linkman_id VARCHAR(32) 来源于第三方系统联系人唯一标识
waiqin365_linkman_id VARCHAR(32) 外勤365联系人唯一标识,若linkman_idh和waiqin365_linkman_id同时传入,以本字段为准

返回结果:

{
    "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/linkman/v1/queryLinkman/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求包体:

{
    "waiqin365_customer_id": "8584076849528596666",
    "linkman_id": "CM001",
    "waiqin365_linkman_id": "8584076849528595560",
    "linkman_status": "1",
    "linkman": "大型超市",
    "linkman_job": "华中大区,南京分区,秦淮社区",
    "linkman_mobile": "150622123456",
    "linkman_office_tel": "25758545",
    "linkman_fax":"25758545",
    "linkman_email":"qq",
    "linkman_weixin":"weixin",
    "linkman_dept":"开发"
}

参数说明:

参数 类型 必填 说明
waiqin365_customer_id VARCHAR(32) 外勤365客户ID
linkman_id VARCHAR(100) 客户联系人唯一ID,来源于第三方系统的客户联系人唯一标识
waiqin365_linkman_id VARCHAR(100) 外勤365客户联系人唯一ID
linkman_status VARCHAR(100) 联系人状态
linkman VARCHAR(1) 联系人名称
linkman_job VARCHAR(1) 联系人职务
linkman_mobile VARCHAR(10) 联系人手机号
linkman_office_tel VARCHAR(10) 联系人固定电话, 如:02544550010
linkman_fax VARCHAR(19) 联系人传真, 如:02544550010
linkman_email VARCHAR(19) 联系人电子邮件
linkman_qq VARCHAR(19) 联系人qq
linkman_weixin VARCHAR(19) 联系人微信
linkman_dept VARCHAR(19) 联系人部门
create_date_start VARCHAR(19) 创建日期开始时间,格式:“yyyy-MM-dd HH:mm:ss”
create_date_end VARCHAR(19) 创建日期开始时间,格式:“yyyy-MM-dd HH:mm:ss”
modify_date_start VARCHAR(19) 修改日期开始时间,格式:“yyyy-MM-dd HH:mm:ss”
modify_date_end VARCHAR(19) 修改日期开始时间,格式:“yyyy-MM-dd HH:mm:ss”

返回结果:

{
    "return_code": "0", 
    "return_msg": "响应信息",
    "msg_id": "{ msg_id }",
    "response_data": "<<DATA>>"
}

数据DATA示例:

[
        {
            "linkmans": [
                {
                    "linkman": "张三",
                    "linkman_job": "店主",
                    "linkman_mobile": "13052125555",
                    "linkman_office_tel": "52365895",
                    "linkman_fax": "25758545",
                    "linkman_sex": "M",
                    "linkman_birthday": "1980-02-06",
                    "linkman_email": "abc@163.com",
                    "linkman_remarks": "",
                    "linkman_main": "1",
                    "linkman_qq": "qq",
                    "linkman_weixin": "微信",
                    "linkman_dept": "部门",
                    "open_cus_acc": "1",
                    "cus_acc_roles": "老板,员工",
                    "linkman_intimacy":"一星",
                    "linkman_importance":"二星",
                    "linkman_decision_relationship":"使用人",
                      "exts": [
                        {
                            "linkman_ext_key": "级别",
                            "linkman_ext_value": "四星"
                        },
                        {
                            "linkman_ext_key": "主营商品",
                            "linkman_ext_value": "食品,电器,日化用品"
                        }
                    ]
                },
                {
                    "linkman": "李四",
                    "linkman_job": "店员",
                    "linkman_mobile": "13022215212",
                    "linkman_office_tel": "58755254",
                    "linkman_fax": "",
                    "linkman_sex": "F",
                    "linkman_birthday": "1981-02-14",
                    "linkman_email": "",
                    "linkman_remarks": "",
                    "linkman_main": "0",
                    "exts": [
                        {
                            "linkman_ext_key": "级别",
                            "linkman_ext_value": "四星"
                        },
                        {
                            "linkman_ext_key": "主营商品",
                            "linkman_ext_value": "食品,电器,日化用品"
                        }
                    ]
                }
            ]
        }
    ]

参数说明:

参数 类型 必填 说明
linkman VARCHAR(100) 联系人名称
waiqin365_linkman_id VARCHAR(32) 外勤365联系人唯一ID
waiqin365_customer_id VARCHAR(32) 外勤365客户ID
linkman_job VARCHAR(32) 联系人职务
linkman_mobile VARCHAR(32) 联系人手机号
linkman_office_tel VARCHAR(32) 联系人固定电话
linkman_fax VARCHAR(32) 联系人传真
linkman_sex VARCHAR(1000) 联系人性别F女性 M 男性,默认值“M”
linkman_birthday timestamp 联系人生日
linkman_email VARCHAR(10) 联系人电子邮箱
linkman_remarks VARCHAR(1000) 联系人备注
linkman_main VARCHAR(1) 是否为主联系人,0-否 1-是,默认值:0
linkman_qq VARCHAR(32) 联系人qq
linkman_weixin VARCHAR(100) 联系人微信
open_cus_acc VARCHAR(100) 是否开通客户账号
cus_acc_roles VARCHAR(4000) 客户账号角色名称,多个角色用逗号隔开
linkman_dept VARCHAR(32) 联系人部门
linkman_status VARCHAR(1) 联系人状态
linkman_create_time timestamp 创建时间
linkman_creator_id VARCHAR(32) 创建人id
linkman_modify_time timestamp 修改时间
linkman_modifyier_id VARCHAR(32) 修改人id
linkman_intimacy VARCHAR(100) 联系人亲密度
linkman_importance VARCHAR(100) 联系人重要程度
linkman_decision_relationship VARCHAR(100) 联系人决策关系
exts[].linkman_ext_key VARCHAR(100) 联系人信息扩展字段key值,联系人信息扩展字段需先在外勤365系统客户管理中创建自定义字段。
exts[].linkman_ext_value VARCHAR(4000) 联系人信息扩展字段value值

推送客户联系人信息

客户/门店/经销商的联系人信息发生变化时向第三方系统推送数据 请求方式: POST(HTTPS
请求地址: 第三方服务接口URL

dataType=cm_linkman

[
  {
    "waiqin365_customer_id":"8987154180832428625",
    "waiqin365_linkman_id": "6974532596418213933",
    "linkman_main": "1",
    "linkman": "kktest2",
    "linkman_job": "",
    "linkman_status": "3",
    "linkman_mobile": "12345678912",
    "linkman_office_tel": "12345678912",
    "linkman_fax": "233",
    "linkman_sex": "M",
    "linkman_birthday": "2018-02-01",
    "linkman_email": "234.qq.com",
    "linkman_remarks": "212",
    "linkman_qq": "234",
    "linkman_weixin": "234",
    "linkman_dept": "1",
    "status": "1"
  }
]

参数说明:

参数 类型 必填 说明
waiqin365_customer_id VARCHAR(4000) 客户ID
waiqin365_linkman_id VARCHAR(4000) 联系人ID
linkman_main VARCHAR(4000) 是否主联系人,可选值:0否 1是 ,此字段默认为“0
linkman VARCHAR(32) 联系人姓名
linkman_job VARCHAR(32) 联系人职务
linkman_status VARCHAR(32) 联系人状态
linkman_mobile VARCHAR(32) 联系人手机号
linkman_office_tel VARCHAR(32) 固定电话
linkman_fax VARCHAR(32) 联系人传真
linkman_sex VARCHAR(32) 联系人性别F女性 M 男性,默认值“M”
linkman_birthday timestamp 联系人生日
linkman_email VARCHAR(10) 电子邮件
linkman_remarks VARCHAR(1000) 备注
linkman_qq VARCHAR(32) QQ号
linkman_weixin VARCHAR(100) 微信号
linkman_dept VARCHAR(32) 部门
status VARCHAR(32) 状态,0逻辑删除,1未删除

返回结果:

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

参数说明:

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