有赞新零售社区

发帖
有赞云历史板块»新交易详情接口开放通知

新交易详情接口开放通知

有赞-安安 2018-04-25 6404 浏览 9 评论 | [显示全部楼层] [打印]
各位开发者:


最近比较多的开发者反馈交易订单超时及延时的问题,为了更好的提高接口的使用体验,现推出新的交易详情接口,后续会停止对老接口的支持。
新接口对已有的字段信息进行了拆分处理,配合查询接口,能有效避免延时超时问题。后续有赞云会继续推出新订单列表接口和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 编辑
用手机打开
收藏 1 ··· 回复
    你好,请问旧接口里的 outer_user_id 字段是去掉了吗?或者 outer_user_id 这个字段是有什么调整了?

    这个字段我们是用来在app内用户登录后,通过登录接口(URL:https://uic.youzan.com/sso/open/login,字段:open_user_id)传给有赞我们系统的用户ID,用户下单的时候我们可以通过这个 outer_user_id 字段得知当前下单用户;

      EstherZhong 发表于 2018-9-6 14:26
      你好,请问旧接口里的 outer_user_id 字段是去掉了吗?或者 outer_user_id 这个字段是有什么调整了?

      这个 ...


      抱歉,我应该是问错帖子了

        1跳至
        您需要登录后才可以回帖 登录 | 立即注册

        本版积分规则

        复制链接
        新浪微博
        QQ空间
        微信扫码
        • 回复

        • 评分

        客服工作时间是9:00-18:00,客服妹子当前不在线,若不能及时回复请谅解。试试右上角的搜索吧,论坛有丰富的经验贴、公告贴,相信一定能够帮到您~

        复制成功