各位开发者:
最近比较多的开发者反馈交易订单超时及延时的问题,为了更好的提高接口的使用体验,现推出新的交易详情接口,后续会停止对老接口的支持。 新接口对已有的字段信息进行了拆分处理,配合查询接口,能有效避免延时超时问题。后续有赞云会继续推出新订单列表接口和V3版本的推送消息,提高大家的使用体验。
请大家关注一下,并尽快更新对接。
新交易详情接口链接如下:https://www.youzanyun.com/apilist/detail/group_trade/trade/youzan.trade.get 关于新交易详情接口,有以下几点需要大家关注:
1、 新老接口的区别 1) 新接口增加了判断零售订单、虚拟订单的字段; 2) 新接口增加了信息打标字段,可直接判断订单是否有结算、支付、担保交易、维权、免邮、退款等操作; 3) 新接口无团编号,五月中旬会开放新接口根据订单id查询团编号信息; 4) 新接口无粉丝昵称信息,可以通过youzan.users.weixin.follower.get接口进一步查询; 5) 新接口目前无周期购、改价、优惠码/优惠券id、优惠活动id、收银台二维码id,后期会迭代实现; 6) 新接口的子订单id 字段长度由原来的8位变为19位。
2、 需重点关注的判断逻辑 1) 如何判断订单是否应该发货? 订单状态是已付款待发货,并且delivery_order->oids中不包含的oid,并且refund_order中不包含退款中的oid以及全额退款的oid,可以发货。
2) 如何判断订单是否已经发货? delivery_order->oids中如果包含已发货了的商品的oid 就不需要去发货了(虚拟商品除外)。
3) 如何判断交易的实收金额? 订单实收:full_order_info->pay_info->payment; 商品实收:full_order_info->orders->payment。
4) 如何判断是否是退款单? is_feedback=true表明买家有发起过维权,具体的退款子订单信息、退款金额可以去refund_order中查看; is_refund=true表明订单发生过退款,具体退款子订单信息、退款金额可以去refund_order中查看。
5)如何判断部分退款?
refund_order 如果不等于空 取到 oid 和对应的refund_fee 去和full_order_info.orders对应的oid的payment对比, 如果payment==refund_fee 就是全额退款 如果 refund_fee<payment 就是部分退款。(简单说:就是用退款金额去对比均摊)
大家有问题请留言反馈,谢谢
有赞云运营 2018年04月24日
本帖最后由 有赞-安安 于 2018-5-23 16:50 编辑
|