开放接口API说明-门店接口

参数名称 参数值
应用编码 store
应用版本 v1
接口名称 新增门店
接口编码 addStore
接口URL https://openapi.waiqin365.com/api/store/v1/addStore/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
store_id VARCHAR(32) 门店唯一标识,来源于第三方系统的门店唯一标识。有效字符详见附录:编码类型参照表
store_name VARCHAR(100) 门店名称,唯一,有效字符详见名称类型参照表
store_code VARCHAR(32) 门店编码,唯一,有效字符详见附录:编码类型参照表
store_manager_id VARCHAR(4000) 门店客户经理唯一标识,多客户经理唯一标识间以“,”分隔。来源于第三方系统的员工唯一标识和员工信息中emp_id对应。 如:EMP0001, EMP0002, EMP0003
store_manager VARCHAR(4000) 门店客户经理名称。多客户经理名称间以“,”分隔。如果和store_manager_id同时传入时,以store_manager_id数据为准。如:张三,李四,王五。
dealer_name VARCHAR(4000) 所属的经销商名称,多个经销商以英文逗号分隔“,”。如果和所属经销商唯一标识dealer_id同时传时,以dealer_id为数据准。如:经销商1,经销商2
dealer_id VARCHAR(4000) 所属经销商唯一标识,来源于第三方系统的经销商唯一标识。多个经销商以英文逗号“,”分隔。如:JSX0001,JSX0002
store_type_code VARCHAR(100) 门店类型编码
store_type VARCHAR(100) 门店类型名称,如果和门店类型编码store_type_code都传时,以store_type_code数据为准
store_district_waiqin365_id VARCHAR(32) 门店所属销售区域ID,来源于外勤365的销售区域唯一ID。
store_district VARCHAR(1000) 门店所属销售区域,此字段需要销售区域的完整层级结构,
多层级间以“,”分隔。如果和外勤365经销商销售区域IDstore_district_waiqin365_id同时传入时,以store_district_waiqin365_id数据为准。如:华中大区,南京分区,秦淮社区
store_dept_waiqin365_id VARCHAR(32) 门店所属部门ID,来源于外勤365部门唯一ID
store_dept_id VARCHAR(32) 门店所属部门唯一标识,来源于第三方系统的部门唯一标识和部门信息中org_id对应,如果和门店所属部门IDstore_dept_waiqin365_id同时传入时,以store_dept_waiqin365_id数据为准
store_mss_province VARCHAR(32) 门店所属行政区域-省名称
store_mss_city VARCHAR(32) 门店所属行政区域-市名称
store_mss_area VARCHAR(32) 门店所属行政区域-县名称
store_addr VARCHAR(4000) 门店地址
store_cooperate_status CHAR(1) 合作状态编码, 0-终止合作 1-合作中, 2-未合作, 3-有意向
store_cooperate_status_name VARCHAR(32) 合作状态: 终止合作/合作中/未合作/有意向/{自定义的},如果和合作状态编码store_cooperate_status同时传入字段,则以store_cooperate_status数据为准
store_ka_sys VARCHAR(100) Ka系统
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) 门店备注
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) 门店联系人部门
exts[].store_ext_key VARCHAR(100) 门店扩展字段key值,
门店扩展字段需先在我方系统门店管理中创建。
exts[].store_ext_value VARCHAR(4000) 门店扩展字段value值对多个选项值,以“,”分隔拼接。
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 varchar200 收货地址扩展字段1
deliverys[].store_delivery_ex2 varchar200 收货地址扩展字段2
deliverys[].store_delivery_ex3 varchar200 收货地址扩展字段3
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "store_id": "CM0001",
    "store_name": "苏果夫子庙店",
    "store_code": "suguo_fzmd",
    "store_manager": "王伟,张强,吴为",
    "store_manager_id": "emp001,emp002",
    "dealer_name": "经销商1,经销商2",
    "dealer_id": "JSX001,JXS002",
    "store_type": "大型超市",
    "store_district": "华中大区,南京分区,秦淮社区",
    "store_mss_province": "江苏省",
    "store_mss_city": "南京市",
    "store_mss_area": "秦淮区",
    "store_addr": "南京市秦淮区大全福巷1号",
    "store_cooperate_status": "1",
    "store_ka_sys": "ka系统",
    "store_tel": "02552416854",
    "store_fax": "02552416854",
    "store_post": "210010",
    "store_remarks": "",
    "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":""
        }
    ],
    "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_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": "部门"
        }
    ],
    "exts": [
        {
            "store_ext_key": "级别",
            "store_ext_value": "四星"
        },
        {
            "store_ext_key": "主营商品",
            "store_ext_value": "食品,电器,日化用品"
        }
    ]
}

// 响应信息示例:
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}
                  
参数名称 参数值
应用编码 store
应用版本 v1
接口名称 修改门店
接口编码 modifyStore
接口URL https://openapi.waiqin365.com/api/store/v1/modifyStore/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
store_waiqin_id VARCHAR(32) 外勤365门店唯一标识,用于更新门店信息
和store_id至少要传一个
store_id VARCHAR(32) 门店唯一标识,有效字符详见附录:编码类型参照表
store_name VARCHAR(100) 门店名称,唯一,有效字符详见附录:编码类型参照表
store_code VARCHAR(32) 门店编码,有效字符详见附录:编码类型参照表
store_manager_id VARCHAR(4000) 门店客户经理唯一标识,多客户经理唯一标识间以“,”分隔。来源于第三方系统的员工唯一标识和员工信息中emp_id对应。 如:EMP0001, EMP0002, EMP0003
store_manager VARCHAR(4000) 门店客户经理名称。多客户经理名称间以“,”分隔。如果和store_manager_id同时传入时,以store_manager_id数据为准。如:张三,李四,王五。
dealer_name VARCHAR(4000) 所属的经销商名称,多个经销商以英文逗号分隔“,”。如果和所属经销商唯一标识dealer_id同时传时,以dealer_id为数据准。如:经销商1,经销商2
dealer_id VARCHAR(4000) 所属经销商唯一标识,来源于第三方系统的经销商唯一标识。多个经销商以英文逗号“,”分隔。如:JSX0001,JSX0002
store_type_code VARCHAR(100) 门店类型编码
store_type VARCHAR(100) 门店类型名称,如果和门店类型编码store_type_code都传时,以store_type_code数据为准
store_district_waiqin365_id VARCHAR(32) 门店所属销售区域ID,来源于外勤365的销售区域唯一ID。
store_district VARCHAR(1000) 门店所属销售区域,此字段需要销售区域的完整层级结构,
多层级间以“,”分隔。如果和外勤365经销商销售区域IDstore_district_waiqin365_id同时传入时,以store_district_waiqin365_id数据为准。如:华中大区,南京分区,秦淮社区
store_dept_waiqin365_id VARCHAR(32) 门店所属部门ID,来源于外勤365部门唯一ID
store_dept_id VARCHAR(32) 门店所属部门唯一标识,来源于第三方系统的部门唯一标识和部门信息中org_id对应,如果和门店所属部门IDstore_dept_waiqin365_id同时传入时,以store_dept_waiqin365_id数据为准
store_mss_province VARCHAR(32) 门店所属行政区域-省
store_mss_city VARCHAR(32) 门店所属行政区域-市
store_mss_area VARCHAR(32) 门店所属行政区域-县
store_addr VARCHAR(4000) 门店地址
store_cooperate_status CHAR(1) 合作状态编码, 0-终止合作 1-合作中, 2-未合作, 3-有意向
store_cooperate_status_name VARCHAR(32) 合作状态:终止合作/合作中/未合作/有意向/{自定义的},如果和合作状态编码store_cooperate_status同时传入字段,则以store_cooperate_status数据为准
store_ka_sys VARCHAR(100) Ka系统
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) 门店备注
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) 门店联系人部门
exts[].store_ext_key VARCHAR(100) 门店扩展字段key值,
门店扩展字段需先在我方系统门店管理中创建。
exts[].store_ext_value VARCHAR(4000) 门店扩展字段value值对多个选项值,以“,”分隔拼接。
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 varchar200 收货地址扩展字段1
deliverys[].store_delivery_ex2 varchar200 收货地址扩展字段2
deliverys[].store_delivery_ex3 varchar200 收货地址扩展字段3
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "store_id": "CM0001",
    "store_name": "苏果夫子庙店",
    "store_code": "suguo_fzmd",
    "store_manager": "王伟,张强,吴为",
    "store_manager_id": "emp001,emp002",
    "dealer_name": "经销商1,经销商2",
    "dealer_id": "JSX001,JXS002",
    "store_type": "大型超市",
    "store_district": "华中大区,南京分区,秦淮社区",
    "store_mss_province": "江苏省",
    "store_mss_city": "南京市",
    "store_mss_area": "秦淮区",
    "store_addr": "南京市秦淮区大全福巷1号",
    "store_delivery_addr": "南京市秦淮区大四福巷10号",
    "store_cooperate_status": "1",
    "store_ka_sys": "ka系统",
    "store_tel": "02552416854",
    "store_fax": "02552416854",
    "store_post": "210010",
    "store_remarks": "",
    "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":""
        }
    ],
    "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_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": "部门"
        }
    ],
    "exts": [
        {
            "store_ext_key": "级别",
            "store_ext_value": "四星"
        },
        {
            "store_ext_key": "主营商品",
            "store_ext_value": "食品,电器,日化用品"
        }
    ]
}

// 响应信息示例:
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}
                  
参数名称 参数值
应用编码 store
应用版本 v1
接口名称 删除门店
接口编码 removeStore
接口URL https://openapi.waiqin365.com/api/store/v1/removeStore/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
store_id VARCHAR(32) 门店唯一标识,有效字符详见附录:编码类型参照表
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "store_id": "store0001"
}

// 响应信息示例:
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}
                  
参数名称 参数值
应用编码 store
应用版本 v1
接口名称 查询门店
接口编码 queryStore
接口URL https://openapi.waiqin365.com/api/store/v1/queryStore/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
page_number INT 页码默认1,每页最大1000条
status CHAR(1) 记录状态:0 已删除 1 正常
id VARCHAR(32) 外勤365门店唯一ID
store_id VARCHAR(32) 门店唯一标识,有效字符详见附录:编码类型参照表
store_name VARCHAR(100) 门店名称,唯一,有效字符详见名称类型参照表
store_code VARCHAR(32) 门店编码,有效字符详见附录:编码类型参照表
store_manager_id VARCHAR(4000) 根据门店经理标识查询,来源于第三方系统的员工唯一标识
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”
create_date CHAR(10) 创建日期,查询创建日期为某天的门店数据,格式:“yyyy-MM-dd”
modify_date CHAR(10) 修改日期,格式:“yyyy-MM-dd”
响应信息 参数名称 参数类型 是否必填 参数说明
id VARCHAR(32) 门店ID,外勤365的门店唯一ID
store_id VARCHAR(32) 来源于第三方系统的门店唯一标识
store_name VARCHAR(100) 门店名称
store_code VARCHAR(32) 门店编码
store_manager VARCHAR(4000) 门店经理。多门店经理名称间以“,”分隔。如:张三,李四,王五。
store_type VARCHAR(100) 门店类型名称
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_mss_province VARCHAR(32) 门店所属行政区域-省份名称,如:北京市、江苏省
store_mss_city VARCHAR(32) 门店所属行政区域-城市名称,如:南京市
store_mss_area VARCHAR(32) 门店所属行政区域-区县名称,如:鼓楼区
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) 门店所属KA系统名称
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) 商圈名称
store_district_id VARCHAR(32) 外勤365销售区域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删除
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) 门店联系人部门
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
exts[].store_ext_key VARCHAR(100) 门店扩展字段key值,
门店扩展字段需先在我方系统门店管理中创建。
exts[].store_ext_value VARCHAR(4000) 门店扩展字段value值对多个选项值,以“,”分隔拼接。
dealers[].waiqin365_dealer_id VARCHAR(32) 所属的经销商外勤365中唯一标识
dealers[].dealer_id VARCHAR(4000) 所属经销商,来源于第三方系统的经销商唯一标识。
dealers[].dealer_name VARCHAR(4000) 所属的经销商名称
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_id": "CM0001",
    "store_name": "苏果夫子庙店",
    "store_code": "suguo_fzmd",
    "store_manager": "王伟,张强,吴为",
    "store_type": "大型超市",
    "store_district": "华中大区,南京分区,秦淮社区",
    "create_date": "2015-05-12",
    "modify_date": "2015-05-12"
}

// 响应信息示例:
{
    "return_code": "0",
    "return_msg": "",
    "msg_id": "a59ec28f234845c38e5b206133b0ff3e",
    "response_data": "
    [
        {
            "id": 6572271053202767748,
            "store_id": "",
            "store_code": "TEST00001",
            "store_name": "测试客户",
            "store_type": "终端门店",
            "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_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_city": "南京市",
            "store_mss_province": "江苏省",
            "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_location": "",
            "store_remarks": "",
            "store_post": "",
            "store_district_id":"6081235751236711020",
            "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",
            "dealers": [
                {
                   "dealer_name": "经销商1",
                   "waiqin365_dealer_id": "6054085002157264655" ,
                   "dealer_id": ""
                },
                {
                   "dealer_name": "经销商2",
                   "waiqin365_dealer_id": "6054085002157264656" ,
                   "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_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": "部门"
                }
            ],
            "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": ""
                }
            ],
            "exts": [
                {
                    "store_ext_key": "级别",
                    "store_ext_value": "四星"
                },
                {
                    "store_ext_key": "主营商品",
                    "store_ext_value": "食品,电器,日化用品"
                }
            ]
        }
    ]"
}
                  
参数名称 参数值
应用编码 store
应用版本 v1
接口名称 合作状态变更
接口编码 modifyStoreCooperateStatus
接口URL https://openapi.waiqin365.com/api/store/v1/modifyStoreCooperateStatus/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
store_id VARCHAR(32) 门店唯一标识,有效字符详见附录:编码类型参照表
store_waiqin365_id VARCHAR(32) 外勤365经销商唯一标识,当store_id与本字段同时传入,以store_waiqin365_id为准
store_cooperate_status CHAR(1) 合作状态编码, 0-终止合作 1-合作中, 2-未合作, 3-有意向
store_cooperate_status_name VARCHAR(32) 合作状态:终止合作/合作中/未合作/有意向/{自定义的},如果和合作状态编码store_cooperate_status同时传入字段,则以store_cooperate_status数据为准
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "store_id": "store0001",
    "store_cooperate_status": "0"
}

// 响应信息示例:
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}
                  
参数名称 参数值
应用编码 store
应用版本 v1
接口名称 门店分配到员工
接口编码 assignStoreToEmp
接口URL https://openapi.waiqin365.com/api/store/v1/assignStoreToEmp/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
store_id VARCHAR(32) 门店唯一标识,有效字符详见附录:编码类型参照表
emp_id VARCHAR(4000) 员工唯一标识,多员工间以“,”分隔。
如:EMP0001, EMP0002, EMP0003
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "store_id": "store0001",
    "emp_id": " EMP0001, EMP0002, EMP0003"
}

// 响应信息示例:
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}
                  
参数名称 参数值
应用编码 store
应用版本 v1
接口名称 门店分配到部门
接口编码 assignStoreToOrg
接口URL https://openapi.waiqin365.com/api/store/v1/assignStoreToOrg/{ openid }/{ timestamp }/{ digest }/{ msg_id }
请求信息 参数 类型 必填 说明
store_id VARCHAR(32) 门店唯一标识,有效字符详见附录:编码类型参照表
org_id VARCHAR(4000) 部门唯一标识,多个部门间以“,”分隔。
如:ORG0001, ORG0002, ORG0003
响应信息 参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码,0-成功, 1-失败, 其他参照附件错误码
return_msg String 响应说明

// 请求消息体示例:
{
    "store_id": "store0001",
    "org_id": " ORG0001, ORG0002, ORG0003"
}

// 响应信息示例:
{
    "msg_id": "X000001",
    "return_code": 0,
    "return_msg": ""
}