饿了么开放平台订单金额计算

文档说明

一笔订单商家实际收入情况是每个商户和开发者都比较关注的问题，此文档面向对象为对订单金额计算有疑问的开发者和商家。特别说明：由于履约过程可能与下单时预估情况不同，最终结算收入可能与预计收入有差异，具体以结算账单为准，账单接口申请查看 该文档。

费用相关的字段说明

字段	含义
originalPrice	订单优惠前的价格，即商品总价加上配送费(该配送费对应用户实际支付的配送费，对应字段deliverFee)和餐盒费
totalPrice	订单总价，用户实际支付的金额
totalAmount	总合计金额，菜品总原 + 餐盒费总原 + 配送费总原价
income	店铺实收
deliverFee	用户实际支付的配送费
merchantDeliverySubsidy	商家替用户承担的配送费
vipDeliveryFeeDiscount	会员减配送费
serviceRate	饿了么服务费率
serviceFee	饿了么服务费
allowanceServiceFee	饿了么智能满减服务费
baseLogisticsServiceFee	饿了么基础物流费
hongbao	订单中红包金额
packageFee	餐盒费
activityTotal	订单活动总额
shopPart	店铺承担活动费用
elemePart	饿了么承担活动费用
coldBoxFee	冷链加价费
price	商品单价
total	总价
userPrice	用户侧价格
shopPrice	商户侧价格
cpcAmount	抽佣转cpc费
contributionAmount	商户公益捐赠金额
publicWelfareGoodsFee	爱心商家捐赠金额
deliveryPackageFee	配送费原价 + 打包费金额
originalDeliverFee	配送费原价
deliveryActivityFee	用户实际配送费，即originalDeliverFee-merchantDeliverySubsidy的金额

 

计算方式

根据商户所签约的服务包合同类型的不同订单收入的计算也并不相同

托管配送餐厅也就是签约了专送、快送服务（包含签约新零售、蜂鸟混合送、蜂鸟质选 ）的商户，采用专送或快送服务配送则订单的配送费是有平台收取：
商家订单实际收入=商品总价 - 商家活动补贴总金额 - 佣金

签约的非专送、快送类服务如：星火计划、星火众包则订单中客户支付的配送费是有商家收取：
商家订单实际收入=商品总价 + 配送费 - 商家活动补贴总金额 - 佣金

注意： 这里的商品总价=菜品价格+餐盒费。

如果需要判断配送方式，可以通过 type=217 类型的消息推送，或者 API接口 eleme.order.getOrder、eleme.order.mgetOrders、eleme.order.getAllOrders 获取订单信息时，通过deliveryProductId字段判断，对应文档：物流标品接入管理。

type=217 类型的消息推送，或者 API接口 eleme.order.getOrder、eleme.order.mgetOrders、eleme.order.getAllOrders 中的 xyPackFlag 表示是否使用 x+y 服务包的标识：

true：平台服务费 = serviceFee + fulfillServiceFee

false：平台服务费 = serviceFee + timeIntervalMarkUpFee + distanceIncreaseFee + pricePremiums

示例解析

示例1： 使用蜂鸟专送配送服务的订单：3060034004757139469；

{"id":"3060034004757139469","orderId":"3060034004757139469","address":"东庆南***","createdAt":"2020-02-21T17:53:58","activeAt":"2020-02-21T17:53:58","deliverFee":0.0,"merchantDeliverySubsidy":-1.5,"deliverTime":null,"description":"","groups":[{"name":"1号篮子","type":"normal","items":[{"id":200018689763,"skuId":200000412388877364,"name":"黄焖鸡套餐+金针菇+土豆+米饭[微辣]","categoryId":1,"price":25.9,"quantity":1,"total":25.9,"additions":[],"newSpecs":[],"attributes":[{"name":"辣度","value":"微辣"}],"extendCode":"","barCode":"","weight":1.0,"userPrice":0.0,"shopPrice":0.0,"vfoodId":1536200077,"ingredients":[]},{"id":200018710284,"skuId":200000412388870196,"name":"黄焖鸡套餐+煎蛋+土豆+米饭[微辣]","categoryId":1,"price":26.9,"quantity":1,"total":26.9,"additions":[],"newSpecs":[],"attributes":[{"name":"辣度","value":"微辣"}],"extendCode":"","barCode":"","weight":1.0,"userPrice":0.0,"shopPrice":0.0,"vfoodId":1536200070,"ingredients":[]}],"relatedItems":[]},{"name":"其它费用","type":"extra","items":[{"id":-70000,"skuId":-1,"name":"餐盒","categoryId":102,"price":4.0,"quantity":1,"total":4.0,"additions":[],"newSpecs":null,"attributes":null,"extendCode":"","barCode":"","weight":null,"userPrice":0.0,"shopPrice":0.0,"vfoodId":0,"ingredients":[]}],"relatedItems":[]},{"name":"赠品","type":"discount","items":[{"id":22339357603,"skuId":-1,"name":"汤一份1份","categoryId":12,"price":0.0,"quantity":1,"total":0.0,"additions":[],"newSpecs":null,"attributes":null,"extendCode":"","barCode":"","weight":null,"userPrice":0.0,"shopPrice":0.0,"vfoodId":0,"ingredients":[]}],"relatedItems":[]}],"invoice":null,"book":false,"onlinePaid":true,"railwayAddress":null,"phoneList":["******"],"shopId":16***25,"shopName":"***黄焖鸡米饭","daySn":18,"status":"unprocessed","refundStatus":"noRefund","userId":-1405782303,"userIdStr":"2000048977633","totalPrice":38.8,"originalPrice":56.8,"consignee":"吴**","deliveryGeo":"113.05255802,22.51519698","deliveryPoiAddress":"东庆南***","invoiced":false,"income":35.51,"serviceRate":0.18,"serviceFee":-7.79,"allowanceServiceFee":0.0,"baseLogisticsServiceFee":0.0,"timeIntervalMarkUpFee":0.0,"hongbao":0.0,"packageFee":4.0,"activityTotal":-18.0,"shopPart":-12.0,"elemePart":-6.0,"downgraded":false,"vipDeliveryFeeDiscount":0.0,"openId":"","secretPhoneExpireTime":"2020-02-22T00:23:55","orderActivities":[{"categoryId":12,"name":"汤一份1份","amount":0.0,"elemePart":0.0,"restaurantPart":0.0,"familyPart":0.0,"userPart":0.0,"id":22339357603,"metaId":1173731179,"orderAllPartiesPartList":[]},{"categoryId":12,"name":"店铺满减","amount":-13.0,"elemePart":-3.0,"restaurantPart":-10.0,"familyPart":0.0,"userPart":0.0,"id":22678532579,"metaId":1344157811,"orderAllPartiesPartList":[{"partName":"商家补贴","partAmount":"10.0"},{"partName":"平台补贴","partAmount":"3.0"}]},{"categoryId":15,"name":"用户代金券","amount":-5.0,"elemePart":-3.0,"restaurantPart":-2.0,"familyPart":0.0,"userPart":0.0,"id":400027959757861459,"metaId":0,"orderAllPartiesPartList":[{"partName":"商家补贴","partAmount":"2.0"},{"partName":"平台补贴","partAmount":"3.0"}]}],"invoiceType":null,"taxpayerId":"","coldBoxFee":0.0,"cancelOrderDescription":null,"cancelOrderCreatedAt":null,"orderCommissions":[],"baiduWaimai":false,"userExtraInfo":{"giverPhone":"","greeting":""},"consigneePhones":["132****2690"],"superVip":"ELEME_SUPER_VIP","confirmCookingTime":null,"orderActivityParts":[{"partName":"饿了么承担","partValue":-6.0,"weight":1},{"partName":"商户承担","partValue":-12.0,"weight":2},{"partName":"优惠总计","partValue":-18.0,"weight":10}],"orderBusinessType":0,"pickUpTime":"1970-01-01T08:00:00","pickUpNumber":0,"umpOrder":0,"tianmaoPart":-0.0,"shopBrandId":0,"userPart":0.0,"specUserPart":0.0,"isBusinessOrder":false,"pinTuanOrder":false,"extraJson":"{\"originalDeliverFee\":\"2.0\",\"deliveryActivityFee\":\"0.0\"}","svcPart":-0.0,"orderSourceTag":"ELEME"}

该订单商家实际收入（income）= 商品总价 - 商家活动补贴总金额 - 佣金 = originalPrice（此字段包含了配送费但配送费是有平台收取） – deliverFee - shopPart – serviceFee - baseLogisticsServiceFee - allowanceServiceFee - merchantDeliverySubsidy - cpcAmount - contributionAmount - publicWelfareGoodsFee= 56.8 - 0 - 12 - 7.79 - 0 - 0 - 1.5 - 0 - 0 - 0 = 35.51元

示例2： 商家自配送或蜂鸟众包配送服务的订单：3013796403083642897；

{"id":"3013796403083642897","orderId":"3013796403083642897","address":"金垅嘉园下大垅工商巷***号","createdAt":"2017-10-12T15:22:28","activeAt":"2017-10-12T15:22:28","deliverFee":4.0,"deliverTime":null,"description":"奶茶都要热的","groups":[{"name":"1号篮子","type":"normal","items":[{"id":1235471227,"skuId":200000036322536519,"name":"红豆布丁烤奶茶(大杯)-大杯[标准冰+标准糖]","categoryId":1,"price":15.0,"quantity":1,"total":15.0,"additions":[],"newSpecs":[{"name":"规格","value":"大杯"}],"attributes":[{"name":"温度","value":"标准冰"},{"name":"甜度","value":"标准糖"}],"extendCode":"1000000251","barCode":"","weight":100.0,"userPrice":0.0,"shopPrice":0.0,"vfoodId":1234390075},{"id":1235471236,"skuId":200000036322545735,"name":"大满贯布丁奶茶(热杯)-热杯[标准冰+标准糖]","categoryId":1,"price":13.0,"quantity":1,"total":13.0,"additions":[],"newSpecs":[{"name":"规格","value":"热杯"}],"attributes":[{"name":"温度","value":"标准冰"},{"name":"甜度","value":"标准糖"}],"extendCode":"1000000300","barCode":"","weight":100.0,"userPrice":0.0,"shopPrice":0.0,"vfoodId":1234390084}]},{"name":"其它费用","type":"extra","items":[{"id":-70000,"skuId":-1,"name":"餐盒","categoryId":102,"price":2.0,"quantity":1,"total":2.0,"additions":[],"newSpecs":null,"attributes":null,"extendCode":"","barCode":"","weight":null,"userPrice":0.0,"shopPrice":0.0,"vfoodId":0}]}],"invoice":null,"book":false,"onlinePaid":true,"railwayAddress":null,"phoneList":["176****935"],"shopId":190***77,"shopName":"***餐厅","daySn":38,"status":"unprocessed","refundStatus":"noRefund","userId":104804472,"totalPrice":16.0,"originalPrice":34.0,"consignee":"陈女士","deliveryGeo":"112.99004026,28.21919046","deliveryPoiAddress":"金垅嘉园下大垅工商巷***号","invoiced":false,"income":18.25,"serviceRate":0.05,"serviceFee":-0.75,"hongbao":-3.0,"packageFee":2.0,"activityTotal":-15.0,"shopPart":-15.0,"elemePart":-0.0,"downgraded":false,"vipDeliveryFeeDiscount":0.0,"openId":"1688","secretPhoneExpireTime":null,"orderActivities":[{"categoryId":12,"name":"在线支付立减优惠","amount":-15.0,"elemePart":0.0,"restaurantPart":0.0,"id":129970322}],"invoiceType":null,"taxpayerId":"","coldBoxFee":0.0}

 

该订单商家实际收入（income）= 商品总价 + 配送费 - 商家活动补贴总金额 - 佣金 = originalPrice（此字段已包含用户实付配送费） + (originalDeliverFee - merchantDeliverySubsidy - deliverFee) - shopPart – serviceFee - baseLogisticsServiceFee - allowanceServiceFee - cpcAmount - contributionAmount -publicWelfareGoodsFee = 34 + 0 - 15 – 0.75 - 0 - 0 - 0 - 0 -0 = 18.25元

相关字段说明：
originalPrice ：订单原始价格也就是订单优惠前的总价格，即菜品总价加上配送费和餐盒费，单位：元；
shopPart：店铺承担活动费用；
elemePart：饿了么承担活动费用；
familyPart：代理商承担活动费用，是代理城市服务商给用户的补贴，此费用并不是商家承担；
serviceFee ： 饿了么服务费也就是佣金 { 佣金=（商品总价 - 商家活动补贴 ） * 费率 } ；
totalPrice ： 用户实际支付的金额 (用户实付金额 = 商品总价 + 配送费 - 总优惠)；

示例中的其他字段说明可参考接口文档：eleme.order.getOrder 内的字段说明

在线帮助

如您有任何疑问，欢迎加入保障宝平台，随时联系我们的保障宝daily进行咨询和反馈，让您的在线解答体验更加顺畅，我们将竭尽所能，不断改进和优化服务，为您提供更加贴心、高效的支持和服务，让您的体验更加美好！

FAQ

Q：items里面的"userPrice": 1.84，“shopPrice”: 2.4，这两个字段分别是什么定义？

A：userPrice是用户侧价格，shopPrice 是商户侧价格，如果两个价格不同说明商品参与有活动。

Q：一笔订单的商家实收如何计算？

A：自配送商户：商家实际收入：商品总价 + 饿了么补贴商家 - 商家活动补贴金额 + 配送费 - 佣金；
托管商户：商家实际收入：商品总价 + 饿了么补贴商家 - 商家活动补贴金额 - 佣金。

Q：超级红包对应订单哪个字段？会员免配送费和超级红包都不区分平台配送、自配送么？

A：用的是hongbao字段，会员免配送费和超级红包都不区分平台配送和自配送，金额都是饿了么承担。

Q：hongbao也是饿了么承担，是单独的活动与其他优惠活动无关？

A：hongbao是单独的字段与其他活动无关。

Q：请问orderActivities里面 “restaurantPart”: 0，和"elemePart": 0，这两个值的定义是什么？为什么为零？

A：orderActivities里面的"restaurantPart"和"elemePart"数据不准已不使用，后续评估后可能会取消掉这两个参数，可以查看orderActivities上方的"shopPart"和 “elemePart”，"elemePart"代表饿了么承担活动费用，"shopPart"代表店铺承担。

Q：商品参与了优惠，消息推送里面的price字段或是调用eleme.order.getOrder接口获取订单信息，字段price是商品原价还是活动价格？

A：您好，price是商品原价。

Q：请问eleme.order.getOrder 获取订单接口中新增的商家替用户承担配送费merchantDeliverySubsidy字段，会体现在此接口返回值“订单参加活动信息orderActivities”中吗？

A：您好，merchantDeliverySubsidy是单独的字段，不在orderActivities内。

Q：请问一个订单可以发生多次部分退款么？每次推送过来给我们的退款金额是累计退款金额还是单次的退款金额？

A：最多能发起三次部分退，每次推送的都是单次的退款金额。

Q：您好部分退款，服务费和配送费怎么退？

A：您好，部分退款只退所退商品的价格，配送费不退。服务费的话则会根据店铺类型平台自动判断是否部分退还。

Q：部分退款订单推送的金额与账单结算金额不一致

A：您好，消息推送推送的是退还给用户的金额，结算账单里面展示的金额是商家承担金额，若用户即享受了平台优惠也享受了商户优惠所以用户收到的退款金额自然就比较少，实际结算金额以账单为准。

Q：请问coldBoxFee，冷链加价费，现在被使用了么？这个费用是商家支出吗？

A：您好，若您采购含有冷链服务的服务包，针对冷链商家含有冷链商品的订单，物流结算时需额外向商户侧收取配送加价费。

Q：deliverFee是顾客支付的配送费，merchantDeliverySubsidy是商家承担的配送费，根据文档描述：“originalPrice为订单优惠前的价格，即商品总价加上配送费和餐盒费，问此描述中的配送费是deliverFee 还是 deliverFee + merchantDeliverySubsidy？

A：您好，此描述中的配送费为用户实际支付配送费（是deliverFe）。

 

说明：

近期有收到开发者反馈推送的订单金额有不准的现象，对此我们建议您以实际账单为准（打款金额是按账单结算），或是自己拿原始数据计算，需要计算的数据有抽佣（抽佣金额只需保留两位小数多出的部分做截断处理）和商家收入；

订单金额在某些情况下确实会出现不准的情况如：订单降级、专送转自配送（专送转自配送的订单在实际结算时不会收取抽佣和配送费）实际请以结算账单为准，结算时会重新再校验订单各项金额。