HowTo: 多门店批量配置 100+ 设备

100+ 门店统一云打印管理：CSV 批量导入 + API 批量绑定 + 出厂预绑定 + 模板按门店下发。本指南适用于连锁零售、连锁餐饮、区域仓储、物流仓库场景，可将部署周期从 1 周压缩到 2 小时。

1准备 CSV 设备清单

把设备 SN/密钥/门店标识整理成 CSV：

sn	secret	store_id	store_name	template_id	note
SW000001	SEC0001...	S001	深圳南山店	tpl_receipt_58mm	前台打印机
SW000002	SEC0002...	S001	深圳南山店	tpl_label_50mm	后厨标签
SW000003	SEC0003...	S002	深圳福田店	tpl_receipt_58mm	前台打印机

2导入控制台 + 一键绑定

登录商为控制台 → 设备管理 → 批量导入 → 上传 CSV → 系统自动验证 SN/密钥/门店映射 → 批量绑定。

导入速度：1000 台 / 分钟（含自动校验）。

导入结果示例：

{ "success_count": 998, "failed_count": 2, "failures": [ {"sn": "SW000099", "reason": "duplicate_sn"}, {"sn": "SW000998", "reason": "invalid_secret"} ], "duration_ms": 12453 }

3按门店下发模板

在控制台 → 模板管理 → 创建/上传模板：

全国统一模板：所有门店统一（如：发票抬头）
门店差异模板：按门店下发（如：门店地址 / 联系电话 / 营业时间）
区域差异模板：按区域批量下发（如：华南用中文，华北中英双语）

模板支持热更新：下发后设备实时拉取，0 停机。

4OTA 远程升级固件

批量升级设备固件，无需现场操作：

灰度发布：先升级 5% 设备 → 观察 → 50% → 100%
强制升级：设置 7 天后强制升级窗口
回滚机制：升级后 24h 内可一键回滚

POST /api/v1/firmware/ota { "device_ids": ["dev_001", "dev_002", ...], // 不指定则全部 "firmware_url": "https://cdn.sw-aiot.com/fw/1.2.4.bin", "strategy": "gray", // gray | force | optional "gray_percent": 5, "force_after_hours": 168 }

⚡ 评估 100+ 门店批量部署？联系 sw@sw-aiot.com 获取连锁行业方案