点餐回调通知
参数说明
一、orderState点餐订单状态枚举:
1: 订单已付
3: 已出码(订单成功)
6: 订单退款
7: 超时未付(取消)
8: 部分退款
12: 配送中(仅外卖单)
二、回调推送:
正常推送情况:出单成功推送codes取餐码;退款推送refundAmount退款金额。
三、出单成功处理:
对于已完成订单,成本结算价为:订单详情接口的epCostPric(企业成本)字段获取结算价格(注:如果订单在出码后发生部分退款业务,订单状态将更新为 8(部分退款)。此时,订单的结算价格也会发生变化,需要重新获取最新的结算价格。)
四、退款处理:
-订单整体退款比率 = 订单退款总金额 / 用户总价(totalRefundAmount / totalUserPrice )
-订单内某个品的退款比率 = refundProducts里面的totalRefundAmount/(quantity*selPrice)
五、epCostPric结算价(企业成本)在部分退款订单的特殊性:
1.
流程说明:
订单出单成功,系统从余额中扣除全部商品金额。
部分商品退款,系统会将退款商品的金额重新充值到余额中。
在财务菜单 → 余额明细中,能看到一笔扣款记录和一笔充值记录。
2.
这种情况发生在部分退款直接扣除对应的结算价格,系统会直接扣除退款之后的商品金额,而不会再进行充值操作。
流程说明:
部分商品退款时,系统直接扣除对应退款之后的商品金额,结算价格自动更新。
在财务菜单 → 余额明细中,能看到一笔扣费明细记录(不会出现充值记录)。
六、部分退款订单的特殊性:
{
"type": 5,
"data": {
"id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",(uuid形式的订单id),
"orderType": "1肯德基 2麦当劳 4星巴克 8奈雪的茶 16瑞幸咖啡 32喜茶",
"orderState": 3,
"entPara": "自定义参数(可在创建订单接口中传入,这里原样返回)",
"totalUserPrice": "用户价格",
"commission": "佣金",
"orderName": "订单名称",
"codes": "取餐码,多个用空格分开,如(A3301 A3302)",
"qrCodes": "点餐生成二维码的值,点餐品牌为瑞幸时,需要生成二维码,多个用空格分开,如(Z2jMdwQ3AAM= Z2jMvwQ3AAM= Z2jM4gQ3AAM=)",
"refundAmount":"当前退款金额",
"totalRefundAmount ":"总退款金额",--企业退款金额
"totalChanelPrice":"总渠道价格",
"totalEpPrice":"企业总成本价",--企业订单总成本
"epRefundAmount":"渠道退款总额:",
"refundId":"退款id",
"refundProducts":[{"productId":"产品id","quantity":"订单商品数量","selPrice":"销售单价", "hasRefund": true,"spec":"规格名称组合","refundCount":"退款商品数量(只用于参考,某些情况下值不一定准确)","refundAmount":"退款金额"}],
"totalOriginPrice":"60(原价总价)",
"createTime":"2020-09-08 10:20:00(订单创建时间)",
"updateTime":"2020-09-08 10:20:00 (订单最后更新时间)",
"courierLocationH5":"https://abc123xyz890.com/courierLocationH5(外卖订单骑手位置H5页面URL)"
}
}
修改于 2025-03-24 05:03:10