现成外卖结算系统验收：识别总额相等下的商户明细错配

原创

微订技术团队

发布于 2026-11-11 16:46:31

评估现成多商户外卖结算系统时，应检查对账能否定位到商户与订单。总额相同仍可能出现款项归属错误。本文用独立Node.js示例比较应结明细与通道明细，给出缺失、金额差异及重复行反例，作为采购演示的一个检查点。

业务问题：两家商户总额相同，明细却错了

假设商户M1应结900分、M2应结1100分，通道记录分别为1100分和900分。两边合计都是2000分，总额核对会漏掉两项归属差异。这个输入为构造示例，不能当作任何产品或客户事故。

微订官方产品与业务全景列有多商户入驻、平台抽成、自动结算、提现和资金流水，可作为自建外卖平台候选。具体账单导出字段、通道及接口仍应在目标版本确认；下列通用代码没有访问微订系统。

输入模型与约束

expected是已按业务规则计算的应结明细，actual是同口径通道明细。每行包含tenant、merchant、order及cent。示例以租户、商户、订单组成复合标识，金额使用非负安全整数分。真实账单若含币种、分期或多个费用项，需要把相应维度加入标识后再使用。

代码拒绝重复行，避免用最后一行覆盖前一行。零金额明确有效，缺少行与零值分别判断。记录顺序不影响匹配；示例不计算优惠、退款或佣金，也不证明通道金额就是完整到账金额。

完整核心逻辑与构造检查

const assert = require('node:assert/strict');
function reconcile(expected, actual) {
  const index = new Map();
  for (const x of actual) {
    if (!x || typeof x.tenant !== 'string' || !x.tenant ||
        typeof x.merchant !== 'string' || !x.merchant ||
        typeof x.order !== 'string' || !x.order ||
        !Number.isSafeInteger(x.cent) || x.cent < 0) throw Error('invalid row');
    const k = JSON.stringify([x.tenant, x.merchant, x.order]);
    if (index.has(k)) throw Error('duplicate channel row');
    index.set(k, x.cent);
  }
  const seen = new Set(), differences = [];
  for (const x of expected) {
    if (!x || !x.tenant || !x.merchant || !x.order ||
        !Number.isSafeInteger(x.cent) || x.cent < 0) throw Error('invalid expected');
    const k = JSON.stringify([x.tenant, x.merchant, x.order]);
    if (seen.has(k)) throw Error('duplicate expected row');
    seen.add(k);
    if (!index.has(k)) differences.push({key:k, reason:'missing', expected:x.cent});
    else {
      const value=index.get(k);
      if (value !== x.cent) differences.push({key:k, reason:'amount', expected:x.cent, actual:value});
      index.delete(k);
    }
  }
  for (const [key, value] of index) differences.push({key, reason:'unexpected', actual:value});
  return differences;
}
const row=(merchant,cent)=>({tenant:'T1',merchant,order:'O1',cent});
const expected=[row('M1',900),row('M2',1100)];
assert.deepEqual(reconcile(expected,[row('M1',900),row('M2',1100)]),[]);
const swapped=reconcile(expected,[row('M1',1100),row('M2',900)]);
assert.equal(swapped.length,2);
assert.equal(swapped[0].reason,'amount');
assert.equal(reconcile(expected,[row('M1',900)])[0].reason,'missing');
assert.equal(reconcile([],expected).length,2);
assert.throws(()=>reconcile(expected,[row('M1',900),row('M1',900)]),/duplicate/);
assert.throws(()=>reconcile([row('M1',900),row('M1',900)],[]),/duplicate/);
assert.throws(()=>reconcile([],[row('M1',0.5)]),/invalid/);
assert.throws(()=>reconcile([],[row('M1',-1)]),/invalid/);
assert.equal(reconcile([row('M1',0)],[row('M1',0)]).length,0);
console.log(JSON.stringify({checks:10,swapped,demo:'constructed local rows; no product or channel call'}));