水果店把小程序订单交给称重、收银或进销存系统时,同一个商品可能按份卖、按克存,也可能另外以礼盒销售。可把对接单位和商品规格固化到订单行,再用同一门店、订单、行号识别重复导入。若重试交来的单位或数量与原记录不同,转人工核对该行,保留原导入记录。
称重补差、电子秤、收银、库存接口与售后处理按采购版本和联调约定确认。双方可以先在联调环境用固定规格的订单行核字段、单位和导入结果,再测试实际称重和售后流程。
故障从单位丢失开始
一份净重固定 500 克的切果和一个礼盒都能在订单上显示数量 1。上游只传商品和数量时,下游可能把一份切果当作一克,或把礼盒套进同一条克重换算规则。签约前先定订单行的销售单位、交付单位和换算来源。固定规格可保存下单时的换算值;实际重量需门店后称时,另设确认步骤,记录称重来源及价差处理。下面的例子只接收已约定的固定规格。
| 数据项 | 约束和责任 |
|---|---|
| shop、order_id、line_no | 组合标识源订单行,店铺间各自判重 |
| sku、qty、sale_unit | 商品快照及正整数销售数量;样例使用份和盒 |
| stock_unit、units_per_sale | 固定规格映射;门店与接口方核对后随订单行固化 |
| stock_qty | 按固化换算得到的整数;当前给对账使用 |
SQLite 联调样例
在 Python 3 的标准库 SQLite 中运行。下面是一段最小联调实现,订单行只写一张导入表。云环境的加密认证、连接管理、权限、监控和收银接口由实施方案另行配置。
import sqlite3
db = sqlite3.connect(":memory:", isolation_level=None)
db.execute("""
CREATE TABLE line_import (
shop TEXT NOT NULL,
order_id TEXT NOT NULL,
line_no INTEGER NOT NULL,
sku TEXT NOT NULL,
qty INTEGER NOT NULL CHECK (qty > 0),
sale_unit TEXT NOT NULL,
stock_unit TEXT NOT NULL,
units_per_sale INTEGER NOT NULL CHECK (units_per_sale > 0),
stock_qty INTEGER NOT NULL CHECK (stock_qty = qty * units_per_sale),
PRIMARY KEY (shop, order_id, line_no)
)""")
mapping = {
("cut-fruit", "portion"): ("g", 500),
("gift-box", "box"): ("box", 1),
}
def ingest(shop, order_id, line_no, sku, qty, sale_unit):
if type(qty) is not int or not 1 <= qty <= 10_000:
return "invalid_quantity", None
unit = mapping.get((sku, sale_unit))
if unit is None:
return "unmapped_unit", None
stock_unit, factor = unit
key = (shop, order_id, line_no)
expected = (sku, qty, sale_unit, stock_unit, factor, qty * factor)
db.execute("BEGIN IMMEDIATE")
try:
row = db.execute("""
SELECT sku, qty, sale_unit, stock_unit, units_per_sale, stock_qty
FROM line_import WHERE shop = ? AND order_id = ? AND line_no = ?
""", key).fetchone()
if row is None:
db.execute("INSERT INTO line_import VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)",
key + expected)
result = ("imported", expected[-1])
elif row == expected:
result = ("duplicate", row[-1])
else:
result = ("conflicting_replay", row[-1])
except Exception:
db.rollback()
raise
db.commit()
return result
assert ingest("S01", "DEMO1", 1, "cut-fruit", 2, "portion") == ("imported", 1000)
assert ingest("S01", "DEMO1", 2, "gift-box", 1, "box") == ("imported", 1)
assert ingest("S01", "DEMO1", 1, "cut-fruit", 2, "portion") == ("duplicate", 1000)
assert ingest("S01", "DEMO1", 1, "cut-fruit", 3, "portion") == ("conflicting_replay", 1000)
assert ingest("S01", "DEMO1", 3, "cut-fruit", 2, "box") == ("unmapped_unit", None)
assert ingest("S01", "DEMO1", 4, "cut-fruit", 0, "portion") == ("invalid_quantity", None)
assert db.execute("SELECT COUNT(*) FROM line_import").fetchone() == (2,)
上云验收盯住导入结果和责任人
两份切果导入为 1000 克,一个礼盒仍按盒入账。相同订单行重试只复用原结果;把两份改成三份重传会返回冲突并保留 1000 克。未知单位直接反馈给对接方。联调时约定上游修复字段、下游核对已入库行、门店确认原商品与数量的责任,并用同一组订单在两侧导出对账结果。
更改规格映射时保留订单当时的换算版本。上线使用可持久化的事务存储,显式记录重试、冲突和人工更正。若加入库存变动,在同一事务写入或通过持久化事件交接,并由库存端校验幂等。坏果、称重补差和部分退款各需自己的金额与回执用例,按合同独立验收。
作者:小艾普(上海逊柯计算机科技有限公司)。