# 门店接口

# 新增门店

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/store/v1/addStore/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "store_id": "CM0001",
    "store_name": "苏果夫子庙店",
    "store_code": "suguo_fzmd",
    "store_manager": "王伟,张强,吴为",
    "store_manager_id": "emp001,emp002",
    "store_emp_code": "yuangong1",
    "store_org_code": "1202001",
    "dealer_name": "经销商1,经销商2",
    "dealer_id": "JSX001,JXS002",
    "autarky_id": "ZYJSX001,ZYJXS002",
    "autarky_name": "自营经销商1,自营经销商2",
    "store_type": "大型超市",
    "store_district": "华中大区,南京分区,秦淮社区",
    "store_mss_province": "江苏省",
    "store_mss_city": "南京市",
    "store_mss_area": "秦淮区",
    "store_mss_street": "华侨路街道",
    "store_addr": "南京市秦淮区大全福巷1号",
    "store_cooperate_status": "1",
    "store_ka_sys": "连锁品牌",
    "store_tel": "02552416854",
    "store_fax": "02552416854",
    "store_post": "210010",
    "store_remarks": "",
    "store_residents_id":"emp001,emp002",
    "store_residents":"王伟,张强",
    "store_label":"标签1,标签2",
    "store_assistant_id":"7053012386494123505,6954172928161735690",
    "store_assistant_name":"王伟,张强",
    "store_road_msg": "道路信息",
    "store_pictures": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "store_house_number": "门牌号信息",
    "store_liscence": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "store_liscence_name": "营业执照信息",
    "store_registration_no": "工商注册号信息",
    "store_registration_date": "2019-10-21",
    "store_operator": "经营者信息",
    "store_sale_direct": "是",
    "store_location":"13.1645,86.3652",
    "deliverys": [
        {
            "store_delivery_main": "0",
            "store_delivery_name": "张三",
            "store_delivery_tel": "52365895",
            "store_delivery_phone": "13052125555",
            "store_delivery_addr": "南京路XXXX号",
            "store_delivery_ex1":"",
            "store_delivery_ex2":"",
            "store_delivery_ex3":"",
            "store_delivery_id":"nw001"
        }
    ],
    "linkmans": [
        {
            "store_linkman_name": "张三",
            "store_linkman_job": "店主",
            "store_linkman_mobile": "13052125555",
            "store_linkman_office_tel": "52365895",
            "store_linkman_fax": "25758545",
            "store_linkman_sex": "M",
            "store_linkman_birthday": "1980-02-06",
            "store_linkman_email": "abc@163.com",
            "store_linkman_remarks": "",
            "store_linkman_main": "1",
            "store_linkman_qq": "qq",
            "store_linkman_weixin": "weixin",
            "store_linkman_dept": "部门",
            "store_linkman_intimacy":"一星",
            "store_linkman_importance":"重要",
            "store_linkman_decision_relationship":"决策人",
            "store_linkman_id":"nw001"
        },
        {
            "store_linkman_name": "李四",
            "store_linkman_job": "店员",
            "store_linkman_mobile": "13022215212",
            "store_linkman_office_tel": "58755254",
            "store_linkman_fax": "",
            "store_linkman_sex": "F",
            "store_linkman_birthday": "1981-02-14",
            "store_linkman_email": "",
            "store_linkman_remarks": "",
            "store_linkman_main": "0",
            "store_linkman_qq": "qq",
            "store_linkman_weixin": "weixin",
            "store_linkman_dept": "部门",
            "store_linkman_intimacy":"一星",
            "store_linkman_importance":"重要",
            "store_linkman_decision_relationship":"决策人",
            "store_linkman_id":"nw002"
        }
    ],
    "exts": [
        {
            "store_ext_key": "级别",
            "store_ext_value": "四星"
        },
        {
            "store_ext_key": "主营商品",
            "store_ext_value": "食品,电器,日化用品"
        }
    ],
     "store_receive_info":[
           {
               "store_id": "zt001",
               "store_waiqin_365_id": "98000123465333545",
               "store_code": "zt001"
           }
     ]  
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
store_id VARCHAR(32) 来源于第三方系统的门店唯一ID
store_name VARCHAR(100) 门店名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
store_code VARCHAR(32) 门店编码,唯一,有效字符详见附录:有效字符说明 (opens new window)
store_manager_id VARCHAR(4000) 门店客户经理唯一标识,多客户经理唯一标识间以“,”分隔。来源于第三方系统的员工唯一标识和员工信息中emp_id对应。 如:EMP0001, EMP0002, EMP0003
store_emp_code VARCHAR(32) 客户经理code(即为员工登录账号),多客户经理唯一标识间以“,”分隔。
store_org_code VARCHAR(32) 门店所属部门code
store_manager_waiqin365_id VARCHAR(4000) 门店客户经理唯一标识,多客户经理唯一标识间以“,”分隔。 外勤唯一主键。store_manager_waiqin365_id、store_manager_id、store_manager如果同时存在优先取store_manager_waiqin365_id
store_manager VARCHAR(4000) 门店客户经理名称。多客户经理名称间以“,”分隔,如:张三,李四,王五。store_manager、store_manager_id如果同时存在优先取store_manager_id
dealer_name VARCHAR(4000) 所属的经销商名称,多个经销商以英文逗号分隔“,”,如:经销商1,经销商2。dealer_name、dealer_id如果同时存在优先取dealer_id
dealer_id VARCHAR(4000) 所属经销商唯一标识,来源于第三方系统的经销商唯一标识。多个经销商以英文逗号“,”分隔。如:JSX0001,JSX0002
autarky_name VARCHAR(4000) 自营经销商名称,多个自营经销商以英文逗号分隔“,”,如:自营经销商1,自营经销商2。autarky_name、autarky_id如果同时存在优先取autarky_id
autarky_id VARCHAR(4000) 自营经销商唯一标识,来源于第三方系统的自营经销商唯一标识。多个自营经销商以英文逗号“,”分隔。如:ZYJSX0001,ZYJSX0002
store_type_code VARCHAR(100) 门店类型编码
store_type VARCHAR(100) 门店类型名称,store_type,store_type_code如果同时存在优先取store_type_code
store_district_waiqin365_id VARCHAR(32) 门店所属销售区域ID,来源于勤策(原外勤365)的销售区域唯一ID
store_third_district_id VARCHAR(32) 第三方销售区域ID,来源于第三方系统的唯一销售区域标识
store_district VARCHAR(1000) 门店所属销售区域,此字段需要销售区域的完整层级结构, 多层级间以“,”分隔,如:华中大区,南京分区,秦淮社区。store_district、store_district_waiqin365_id如果同时存在优先取store_district_waiqin365_id。
此字段从2022年01月01日起废弃,使用store_district_waiqin365_idstore_third_district_id替代,新增或修改销售区域时直接使用销售区域管理接口
store_dept_waiqin365_id VARCHAR(32) 门店所属部门ID,来源于勤策(原外勤365)部门唯一ID
store_dept_id VARCHAR(32) 门店所属部门唯一标识,来源于第三方系统的部门唯一标识和部门信息中org_id对应,store_dept_id、store_dept_waiqin365_id如果同时存在优先取store_dept_waiqin365_id
store_mss_province VARCHAR(32) 门店所属行政区域-省名称,如是直辖市,省和市请传一样的值
store_mss_city VARCHAR(32) 门店所属行政区域-市名称,如是直辖市,省和市请传一样的值
store_mss_area VARCHAR(32) 门店所属行政区域-县名称,如是直筒子市,市和县请传一样的值
store_mss_street VARCHAR(100) 门店所属行政区域-乡镇街道名称
store_addr VARCHAR(4000) 门店地址
store_cooperate_status CHAR(1) 合作状态编码。0:终止合作,1:合作中,2:未合作,3:有意向
store_cooperate_status_name VARCHAR(32) 合作状态: 终止合作/合作中/未合作/有意向/{自定义的},store_cooperate_status_name、store_cooperate_status如果同时存在优先取store_cooperate_status
store_ka_sys VARCHAR(100) 连锁品牌
store_level VARCHAR(100) 门店级别
store_tel VARCHAR(32) 门店电话, 如:02544550010或025-44550010
store_fax VARCHAR(32) 门店传真, 如:02544550010或025-44550010
store_post VARCHAR(32) 门店邮编
store_remarks VARCHAR(4000) 门店备注
store_residents_id VARCHAR(4000) 门店驻店人员唯一标识。多驻店人员唯一标识以“,”分隔
store_residents VARCHAR(4000) 门店驻店人员名称。多驻店人员以“,”分隔
store_label VARCHAR(4000) 门店标签名称。多标签以“,”分隔
store_assistant_id VARCHAR(4000) 门店协助员唯一标识。多协助员唯一标识以“,”分隔,来源于勤策(原外勤365)员工唯一标识。store_assistant_id、store_assistant_name如果同时存在优先取store_assistant_id
store_assistant_name VARCHAR(4000) 门店协助员名称。多协助员名称以“,”分隔
store_road_msg VARCHAR(4000) 门店道路信息
store_pictures VARCHAR(4000) 门店门头照,图片下载url
store_house_number VARCHAR(4000) 门店门牌号信息
store_liscence VARCHAR(4000) 门店营业执照,传图片下载url;传多个url时,以“,”分隔拼接
store_liscence_name VARCHAR(4000) 门店营业执照信息
store_registration_no VARCHAR(4000) 门店工商注册号信息
store_registration_date VARCHAR(32) 门店注册日期。格式:yyyy-MM-dd
store_operator VARCHAR(4000) 门店经营者信息
store_sale_direct VARCHAR(1) 是否直接交易客户。只能填写“是”、“否”
store_location VARCHAR(100) 门店纬经度。坐标格式为"纬度,经度",如:28.153774,112.986099
store_linkman_full_sync VARCHAR(1) 门店联系人全量同步标识,需要使用,传1,将以接口中数据覆盖系统中数据;如无需使用,不传任何值
store_delivery_full_sync VARCHAR(1) 门店收货地址全量同步标识,需要使用,传1,将以接口中数据覆盖系统中数据;如无需使用,不传任何值
store_selling_area VARCHAR(10) 门店营业面积
store_cashiers_num VARCHAR(10) 门店收银台个数
store_shelf_num VARCHAR(10) 门店货架组数
store_total_num VARCHAR(10) 门店总排面数
store_self_product_num VARCHAR(10) 门店本品排面数
store_open_time timestamp 门店营业开始时间
store_close_time timestamp 门店营业结束时间
linkmans List 门店联系人列表
linkmans
.store_linkman_name
VARCHAR(100) 门店联系人名称
linkmans
.store_linkman_job
VARCHAR(32) 门店联系人职务
linkmans
.store_linkman_mobile
VARCHAR(32) 门店联系人手机
linkmans
.store_linkman_office_tel
VARCHAR(32) 门店联系人固定电话,如:02544550010或025-44550010
linkmans
.store_linkman_fax
VARCHAR(32) 门店联系人传真, 如:02544550010或025-44550010
linkmans
.store_linkman_sex
VARCHAR(1) 门店联系人性别。F:女性,M:男性。默认值为M
linkmans
.store_linkman_birthday
timestamp 门店联系人生日
linkmans
.store_linkman_email
VARCHAR(100) 门店联系人电子邮件
linkmans
.store_linkman_remarks
VARCHAR(4000) 门店联系人备注
linkmans
.store_linkman_main
VARCHAR(1) 是否为主联系人。0:否,1:是。默认值为0
linkmans
.store_linkman_qq
VARCHAR(100) 门店联系人qq
linkmans
.store_linkman_weixin
VARCHAR(100) 门店联系人微信
linkmans
.store_linkman_dept
VARCHAR(200) 门店联系人部门
linkmans
.store_linkman_intimacy
VARCHAR(50) 门店联系人亲密度
linkmans
.store_linkman_importance
VARCHAR(50) 门店联系人重要关系
linkmans
.store_linkman
_decision_relationship
VARCHAR(50) 门店联系人决策关系
linkmans
.store_linkman_id
VARCHAR(100) 门店联系人第三方id,来源于第三方唯一标识,校验唯一性
exts List 门店信息扩展字段列表
exts.store_ext_key VARCHAR(100) 门店扩展字段key值, 门店扩展字段需先在我方系统门店管理中创建
exts.store_ext_value VARCHAR(4000) 门店扩展字段value值对多个选项值,以“,”分隔拼接
deliverys List 门店收货地址列表
deliverys
.store_delivery_main
VARCHAR(1) 门店收获地址是否为默认收获地址可选值。0:否,1:是。当存在门店收货人信息时,此字段默认为“0”
deliverys
.store_delivery_name
VARCHAR(32) 收货人名称
deliverys
.store_delivery_tel
VARCHAR(32) 收货电话
deliverys
.store_delivery_phone
VARCHAR(32) 收货手机号
deliverys
.store_delivery_addr
VARCHAR(4000) 收货地址
deliverys
.store_delivery_ex1
VARCHAR(200) 收货地址扩展字段1
deliverys
.store_delivery_ex2
VARCHAR(200) 收货地址扩展字段2
deliverys
.store_delivery_ex3
VARCHAR(200) 收货地址扩展字段3
deliverys
.store_delivery_id
VARCHAR(100) 收货地址第三方唯一标识,校验唯一性
cm_receive_info List 门店收货方列表
store_receive_info
.store_id
VARCHAR(32) 门店收货方唯一标识,来源于第三方系统的唯一客户标识,store_waiqin_365_id、store_id、store_code如果同时存在,优先级依次降低
store_receive_info
.store_waiqin_365_id
VARCHAR(32) 门店收货方对应的勤策(原外勤365)的id,store_waiqin_365_id、store_id、store_code如果同时存在,优先级依次降低
store_receive_info
.store_code
VARCHAR(32) 门店收货方编码,store_waiqin_365_id、store_id、store_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/store/v1/modifyStore/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

参数说明:

{
    "store_id": "CM0001",
    "store_name": "苏果夫子庙店",
    "store_code": "suguo_fzmd",
    "store_manager": "王伟,张强,吴为",
    "store_manager_id": "emp001,emp002",
    "store_emp_code": "yuangong1",
    "store_org_code": "1202001",
    "dealer_name": "经销商1,经销商2",
    "dealer_id": "JSX001,JXS002",
    "autarky_name": "自营经销商1,自营经销商2",
    "autarky_id": "ZYJSX001,ZYJXS002",
    "store_type": "大型超市",
    "store_district": "华中大区,南京分区,秦淮社区",
    "store_mss_province": "江苏省",
    "store_mss_city": "南京市",
    "store_mss_area": "秦淮区",
    "store_mss_street": "红花街道",
    "store_addr": "南京市秦淮区大全福巷1号",
    "store_delivery_addr": "南京市秦淮区大四福巷10号",
    "store_cooperate_status": "1",
    "store_ka_sys": "连锁品牌",
    "store_tel": "02552416854",
    "store_fax": "02552416854",
    "store_post": "210010",
    "store_remarks": "",
    "store_residents_id": "emp001,emp002",
    "store_residents": "王伟,张强",
    "store_label": "标签1,标签2",
    "store_assistant_id": "7053012386494123505,6954172928161735690",
    "store_assistant_name": "王伟,张强",
    "store_road_msg": "道路信息",
    "store_pictures": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "store_house_number": "门牌号信息",
    "store_liscence": "https://image.waiqin365.com/7203760635523959962/cm/photo/cd3c282b1302498781c77d26fbdde351.png",
    "store_liscence_name": "营业执照信息",
    "store_registration_no": "工商注册号信息",
    "store_registration_date": "2019-10-21",
    "store_operator": "经营者信息",
    "store_sale_direct": "是",
    "store_location": "28.153774,112.986099",
    "deliverys": [
        {
            "store_delivery_main": "0",
            "store_delivery_name": "张三",
            "store_delivery_tel": "52365895",
            "store_delivery_phone": "13052125555",
            "store_delivery_addr": "南京路XXXX号",
            "store_delivery_ex1":"",
            "store_delivery_ex2":"",
            "store_delivery_ex3":"",
            "store_delivery_id":"nw001"
        }
    ],
    "linkmans": [
        {
            "store_linkman_name": "张三",
            "store_linkman_job": "店主",
            "store_linkman_mobile": "13052125555",
            "store_linkman_office_tel": "52365895",
            "store_linkman_fax": "25758545",
            "store_linkman_sex": "M",
            "store_linkman_birthday": "1980-02-06",
            "store_linkman_email": "abc@163.com",
            "store_linkman_remarks": "",
            "store_linkman_main": "1",
            "store_linkman_qq": "qq",
            "store_linkman_weixin": "weixin",
            "store_linkman_dept": "部门",
            "store_linkman_intimacy":"一星",
            "store_linkman_importance":"重要",
            "store_linkman_decision_relationship":"决策人",
            "store_linkman_id":"nw001"
        },
        {
            "store_linkman_name": "李四",
            "store_linkman_job": "店员",
            "store_linkman_mobile": "13022215212",
            "store_linkman_office_tel": "58755254",
            "store_linkman_fax": "",
            "store_linkman_sex": "F",
            "store_linkman_birthday": "1981-02-14",
            "store_linkman_email": "",
            "store_linkman_remarks": "",
            "store_linkman_main": "0",
            "store_linkman_qq": "qq",
            "store_linkman_weixin": "weixin",
            "store_linkman_dept": "部门",
            "store_linkman_intimacy":"一星",
            "store_linkman_importance":"重要",
            "store_linkman_decision_relationship":"决策人",
             "store_linkman_id":"nw002"
        }
    ],
    "exts": [
        {
            "store_ext_key": "级别",
            "store_ext_value": "四星"
        },
        {
            "store_ext_key": "主营商品",
            "store_ext_value": "食品,电器,日化用品"
        }
    ],
    "store_receive_info":[
        {
            "store_id": "zt001",
            "store_waiqin_365_id": "98000123465333545",
            "store_code": "zt001"
        }
      ] 
}  
说明: 本示例仅供参考。
参数 类型 必填 说明
store_waiqin_id VARCHAR(32) 勤策(原外勤365)的门店唯一ID,和来源于第三方系统门店唯一ID(store_id)作为更新数据的唯一标识,所以不能同时为空
store_id VARCHAR(32) 来源于第三方系统的门店唯一ID,对应新增门店 (store_id)字段,只有当数据来源于新增接口时才有值,如果数据从勤策(原外勤365)系统中直接创建则该字段值为空。 调用此接口时该字段值(store_id)和勤策(原外勤365)的门店唯一ID(store_waiqin_id)作为更新数据的唯一标识,所以不能同时为空, 如果两个值同时存在则优先顺序为store_waiqin_idstore_id
store_name VARCHAR(100) 门店名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
store_code VARCHAR(32) 门店编码,有效字符详见附录:有效字符说明 (opens new window)
store_manager_id VARCHAR(4000) 门店客户经理唯一标识,多客户经理唯一标识间以“,”分隔。来源于第三方系统的员工唯一标识和员工信息中emp_id对应。 如:EMP0001, EMP0002, EMP0003
store_emp_code VARCHAR(32) 客户经理code(即为员工登录账号),多客户经理唯一标识间以“,”分隔。
store_org_code VARCHAR(32) 门店所属部门code
store_manager_waiqin365_id VARCHAR(4000) 门店客户经理唯一标识,多客户经理唯一标识间以“,”分隔。 外勤唯一主键,store_manager_waiqin365_id、store_manager_id、store_manager如果同时存在,优先级依次降低
store_manager VARCHAR(4000) 门店客户经理名称。多客户经理名称间以“,”分隔,如:张三,李四,王五。store_manager_waiqin365_id、store_manager_id、store_manager如果同时存在,优先级依次降低
dealer_name VARCHAR(4000) 所属的经销商名称,多个经销商以英文逗号分隔“,”,如:经销商1,经销商2。dealer_name、dealer_id如果同时存在,优先级依次降低
dealer_id VARCHAR(4000) 所属经销商唯一标识,来源于第三方系统的经销商唯一标识。多个经销商以英文逗号“,”分隔。如:JSX0001,JSX0002
autarky_name VARCHAR(4000) 自营经销商名称,多个自营经销商以英文逗号分隔“,”,如:自营经销商1,自营经销商2。autarky_name、autarky_id如果同时存在优先取autarky_id
autarky_id VARCHAR(4000) 自营经销商唯一标识,来源于第三方系统的自营经销商唯一标识。多个自营经销商以英文逗号“,”分隔。如:ZYJSX0001,ZYJSX0002
store_type_code VARCHAR(100) 门店类型编码
store_type VARCHAR(100) 门店类型名称,store_type、store_type_code如果同时存在优先取store_type_code
store_district_waiqin365_id VARCHAR(32) 门店所属销售区域ID,来源于勤策(原外勤365)的销售区域唯一ID
store_third_district_id VARCHAR(32) 第三方销售区域ID,来源于第三方系统的唯一销售区域标识
store_district VARCHAR(1000) 门店所属销售区域,此字段需要销售区域的完整层级结构, 多层级间以“,”分隔,如:华中大区,南京分区,秦淮社区。store_district、store_district_waiqin365_id如果同时存在优先取store_district_waiqin365_id
此字段从2022年01月01日起废弃,使用store_district_waiqin365_idstore_third_district_id替代,新增或修改销售区域时直接使用销售区域管理接口。
store_dept_waiqin365_id VARCHAR(32) 门店所属部门ID,来源于勤策(原外勤365)部门唯一ID
store_dept_id VARCHAR(32) 门店所属部门唯一标识,来源于第三方系统的部门唯一标识和部门信息中org_id对应,store_dept_id、store_dept_waiqin365_id如果同时存在优先取store_dept_waiqin365_id
store_mss_province VARCHAR(32) 门店所属行政区域-省名称,如是直辖市,省和市请传一样的值
store_mss_city VARCHAR(32) 门店所属行政区域-市名称,如是直辖市,省和市请传一样的值
store_mss_area VARCHAR(32) 门店所属行政区域-县名称,如是直筒子市,市和县请传一样的值
store_mss_street VARCHAR(32) 门店所属行政区域-乡镇街道名称
store_addr VARCHAR(4000) 门店地址
store_cooperate_status CHAR(1) 合作状态编码。0:终止合作,1:合作中,2:未合作,3:有意向
store_cooperate_status_name VARCHAR(32) 合作状态:终止合作/合作中/未合作/有意向/{自定义的},store_cooperate_status_name、store_cooperate_status如果同时存在优先取store_cooperate_status
store_ka_sys VARCHAR(100) 连锁品牌
store_level VARCHAR(100) 门店级别
store_tel VARCHAR(32) 门店电话, 如:02544550010或025-44550010
store_fax VARCHAR(32) 门店传真, 如:02544550010或025-44550010
store_post VARCHAR(32) 门店邮编
store_remarks VARCHAR(4000) 门店备注
store_residents_id VARCHAR(4000) 门店驻店人员唯一标识。多驻店人员唯一标识以“,”分隔
store_residents VARCHAR(4000) 门店驻店人员名称。多驻店人员以“,”分隔
store_label VARCHAR(4000) 门店标签名称。多标签以“,”分隔
store_assistant_id VARCHAR(4000) 门店协助员唯一标识。多协助员唯一标识以“,”分隔,来源于勤策(原外勤365)员工唯一标识。store_assistant_id、store_assistant_name如果同时存在优先取store_assistant_id
store_assistant_name VARCHAR(4000) 门店协助员名称。多协助员名称以“,”分隔
store_road_msg VARCHAR(4000) 门店道路信息
store_pictures VARCHAR(4000) 门店门头照,图片下载url
store_house_number VARCHAR(4000) 门店门牌号信息
store_liscence VARCHAR(4000) 门店营业执照,传图片下载url;传多个url时,以“,”分隔拼接
store_liscence_name VARCHAR(4000) 门店营业执照信息
store_registration_no VARCHAR(4000) 门店工商注册号信息
store_registration_date timestamp 门店注册日期。格式:yyyy-MM-dd
store_operator VARCHAR(4000) 门店经营者信息
store_sale_direct VARCHAR(1) 是否直接交易客户。只能填写“是”、“否”
store_linkman_full_sync VARCHAR(1) 门店联系人全量同步标识,需要使用,传1,将以接口中数据覆盖系统中数据;如无需使用,不传任何值
store_delivery_full_sync VARCHAR(1) 门店收货地址全量同步标识,需要使用,传1,将以接口中数据覆盖系统中数据;如无需使用,不传任何值
store_selling_area VARCHAR(10) 门店营业面积
store_cashiers_num VARCHAR(10) 门店收银台个数
store_shelf_num VARCHAR(10) 门店货架组数
store_total_num VARCHAR(10) 门店总排面数
store_self_product_num VARCHAR(10) 门店本品排面数
store_open_time timestamp 门店营业开始时间。格式:yyyy-MM-dd HH:mm:ss
store_close_time timestamp 门店营业结束时间。格式:yyyy-MM-dd HH:mm:ss
store_location VARCHAR(100) 门店纬经度。坐标格式为"纬度,经度",如:28.153774,112.986099
store_delivery_addr VARCHAR(200) 收货地址
linkmans List 门店联系人列表
linkmans
.store_linkman_name
VARCHAR(100) 门店联系人名称
linkmans
.store_linkman_job
VARCHAR(32) 门店联系人职务
linkmans
.store_linkman_mobile
VARCHAR(32) 门店联系人手机
linkmans
.store_linkman_office_tel
VARCHAR(32) 门店联系人固定电话,如:02544550010或025-44550010
linkmans
.store_linkman_fax
VARCHAR(32) 门店联系人传真,如:02544550010或025-44550010
linkmans
.store_linkman_sex
VARCHAR(1) 门店联系人性别。F:女性,M:男性,默认值为M
linkmans
.store_linkman_birthday
timestamp 门店联系人生日
linkmans
.store_linkman_email
VARCHAR(100) 门店联系人电子邮件
linkmans
.store_linkman_remarks
VARCHAR(4000) 门店联系人备注
linkmans
.store_linkman_main
VARCHAR(1) 是否为主联系人。0:否,1:是。默认值为0
linkmans
.store_linkman_qq
VARCHAR(100) 门店联系人qq
linkmans
.store_linkman_weixin
VARCHAR(100) 门店联系人微信
linkmans
.store_linkman_dept
VARCHAR(200) 门店联系人部门
linkmans
.store_linkman_intimacy
VARCHAR(50) 门店联系人亲密度
linkmans
.store_linkman_importance
VARCHAR(50) 门店联系人重要关系
linkmans
.store_linkman
_decision_relationship
VARCHAR(50) 门店联系人决策关系
linkmans
.store_linkman_id
VARCHAR(100) 门店联系人第三方id,来源于第三方唯一标识,校验唯一性
exts List 门店信息扩展字段列表
exts.store_ext_key VARCHAR(100) 门店扩展字段key值, 门店扩展字段需先在我方系统门店管理中创建
exts.store_ext_value VARCHAR(4000) 门店扩展字段value值对多个选项值,以“,”分隔拼接
deliverys List 门店收货地址列表
deliverys
.store_delivery_main
VARCHAR(1) 是否为默认收获地址。0:否,1:是。默认值为0
deliverys
.store_delivery_name
VARCHAR(32) 收货人名称
deliverys
.store_delivery_tel
VARCHAR(32) 收货电话
deliverys
.store_delivery_phone
VARCHAR(32) 收货手机号
deliverys
.store_delivery_addr
VARCHAR(200) 收货地址
deliverys
.store_delivery_ex1
VARCHAR(200) 收货地址扩展字段1
deliverys
.store_delivery_ex2
VARCHAR(200) 收货地址扩展字段2
deliverys
.store_delivery_ex3
VARCHAR(200) 收货地址扩展字段3
deliverys
.store_delivery_id
VARCHAR(100) 收货地址第三方唯一标识,校验唯一性
cm_receive_info List 门店收货方列表
store_receive_info
.store_id
VARCHAR(32) 门店收货方唯一标识,来源于第三方系统的唯一客户标识,store_waiqin_365_id、store_id、store_code如果同时存在,优先级依次降低
store_receive_info
.store_waiqin_365_id
VARCHAR(32) 门店收货方对应的勤策(原外勤365)的id,store_waiqin_365_id、store_id、store_code如果同时存在,优先级依次降低
store_receive_info
.store_code
VARCHAR(32) 门店收货方编码,store_waiqin_365_id、store_id、store_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/store/v1/removeStore/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "store_id": "store0001",
    "store_waiqin_id": "store0001"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
store_id VARCHAR(32) 来源于第三方系统的门店唯一ID,对应新增门店 (store_id)字段,只有当数据来源于新增接口时才有值,如果数据从勤策(原外勤365)系统中直接创建则该字段值为空
store_waiqin_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/store/v1/recoverStore/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "store_id": "CM0001",
    "store_waiqin365_id": "8397938754676734"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
store_id VARCHAR(32) 来源于第三方的客户唯一标识,和勤策(原外勤365)的客户唯一标识不能同时为空
store_waiqin365_id LONG 勤策(原外勤365)的客户唯一标识,和第三方的客户唯一标识不能同时为空

响应示例:

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

{
    "page_number": "1",
    "store_id": "CM0001",
    "store_name": "苏果夫子庙店",
    "store_code": "suguo_fzmd",
    "store_type_code": "001",
    "store_type": "大型超市",
    "store_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",
    "store_manager_id": "5973487364548349847"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
page_number INT 分页页码,默认1
status CHAR(1) 记录状态。0:已删除,1:正常
id VARCHAR(32) 勤策(原外勤365)的门店唯一ID
store_id VARCHAR(32) 来源于第三方系统的门店唯一ID,对应新增门店 (store_id)字段,只有当数据来源于新增接口时才有值,如果数据从勤策(原外勤365)系统中直接创建则该字段值为空。 如果两个值同时存在则优先顺序为store_waiqin_idstore_id
store_name VARCHAR(100) 门店名称,唯一,有效字符详见附录:有效字符说明 (opens new window)
store_code VARCHAR(32) 门店编码,有效字符详见附录:有效字符说明 (opens new window)
store_manager_id VARCHAR(4000) 根据门店客户经理标识查询
store_type_code VARCHAR(100) 门店类型编码,store_type、store_type_code如果同时存在优先取store_type_code
store_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
store_district VARCHAR(1000) 门店所属销售区域,此字段需要销售区域的完整层级结构, 多层级间以“,”分隔,如:华中大区,南京分区,秦淮社区

响应示例:

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

数据DATA示例:


    [
        {
            "id": 6572271053202767748,
            "store_id": "CM0001",
            "creator_waiqin_id": "8830671133213284556",
            "creator_name": "丁金金",
            "creator_id": "5956995671401092891",
            "return_pool_reason": "打回测试",
            "store_code": "TEST00001",
            "store_name": "测试客户",
            "store_type": "终端门店",
            "store_type_code": "001",
            "store_manager": "张三,李四",
            "store_manager_waiqin365_id": "6907820106019252086,5597071445856845986",
            "store_dept_name": "销售部",
            "store_dept_waiqin365_id": "9121587515174713166",
            "store_dept_id": "",
            "store_photo": "cm/photo/c2a39abc769a49ca9f49221336d30f7e.jpg",
            "store_district": "测试区域",
            "store_district_full_path": "全部,江苏,南京,测试区域",
            "store_level": "金牌客户",
            "store_level_id": "5632595796469497568",
            "store_tel": "025-88999988",
            "store_fax": "025-88999987",
            "store_ka_sys": "苏果超市",
            "store_addr": "南京市建邺区嘉陵江东街50号",
            "store_delivery_addr": "",
            "store_mss_area": "鼓楼区",
            "store_mss_area_code": "320106",
            "store_mss_city": "南京市",
            "store_mss_city_code": "320100",
            "store_mss_province": "江苏省",
            "store_mss_province_code": "320000",
            "tradingarea": "新街口",
            "tradingarea_big": "核心城区",
            "store_status": "1",
            "create_time": "2018-05-18 14:39:12",
            "store_approval_status": "3",
            "store_cooperate_status": "1",
            "store_cooperate_status_id": "2",
            "store_remarks": "",
            "store_post": "",
            "store_district_id":"6081235751236711020",
            "store_district_waiqin365_id":"6081235751236765420",
            "store_third_district_id":"6081235751236711123",
            "store_district_create_time":"2017-09-09 13:14:11",
            "store_district_modify_time":"2017-10-09 23:14:11",
            "store_district_creator_name":"张三",
            "store_district_modifyier_name":"李四",
            "store_district_status":"1",
            "store_type_id":"4803341355190322405",
            "store_rel_level_id":"5669281775545680668",
            "store_mss_street":"华侨路街道",
            "store_mss_street_code":"320106002",
            "store_label":"标签1,标签2",
            "store_label_id":"7669281775545680666,2369281775545680667",
            "store_assistant_id":"8776918981000102550,6831633994841635708",
            "store_assistant_name":"张三,李四",
            "store_road_msg": "道路信息",
            "store_house_number": "门牌号信息",
            "store_liscence_name": "营业执照信息",
            "store_registration_no": "工商注册号信息",
            "store_registration_date": "2019-10-21",
            "store_operator": "经营者信息",
            "store_sale_direct": "是",
            "store_modify_time": "2019-10-21 17:20:36",
            "store_modifyier_name": "张三",
            "store_create_approval_time": "2019-10-21 17:20:36",
            "store_modify_approval_time": "2019-10-21 20:20:36",
            "store_source_type": "自建",
            "store_creator_code": "EMP001",
            "store_modifier_code": "EMP002",
            "store_manager_code": "EMP003",
            "dealers": [
                {
                   "dealer_name": "经销商1",
                   "waiqin365_dealer_order": "1" ,
                   "waiqin365_dealer_id": "6054085002157264655" ,
                   "dealer_id": ""
                },
                {
                   "dealer_name": "经销商2",
                   "waiqin365_dealer_order": "2" ,
                   "waiqin365_dealer_id": "6054085002157264656" ,
                   "dealer_id": ""
                }
            ],
            "autarky": [
                {
                   "autarky_dealer_name": "自营经销商1",
                   "autarky_waiqin365_dealer_id": "6544085442157264677" ,
                   "autarky_dealer_id": ""
                },
                {
                   "autarky_dealer_name": "自营经销商2",
                   "autarky_waiqin365_dealer_id": "606258930615121973" ,
                   "autarky_dealer_id": ""
                }
            ],
            "linkmans": [
                {
                    "store_linkman_name": "张三风",
                    "store_linkman_job": "店主",
                    "store_linkman_mobile": "13052125555",
                    "store_linkman_office_tel": "52365895",
                    "store_linkman_fax": "25758545",
                    "store_linkman_sex": "M",
                    "store_linkman_birthday": "1980-02-06",
                    "store_linkman_email": "abc@163.com",
                    "store_linkman_remarks": "",
                    "store_linkman_main": "1",
                    "store_linkman_qq": "qq",
                    "store_linkman_weixin": "weixin",
                    "store_linkman_dept": "部门",
                    "store_linkman_id": "L001",
                    "store_linkman_intimacy":"一星",
                    "store_linkman_importance":"重要",
                    "store_linkman_decision_relationship":"决策人",
                    "store_linkman_approval_status": "3"
                },
                {
                    "store_linkman_name": "李四光",
                    "store_linkman_job": "店员",
                    "store_linkman_mobile": "13022215212",
                    "store_linkman_office_tel": "58755254",
                    "store_linkman_fax": "",
                    "store_linkman_sex": "F",
                    "store_linkman_birthday": "1981-02-14",
                    "store_linkman_email": "",
                    "store_linkman_remarks": "",
                    "store_linkman_main": "0",
                    "store_linkman_qq": "qq",
                    "store_linkman_weixin": "weixin",
                    "store_linkman_dept": "部门",
                    "store_linkman_id": "L002",
                    "store_linkman_intimacy":"一星",
                    "store_linkman_importance":"重要",
                    "store_linkman_decision_relationship":"决策人",
                    "store_linkman_approval_status": "3"
                }
            ],
            "deliverys": [
                {
                    "store_delivery_main": "0",
                    "store_delivery_name": "张三",
                    "store_delivery_tel": "52365895",
                    "store_delivery_phone": "13052125555",
                    "store_delivery_addr": "南京路XXXX号",
                    "store_delivery_province": "江苏省",
                    "store_delivery_province_code": "320000",
                    "store_delivery_city": "南京市",
                    "store_delivery_city_code": "320100",
                    "store_delivery_area": "鼓楼区",
                    "store_delivery_area_code": "320101",
                    "store_delivery_ex1": "",
                    "store_delivery_ex2": "",
                    "store_delivery_ex3": "",
                    "store_delivery_id": "D001"
                }
            ],
            "exts": [
                {
                    "store_ext_column": "exdf_988765",
                    "store_ext_key": "级别",
                    "store_ext_value": "四星"
                },
                {
                    "store_ext_column": "exdf_832623",
                    "store_ext_key": "主营商品",
                    "store_ext_value": "食品,电器,日化用品"
                }
            ],
            "store_receive_info":[
                  {
                      "store_id": "zt001",
                      "store_waiqin_365_id": "98000123465333545",
                      "store_code": "zt001"
                  }
            ] 
        }
    ]

参数说明:

参数名称 参数类型 是否必填 参数说明
id VARCHAR(32) 勤策(原外勤365)的门店唯一ID
store_id VARCHAR(32) 来源于第三方系统的门店唯一ID,对应新增门店 (store_id)字段,只有当数据来源于新增接口时才有值,如果数据从勤策(原外勤365)系统中直接创建则该字段值为空
creator_waiqin_id VARCHAR(32) 创建人id,来源勤策(原外勤365)员工唯一ID
creator_name VARCHAR(100) 创建人名称
creator_id VARCHAR(100) 创建人id,来源第三方系统的唯一ID
return_pool_reason VARCHAR(4000) 退回原因
store_name VARCHAR(100) 门店名称
store_code VARCHAR(32) 门店编码
store_manager VARCHAR(4000) 门店经理。多门店经理名称间以“,”分隔。如:张三,李四,王五
store_manager_id VARCHAR(4000) 外勤门店经理id。第三方唯一标识,多门店经理id间以“,”分隔
store_manager_waiqin365_id VARCHAR(4000) 外勤门店经理id。外勤唯一标识,多门店经理id间以“,”分隔。store_manager_waiqin365_id、store_manager_id、store_manager如果同时存在,优先级依次降低
store_type VARCHAR(100) 门店类型名称
store_type_code VARCHAR(100) 门店类型编码
store_type_id VARCHAR(100) 门店类型id
store_level_id VARCHAR(32) 勤策(原外勤365)门店等级ID
store_level VARCHAR(32) 门店等级名称
store_dept_waiqin365_id VARCHAR(100) 勤策(原外勤365)门店所属部门ID
store_dept_id VARCHAR(100) 门店所属部门,来源第三方系统的唯一标识和部门信息中org_id对应
store_dept_name VARCHAR(100) 门店部门名称
store_district VARCHAR(1000) 门店所属销售区域,此字段为 销售区域的最末级结构
store_district_full_path VARCHAR(1000) 门店所属销售区域,此字段为销售区域的完整层级结构,多层级间以“,”分隔。 如:华中大区,南京分区,秦淮社区
store_district_waiqin365_id VARCHAR(1000) 门店所属销售区域ID,来源于勤策(原外勤365)的销售区域唯一ID
store_third_district_id VARCHAR(1000) 第三方销售区域id
store_mss_province VARCHAR(32) 门店所属行政区域-省份名称,如:北京市、江苏省
store_mss_province_code VARCHAR(32) 门店所属行政区域-省份编码,如:110000、320000
store_mss_city VARCHAR(32) 门店所属行政区域-城市名称,如:南京市
store_mss_city_code VARCHAR(32) 门店所属行政区域-城市编码,如:320100
store_mss_area VARCHAR(32) 门店所属行政区域-区县名称,如:鼓楼区
store_mss_area_code VARCHAR(32) 门店所属行政区域-区县编码,如:320106
store_mss_street VARCHAR(32) 门店所属行政区域-乡镇街道名称,如:宁海路街道
store_mss_street_code VARCHAR(32) 门店所属行政区域-乡镇街道编码,如:320106001
store_addr VARCHAR(4000) 门店所在地址
store_cooperate_status_id VARCHAR(32) 勤策(原外勤365)合作状态ID
store_cooperate_status CHAR(1) 合作状态编码。0:终止合作,1:合作中,2:未合作,3:有意向
store_ka_sys VARCHAR(100) 门店所属连锁品牌
store_tel VARCHAR(32) 门店电话,如:02544550010或025-44550010
store_fax VARCHAR(32) 门店传真,如:02544550010或025-44550010
store_post VARCHAR(32) 门店邮编
store_remarks VARCHAR(4000) 门店备注
tradingarea_big VARCHAR(100) 商圈等级
tradingarea VARCHAR(100) 商圈标签
tradingarea_level_code VARCHAR(100) 商圈等级编码
tradingarea_level_name VARCHAR(100) 商圈等级名称
store_district_id VARCHAR(32) 勤策(原外勤365)销售区域id。此字段从2021年8月01日起,对新创建第三方应用不再返回真实store_district_id,使用store_district_waiqin365_id代替store_district_id
store_district_create_time CHAR(19) 销售区域创建时间。格式:yyyy-MM-dd HH:mm:ss
store_district_modify_time CHAR(19) 销售区域修改时间。格式:yyyy-MM-dd HH:mm:ss
store_district_creator_name VARCHAR(100) 销售区域创建人
store_district_modifyier_name VARCHAR(100) 销售区域修改人
store_district_status CHAR(1) 销售区域状态。1:正常,0:删除。默认值为1
store_rel_level_id VARCHAR(100) 外勤客户层级id。“-1”表示是根节点
store_label VARCHAR(4000) 门店分层标签名称。多分层标签名称以“,”分隔
store_label_id VARCHAR(4000) 门店分层标签id。多分层标签id以“,”分隔
store_assistant_id VARCHAR(4000) 门店协助员唯一标识。多协助员唯一标识以“,”分隔
store_assistant_name VARCHAR(4000) 门店协助员名称。多协助员名称以“,”分隔
store_road_msg VARCHAR(4000) 门店道路信息
store_house_number VARCHAR(4000) 门店门牌号信息
store_liscence_name VARCHAR(4000) 门店营业执照信息
store_registration_no VARCHAR(4000) 门店工商注册号信息
store_registration_date VARCHAR(32) 门店注册日期。格式:yyyy-MM-dd
store_operator VARCHAR(4000) 门店经营者信息
store_sale_direct VARCHAR(1) 是否直接交易客户。0:是,1:否
store_modify_time VARCHAR(4) 门店修改时间。格式:yyyy-MM-dd HH:mm:ss
store_modifyier_name VARCHAR(19) 门店修改人名称
store_create_approval_time VARCHAR(32) 新增门店最终审批通过时间。格式:yyyy-MM-dd HH:mm:ss
store_modify_approval_time VARCHAR(19) 修改客户审批通过时间。格式:yyyy-MM-dd HH:mm:ss
store_source_type VARCHAR(32) 创建方式
store_selling_area VARCHAR(10) 门店营业面积
store_cashiers_num VARCHAR(10) 门店收银台个数
store_shelf_num VARCHAR(10) 门店货架组数
store_total_num VARCHAR(10) 门店总排面数
store_self_product_num VARCHAR(10) 门店本品排面数
store_open_time timestamp 门店营业开始时间。格式:yyyy-MM-dd HH:mm:ss
store_close_time timestamp 门店营业结束时间。格式:yyyy-MM-dd HH:mm:ss
store_pictures VARCHAR(4000) 门店门头照信息,多个以“,”号隔开
store_liscence VARCHAR(4000) 门店营业执照信息,多个以“,”号隔开
store_manager_code VARCHAR(4000) 门店客户经理编码,即为员工登录账号,多客户经理唯一标识间以英文“,”隔开
store_creator_code VARCHAR(100) 创建人编码
store_modifier_code VARCHAR(100) 修改人编码,取最新修改记录操作人
linkmans List 门店联系人列表
linkmans
.store_linkman_waiqin365_id
VARCHAR(32) 终端门店联系人勤策(原外勤365)Id
linkmans
.store_linkman_name
VARCHAR(100) 门店联系人名称
linkmans
.store_linkman_job
VARCHAR(32) 门店联系人职务
linkmans
.store_linkman_mobile
VARCHAR(32) 门店联系人手机
linkmans
.store_linkman_office_tel
VARCHAR(32) 门店联系人固定电话, 如:02544550010或025-44550010
linkmans
.store_linkman_fax
VARCHAR(32) 门店联系人传真, 如:02544550010或025-44550010
linkmans
.store_linkman_sex
VARCHAR(1) 门店联系人性别。F:女性,M:男性。默认值为M
linkmans
.store_linkman_birthday
VARCHAR() 门店联系人生日
linkmans
.store_linkman_email
VARCHAR(100) 门店联系人电子邮件
linkmans
.store_linkman_remarks
VARCHAR(4000) 门店联系人备注
linkmans
.store_linkman_main
VARCHAR(1) 是否为主联系人。0:否,1:是。默认值为0
linkmans
.store_linkman_qq
VARCHAR(100) 门店联系人qq
linkmans
.store_linkman_weixin
VARCHAR(100) 门店联系人微信
linkmans
.store_linkman_dept
VARCHAR(200) 门店联系人部门
linkmans
.store_linkman_id
VARCHAR(50) 门店联系人第三方id
linkmans
.store_linkman_intimacy
VARCHAR(50) 门店联系人亲密度
linkmans
.store_linkman_importance
VARCHAR(50) 门店联系人重要关系
linkmans
.store_linkman
_decision_relationship
VARCHAR(50) 门店联系人决策关系
linkmans
.store_linkman_modify_time
timestamp 门店联系人修改时间。格式:yyyy-MM-dd HH:mm:ss
linkmans
.store_linkman_approval_status
CHAR(1) 门店联系人审批状态。1:待审批,2:审批打回,3:审批通过
deliverys List 门店收货地址列表
deliverys
.store_delivery_waiqin365_id
VARCHAR(32) 经销商收货人勤策(原外勤365)Id
deliverys
.store_delivery_main
VARCHAR(1) 门店收获地址是否为默认收获地址可选值。0:否,1:是。当存在门店收货人信息时,此字段默认值为0
deliverys
.store_delivery_name
VARCHAR(32) 收货人名称
deliverys
.store_delivery_tel
VARCHAR(32) 收货电话
deliverys
.store_delivery_phone
VARCHAR(32) 收货手机号
deliverys
.store_delivery_addr
VARCHAR(4000) 收货地址
deliverys
.store_delivery_province
VARCHAR(32) 收货地址所属行政区域-省名称
deliverys
.store_delivery_province_code
VARCHAR(32) 收货地址所属行政区域-省编码
deliverys
.store_delivery_city
VARCHAR(32) 收货地址所属行政区域-市名称
deliverys
.store_delivery_city_code
VARCHAR(32) 收货地址所属行政区域-市编码
deliverys
.store_delivery_area
VARCHAR(32) 收货地址所属行政区域-区名称
deliverys
.store_delivery_area_code
VARCHAR(32) 收货地址所属行政区域-区编码
deliverys
.store_delivery_ex1
VARCHAR(200) 收货地址扩展字段1
deliverys
.store_delivery_ex2
VARCHAR(200) 收货地址扩展字段2
deliverys
.store_delivery_ex3
VARCHAR(200) 收货地址扩展字段3
deliverys
.store_delivery_id
VARCHAR(50) 收货地址第三方id
exts List 门店自定义字段列表
exts.store_ext_key VARCHAR(100) 门店扩展字段key值,门店扩展字段需先在我方系统门店管理中创建
exts.store_ext_value VARCHAR(4000) 门店扩展字段value值对多个选项值,以“,”分隔拼接
dealers List 所属经销商
dealers.waiqin365_dealer_order VARCHAR(32) 经销商排序序号
dealers.waiqin365_dealer_id VARCHAR(32) 所属的经销商勤策(原外勤365)中唯一标识
dealers.dealer_id VARCHAR(4000) 所属经销商,来源于第三方系统的经销商唯一标识
dealers.dealer_name VARCHAR(4000) 所属的经销商名称
autarky List 自营所属经销商列表
autarky.autarky_dealer_name VARCHAR(50) 自营所属经销商名称
autarky.autarky_dealer_id VARCHAR(50) 自营经销商第三方唯一标识
autarky.autarky_waiqin365_dealer_id VARCHAR(50) 自营经销商勤策(原外勤365)中唯一标识
store_approval_status CHAR(1) 门店审批状态。1:待审批,2:审批打回,3:审批通过
store_status CHAR(1) 门店删除状态。0:删除,1:正常
create_time CHAR(19) 创建日期。格式:yyyy-MM-dd HH:mm:ss
store_receive_info List 门店收货方列表
store_receive_info
.store_id
VARCHAR(32) 来源于第三方系统门店收货方唯一标识
store_receive_info
.store_waiqin_365_id
VARCHAR(32) 门店收货方勤策(原外勤365)的唯一ID
store_receive_info
.store_code
VARCHAR(32) 门店编码

# 门店合作状态变更

请求方式: POST(HTTPS
请求地址: https://openapi.waiqin365.com/api/store/v1/modifyStoreCooperateStatus/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "store_id": "store0001",
    "store_cooperate_status": "0"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
store_id VARCHAR(32) 来源于第三方系统的门店唯一ID,对应新增门店 (store_id)字段,只有当数据来源于新增接口时才有值,如果数据从勤策(原外勤365)系统中直接创建则该字段值为空。 调用此接口时该字段值(store_id)和勤策(原外勤365)的门店唯一ID(store_waiqin_id)作为更新数据的唯一标识,所以不能同时为空, 如果两个值同时存在则优先顺序为store_waiqin_idstore_id
store_waiqin365_id VARCHAR(32) 勤策(原外勤365)的门店唯一ID,和来源于第三方系统门店唯一ID(store_id)作为更新数据的唯一标识,所以不能同时为空
store_cooperate_status CHAR(1) 合作状态编码。0:终止合作,1:合作中,2:未合作,3:有意向
store_cooperate_status_name VARCHAR(32) 合作状态:终止合作/合作中/未合作/有意向/{自定义的},store_cooperate_status_name、store_cooperate_status如果同时存在优先取store_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/store/v1/assignStoreToEmp/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "store_id": "store0001",
    "emp_id": " EMP0001, EMP0002, EMP0003"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
store_id VARCHAR(32) 来源于第三方系统的门店唯一ID,对应新增门店 (store_id)字段,只有当数据来源于新增接口时才有值,如果数据从勤策(原外勤365)系统中直接创建则该字段值为空。 调用此接口时该字段值(store_id)和勤策(原外勤365)的门店唯一ID(store_waiqin_id)作为更新数据的唯一标识,所以不能同时为空, 如果两个值同时存在则优先顺序为store_waiqin_idstore_id
store_waiqin365_id VARCHAR(32) 勤策(原外勤365)的门店唯一ID,和来源于第三方系统门店唯一ID(store_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/store/v1/assignStoreToOrg/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例:

{
    "store_id": "store0001",
    "org_id": " ORG0001, ORG0002, ORG0003"
}
说明: 本示例仅供参考。

参数说明:

参数 类型 必填 说明
store_id VARCHAR(32) 来源于第三方系统的门店唯一ID,对应新增门店 (store_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 响应说明