从设备绑定、任务推送到状态回执，先确认协议与网络约束，再决定走云平台、MQTT 直连还是本地云盒。您负责业务体验，商为提供打印能力与设备支持。
差异主要在三处：数据经过哪里、需要您准备什么、设备侧怎么连。下表按维度横向对照，选定后可直接跳到对应文档。
| 对比维度 | 商为云 · HTTP API | MQTT 直连自有 Broker | 打印云盒 · 本地接入 |
|---|---|---|---|
| 一句话 | 最快落地，首次调用 5 分钟 | 打印数据不经过商为云，由您的服务器全权管理 | 不改网络架构，让现有打印机联网 |
| 数据流向 | 业务系统 → 商为云 → 设备 | 业务系统 → 您的 Broker → 设备 | 业务系统 → 云盒 → 打印机 |
| 需要准备 | 平台侧一个接入凭证 | 自建 / 阿里云 / 腾讯云 Broker，并配置 TLS 证书 | 云盒 + 现有打印机（USB 或网口） |
| 适合场景 | 通用 SaaS / ERP / POS / WMS | 金融 / 医疗 / 政务等要求数据自主管理的场景 | 已有打印机的存量门店与门店改造 |
| 设备范围 | 全系云打印机与打印云盒 | 支持 MQTT 直连的机型 | 经云盒接入的打印机 |
| 状态与回执 | 任务查询接口 + 状态回调 | 设备状态与打印结果直接投递到您的 Broker | 同「商为云 · HTTP API」 |
| 当前状态 | 已上线 | 已上线，已在国内外商用运行 | 已上线 |
| 了解详情 | 接口文档 | MQTT 直连 | 选型指南 |
三条路径可组合使用：例如平台主链路走 API，个别对数据流向有要求的客户单独走 MQTT 直连。
| 内容类型 | 支持情况 | 机型约束 |
|---|---|---|
| 小票 / 票据 | ESC/POS 指令，兼容 UTF-8 与传统代码页 | — |
| 标签 | TSPL、CPCL、ESC/POS | 标签类机型 |
| 图片 | PNG 与 1 位 BMP，可传 Base64 数据或图片 URL | — |
| 图文排版 | JSON 结构化排版；XML 智能排版 | XML 排版按机型支持 |
| PDF 直打 | 设备端直接解析 PDF，无需在服务端转换 | M 后缀机型 |
| 矢量多语言 | 打印机端矢量自主渲染、无损缩放，支持 RTL 排版 | 仅 M 后缀机型 |
| 语音播报 | 自定义 amr-wb/MP3 语音文件，随打印任务下发 | 支持语音的机型 |
矢量多语言与 PDF 直打为 M 后缀机型专属能力，选型前请确认型号后缀；其余能力请以对应机型的出厂规格书为准。
这几条决定您的网络环境能不能接、安全评审能不能过。建议直接转给负责网络与安全的同事。
码段本身说明了消息性质，这是服务端设计状态机的依据。
0
成功
带任务 id 表示该打印任务成功；不带 id 表示打印机状态恢复。
1xx
设备状态
设备侧状态上报，不带任务 id。例如设备离线、打印机未连接。
2xx
任务结果
打印任务的处理结果，必带任务 id。
当前版本已支持
码段 0、100–103、107、109、201–209 已在固件中实现，可直接用于业务判断。其中 107 为设备离线（通过遗嘱消息上报），109 为打印机未连接。
后续版本规划中
任务级状态将进一步细分：210 任务受阻待出票、211 队列已满、212 任务超时过期、213 硬件故障放弃，随固件升级分批可用。210 与 211 为中间态，212 与 213 为终态。
当前设备不会上报这几个状态。现有接入方式不受影响：未上报时按超时分支处理，重发请沿用原任务 id；判定为终态后不要重发，补单需生成新 id。
协议保持向后兼容，新增能力不影响既有接入代码。完整码表与处理建议见接口文档。
申请平台接入凭证；若走 MQTT 直连，在您的 Broker 侧完成设备三元组配置。
获取 Token 接口绑定设备；直连场景下确认 TLS 与出网白名单已放行，设备能稳定上线。
设备绑定接口用在线调试工具跑通一次真实出纸，确认纸张宽度、排版与内容无误。
进入在线调试接入状态码与回调，处理重发、过期与硬件故障分支，形成业务闭环。
回调通知接口告诉我们行业、系统类型、设备规模与目标场景，我们会给出对应的接入方式建议与联调计划。