货源数量、精确单价与导入失败处理

本说明适用于商城 0.1.377 及以后版本。商城更新完成后，已有任务的失败记录仍会保留，需要管理员按提示处理并选择重试。

遇到失败时怎么操作

1. 在“对接管理 → 货源渠道”打开该渠道的进度，或到“商品中心 → 商品运营”查看原导入任务。
2. 查看具体失败项。不要重新创建整渠道任务，也不要改小起购量、改大最大数量或调整单价来绕过提示。
3. 确认上游资料有效后，在原任务选择“只重试失败项”；中断或尚未处理的任务按页面提示继续。
4. 导入后核对商品标题、规格、数量范围、价格模板和前台合计。原先成功的商品不会因为本次发布自动重新导入或改价。

易客商品的数量规则

• 起购数量、最大数量和数量倍数按上游数据处理，不把“10000 个”换成“1 份”，也不按数量换算单价或计量单位。
• 易客的最大数量为 -1 时表示上游不限量。商城单次最多支持 10 亿，同时仍检查起购量、数量倍数、库存和总金额。这个含义只用于已核实的易客字段，其他负值不会被当成不限量。
• 明确给出有效上限的易客商品可超过 100 万，最高支持 10 亿。没有设置商品数量规则的旧商品仍使用原来的 100 万默认上限；本地卡密每次最多 1023 的限制保留。其他货源类型按照各自接口规则处理。
• 最大数量小于起购数量时，商城会阻止导入，并提示联系上游修正。上游已停售的商品不会因兼容处理自动恢复销售。

单字标题和精确单价

标题可以只有一个字或数字，例如“卡”“2”，不会自动补字；空白标题仍需上游修正。

单价最多支持 8 位有效小数。例如上游成本 0.0000825 会精确保留为 0.0000825，不会截为 0.000082 或改为 0.000083。商品零售价仍由您选择的价格模板决定，兼容修复不会替您增加或减少加价。

订单合计按单价乘数量计算，最终支付、余额和退款使用整数分，沿用商城的合计舍入规则。例如单价 0.0000825、数量 10000000，未计其他费用或优惠时合计为 825.00 元。不能用界面上的兼容整数分字段反推或覆盖精确单价。

这些提示需要上游处理

更新与恢复

请通过商城更新中心完成备份、下载验签和更新，不要只替换程序文件。此版本包含数量约束迁移，须由更新流程执行；原商品、单位、价格、订单和库存记录不会被迁移批量改写。

更新失败时按更新中心的恢复提示操作并保留日志。若更新后已创建超过旧版数量范围的新订单，不能直接换回旧程序继续接单；须使用与备份匹配的程序和数据库恢复，并先核对备份之后的订单变化，避免丢单。