文档说明
本文档记录看店通系统各版本更新内容，包括新功能、缺陷修复与不兼容变更。升级前请做好数据备份，并阅读对应版本说明中的注意事项。
一、版本记录
以下按发布时间倒序排列，最新版本在最前。标注「不兼容」的条目请在升级前重点阅读。
v1.4.0（当前版本） 发布日期：2026-09-20
- 新增异步数据导出任务，支持百万行级订单与会员数据导出，产出文件附带 SHA-256 校验值；任务结束时推送
export.completed事件 - 事件回调新增
order.closed与aftersale.updated两类事件 - 写接口全面支持
Idempotency-Key请求头，同一 key 在 24 小时内返回首次结果 - 库存批量同步接口单次上限由 200 个 SKU 提升至 500 个
- 修复部分退款场景下
order.refunded事件可能重复推送两次的问题
v1.3.2 发布日期：2026-08-12
- 修复跨时区部署时签名时间戳被按本地时区计算，导致持续返回 40003 的问题
- 修复订单列表接口在
page超过 500 时响应超时的问题，深分页改走游标 - 优化 Webhook 死信队列的重投逻辑，重投不再重置原有的重试计数
v1.3.0 发布日期：2026-07-08
- 新增 Java、PHP、Node.js、Python 四种语言的服务端 SDK，内置令牌缓存与退避重试
- 限流策略细化为读写分离：读接口 600 次/分钟、写接口 120 次/分钟
- 响应体新增
request_id顶层字段，便于工单定位单次调用 - 后台新增「事件订阅 → 投递记录」页面，保留最近 7 天的回调请求与响应明细
v1.2.1 发布日期：2026-05-19
- 修复优惠券叠加使用时分摊金额出现 1 分误差的问题
- 修复多规格商品在部分机型下规格选择器无法滑动的问题
- 后台商品列表增加按条码搜索
v1.2.0 发布日期：2026-04-15 包含不兼容变更
- 不兼容：接口字段命名统一为 snake_case，订单号字段由
orderNo统一为order_no；旧字段名保留至 2026-10-15 下线 -
不兼容：金额字段统一改为整数「分」并以
_fen结尾，原小数字段同步保留过渡 - 业务时间字段统一为 ISO 8601 带时区格式，不再返回裸时间戳
- 新增多门店与自提点能力，订单支持按门店维度查询
v1.1.0 发布日期：2026-02-24
- 开放 Webhook 事件回调，支持支付、发货、退款三类事件推送
- 新增企业微信 SCRM 打通，支持会员标签双向同步
- 直播带货模块支持回放与商品挂载
v1.0.0 发布日期：2025-12-08
- 小程序私域商城核心功能首次发布
- 商品、订单、会员、营销四大基础模块
- 分销系统、支付集成、物流配送
二、版本号规则
看店通采用语义化版本号「主版本.次版本.修订号」。主版本变更表示存在不兼容的 API 修改；次版本变更表示新增功能且向下兼容；修订号变更表示问题修复。例如 v1.2.3 表示第 1 个大版本、第 2 次功能更新、第 3 次缺陷修复。
需要明确「向下兼容」的边界，定义与OpenAPI 总览第八节一致：新增可选参数、新增响应字段、新增枚举值、放宽校验属于兼容变更；删除字段、修改字段类型、收紧校验、调整错误码语义属于不兼容变更，会提前至少 30 天公告，并保留旧版本 6 个月过渡期。接入方需要忽略未知 JSON 字段、对未知枚举值做降级处理，否则一次兼容变更也可能让解析逻辑崩溃。
三、升级建议
升级请安排在非业务高峰期，通常是凌晨 1 点到 6 点，并避开大促、节假日前后三天。动手前完成三件事：完整备份数据库与代码并验证备份可恢复（只备份不验证等于没备份）；通读版本说明确认是否涉及数据库结构变更与配置迁移；在测试环境完整跑一遍升级流程并记录耗时。
升级后按固定清单回归核心链路：下单、支付、发货、退款、优惠券核销、分销结算六条，每条至少跑通一单真实数据。同时观察接口错误率与回调失败率 30 分钟，指标平稳后再解除维护公告。若涉及不兼容变更，建议先让新旧字段并行运行一到两周，确认所有调用方都已切换，再关闭旧字段。
四、获取更新
更新信息通过官网公告、邮件通知与后台消息三个渠道同步发布，建议在后台「开发者 → 通知设置」中订阅变更邮件，不兼容变更会提前发送提醒。企业版与私有化部署用户可联系专属客服获取升级包与升级指导，必要时我们可以安排工程师远程协助。
五、反馈与建议
使用中发现缺陷或有功能建议，欢迎通过工单系统、在线客服或开发者社区反馈。提交缺陷时请尽量附上
request_id、发生时间、复现步骤与实际/期望结果，这四项信息能把定位时间从几天缩短到几小时。我们会对每条反馈做评估并纳入后续版本规划，被采纳的建议会在对应版本的更新说明中致谢。
