商城与 POS 对接怎么做？商品、订单、库存的准备清单
梳理平台授权、SKU、订单、库存与支付规则，准备一份门店和网店都能使用的接入清单。
先看结论
商城与 POS 对接，先确认平台版本和授权，再梳理 SKU、价格、订单来源、仓库和库存更新方向。支付方式、退款与异常处理也应写进服务方案。AllinWebPOS 可围绕 OpenCart 对接方案、Shopify 定制接入和门店设备需求安排评估，确定适合业务的实施范围。
把流程放到门店现场
先约定商品标识与库存归属，再衔接订单、备货与发货，让线上需求进入清楚的履约流程。
- 运营
确认订单范围
明确接入渠道、商品标识与订单需要传递的信息。
- 店员与仓库
核对可售数量
按约定的库存来源，核对订单商品与备货数量。
- 履约人员
拣货打包
核对规格、数量和包装要求，准备交付商品。
- 运营
交接发货记录
依渠道方案核对交付与发货信息，跟进异常订单。
先确认版本、权限和商户条件
记录商城版本、插件、API 权限、商户地区和币种。外部平台权限可能按账号、应用和接口分别限制。测试环境和正式环境的授权也可能不同，应明确测试在哪个环境执行，哪些数据允许写入。
Shopify 的 API 访问范围决定应用可读取或修改哪些店铺数据；OpenCart 则通过 API 用户、权限与允许访问的 IP 管理调用。两者的准备方式不同，应参照对应平台的官方文档，按业务需要安排授权。
按商品、订单与库存拆分验收
商品导入要检查规格与编码，订单导入要检查优惠、税费和来源标识，库存回写要检查数量和仓库。每项验收都应在外部平台核对结果。一个接口返回成功不能代表三条业务链路同时完成。
支付从发起一直核对到账
检查发起支付、取消、超时、回调签名、重复回调、退款和交易核对。系统内显示支付成功，必须与服务商交易状态一致。商家还应明确支付服务商、商户账号、支持币种和退款规则，确保选用的收款方案适合经营地区。
把重试和异常纳入验收
重复订单、接口限流、授权失效和库存冲突都应有处理规则。明确哪些异常自动重试，哪些需要人工确认，并给人工核对提供来源订单号和处理记录。完成正常订单只是验收的第一部分。
怎样安排点单、商城与支付方案？
H5 点单、独立网店和第三方支付解决的是不同业务任务。H5 关注顾客选购与门店服务，商城接入关注商品与订单之间的连接，支付方案关注收款与退款。将这些需求分别列清楚，更容易安排适合门店的实施计划。
一条验收用例应包含什么？
把检查项目写成可执行的业务任务。例如，在商城创建包含两个 SKU 和优惠的测试订单，核对 POS 中的来源编号、商品规格、金额和所属门店；再处理一次取消或部分退款，确认相关订单记录和库存变化符合门店规则。重复处理同一笔来源订单时，也要核对是否出现重复记录。
将操作步骤、预期结果和核对记录放在一起，门店与服务团队就能沿用同一份清单。订单、库存、退款和会员分别检查，再明确后续异常由谁处理。
收款与退款，怎样核对记录？
保存商户环境、系统订单号、支付尝试号、外部交易号和回调处理结果。正常付款之外，还应验证取消、超时、重复回调和退款。系统内金额与服务商交易金额必须能解释；收款记录、商户结算与余额变化不能混成同一个状态。
测试阶段可以先核对系统流程，再使用指定商户环境检查交易与退款。正式营业前，将订单记录、服务商交易与门店日结放在一起核对，确保每笔收款都有清楚的对应关系。
接入后，日常经营怎样维护？
把日常维护安排给明确的负责人：谁处理店铺授权到期，谁核对未同步订单，谁跟进打印异常，谁联系支付服务商。平台升级、商品规格调整或新增门店时，也要检查原有商品映射和仓库规则是否仍然适用。
在规划阶段说明这些经营需求，可以让服务范围、实施步骤和后续支持更清楚。将你使用的商城、支付方式与设备型号带给 AllinWebPOS 团队，我们会与你梳理适合门店的接入方案。
商城与 POS 接入核对表
| 链路 | 应观察的结果 | 建议核对的资料 |
|---|---|---|
| 商品映射 | SKU 与规格匹配 | 映射表和双方商品编号 |
| 订单导入 | 金额准确且避免重复 | 来源订单与内部订单记录 |
| 库存更新 | 目标平台数量符合约定 | 更新前后数量与任务记录 |
| 支付退款 | 交易和退款状态相符 | 商户交易、回调及核对记录 |
落地检查清单
- 记录平台版本和实际权限
- 商品、订单、库存分别取证
- 支付与外部交易状态一致
- 重复事件和失败重试可复现
参考资料
- Shopify 开发文档：API 访问权限
了解商品、订单与库存访问所需的授权范围。
- OpenCart 文档：API 用户与权限
了解 API 账号、权限和允许访问的 IP 配置。
