批量导入店铺

通过本地 API 批量导入店铺 Excel。调用方只需要传 Excel 文件完整路径，Web 端通过 Electron 外壳提供的 window.api.readFileAsBase64(filePath) 读取文件内容，再调用店铺上传接口完成预览和导入。

基本信息

Path: /batchImportStore

Method: POST

兼容 method: batchImportEnv。该方法会走同一套导入逻辑，保留给旧调用方使用。

请求参数

参数	类型	必填	说明
method	string	WebSocket 必填	传 batchImportStore，兼容旧值 batchImportEnv。
filePath / path	string	是	Excel 文件完整路径，例如 D:\\tmp\\stores.xlsx。使用本地 HTTP /batchImportStore 时只需要传该路径参数即可。
fileName	string	否	覆盖上传文件名；不传时会从 filePath 解析。
mimeType	string	否	文件 MIME 类型；不传时按扩展名推断。
fileBase64 / base64 / contentBase64	string	否	不走文件路径时可直接传 Base64 文件内容。
file	object	否	另一种文件传参方式，格式为 { base64, fileName, mimeType }。
groupId	string/number	否	导入到指定店铺分组时传。
previewOnly	boolean/string	否	传 true 时只预览，不执行正式导入。
autoConfirm	boolean/string	否	默认 true。传 false 时只预览，不执行正式导入。

请求示例

{
  "method": "batchImportStore",
  "filePath": "D:\\tmp\\stores.xlsx"
}

{
  "method": "batchImportStore",
  "filePath": "D:\\tmp\\stores.xlsx",
  "previewOnly": true
}

{
  "method": "batchImportEnv",
  "filePath": "D:\\tmp\\stores.xlsx",
  "groupId": 123
}

成功返回示例

{
  "method": "batchImportStore",
  "response": {
    "code": 200,
    "msg": "success",
    "fileName": "stores.xlsx",
    "preview": {},
    "successCount": 10,
    "errCount": 0,
    "totalCount": 10,
    "downloadUrl": "",
    "data": {}
  }
}

仅预览返回示例

{
  "method": "batchImportStore",
  "response": {
    "code": 200,
    "msg": "success",
    "fileName": "stores.xlsx",
    "preview": {},
    "data": {}
  }
}

失败返回示例

{
  "method": "batchImportStore",
  "status": "error",
  "code": "400",
  "msg": "filePath is required, or pass fileBase64 and fileName"
}

注意事项

如果传入 filePath，Web 页面本身不能直接读取本地文件，必须由 Electron 外壳实现 window.api.readFileAsBase64(filePath) 并返回 Base64 字符串，或返回 { base64, fileName, mimeType } 对象。

正式导入默认会先走预览接口，再自动确认导入。需要调用方人工确认时，可传 previewOnly: true 或 autoConfirm: false。