API开放平台

TIP

# 经销商接口

# 新增经销商

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dealer/v1/addDealer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "dealer_id": "CM0001",
    "dealer_name": "苏果夫子庙店",
    "dealer_code": "suguo_fzmd",
    "dealer_manager": "王伟,张强,吴为",
    "dealer_manager_id": "emp001,emp002",
    "dealer_emp_code": "yuangong1",
    "dealer_org_code": "1202001",
    "dealer_type": "大型超市",
    "dealer_district": "华中大区,南京分区,秦淮社区",
    "dealer_district_code": "code01",
    "dealer_sales_org" : "",
    "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_pictures": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "dealer_house_number": "门牌号信息",
    "dealer_liscence": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "dealer_liscence_name": "营业执照信息",
    "dealer_registration_no": "工商注册号信息",
    "dealer_registration_date": "2019-10-21",
    "dealer_operator": "经营者信息",
    "dealer_location":"13.6541,86.6656",
    "dealer_sale_direct": "是",
    "dealer_city_id_code": "110000",
    "dealer_city_id_name": "北京市",
    "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_emp_code VARCHAR(32) 否 客户经理code（即为员工登录账号），多客户经理唯一标识间以“,”分隔。
dealer_org_code VARCHAR(32) 否 经销商所属部门code
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_third_district_id VARCHAR(32) 否 第三方销售区域ID,来源于第三方系统的唯一销售区域标识
dealer_district_waiqin365_id VARCHAR(32) 否 经销商所属销售区域ID，来源于勤策的销售区域唯一ID
dealer_district_code VARCHAR(32) 否 经销商所属销售区域编码，来源于勤策的销售区域编码。如果dealer_district_waiqin365_id、dealer_third_district_id、dealer_district_code同时存在，依展示顺序优先取作为对应销售区域
dealer_sales_org VARCHAR(32) 否 销售组织(id或名称)
dealer_district VARCHAR(1000) 否 经销商销售区域，此字段需要销售区域的完整层级结构， 多层级间以“,”分隔。dealer_district、dealer_district_waiqin365_id如果同时存在优先取dealer_district_waiqin365_id。如：华中大区,南京分区,秦淮社区。
此字段从2022年01月01日起废弃，使用dealer_district_waiqin365_id、dealer_third_district_id替代，新增或修改销售区域时直接使用销售区域管理接口
dealer_dept_waiqin365_id VARCHAR(32) 否 经销商所属部门ID，来源于勤策部门唯一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，来源于勤策的经销商唯一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) 否 经销商协助员唯一标识。多唯一标识以“,”分隔，来源于第三方系统的员工唯一标识。dealer_assistant_id、dealer_assistant_name如果同时存在优先取dealer_assistant_id
dealer_assistant_name VARCHAR(4000) 否 经销商协助员名称。多协助员以“,”分隔
dealer_road_msg VARCHAR(4000) 否 经销商道路信息
dealer_pictures VARCHAR(4000) 否 经销商门头照，图片下载url
dealer_house_number VARCHAR(4000) 否 经销商门牌号信息
dealer_liscence VARCHAR(4000) 否 经销商营业执照，传图片下载url；传多个url时，以“,”分隔拼接
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_city_id_code VARCHAR(32) 否 所在城市编码。所在城市配置手动维护时生效，对应省市区码。
dealer_city_id_mame VARCHAR(100) 否 所在城市名称。所在城市配置手动维护时生效，对应省市区名称(dealer_city_id_code存在则以该字段为准)
dealer_linkman_full_sync VARCHAR(1) 否 经销商联系人全量同步标识，需要使用，传1，将以接口中数据覆盖系统中数据；如无需使用，不传任何值
dealer_delivery_full_sync VARCHAR(1) 否 经销商收货地址全量同步标识，需要使用，传1，将以接口中数据覆盖系统中数据；如无需使用，不传任何值
linkmans 经销商联系人列表
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值对多个选项值，以“,”分隔拼接
delivery 收货信息列表
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_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) 否 经销商收货方对应的勤策的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 } 在线调试
请求示例：

{
    "dealer_id": "CM0001",
    "dealer_name": "苏果夫子庙店",
    "dealer_code": "suguo_fzmd",
    "dealer_manager": "王伟,张强,吴为",
    "dealer_manager_id": "emp001,emp002",
    "dealer_emp_code": "yuangong1",
    "dealer_org_code": "1202001",
    "dealer_type": "大型超市",
    "dealer_district": "华中大区,南京分区,秦淮社区",
    "dealer_district_code": "code01",
    "dealer_sales_org" : "",
    "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_pictures": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "dealer_house_number": "门牌号信息",
    "dealer_liscence": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "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": "是",
    "dealer_city_id_code": "110000",
    "dealer_city_id_name": "北京市",
    "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) 否 勤策的经销商唯一ID，和来源于第三方系统经销商唯一ID(dealer_id)作为更新数据的唯一标识，所以不能同时为空。dealer_waiqin_id、dealer_id如果同时存在优先取dealer_waiqin_id
dealer_id VARCHAR(32) 否 来源于第三方系统的经销商唯一ID，对应新增经销商 (dealer_id)字段，只有当数据来源于新增接口时才有值，如果数据从勤策系统中直接创建则该字段值为空。 调用此接口时该字段值(dealer_id)和勤策的经销商唯一ID(dealer_waiqin_id)作为更新数据的唯一标识，所以不能同时为空， 如果两个值同时存在则优先顺序为dealer_waiqin_id、dealer_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_emp_code VARCHAR(32) 否 客户经理code（即为员工登录账号），多客户经理唯一标识间以“,”分隔。
dealer_org_code VARCHAR(32) 否 经销商所属部门code
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_third_district_id VARCHAR(32) 否 第三方销售区域ID,来源于第三方系统的唯一销售区域标识
dealer_district_waiqin365_id VARCHAR(32) 否 经销商所属销售区域ID，来源于勤策的客户销售区域唯一ID
dealer_district_code VARCHAR(32) 否 经销商所属销售区域编码，来源于勤策的销售区域编码。如果dealer_district_waiqin365_id、dealer_third_district_id、dealer_district_code同时存在，依展示顺序优先取作为对应销售区域
dealer_sales_org VARCHAR(32) 否 销售组织(id或名称)
dealer_district VARCHAR(1000) 否 经销商所属销售区域，此字段需要销售区域的完整层级结构， 多层级间以“,”分隔，如：华中大区,南京分区,秦淮社区。dealer_district、dealer_district_waiqin365_id如果同时存在优先取dealer_district_waiqin365_id。
此字段从2022年01月01日起废弃，使用dealer_district_waiqin365_id、dealer_third_district_id替代，新增或修改销售区域时直接使用销售区域管理接口
dealer_dept_waiqin365_id VARCHAR(32) 否 经销商所属部门ID，来源于勤策部门唯一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，来源于勤策的经销商唯一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) 否 经销商协助员唯一标识。多唯一标识以“,”分隔，来源于第三方系统的员工唯一标识。dealer_assistant_id、dealer_assistant_name如果同时存在优先取dealer_assistant_id
dealer_assistant_name VARCHAR(4000) 否 经销商协助员名称。多协助员以“,”分隔
dealer_road_msg VARCHAR(4000) 否 经销商道路信息
dealer_pictures VARCHAR(4000) 否 经销商门头照，图片下载url
dealer_house_number VARCHAR(4000) 否 经销商门牌号信息
dealer_liscence VARCHAR(4000) 否 客户营业执照，传图片下载url；传多个url时，以“,”分隔拼接
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) 否 是否直接交易客户。只能填写“是”、“否”
dealer_city_id_code VARCHAR(32) 否 所在城市编码。所在城市配置手动维护时生效，对应省市区码。
dealer_city_id_mame VARCHAR(100) 否 所在城市名称。所在城市配置手动维护时生效，对应省市区名称(dealer_city_id_code存在则以该字段为准)
linkmans 经销商联系人列表
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 经销商扩展字段列表
exts.dealer_ext_key VARCHAR(100) 否 经销商扩展字段key值， 经销商扩展字段需先在我方系统经销商管理中创建
exts.dealer_ext_value VARCHAR(4000) 否 经销商扩展字段value值对多个选项值，以“,”分隔拼接
deliverys 收货信息列表
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_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) 否 经销商收货方对应的勤策的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 } 在线调试
请求示例：

{
    "dealer_id": "dealer0001",
    "dealer_waiqin_id": "dealer0001"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
dealer_id VARCHAR(32) 是 来源于第三方系统的经销商唯一ID，对应新增经销商 (dealer_id)字段，只有当数据来源于新增接口时才有值，如果数据从勤策系统中直接创建则该字段值为空
dealer_waiqin_id VARCHAR(32) 是 经销商勤策ID，与第三方系统经销商id（dealer_id）两者必传其一

响应示例：

{
    "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/recoverDealer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "dealer_id": "CM0001",
    "dealer_waiqin365_id": "8397938754676734"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
dealer_id VARCHAR(32) 否 来源于第三方的客户唯一标识，和勤策的客户唯一标识不能同时为空
dealer_waiqin365_id LONG 否 勤策的客户唯一标识，和第三方的客户唯一标识不能同时为空

响应示例：

{
    "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/queryDealer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "page_number": "1",
    "dealer_id": "CM0001",
    "dealer_name": "苏果夫子庙店",
    "dealer_code": "suguo_fzmd",
    "dealer_type_code": "001",
    "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",
    "filterStores": "1",
    "dealer_dept_code": "dept_001",
    "dealer_level": "金牌客户",
    "dealer_district_code": "district_001"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page_number INT 否 分页页码，默认值为1
status CHAR(1) 否 记录状态。0：已删除，1：正常
id VARCHAR(32) 否 勤策的经销商唯一ID
dealer_id VARCHAR(32) 否 来源于第三方系统的经销商唯一ID，对应新增经销商 (dealer_id)字段，只有当数据来源于新增接口时才有值，如果数据从勤策系统中直接创建则该字段值为空
dealer_name VARCHAR(100) 否 经销商名称，唯一，有效字符详见附录：有效字符说明 (opens new window)
dealer_code VARCHAR(32) 否 经销商编码，有效字符详见附录：有效字符说明 (opens new window)
dealer_manager_id VARCHAR(4000) 否 根据经销商客户经理唯一标识精确查询
dealer_type_code VARCHAR(100) 否 经销商类型编码，dealer_type、ealer_type_code如果同时存在优先取dealer_type_code
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) 否 经销商所属销售区域，此字段需要销售区域的完整层级结构， 多层级间以“,”分隔。如：华中大区,南京分区,秦淮社区
filterStores CHAR(1) 否 是否过滤经销商下属终端信息。1：过滤
dealer_dept_code VARCHAR(1000) 否 经销商所属部门code,多个数值间用英文“,”隔开
dealer_level VARCHAR(1000) 否 经销商级别，多个数值间用英文“,”隔开
dealer_district_code VARCHAR(1000) 否 销售区域编码，非全路径编码，多个数值间用英文“,”隔开

响应示例：

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

数据DATA示例:

[
        {
            "id": "7863150652620035205",
            "dealer_id": "CM0001",
            "creator_waiqin_id": "8830671133213284556",
            "creator_name": "丁金金",
            "creator_id": "5956995671401092891",
            "return_pool_reason": "打回测试",
            "dealer_name": "苏果夫子庙店",
            "dealer_code": "suguo_fzmd",
            "dealer_source_type": "自建",
            "dealer_manager": "王伟,张强,吴为",
            "dealer_district": "秦淮社区",
            "dealer_district_full_path": "华中大区,南京分区,秦淮社区",
            "dealer_type": "大型超市",
            "dealer_type_code": "001",
            "dealer_mss_province": "江苏省",
            "dealer_mss_province_code": "320000",
            "dealer_mss_city": "南京市",
            "dealer_mss_city_code": "320100",
            "dealer_mss_area": "秦淮区",
            "dealer_mss_area_code": "320104",
            "dealer_addr": "南京市秦淮区大全福巷1号",
            "dealer_delivery_addr": "南京市秦淮区大四福巷10号",
            "dealer_cooperate_status": "1",
            "upper_dealer": "苏果新街口店,苏果新街口店1",
            "upper_dealer_code": "",
            "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_code":"code01",
            "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_mss_street_code":"320106002",
            "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_credit_no": "统一社会信用代码",
            "dealer_registration_date": "2019-10-21",
            "dealer_operator": "经营者信息",
            "dealer_sale_direct": "是",
            "dealer_creator_code": "EMP001",
            "dealer_modifier_code": "EMP002",
            "dealer_modify_time": "2024-04-17 15:11:47",
            "dealer_manager_code": "EMP003",
            "sales_org_id" : "",
            "sales_org_name" : "销售组织名称",            
            "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_street": "鼓楼街道",
                    "dealer_delivery_street_code": "",
                    "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)字段，只有当数据来源于新增接口时才有值，如果数据从勤策系统中直接创建则该字段值为空
creator_waiqin_id VARCHAR(32) 否 创建人id，来源勤策员工唯一ID
creator_name VARCHAR(100) 否 创建人名称
creator_id VARCHAR(100) 否 创建人id，来源第三方系统的唯一ID
return_pool_reason VARCHAR(4000) 否 退回原因
dealer_name VARCHAR(100) 是 经销商名称，唯一，有效字符详见附录：有效字符说明 (opens new window)
dealer_code VARCHAR(32) 是 经销商编码，有效字符详见附录：有效字符说明 (opens new window)
dealer_source_type VARCHAR(32) 否 经销创建方式。
dealer_manager VARCHAR(4000) 否 经销商经理。多经销商经理名称间以“,”分隔。如：张三,李四,王五
dealer_manager_waiqin365_id VARCHAR(4000) 否 经销商经理id。多经销商经理id间以“,”分隔
dealer_type VARCHAR(100) 否 经销商类型名称
dealer_type_code 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，来源于勤策部门唯一ID和部门信息中id对应
dealer_district VARCHAR(1000) 否 销商所属销售区域，此字段为 销售区域的最末级结构
dealer_district_full_path VARCHAR(1000) 否 经销商所属销售区域，此字段需要销售区域的完整层级结构，多层级间以“,”分隔。 如：华中大区,南京分区,秦淮社区
dealer_district_waiqin365_id VARCHAR(1000) 否 经销商所属销售区域ID，来源于勤策的销售区域唯一ID
dealer_third_district_id VARCHAR(1000) 否 第三方销售区域id
upper_dealer VARCHAR(100) 否 上级经销商名称
upper_dealer_code VARCHAR(100) 否 上级经销商编码
upper_dealer_id VARCHAR(100) 否 上级经销商第三方唯一标识，来源于第三方系统的经销商唯一标识和经销商信息中dealer_id对应
waiqin365_upper_dealer_id VARCHAR(100) 否 上级经销商ID，来源于勤策系统的经销商唯一ID和经销商信息中id对应
dealer_mss_province VARCHAR(32) 否 经销商所属行政区域-省名称
dealer_mss_province_code VARCHAR(32) 否 经销商所属行政区域-省编码
dealer_mss_city VARCHAR(32) 否 经销商所属行政区域-市名称
dealer_mss_city_code VARCHAR(32) 否 经销商所属行政区域-市编码
dealer_mss_area VARCHAR(32) 否 经销商所属行政区域-县名称
dealer_mss_area_code VARCHAR(32) 否 经销商所属行政区域-县编码
dealer_mss_street VARCHAR(32) 否 经销商所属行政区域-乡镇街道名称
dealer_mss_street_code 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) 否 勤策销售区域id。此字段从2021年8月01日起，对新创建第三方应用不再返回真实dealer_district_id，使用dealer_district_waiqin365_id代替cm_district_id
dealer_district_code VARCHAR(32) 否 经销商所属销售区域编码，来源于勤策的销售区域编码
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：删除。默认值为1
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_credit_no VARCHAR(32) 否 经销商统一社会信用代码信息
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：否
dealer_manager_code VARCHAR(4000) 否 经销商客户经理编码，即为员工登录账号，多客户经理唯一标识间以英文“,”隔开
dealer_creator_code VARCHAR(100) 否 创建人编码
dealer_modifier_code VARCHAR(100) 否 修改人编码，取最新修改记录操作人
dealer_modify_time VARCHAR(100) 否 修改时间。格式：yyyy-MM-dd hh:mm:ss
sales_org_id VARCHAR(100) 否 销售组织id
sales_org_name VARCHAR(100) 否 销售组织名称
linkmans List 经销商联系人列表
linkmans
.dealer_linkman_waiqin365_id		 VARCHAR(32) 是 经销商联系人勤策Id
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) 是 经销商收货人勤策Id
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_street		 VARCHAR(32) 否 收货地址所属行政区域-街道名称
deliverys
.dealer_delivery_street_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 否 经销商自定义字段列表
exts.dealer_ext_key VARCHAR(100) 是 经销商自定义字段key值， 经销商扩展字段需先在我方系统经销商管理中创建
exts.dealer_ext_value VARCHAR(4000) 否 经销商扩展字段value值对多个选项值，以“,”分隔拼接
stores 否 下属门店列表
stores.waiqin365_store_id VARCHAR(100) 是 经销商下属门店在勤策系统里面对应的id
stores.store_id VARCHAR(32) 否 经销商下属门店经销商下属门店来源第三方系统的门店唯一标识
stores.store_name VARCHAR(100) 是 门店名称
id VARCHAR(32) 是 经销商唯一ID，勤策中经销商的唯一ID
dealer_cooperate_status_id VARCHAR(32) 是 合作状态id
dealer_level_id VARCHAR(32) 否 经销商级别ID，来源于勤策的经销商级别唯一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 否 经销商收货方列表
dealer_receive_info
.dealer_id		 VARCHAR(32) 否 来源于第三方系统的经销商收货方唯一标识
dealer_receive_info
.dealer_waiqin_365_id		 VARCHAR(32) 是 经销商收货方对应的勤策的id
dealer_receive_info
.dealer_code		 VARCHAR(32) 是 经销商收货方编码

# 经销商合作状态变更

请求方式： POST（HTTPS）
请求地址： https://openapi.waiqin365.com/api/dealer/v1/modifyDealerCooperateStatus/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "dealer_id": "dealer0001",
    "dealer_cooperate_status": "0"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
dealer_id VARCHAR(32) 否 来源于第三方系统的经销商唯一ID，对应新增经销商 (dealer_id)字段，只有当数据来源于新增接口时才有值，如果数据从勤策系统中直接创建则该字段值为空。 调用此接口时该字段值(dealer_id)和勤策的经销商唯一ID(dealer_waiqin_id)作为更新数据的唯一标识，所以不能同时为空， 如果两个值同时存在则优先顺序为dealer_waiqin_id、dealer_id
dealer_waiqin365_id VARCHAR(32) 否 勤策的经销商唯一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 } 在线调试
请求示例：

{
    "dealer_id": "dealer0001",
    "emp_id": " EMP0001, EMP0002, EMP0003"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
dealer_id VARCHAR(32) 否 来源于第三方系统的经销商唯一ID，对应新增经销商 (dealer_id)字段，只有当数据来源于新增接口时才有值，如果数据从勤策系统中直接创建则该字段值为空。 调用此接口时该字段值(dealer_id)和勤策的经销商唯一ID(dealer_waiqin_id)作为更新数据的唯一标识，所以不能同时为空， 如果两个值同时存在则优先顺序为dealer_waiqin_id、dealer_id
dealer_waiqin365_id VARCHAR(32) 否 勤策的经销商唯一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 } 在线调试
请求示例：

{
    "dealer_id": "dealer0001",
    "org_id": " ORG0001, ORG0002, ORG0003"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
dealer_id VARCHAR(32) 是 来源于第三方系统的经销商唯一ID，对应新增经销商 (dealer_id)字段，只有当数据来源于新增接口时才有值，如果数据从勤策系统中直接创建则该字段值为空
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 } 在线调试
请求示例：

{
    "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) 否 勤策经销商唯一标识

响应示例：

{
    "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/poiInfo/v1/queryMainRelDealer/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
    "rows": "50",
    "page_number":"1",
    "dealer_id": "51556486151687110",
    "dealer_code": "code123",
    "source_code": "EA15668"
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
rows VARCHAR(32) 否 每页条数，默认50
page_number VARCHAR(4000) 否 分页页码，默认值为1
dealer_id VARCHAR(100) 否 勤策的经销商唯一ID)
dealer_code VARCHAR(32) 否 勤策的经销商Code
source_code VARCHAR(32) 否 来源于第三方的经销商ID

响应示例：

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

数据DATA示例:

[
        {
            "dealer_id": "7863150652620035205",
            "dealer_code": "51515",
            "source_code": "V545",
            "dealer_name": "苏果夫子庙店",
            "primary_dealer_id": "15616413548961",
            "primary_dealer_code": "123",
            "primary_source_code": "Q151",
            "primary_dealer_name": "苏果夫子庙店"
        }
]

参数说明：

参数 类型 必填 说明
dealer_id VARCHAR(32) 勤策的经销商唯一ID
dealer_code VARCHAR(32) 勤策的经销商Code
source_code VARCHAR(32) 来源于第三方的经销商ID
dealer_name VARCHAR(32) 经销商名称
primary_dealer_id VARCHAR(32) 主关联经销商的唯一ID（勤策的id）
primary_dealer_code VARCHAR(32) 主关联经销商的Code（勤策的code）
primary_source_code VARCHAR(32) 主关联经销商的来源于第三方的ID
primary_dealer_name VARCHAR(32) 主关联经销商的名称)

← KOL信息接口 →