点三  电商OMS/ERP/API帮您串联线上线下订单业务-稳定运行11年【免费试用】

客服热线

400 8080 092

当前位置: 首页 > 资讯 > API接口

关于有赞API的常见问题

编辑:原创    时间:2024-05-10 17:52:42

为帮助开发者更高效的对接有赞API,本篇文章收集了一些关于有赞API的常见问题,并给出问题答案,一起来看下吧。


一、如何获取有赞微商城上面所有商品,要使用哪些有赞API?

使用接口youzan.items.onsale.get(获取出售中的商品列表)和youzan.items.inventory.get(获取仓库中的商品列表,已下架+已售罄)即可获取微商城店铺下所有商品信息,包括商品id(item_id)、商品标题(title)等。


二、修改商品库存,可以使用哪些有赞API接口?

修改商品库存可以使用:youzan.item.quantity.update或youzan.item.sku.update

需要注意的是,修改有规格商品库存时,建议先调用youzan.item.get查询商品目前的sku_id,以便在修改库存时传入正确的值。


三、有赞API订单详情接口中order_promotion中没有返回数据是怎么回事?

1.需确认订单中是否有优惠信息,如果没有参加优惠,不会返回数据。

2.需确认是否是老订单,倒数第五位不是0的都是老订单,才订单不支持返回优惠信息。


四、有赞API如何查询每一个包裹发货时间?

1.https://doc.youzanyun.com/detail/api/0/138使用该接口获取distOrderDTOs.update_time字段即发货时间(Unix时间戳:单位:毫秒)使用:dist_id字段关联

2.或基于消息推送处理:trade_TradePartlySellerShip (部分发货消息)中update_time,该时间是每一个包裹的发货时间。


五、有赞API订单详情接口中的real_payment和payment的差别是什么?

youzan.trade.get订单详情接口中pay_info.payment是买家应付的金额,pay_info.real_payment是买家实付的金额。一般来说payment=real_payment。

但在以下几个场景下,实付金额会小于应付金额:

1.定金预售如只付定金显示定金;

可通过order_info.order_tags.is_down_payment_pre(是否是定金预售)字段来判断订单是定金预售商品。

2.未支付订单为0;

可通过pay_type(订单支付类型)=0来判断是否是未支付。

3.货到付款为0

可通过pay_type(订单支付类型)=9来判断是否是货到付款。

4.扣除支付营销优惠金额

可通过pay_ump_detail是否为空来判断有没有支付营销优惠这个优惠类型。


六、有赞API库存调整接口:youzan.retail.open.stock.adjust,调整的库存是全量还是增量?

当操作类型字段未传入时为全量,操作类型1为增加,操作类型2为减少。


七、有赞API库存调整接口中关联单据号如何获取?

关联单据号商家可自定义生成传入。


八、如何使用有赞API接口进行发货操作?

1.订单发货接口 youzan.logistics.online.confirm

适用场景:

1)一个订单下有多种商品,要拆单发货(一种商品仅支持一个运单);举例:比如买家买了商品A和商品B,可分别调用该接口拆单发货,商品A发运单1,商品B发运单2;

2)一个订单下有单个商品,卖家要进行发货操作。 

2. 单商品分为多个运单发货接口youzan.trade.dc.delivery.ordersingleitemsend

适用场景:

1)一个订单下有1种商品,要分为多个运单发货;举例:比如买家下了10件苹果,因为重量原因不能在一个运单中发货,可调用该接口进行单商品拆单发货,5件苹果发运单1,另外5件苹果发运单2;

2)一个订单下有n种商品,其中某个商品数量大于1,要分为多个运单发货;举例:比如买家下了10件苹果和4件西瓜,因为重量原因不能在一个运单中发货,可调用该接口进行拆单发货。5件苹果发运单1,另外5件苹果发运单2,4件西瓜发运单3 。

需要注意的是,调用此接口每种商品要一次性发完,即发货商品的包裹中数量要等于订单中的发货商品数量(ex_packages.num的总和需要等于单商品的数量)。不满足的情况下接口会返回以下错误:102570059 所发包裹的商品总数必须等于该商品的购买总数

3)一个订单下有多种商品,要拆单发货;

4)一个订单下有单个商品,卖家要进行发货操作。  

如果开发者有单商品多运单的场景推荐使用接口2.单商品分为多个运单发货,如果仅同种商品拆单发货的话,使用接口1.订单发货接口即可。


开发者如果想要高效对接有赞API,可以咨询点三客服获取解决方案。

50000+企业的共同选择
点三全渠道全链路ERP

免费注册试用

400 8080 092