有赞新零售社区

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

新交易详情接口开放通知

有赞-安安 2018-04-25 7877 浏览 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 ··· 回复
    完成新版API部署

      Aidenboss   青铜   2018-05-15 | 只看该作者
      您好,想问下,我使用 Java SDK 调用该接口的时候,返回内容是 {code='51003', msg='系统异常'}。是什么原因导致的呢?
      望回复,谢谢!

        有赞-安安 青铜   2018-05-18 | 只看该作者
        Aidenboss 发表于 2018-5-14 19:19
        您好,想问下,我使用 Java SDK 调用该接口的时候,返回内容是 {code='51003', msg='系统异常'}。是什么原 ...


        开发看了一下应该是一些入参的校验错误,具体定位需要你提供一下调用的详情、时间等信息

          a5d5893b36db   青铜   2018-07-19 | 只看该作者
          请问下,什么时候补充 refund_order、delivery_order、order_promotion 这3部分信息?如果按4.0接口文档里的结构,这样集成在订单里,会方便很多。谢谢。

            a5d5893b36db 发表于 2018-7-19 01:37
            请问下,什么时候补充 refund_order、delivery_order、order_promotion 这3部分信息?如果按4.0接口文档里 ...


            您好,这个问题我们这边了解了,以后有推出会告知到开发者的。

              EstherZhong   青铜   2018-09-06 | 只看该作者
              你好,请问旧接口里的 outer_user_id 字段是去掉了吗?或者 outer_user_id 这个字段是有什么调整了?

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

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

                这个 ...


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

                  cd47286427c3   青铜   2018-09-20 | 只看该作者
                  请问下,什么时候补充 refund_order、delivery_order、order_promotion 这3部分信息?如果按4.0接口文档里的结构,这样集成在订单里,会方便很多。谢谢。

                    口十   青铜   2018-09-21 | 只看该作者
                    EstherZhong 发表于 2018-9-6 14:26
                    你好,请问旧接口里的 outer_user_id 字段是去掉了吗?或者 outer_user_id 这个字段是有什么调整了?

                    这个 ...


                    是的,暂时没有,下周应该就有了。

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

                      本版积分规则

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

                      • 评分

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

                      复制成功