# 经销商接口

# 新增经销商

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

{
    "dealer_id": "CM0001",
    "dealer_name": "苏果夫子庙店",
    "dealer_code": "suguo_fzmd",
    "dealer_manager": "王伟,张强,吴为",
    "dealer_manager_id": "emp001,emp002",
    "dealer_type": "大型超市",
    "dealer_district": "华中大区,南京分区,秦淮社区",
    "dealer_mss_province": "江苏省",
    "dealer_mss_city": "南京市",
    "dealer_mss_area": "秦淮区",
    "dealer_mss_street": "红花街道",
    "dealer_addr": "南京市秦淮区大全福巷1号",
    "dealer_delivery_addr": "南京市秦淮区大四福巷10号",
    "dealer_cooperate_status": "1",
    "upper_dealer": "苏果新街口店,苏果新街口店1",
    "upper_dealer_id": "JXS000002,4733134010386056744",
    "waiqin365_upper_dealer_id": "8405948870317782484,4886249304887989140",
    "dealer_source": "老经销商介绍",
    "dealer_trade": "服务业",
    "dealer_scale": "200人以上",
    "dealer_tel": "02552416854",
    "dealer_fax": "02552416854",
    "dealer_post": "210010",
    "dealer_remarks": "",
    "dealer_label": "标签1,标签2",
    "dealer_assistant_id": "7053012386494123505,6954172928161735690",
    "dealer_assistant_name": "张三,李四",
    "dealer_road_msg": "道路信息",
    "dealer_house_number": "门牌号信息",
    "dealer_liscence_name": "营业执照信息",
    "dealer_registration_no": "工商注册号信息",
    "dealer_registration_date": "2019-10-21",
    "dealer_operator": "经营者信息",
    "dealer_location":"13.6541,86.6656",
    "dealer_sale_direct": "是",
    "deliverys": [
        {
            "dealer_ delivery_main": "1",
            "dealer_delivery_name": "张三",
            "dealer_delivery_main": "0",
            "dealer_delivery_tel": "52365895",
            "dealer_delivery_phone": "13052125555",
            "dealer_delivery_addr": "南京路XXXX号",
            "dealer_delivery_ex1":"",
            "dealer_delivery_ex2":"",
            "dealer_delivery_ex3":"",
            "dealer_delivery_id":"nw001"
        }
    ],
    "linkmans": [
        {
            "dealer_linkman_name": "张三",
            "dealer_linkman_job": "店主",
            "dealer_linkman_mobile": "13052125555",
            "dealer_linkman_office_tel": "52365895",
            "dealer_linkman_fax": "25758545",
            "dealer_linkman_sex": "M",
            "dealer_linkman_birthday": "1980-02-06",
            "dealer_linkman_email": "abc@163.com",
            "dealer_linkman_remarks": "",
            "dealer_linkman_main": "1",
            "dealer_linkman_intimacy":"一星",
            "dealer_linkman_importance":"重要",
            "dealer_linkman_decision_relationship":"决策人",
            "dealer_linkman_id":"nw001"
        },
        {
            "dealer_linkman_name": "李四",
            "dealer_linkman_job": "店员",
            "dealer_linkman_mobile": "13022215212",
            "dealer_linkman_office_tel": "58755254",
            "dealer_linkman_fax": "",
            "dealer_linkman_sex": "F",
            "dealer_linkman_birthday": "1981-02-14",
            "dealer_linkman_email": "",
            "dealer_linkman_remarks": "",
            "dealer_linkman_main": "0",
            "dealer_linkman_intimacy":"一星",
            "dealer_linkman_importance":"重要",
            "dealer_linkman_decision_relationship":"决策人",
            "dealer_linkman_id":"nw002"
        }
    ],
    "exts": [
        {
            "dealer_ext_key": "级别",
            "dealer_ext_value": "四星"
        },
        {
            "dealer_ext_key": "主营商品",
            "dealer_ext_value": "食品,电器,日化用品"
        }
    ],
     "dealer_receive_info":[
           {
               "dealer_id": "zt001",
               "dealer_waiqin_365_id": "98000123465333545",
               "dealer_code": "zt001"
           }
     ]  
}

参数说明:

参数 类型 必填 说明
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID
dealer_name VARCHAR(100) 经销商名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
dealer_code VARCHAR(32) 经销商编码,唯一,有效字符详见附录:有效字符说明 (opens new window)
dealer_manager_id VARCHAR(4000) 经销商客户经理唯一标识,多客户经理唯一标识间以“,”分隔。来源于第三方系统的员工唯一标识,和员工信息中emp_id对应。 如:EMP0001, EMP0002, EMP0003
dealer_manager_waiqin365_id VARCHAR(4000) 经销商客户经理唯一标识,多客户经理唯一标识间以“,”分隔。dealer_manager_id、dealer_manager、dealer_manager_waiqin365_id如果同时存在优先取dealer_manager_waiqin365_id
dealer_manager VARCHAR(4000) 经销商客户经理名称。多客户经理名称间以“,”分隔。dealer_manager_id、dealer_manager、dealer_manager_waiqin365_id如果同时存在优先取dealer_manager_waiqin365_id。如:张三,李四,王五。
dealer_type_code VARCHAR(100) 经销商类型编码
dealer_type VARCHAR(100) 经销商类型名称,dealer_type、dealer_type_code如果同时存在优先取dealer_type_code
dealer_district_waiqin365_id VARCHAR(32) 经销商所属销售区域ID,来源于外勤365的销售区域唯一ID。
dealer_district VARCHAR(1000) 经销商销售区域,此字段需要销售区域的完整层级结构, 多层级间以“,”分隔。dealer_district、dealer_district_waiqin365_id如果同时存在优先取dealer_district_waiqin365_id。如:华中大区,南京分区,秦淮社区
dealer_dept_waiqin365_id VARCHAR(32) 经销商所属部门ID,来源于外勤365部门唯一ID
dealer_dept_id VARCHAR(32) 经销商所属部门唯一标识,来源于第三方系统的部门唯一标识和部门信息中org_id对应,dealer_dept_id、dealer_dept_waiqin365_id如果同时存在优先取dealer_dept_waiqin365_id
dealer_mss_province VARCHAR(32) 经销商所属行政区域-省名称,如是直辖市,省和市请传一样的值。
dealer_mss_city VARCHAR(32) 经销商所属行政区域-市名称,如是直辖市,省和市请传一样的值。
dealer_mss_area VARCHAR(32) 经销商所属行政区域-县名称,如是直筒子市,市和县请传一样的值。
dealer_mss_street VARCHAR(32) 经销商所属行政区域-乡镇街道名称
dealer_addr VARCHAR(4000) 经销商地址
dealer_delivery_addr VARCHAR(4000) 经销商送货地址
dealer_cooperate_status CHAR(1) 合作状态, 0-终止合作 1-合作中, 2-未合作, 3-有意向
dealer_cooperate_status_name VARCHAR(32) 合作状态:终止合作/合作中/未合作/有意向/{自定义的},dealer_cooperate_status_name、dealer_cooperate_status如果同时存在优先取dealer_cooperate_status
waiqin365_upper_dealer_id VARCHAR(100) 上级经销商ID,来源于外勤365的经销商唯一ID,支持多个,优先次序(1.上级经销商IDwaiqin365_upper_dealer_id,2.上级经销商第三方唯一标识uper_dealer_id,3.上级经销商名称upper_dealer)
upper_dealer_id VARCHAR(100) 上级经销商标识,来源第三方系统的经销商唯一标识,支持多个,优先次序(1.上级经销商IDwaiqin365_upper_dealer_id,2.上级经销商第三方唯一标识uper_dealer_id,3.上级经销商名称upper_dealer)
upper_dealer VARCHAR(100) 上级经销商名称,支持多个
dealer_level VARCHAR(100) 经销商级别名称
dealer_source VARCHAR(100) 经销商来源
dealer_trade VARCHAR(100) 经销商行业
dealer_scale VARCHAR(100) 经销商人员规模
dealer_tel VARCHAR(32) 经销商电话, 如:02544550010或025-44550010
dealer_fax VARCHAR(32) 经销商传真, 如:02544550010或025-44550010
dealer_post VARCHAR(32) 经销商邮编
dealer_remarks VARCHAR(4000) 经销商备注
dealer_label VARCHAR(4000) 经销商标签名称。多标签以“,”分隔
dealer_assistant_id VARCHAR(4000) 经销商协助员唯一标识。多唯一标识以“,”分隔,来源于外勤365员工唯一标识。dealer_assistant_id、dealer_assistant_name如果同时存在优先取dealer_assistant_id
dealer_assistant_name VARCHAR(4000) 经销商协助员名称。多协助员以“,”分隔
dealer_road_msg VARCHAR(4000) 经销商道路信息。
dealer_house_number VARCHAR(4000) 经销商门牌号信息。
dealer_liscence_name VARCHAR(4000) 经销商营业执照信息。
dealer_registration_no VARCHAR(4000) 经销商工商注册号信息。
dealer_registration_date VARCHAR(32) 经销商注册日期。格式“yyyy-MM-dd”
dealer_operator VARCHAR(4000) 经销商经营者信息。
dealer_location VARCHAR(100) 经销商纬经度。坐标格式为"纬度,经度",如:28.153774,112.986099
dealer_sale_direct VARCHAR(1) 是否直接交易客户。只能填写“是”、“否”
dealer_linkman_full_sync VARCHAR(1) 经销商联系人全量同步标识,需要使用,传1,将以接口中数据覆盖系统中数据;如无需使用,不传任何值。
dealer_delivery_full_sync VARCHAR(1) 经销商收货地址全量同步标识,需要使用,传1,将以接口中数据覆盖系统中数据;如无需使用,不传任何值。
linkmans[]
.dealer_linkman_name
VARCHAR(100) 经销商联系人名称
linkmans[]
.dealer_linkman_job
VARCHAR(32) 经销商联系人职务
linkmans[]
.dealer_linkman_mobile
VARCHAR(32) 经销商联系人手机
linkmans[]
.dealer_linkman_office_tel
VARCHAR(32) 经销商联系人固定电话, 如:02544550010或025-44550010
linkmans[]
.dealer_linkman_fax
VARCHAR(32) 经销商联系人传真, 如:02544550010或025-44550010
linkmans[]
.dealer_linkman_sex
VARCHAR(1) 经销商联系人性别F女性 M 男性,默认值“M”
linkmans[]
.dealer_linkman_birthday
timestamp 经销商联系人生日
linkmans[]
.dealer_linkman_email
VARCHAR(100) 经销商联系人电子邮件
linkmans[]
.dealer_linkman_remarks
VARCHAR(4000) 经销商联系人备注
linkmans[]
.dealer_linkman_main
VARCHAR(1) 经销商联系人是否为主联系人可选值: 0否 1是当存在经销商联系人信息时, 此字段默认为“0”
linkmans[]
.dealer_linkman_qq
VARCHAR(100) 经销商联系人qq
linkmans[]
.dealer_linkman_weixin
VARCHAR(100) 经销商联系人微信
linkmans[]
.dealer_linkman_dept
VARCHAR(200) 经销商联系人部门
linkmans[]
.dealer_linkman_intimacy
VARCHAR(200) 经销商联系人亲密度
linkmans[]
.dealer_linkman_importance
VARCHAR(200) 经销商联系人重要程度
linkmans[]
.dealer_linkman
_decision_relationship
VARCHAR(200) 经销商联系人决策关系
linkmans[]
.dealer_linkman_id
VARCHAR(100) 经销商联系人第三方id,来源于第三方唯一标识,校验唯一性
exts[].dealer_ext_key VARCHAR(100) 经销商扩展字段key值, 经销商扩展字段需先在我方系统经销商管理中创建
exts[].dealer_ext_value VARCHAR(4000) 经销商扩展字段value值对多个选项值,以“,”分隔拼接。
deliverys[].dealer_delivery_main VARCHAR(1) 是否为默认收获地址,0-否 1-是,默认值:0
deliverys[]
.dealer_delivery_name
VARCHAR(32) 收货人名称
deliverys[]
.dealer_delivery_tel
VARCHAR(32) 收货电话
deliverys[]
.dealer_delivery_phone
VARCHAR(32) 收货手机号
deliverys[]
.dealer_delivery_addr
VARCHAR(4000) 收货地址
deliverys[]
.dealer_delivery_ex1
VARCHAR(200) 收货地址扩展字段1
deliverys[]
.dealer_delivery_ex2
VARCHAR(200) 收货地址扩展字段2
deliverys[]
.dealer_delivery_ex3
VARCHAR(200) 收货地址扩展字段3
deliverys[]
.dealer_delivery_id
VARCHAR(100) 收货地址第三方唯一标识,校验唯一性
dealer_receive_info[]
.dealer_id
VARCHAR(32) 经销商收货方唯一标识,来源于第三方系统的唯一客户标识,dealer_id、dealer_waiqin_365_id、dealer_code如果同时存在优先取dealer_waiqin_365_id
dealer_receive_info[]
.dealer_waiqin_365_id
VARCHAR(32) 经销商收货方对应的外勤365的id,dealer_id、dealer_waiqin_365_id、dealer_code如果同时存在优先取dealer_waiqin_365_id
dealer_receive_info[]
.dealer_code
VARCHAR(32) 经销商收货方编码,dealer_id、dealer_waiqin_365_id、dealer_code如果同时存在优先取dealer_waiqin_365_id

返回结果:

{
    "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/dealer/v1/modifyDealer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "dealer_id": "CM0001",
    "dealer_name": "苏果夫子庙店",
    "dealer_code": "suguo_fzmd",
    "dealer_manager": "王伟,张强,吴为",
    "dealer_manager_id": "emp001,emp002",
    "dealer_type": "大型超市",
    "dealer_district": "华中大区,南京分区,秦淮社区",
    "dealer_mss_province": "江苏省",
    "dealer_mss_city": "南京市",
    "dealer_mss_area": "秦淮区",
    "dealer_mss_street": "红花街道",
    "dealer_addr": "南京市秦淮区大全福巷1号",
    "dealer_delivery_addr": "南京市秦淮区大四福巷10号",
    "dealer_cooperate_status": "1",
    "dealer_source": "老经销商介绍",
    "dealer_trade": "服务业",
    "dealer_scale": "200人以上",
    "dealer_tel": "02552416854",
    "dealer_fax": "02552416854",
    "dealer_post": "210010",
    "dealer_remarks": "",
    "dealer_label": "标签1,标签2",
    "status": "1",
    "dealer_assistant_id": "7053012386494123505,6954172928161735690",
    "dealer_assistant_name": "张三,李四",
    "dealer_road_msg": "道路信息",
    "dealer_house_number": "门牌号信息",
    "dealer_liscence_name": "营业执照信息",
    "dealer_registration_no": "工商注册号信息",
    "dealer_registration_date": "2019-10-21",
    "dealer_operator": "经营者信息",
    "upper_dealer": "苏果新街口店,苏果新街口店1",
    "upper_dealer_id": "JXS000002,4733134010386056744",
    "waiqin365_upper_dealer_id": "8405948870317782484,4886249304887989140",
    "dealer_location": "28.153774,112.986099",
    "dealer_sale_direct": "是",
    "deliverys": [
        {
            "dealer_delivery_name": "张三",
            "dealer_delivery_main": "0",
            "dealer_delivery_tel": "52365895",
            "dealer_delivery_phone": "13052125555",
            "dealer_delivery_addr": "南京路XXXX号",
            "dealer_delivery_ex1":"",
            "dealer_delivery_ex2":"",
            "dealer_delivery_ex3":"",
            "dealer_delivery_id":"nw001"
        }
    ],
    "linkmans": [
        {
            "dealer_linkman_name": "张三",
            "dealer_linkman_job": "店主",
            "dealer_linkman_mobile": "13052125555",
            "dealer_linkman_office_tel": "52365895",
            "dealer_linkman_fax": "25758545",
            "dealer_linkman_sex": "M",
            "dealer_linkman_birthday": "1980-02-06",
            "dealer_linkman_email": "abc@163.com",
            "dealer_linkman_remarks": "",
            "dealer_linkman_main": "1",
            "dealer_linkman_intimacy":"一星",
            "dealer_linkman_importance":"重要",
            "dealer_linkman_decision_relationship":"决策人",
            "dealer_linkman_id":"nw001"
        },
        {
            "dealer_linkman_name": "李四",
            "dealer_linkman_job": "店员",
            "dealer_linkman_mobile": "13022215212",
            "dealer_linkman_office_tel": "58755254",
            "dealer_linkman_fax": "",
            "dealer_linkman_sex": "F",
            "dealer_linkman_birthday": "1981-02-14",
            "dealer_linkman_email": "",
            "dealer_linkman_remarks": "",
            "dealer_linkman_main": "0",
            "dealer_linkman_intimacy":"一星",
            "dealer_linkman_importance":"重要",
            "dealer_linkman_decision_relationship":"决策人",
            "dealer_linkman_id":"002"
        }
    ],
    "exts": [
        {
            "dealer_ext_key": "级别",
            "dealer_ext_value": "四星"
        },
        {
            "dealer_ext_key": "主营商品",
            "dealer_ext_value": "食品,电器,日化用品"
        }
    ],
      "dealer_receive_info":[
            {
                "dealer_id": "zt001",
                "dealer_waiqin_365_id": "98000123465333545",
                "dealer_code": "zt001"
            }
      ] 
}

参数说明:

参数 类型 必填 说明
dealer_waiqin_id VARCHAR(32) 外勤365的经销商唯一ID,和来源于第三方系统经销商唯一ID(dealer_id)作为更新数据的唯一标识,所以不能同时为空。dealer_waiqin_id、dealer_id如果同时存在优先取dealer_waiqin_id
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID,对应新增经销商 (dealer_id)字段,只有当数据来源于新增接口时才有值,如果数据从外勤365系统中直接创建则该字段值为空。 调用此接口时该字段值(dealer_id)和外勤365的经销商唯一ID(dealer_waiqin_id)作为更新数据的唯一标识,所以不能同时为空, 如果两个值同时存在则优先顺序为dealer_waiqin_iddealer_id
dealer_name VARCHAR(100) 经销商名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
dealer_code VARCHAR(32) 经销商编码,唯一,有效字符详见附录:有效字符说明 (opens new window)
dealer_manager_id VARCHAR(4000) 经销商客户经理唯一标识,多客户经理唯一标识间以“,”分隔。来源于第三方系统的员工唯一标识,和员工信息中emp_id对应。 如:EMP0001, EMP0002, EMP0003
dealer_manager_waiqin365_id VARCHAR(4000) 经销商客户经理唯一标识,多客户经理唯一标识间以“,”分隔。 dealer_manager_waiqin365_id、dealer_manager_id、dealer_manager如果同时存在优先取dealer_manager_waiqin365_id。
dealer_manager VARCHAR(4000) 经销商客户经理名称。多客户经理名称间以“,”分隔,如:张三,李四,王五。dealer_manager_waiqin365_id、dealer_manager_id、dealer_manager如果同时存在优先取dealer_manager_waiqin365_id
dealer_type_code VARCHAR(100) 经销商类型编码
dealer_type VARCHAR(100) 经销商类型名称,dealer_type、ealer_type_code如果同时存在优先取dealer_type_code
dealer_district_waiqin365_id VARCHAR(32) 经销商所属销售区域ID,来源于外勤365的客户销售区域唯一ID。
dealer_district VARCHAR(1000) 经销商所属销售区域,此字段需要销售区域的完整层级结构, 多层级间以“,”分隔,如:华中大区,南京分区,秦淮社区。dealer_district、dealer_district_waiqin365_id如果同时存在优先取dealer_district_waiqin365_id
dealer_dept_waiqin365_id VARCHAR(32) 经销商所属部门ID,来源于外勤365部门唯一ID
dealer_dept_id VARCHAR(32) 经销商所属部门唯一标识,来源于第三方系统的部门唯一标识和部门信息中org_id对应,dealer_dept_id、dealer_dept_waiqin365_id如果同时存在优先取dealer_dept_waiqin365_id
dealer_mss_province VARCHAR(32) 经销商所属行政区域-省名称,如是直辖市,省和市请传一样的值。
dealer_mss_city VARCHAR(32) 经销商所属行政区域-市名称,如是直辖市,省和市请传一样的值。
dealer_mss_area VARCHAR(32) 经销商所属行政区域-县名称,如是直筒子市,市和县请传一样的值。
dealer_mss_street VARCHAR(32) 经销商所属行政区域-乡镇街道名称
dealer_addr VARCHAR(4000) 经销商地址
dealer_delivery_addr VARCHAR(4000) 经销商送货地址
dealer_cooperate_status CHAR(1) 合作状态, 0-终止合作 1-合作中, 2-未合作, 3-有意向
dealer_cooperate_status_name VARCHAR(32) 合作状态:终止合作/合作中/未合作/有意向/{自定义的},dealer_cooperate_status_name、dealer_cooperate_status如果同时存在优先取dealer_cooperate_status
waiqin365_upper_dealer_id VARCHAR(100) 上级经销商ID,来源于外勤365的经销商唯一ID,支持多个,优先次序(1.上级经销商IDwaiqin365_upper_dealer_id,2.上级经销商第三方唯一标识uper_dealer_id,3.上级经销商名称upper_dealer)
upper_dealer_id VARCHAR(100) 上级经销商第三方唯一标识,来源第三方系统的经销商唯一标识,支持多个,优先次序(1.上级经销商IDwaiqin365_upper_dealer_id,2.上级经销商第三方唯一标识upper_dealer_id,3.上级经销商名称upper_dealer)
upper_dealer VARCHAR(100) 上级经销商名称,支持多个
dealer_level VARCHAR(100) 经销商级别名称
dealer_source VARCHAR(100) 经销商来源
dealer_trade VARCHAR(100) 经销商行业
dealer_scale VARCHAR(100) 经销商人员规模
dealer_tel VARCHAR(32) 经销商电话, 如:02544550010或025-44550010
dealer_fax VARCHAR(32) 经销商传真, 如:02544550010或025-44550010
dealer_post VARCHAR(32) 经销商邮编
dealer_remarks VARCHAR(4000) 经销商备注
dealer_label VARCHAR(4000) 经销商标签名称。多标签以“,”分隔
status VARCHAR(1) 经销商状态,1正常、0删除
dealer_assistant_id VARCHAR(4000) 经销商协助员唯一标识。多唯一标识以“,”分隔,来源于外勤365员工唯一标识。dealer_assistant_id、dealer_assistant_name如果同时存在优先取dealer_assistant_id
dealer_assistant_name VARCHAR(4000) 经销商协助员名称。多协助员以“,”分隔
dealer_road_msg VARCHAR(4000) 经销商道路信息。
dealer_house_number VARCHAR(4000) 经销商门牌号信息。
dealer_liscence_name VARCHAR(4000) 经销商营业执照信息。
dealer_registration_no VARCHAR(4000) 经销商工商注册号信息。
dealer_registration_date VARCHAR(32) 经销商注册日期。格式“yyyy-MM-dd”
dealer_operator VARCHAR(4000) 经销商经营者信息。
dealer_linkman_full_sync VARCHAR(1) 经销商联系人全量同步标识,需要使用,传1,将以接口中数据覆盖系统中数据;如无需使用,不传任何值。
dealer_delivery_full_sync VARCHAR(1) 经销商收货地址全量同步标识,需要使用,传1,将以接口中数据覆盖系统中数据;如无需使用,不传任何值。
dealer_location VARCHAR(100) 经销商纬经度。坐标格式为"纬度,经度",如:28.153774,112.986099
dealer_sale_direct VARCHAR(1) 是否直接交易客户。只能填写“是”、“否”
linkmans[]
.dealer_linkman_name
VARCHAR(100) 经销商联系人名称
linkmans[]
.dealer_linkman_job
VARCHAR(32) 经销商联系人职务
linkmans[]
.dealer_linkman_mobile
VARCHAR(32) 经销商联系人手机
linkmans[]
.dealer_linkman_office_tel
VARCHAR(32) 经销商联系人固定电话, 如:02544550010或025-44550010
linkmans[]
.dealer_linkman_fax
VARCHAR(32) 经销商联系人传真, 如:02544550010或025-44550010
linkmans[]
.dealer_linkman_sex
VARCHAR(1) 经销商联系人性别F女性 M 男性,默认值“M”
linkmans[]
.dealer_linkman_birthday
timestamp 经销商联系人生日
linkmans[]
.dealer_linkman_email
VARCHAR(100) 经销商联系人电子邮件
linkmans[]
.dealer_linkman_remarks
VARCHAR(4000) 经销商联系人备注
linkmans[]
.dealer_linkman_main
VARCHAR(1) 经销商联系人是否为主联系人可选值: 0否 1是当存在经销商联系人信息时, 此字段默认为“0”
linkmans[]
.dealer_linkman_qq
VARCHAR(100) 经销商联系人qq
linkmans[]
.dealer_linkman_weixin
VARCHAR(100) 经销商联系人微信
linkmans[]
.dealer_linkman_dept
VARCHAR(200) 经销商联系人部门
linkmans[]
.dealer_linkman_intimacy
VARCHAR(200) 经销商联系人亲密度
linkmans[]
.dealer_linkman_importance
VARCHAR(200) 经销商联系人重要程度
linkmans[]
.dealer_linkman
_decision_relationship
VARCHAR(200) 经销商联系人决策关系
linkmans[]
.dealer_linkman_id
VARCHAR(100) 经销商联系人第三方id,来源于第三方唯一标识,校验唯一性
exts[].dealer_ext_key VARCHAR(100) 经销商扩展字段key值, 经销商扩展字段需先在我方系统经销商管理中创建。
exts[].dealer_ext_value VARCHAR(4000) 经销商扩展字段value值对多个选项值,以“,”分隔拼接。
deliverys[]
.dealer_delivery_main
VARCHAR(1) 是否为默认收获地址,0-否 1-是,默认值:0
deliverys[]
.dealer_delivery_name
VARCHAR(32) 收货人名称
deliverys[]
.dealer_delivery_tel
VARCHAR(32) 收货电话
deliverys[]
.dealer_delivery_phone
VARCHAR(32) 收货手机号
deliverys[]
.dealer_delivery_addr
VARCHAR(200) 收货地址
deliverys[]
.dealer_delivery_ex1
VARCHAR(200) 收货地址扩展字段1
deliverys[]
.dealer_delivery_ex2
VARCHAR(200) 收货地址扩展字段2
deliverys[]
.dealer_delivery_ex3
VARCHAR(200) 收货地址扩展字段3
deliverys[]
.dealer_delivery_id
VARCHAR(100) 收货地址第三方唯一标识,校验唯一性
dealer_receive_info[]
.dealer_id
VARCHAR(32) 经销商收货方唯一标识,来源于第三方系统的唯一客户标识,dealer_id、dealer_waiqin_365_id、dealer_code如果同时存在优先取dealer_waiqin_365_id
dealer_receive_info[]
.dealer_waiqin_365_id
VARCHAR(32) 经销商收货方对应的外勤365的id,dealer_id、dealer_waiqin_365_id、dealer_code如果同时存在优先取dealer_waiqin_365_id
dealer_receive_info[]
.dealer_code
VARCHAR(32) 经销商收货方编码,dealer_id、dealer_waiqin_365_id、dealer_code如果同时存在优先取dealer_waiqin_365_id

返回结果:

{
    "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/dealer/v1/removeDealer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试 (opens new window)
请求包体:

{
    "dealer_id": "dealer0001"
}

参数说明:

参数 类型 必填 说明
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID,对应新增经销商 (dealer_id)字段,只有当数据来源于新增接口时才有值,如果数据从外勤365系统中直接创建则该字段值为空

返回结果:

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

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 查询经销商

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

{
    "page_number": "1",
    "dealer_id": "CM0001",
    "dealer_name": "苏果夫子庙店",
    "dealer_code": "suguo_fzmd",
    "dealer_type": "大型超市",
    "dealer_district": "华中大区,南京分区,秦淮社区",
    "create_date": "2015-05-12",
    "modify_date": "2015-05-12",
    "after_create_date": "2015-05-10 16:18:33",
    "after_modify_date": "2015-05-10 16:18:33",
    "before_create_date": "2015-05-14 22:18:22",
    "before_modify_date": "2015-05-14 22:18:22",
    "dealer_manager_id": "5973487364548349847"
}

参数说明:

参数 类型 必填 说明
page_number INT 分页页码,默认1
status CHAR(1) 记录状态:0 已删除 1 正常
id VARCHAR(32) 外勤365的经销商唯一ID
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID,对应新增经销商 (dealer_id)字段,只有当数据来源于新增接口时才有值,如果数据从外勤365系统中直接创建则该字段值为空
dealer_name VARCHAR(100) 经销商名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
dealer_code VARCHAR(32) 经销商编码,有效字符详见附录:有效字符说明 (opens new window)
dealer_manager_id VARCHAR(4000) 根据经销商客户经理唯一标识精确查询。
dealer_type VARCHAR(100) 根据经销商类型名称查询
after_create_date CHAR(19) 创建时间之后,格式:“yyyy-MM-dd HH:mm:ss”
after_modify_date CHAR(19) 更新时间之后,格式:“yyyy-MM-dd HH:mm:ss”
before_create_date CHAR(19) 创建时间之前,格式:“yyyy-MM-dd HH:mm:ss”
before_modify_date CHAR(19) 更新时间之前,格式:“yyyy-MM-dd HH:mm:ss”
create_date CHAR(10) 创建日期,格式:“yyyy-MM-dd”
modify_date CHAR(10) 修改日期,格式:“yyyy-MM-dd”
dealer_district VARCHAR(1000) 经销商所属销售区域,此字段需要销售区域的完整层级结构, 多层级间以“,”分隔。如:华中大区,南京分区,秦淮社区

返回结果:

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

数据DATA示例:

[
        {
            "id": "7863150652620035205",
            "dealer_id": "CM0001",
            "dealer_name": "苏果夫子庙店",
            "dealer_code": "suguo_fzmd",
            "dealer_manager": "王伟,张强,吴为",
            "dealer_district": "华中大区,南京分区,秦淮社区",
            "dealer_type": "大型超市",
            "dealer_mss_province": "江苏省",
            "dealer_mss_city": "南京市",
            "dealer_mss_area": "秦淮区",
            "dealer_addr": "南京市秦淮区大全福巷1号",
            "dealer_delivery_addr": "南京市秦淮区大四福巷10号",
            "dealer_cooperate_status": "1",
            "upper_dealer": "苏果新街口店,苏果新街口店1",
            "upper_dealer_id": "JXS000002,4733134010386056744",
            "waiqin365_upper_dealer_id": "8405948870317782484,4886249304887989140",
            "dealer_source": "老经销商介绍",
            "dealer_trade": "服务业",
            "dealer_scale": "200人以上",
            "dealer_tel": "02552416854",
            "dealer_fax": "02552416854",
            "dealer_post": "210010",
            "dealer_remarks": "",
            "dealer_cooperate_status_id": "2",
            "dealer_level_id": "7287736961434231483",
            "dealer_level": "二级客户",
            "dealer_approval_status":"1",
            "tradingarea_big ":"核心区域",
            "tradingarea":"新街口",
            "create_time":"2017-08-08 12:22:56",
            "dealer_district_id":"6081235751236711020",
            "dealer_district_waiqin365_id":"6081235751236765420",
            "dealer_third_district_id":"6081235751236711123",
            "dealer_district_create_time":"2017-09-09 13:14:11",
            "dealer_district_modify_time":"2017-10-09 23:14:11",
            "dealer_district_creator_name":"张三",
            "dealer_district_modifyier_name":"李四",
            "dealer_district_status":"1",
            "dealer_type_id":"4803341355190322405",
            "dealer_manager_waiqin365_id":"8776918981000102550,6831633994841635708",
            "dealer_mss_street":"华侨路街道",
            "dealer_label":"标签1,标签2",
            "dealer_label_id":"8287736961434231550,683163399484164567",
            "dealer_assistant_id": "7053012386494123505,6954172928161735690",
            "dealer_assistant_name": "张三,李四",
            "dealer_road_msg": "道路信息",
            "dealer_house_number": "门牌号信息",
            "dealer_liscence_name": "营业执照信息",
            "dealer_registration_no": "工商注册号信息",
            "dealer_registration_date": "2019-10-21",
            "dealer_operator": "经营者信息",
            "dealer_sale_direct": "是",
            "linkmans": [
                {
                    "dealer_linkman_name": "张三",
                    "dealer_linkman_job": "店主",
                    "dealer_linkman_mobile": "13052125555",
                    "dealer_linkman_office_tel": "52365895",
                    "dealer_linkman_fax": "25758545",
                    "dealer_linkman_sex": "M",
                    "dealer_linkman_birthday": "1980-02-06",
                    "dealer_linkman_email": "abc@163.com",
                    "dealer_linkman_remarks": "",
                    "dealer_linkman_main": "1",
                    "dealer_linkman_id": "L001",
                    "dealer_linkman_intimacy":"一星",
                    "dealer_linkman_importance":"重要",
                    "dealer_linkman_decision_relationship":"决策人",
                    "dealer_linkman_approval_status": "3"
                },
                {
                    "dealer_linkman_name": "李四",
                    "dealer_linkman_job": "店员",
                    "dealer_linkman_mobile": "13022215212",
                    "dealer_linkman_office_tel": "58755254",
                    "dealer_linkman_fax": "",
                    "dealer_linkman_sex": "F",
                    "dealer_linkman_birthday": "1981-02-14",
                    "dealer_linkman_email": "",
                    "dealer_linkman_remarks": "",
                    "dealer_linkman_main": "0",
                     "dealer_linkman_id": "L002",
                    "dealer_linkman_intimacy":"一星",
                    "dealer_linkman_importance":"重要",
                    "dealer_linkman_decision_relationship":"决策人",
                    "dealer_linkman_approval_status": "3"
                }
            ],
            "deliverys": [
                {
                    "dealer_delivery_name": "张三",
                    "dealer_delivery_main": "0",
                    "dealer_delivery_tel": "52365895",
                    "dealer_delivery_phone": "13052125555",
                    "dealer_delivery_addr": "南京路XXXX号",
                    "dealer_delivery_province": "江苏省",
                    "dealer_delivery_province_code": "320000",
                    "dealer_delivery_city": "南京市",
                    "dealer_delivery_city_code": "320100",
                    "dealer_delivery_area": "鼓楼区",
                    "dealer_delivery_area_code": "320101",
                    "dealer_delivery_ex1":"",
                    "dealer_delivery_ex2":"",
                    "dealer_delivery_ex3":"",
                    "dealer_delivery_id":"D001"
                }
            ],
            "exts": [
                {
                    "dealer_ext_column": "exdf_231541",
                    "dealer_ext_key": "级别",
                    "dealer_ext_value": "四星"
                },
                {
                    "dealer_ext_column": "exdf_878543",
                    "dealer_ext_key": "主营商品",
                    "dealer_ext_value": "食品,电器,日化用品"
                }
            ],
            "stores": [
                {
                    "store_id": "MD0001",
                    "store_name": "门店1",
                    "waiqin365_store_id":"15369984587"
                },
                {
                    "store_id": "MD0002",
                    "store_name": "门店2",
                    "waiqin365_store_id":"154887412365"
                }
            ],
            "dealer_receive_info":[
                  {
                      "dealer_id": "zt001",
                      "dealer_waiqin_365_id": "98000123465333545",
                      "dealer_code": "zt001"
                  }
            ] 
        }
]

参数说明:

参数 类型 必填 说明
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID,对应新增经销商 (dealer_id)字段,只有当数据来源于新增接口时才有值,如果数据从外勤365系统中直接创建则该字段值为空
dealer_name VARCHAR(100) 经销商名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
dealer_code VARCHAR(32) 经销商编码,有效字符详见附录:有效字符说明 (opens new window)
dealer_manager VARCHAR(4000) 经销商经理。多经销商经理名称间以“,”分隔。如:张三,李四,王五
dealer_manager_waiqin365_id VARCHAR(4000) 经销商经理id。多经销商经理id间以“,”分隔。
dealer_type VARCHAR(100) 经销商类型名称
dealer_type_id VARCHAR(100) 经销商类型id
dealer_dept_id VARCHAR(100) 经销商所属部门唯一标识,来源于第三方系统的部门唯一标识和部门信息中org_id对应
dealer_dept_name VARCHAR(100) 经销商所属部门名称
dealer_dept_waiqin365_id VARCHAR(32) 经销商所属部门ID,来源于外勤365部门唯一ID和部门信息中id对应
dealer_district VARCHAR(1000) 经销商所属销售区域,此字段需要销售区域的完整层级结构,多层级间以“,”分隔。 如:华中大区,南京分区,秦淮社区
dealer_district_waiqin365_id VARCHAR(1000) 经销商所属销售区域ID,来源于外勤365的销售区域唯一ID。
dealer_third_district_id VARCHAR(1000) 第三方销售区域id
upper_dealer VARCHAR(100) 上级经销商名称
upper_dealer_id VARCHAR(100) 上级经销商第三方唯一标识,来源于第三方系统的经销商唯一标识和经销商信息中dealer_id对应
waiqin365_upper_dealer_id VARCHAR(100) 上级经销商ID,来源于外勤365系统的经销商唯一ID和经销商信息中id对应
dealer_mss_province VARCHAR(32) 经销商所属行政区域-省
dealer_mss_city VARCHAR(32) 经销商所属行政区域-市
dealer_mss_area VARCHAR(32) 经销商所属行政区域-县
dealer_mss_street VARCHAR(32) 经销商所属行政区域-乡镇街道
dealer_addr VARCHAR(4000) 经销商地址
dealer_delivery_addr VARCHAR(4000) 经销商送货地址
dealer_cooperate_status CHAR(1) 合作状态, 0-终止合作 1-合作中, 2-未合作, 3-有意向
dealer_source VARCHAR(100) 经销商来源
dealer_trade VARCHAR(100) 经销商行业
dealer_scale VARCHAR(100) 经销商人员规模
dealer_tel VARCHAR(32) 经销商电话, 如:02544550010或025-44550010
dealer_fax VARCHAR(32) 经销商传真, 如:02544550010或025-44550010
dealer_post VARCHAR(32) 经销商邮编
dealer_remarks VARCHAR(4000) 经销商备注
tradingarea_big VARCHAR(100) 商圈等级
tradingarea VARCHAR(100) 商圈标签
tradingarea_level_code VARCHAR(100) 商圈等级编码
tradingarea_level_name VARCHAR(100) 商圈等级名称
dealer_district_id VARCHAR(32) 外勤365销售区域id。此字段从2021年8月01日起,对新创建第三方应用不再返回真实dealer_district_id,使用dealer_district_waiqin365_id代替cm_district_id
dealer_district_create_time CHAR(19) 销售区域创建时间,格式:“yyyy-MM-dd HH:mm:ss”
dealer_district_modify_time CHAR(19) 销售区域修改时间,格式:“yyyy-MM-dd HH:mm:ss”
dealer_district_creator_name VARCHAR(100) 销售区域创建人
dealer_district_modifyier_name VARCHAR(100) 销售区域修改人
dealer_district_status CHAR(1) 销售区域状态,默认1正常,0删除
dealer_label VARCHAR(4000) 经销商标签名称。多个 经销商标签名称以“,”分隔
dealer_label_id VARCHAR(4000) 经销商标签id,多个 经销商标签id以“,”分隔
dealer_assistant_id VARCHAR(4000) 经销商协助员唯一标识。多唯一标识以“,”分隔
dealer_assistant_name VARCHAR(4000) 经销商协助员名称。多协助员以“,”分隔
dealer_road_msg VARCHAR(4000) 经销商道路信息。
dealer_house_number VARCHAR(4000) 经销商门牌号信息。
dealer_liscence_name VARCHAR(4000) 经销商营业执照信息。
dealer_registration_no VARCHAR(4000) 经销商工商注册号信息。
dealer_registration_date VARCHAR(32) 经销商注册日期。格式“yyyy-MM-dd”
dealer_operator VARCHAR(4000) 经销商经营者信息。
dealer_pictures VARCHAR(4000) 经销商门头照信息,多个以“,”号隔开。
dealer_liscence VARCHAR(4000) 经销商营业执照信息,多个以“,”号隔开。
dealer_sale_direct VARCHAR(1) 是否直接交易客户。 0-是,1-否
linkmans[]
.dealer_linkman_waiqin365_id
VARCHAR(32) 经销商联系人外勤365Id
linkmans[]
.dealer_linkman_name
VARCHAR(100) 经销商联系人名称
linkmans[]
.dealer_linkman_job
VARCHAR(32) 经销商联系人职务
linkmans[]
.dealer_linkman_mobile
VARCHAR(32) 经销商联系人手机
linkmans[]
.dealer_linkman_office_tel
VARCHAR(32) 经销商联系人固定电话, 如:02544550010或025-44550010
linkmans[]
.dealer_linkman_fax
VARCHAR(32) 经销商联系人传真, 如:02544550010或025-44550010
linkmans[]
.dealer_linkman_sex
VARCHAR(1) 经销商联系人性别F女性 M 男性,默认值“M”
linkmans[]
.dealer_linkman_birthday
timestamp 经销商联系人生日
linkmans[]
.dealer_linkman_email
VARCHAR(100) 经销商联系人电子邮件
linkmans[]
.dealer_linkman_remarks
VARCHAR(4000) 经销商联系人备注
linkmans[]
.dealer_linkman_main
VARCHAR(1) 是否为主联系人,0-否 1-是,默认值:0
linkmans[]
.dealer_linkman_qq
VARCHAR(100) 经销商联系人qq
linkmans[]
.dealer_linkman_weixin
VARCHAR(100) 经销商联系人微信
linkmans[]
.dealer_linkman_dept
VARCHAR(200) 经销商联系人部门
linkmans[]
.dealer_linkman_id
VARCHAR(50) 经销商联系人第三方id
linkmans[]
.dealer_linkman_intimacy
VARCHAR(50) 经销商联系人亲密度
linkmans[]
.dealer_linkman_importance
VARCHAR(50) 经销商联系人重要关系
linkmans[]
.dealer_linkman
_decision_relationship
VARCHAR(50) 经销商联系人决策关系
linkmans[]
.dealer_linkman_modify_time
timestamp 经销商联系人修改时间,格式“yyyy-MM-dd HH:mm:ss”
linkmans[]
.dealer_linkman_approval_status
CHAR(1) 经销商联系人审批状态。1-待审批 2-审批打回 3-审批通过
deliverys[]
.dealer_delivery_waiqin365_id
VARCHAR(32) 经销商收货人外勤365Id
deliverys[]
.dealer_delivery_main
VARCHAR(1) 门店收获地址是否为默认收获地址可选值:0否 1是 当存在门店收货人信息时,此字段默认为“0”
deliverys[]
.dealer_delivery_name
VARCHAR(32) 收货人名称
deliverys[]
.dealer_delivery_tel
VARCHAR(32) 收货电话
deliverys[]
.dealer_delivery_phone
VARCHAR(32) 收货手机号
deliverys[]
.dealer_delivery_addr
VARCHAR(4000) 收货地址
deliverys[]
.dealer_delivery_province
VARCHAR(32) 收货地址所属行政区域-省名称
deliverys[]
.dealer_delivery_province_code
VARCHAR(32) 收货地址所属行政区域-省编码
deliverys[]
.dealer_delivery_city
VARCHAR(32) 收货地址所属行政区域-市名称
deliverys[]
.dealer_delivery_city_code
VARCHAR(32) 收货地址所属行政区域-市编码
deliverys[]
.dealer_delivery_area
VARCHAR(32) 收货地址所属行政区域-区名称
deliverys[]
.dealer_delivery_area_code
VARCHAR(32) 收货地址所属行政区域-区编码
deliverys[]
.dealer_delivery_ex1
varchar(200) 收货地址扩展字段1
deliverys[]
.dealer_delivery_ex2
varchar(200) 收货地址扩展字段2
deliverys[]
.dealer_delivery_ex3
varchar(200) 收货地址扩展字段3
deliverys[]
.dealer_delivery_id
varchar(50) 收货地址第三方id
exts[] List 经销商自定义字段
exts[].dealer_ext_key VARCHAR(100) 经销商自定义字段key值, 经销商扩展字段需先在我方系统经销商管理中创建。
exts[].dealer_ext_value VARCHAR(4000) 经销商扩展字段value值对多个选项值,以“,”分隔拼接。
stores[] List 下属门店
stores[].waiqin365_store_id VARCHAR(100) 经销商下属门店在外勤365系统里面对应的id
stores[].store_id VARCHAR(32) 经销商下属门店经销商下属门店来源第三方系统的门店唯一标识
stores[].store_name VARCHAR(100) 门店名称
id VARCHAR(32) 经销商唯一ID,外勤365中经销商的唯一ID
dealer_cooperate_status_id VARCHAR(32) 合作状态id
dealer_level_id VARCHAR(32) 经销商级别ID,来源于外勤365的经销商级别唯一ID和经销商级别信息中id对应
dealer_level VARCHAR(100) 经销商级别名称
dealer_approval_status char(1) 经销商审批状态1-待审批 2-审批打回 3-审批通过
dealer_status CHAR(1) 经销商删除状态:0-删除 1-正常
create_time CHAR(19) 创建日期,格式:“yyyy-MM-dd HH:mm:ss”
dealer_receive_info[] List 经销商收货方
dealer_receive_info[]
.dealer_id
VARCHAR(32) 来源于第三方系统的经销商收货方唯一标识
dealer_receive_info[]
.dealer_waiqin_365_id
VARCHAR(32) 经销商收货方对应的外勤365的id
dealer_receive_info[]
.dealer_code
VARCHAR(32) 经销商收货方编码

# 合作状态变更

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

{
    "dealer_id": "dealer0001",
    "dealer_cooperate_status": "0"
}

参数说明:

参数 类型 必填 说明
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID,对应新增经销商 (dealer_id)字段,只有当数据来源于新增接口时才有值,如果数据从外勤365系统中直接创建则该字段值为空。 调用此接口时该字段值(dealer_id)和外勤365的经销商唯一ID(dealer_waiqin_id)作为更新数据的唯一标识,所以不能同时为空, 如果两个值同时存在则优先顺序为dealer_waiqin_iddealer_id
dealer_waiqin365_id VARCHAR(32) 外勤365的经销商唯一ID,和来源于第三方系统经销商唯一ID(dealer_id)作为更新数据的唯一标识,所以不能同时为空
dealer_cooperate_status CHAR(1) 合作状态, 0-终止合作 1-合作中, 2-未合作, 3-有意向
dealer_cooperate_status_name VARCHAR(32) 合作状态:终止合作/合作中/未合作/有意向/{自定义的}, dealer_cooperate_status_name、dealer_cooperate_status如果同时存在优先取dealer_cooperate_status

返回结果:

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

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 经销商分配到员工

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

{
    "dealer_id": "dealer0001",
    "emp_id": " EMP0001, EMP0002, EMP0003"
}

参数说明:

参数 类型 必填 说明
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID,对应新增经销商 (dealer_id)字段,只有当数据来源于新增接口时才有值,如果数据从外勤365系统中直接创建则该字段值为空。 调用此接口时该字段值(dealer_id)和外勤365的经销商唯一ID(dealer_waiqin_id)作为更新数据的唯一标识,所以不能同时为空, 如果两个值同时存在则优先顺序为dealer_waiqin_iddealer_id
dealer_waiqin365_id VARCHAR(32) 外勤365的经销商唯一ID,和来源于第三方系统经销商唯一ID(dealer_id)作为更新数据的唯一标识,所以不能同时为空
emp_id VARCHAR(4000) 员工第三方唯一标识,多员工间以“,”分隔。 如:EMP0001, EMP0002。emp_waiqin365_id`、emp_id、emp_waiqin365_code如果同时存在,优先级依次降低
emp_waiqin365_id VARCHAR(4000) 员工外勤唯一标识,多员工间以“,”分隔。 emp_waiqin365_id、emp_id、emp_waiqin365_code如果同时存在,优先级依次降低
emp_waiqin365_code VARCHAR(4000) 员工编码,多员工间以“,”分隔。 emp_waiqin365_id、emp_id、emp_waiqin365_code如果同时存在,优先级依次降低

返回结果:

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

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 经销商分配到部门

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

{
    "dealer_id": "dealer0001",
    "org_id": " ORG0001, ORG0002, ORG0003"
}

参数说明:

参数 类型 必填 说明
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID,对应新增经销商 (dealer_id)字段,只有当数据来源于新增接口时才有值,如果数据从外勤365系统中直接创建则该字段值为空
org_id VARCHAR(4000) 部门唯一标识,多个部门间以“,”分隔。 如:ORG0001, ORG0002, ORG0003

返回结果:

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

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明

# 给经销商分配管理的门店

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

{
    "dealer_id": "dealer0001",
    "store_id": "MD0001",
    "dealer_name": "经销商001",
    "dealer_waiqin365_id": ""
}

参数说明:

参数 类型 必填 说明
dealer_id VARCHAR(32) 来源于第三方系统的经销商唯一ID
store_id VARCHAR(4000) 门店唯一标识,多门店间以“,”分隔。 如:MD0001, MD0002, MD0003
dealer_name VARCHAR(100) 经销商名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
dealer_waiqin365_id VARCHAR(32) 外勤365经销商唯一标识

返回结果:

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

参数说明:

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他详见附录错误码说明 (opens new window)
return_msg String 响应说明