综述概述：零售促销活动涵盖卡折扣、馈赠、满赠、第三方券（美团 / 抖音）等类型，配置涉及会员卡系统与业务系统双端协同。异常多源于配置不一致或接口字段映射错误。
体系框架
促销活动配置（双系统：会员卡 + 业务系统）
├── 卡折扣 → 价格类型 → 促销规划 → 卡折扣设置
├── 馈赠 → POS 功能（赠送 / 馈赠 / 预览）→ 消息队列同步
└── 第三方券 → 美团授权 / 抖音字段映射
↓ 异常
配置不一致 / 字段映射错误 / 消息队列未开启脉络一：配置双系统协同
卡折扣配置需要会员卡系统和业务系统都配置（价格类型 + 促销规划 + 卡折扣设置）。只配一端会导致折扣不生效——这是促销配置最常见的坑。
脉络二：配置一致性与折让异常
卡折扣设置供应商承担折让时，POS 按商品主供应商匹配促销策略。主供应商与卡折扣供应商不一致 → 匹配不到承担比例策略 → 仍产生折让。同类问题：结算单会员折让也与门店主供应商关联。
脉络三：POS 端同步链路
馈赠活动赠券依赖 posserver 消息队列同步。POS 端成功但后台无记录 → 检查 Cust.xml 消息队列配置。第三方券（美团 / 抖音）依赖服务授权与字段映射，授权过期或字段映射错误都会导致异常。
实践要点
| 场景 | 排查方向 |
|---|---|
| 卡折扣配置 | 双系统都要配，缺一不可 |
| 折让异常 | 先核对主供应商与卡折扣供应商是否一致 |
| 赠券中断 | 先查 posserver Cust.xml 消息队列 |
| 第三方券差异 | 美团查授权；抖音查字段映射（商家优惠 / 品牌商优惠） |
常见问题
卡折扣不生效？
先检查双系统配置是否完整（价格类型 + 促销规划 + 卡折扣设置）。
赠券突然中断？
检查 posserver 消息队列是否开启（Cust.xml）。
抖音券流水与实付不符？
商家补贴可能被合并入实付——字段映射问题（商家优惠 / 品牌商优惠反了）。