关于我们

饿了么开放平台【接口升级】金融接口新老账单和订单接口优化升级通知

发布时间:2022-02-13

 

个人零费用代理店+,日收入3000+,可兼职做

尊敬的开发者:

您好,为了提升商户对账体验,平台正在做账单接口升级,以完善账单接口返回的数据信息。请符合接入要求且已接入的开发者重点关注。

 

涉及变更接口如下:

--老金融接口,最早一批接入的开发者需关注

eleme.finance.queryHeadBills 查询总店账单(旧接口,即将下线)

eleme.finance.queryHeadOrders 查询总店订单(旧接口,即将下线)

eleme.finance.queryBranchBills 查询分店账单(旧接口,即将下线)

eleme.finance.queryBranchOrders 查询分店订单(旧接口,即将下线)

eleme.finance.getOrder 查询订单(旧接口,即将下线)

 

 

--新金融接口,最近一批接入的开发者需关注

eleme.finance.queryHeadBillsNew 查询总店账单(新接口)

eleme.finance.queryHeadOrdersNew 查询总店订单(新接口)

eleme.finance.queryBranchBillsNew 查询分店账单(新接口)

eleme.finance.queryBranchOrdersNew 查询分店订单(新接口)

eleme.finance.getOrderNew 查询订单(新接口)

 

 

一、查询总店账单、查询分店账单

1、老账单接口:eleme.finance.queryHeadBills 查询总店账单(旧接口,即将下线)、eleme.finance.queryBranchBills 查询分店账单(旧接口,即将下线)

2、新账单接口:eleme.finance.queryHeadBillsNew 查询总店账单(新接口)、eleme.finance.queryBranchBillsNew 查询分店账单(新接口)

 

如上,新老接口中的总店和分店账单接口,变更内容如下:

1)、checkoutAmount字段描述改为:外卖结算金额;

2)、老的账单接口新增status字段,0-待结算,1-已结算;

3)、新增settleAccountShopId结算入账id、agentCommissionAmount代运营佣金结算金额、agentStatus代运营佣金结算状态、promotionCommissionAmount联盟推广佣金结算金额、promotionStatus联盟推广佣金结算状态、insuranceCommissionAmount保险费用结算金额、insuranceStatus保险费用结算状态、otherCommissionAmount其他账户结算金额、otherStatus其他账户结算状态;

4)、原接口中的income本期订单收入、expense本期订单支出、deductAmount本期抵扣欠款、dueAmount剩余欠款,保留定义值但返回为null, 请开发者重点关注。

 

 

二、查询总店订单、查询分店订单、查询订单接口

1、eleme.finance.queryHeadOrders 查询总店订单(旧接口,即将下线)、eleme.finance.queryBranchOrders 查询分店订单(旧接口,即将下线)、eleme.finance.getOrder 查询订单(旧接口,即将下线)

2、eleme.finance.queryHeadOrdersNew 查询总店订单(新接口)、eleme.finance.queryBranchOrdersNew 查询分店订单(新接口)、eleme.finance.getOrderNew 查询订单(新接口)

 

如上,新老接口中的总店和分店订单接口,变更内容如下:

1)、新的账单接口新增merchantDeliveryCoupon商户配送费券补贴;

2)、新增ffmTotalAmt实收履约服务费、distancePriceUp距离加价、costAdditionalPrice价格加价、additionServiceAmount增值服务费、contributionAmount募捐金额、familyDeliCouponSubsidyAmt代理商配送券补贴费、familyDeliActiSubsidyAmt代理商配送费活动补贴、eleDeliCouponSubsidyAmt平台配送费券补贴费、eleDeliActiSubsidyAmt平台配送费活动补贴;

3)、新增agentCommission_info代运营费用信息结构,包含agentCommissionRate代运营佣金费率、agentCommissionBasicAmt代运营佣金结算基数、settleAmt代运营结算金额;新增promotionCommissionInfo联盟推广费用信息结构,包含promotionCommissionRate退款佣金费率、promotionCommissionBasicAmt推广佣金结算基数、settleAmt联盟推广结算金额;新增InsuranceFeeInfo保险相关费用结构,包含orderType保险类型、insuranceFeeAmount应收保费金额、platformSubsidyAmount平台补贴金额、merchantSettleAmount商户结算金额;

4)、原接口中的compensationRate取消赔偿费率、refundAmount用户申请退单金额、cancelledCallDeliveryAmount取消呼单赔付金额、zionServiceType服务包ID、coldDeliveryFee冷链配送、cpsName cps扣费名称、cpsAmount cps扣费金额,保留定义值但返回null,请开发者重点关注。

 

以上接口变更预计八月底上线,请各位开发者及时评估是否对当前处理逻辑有影响,如有疑问请提交在线工单反馈或者进如下钉群反馈。

/template/Home/AllNew/PC/Static