快手打单接口能力说明



1 订单查询

获取订单列表:调用open.order.pcursor.list(获取订单列表(游标方式) ),可以按照状态(type)、分销类型(cpsType)和生成时间(beginTime/endTime)筛选查看订单列表,并输出这些订单的详情,包括订单信息、商品信息、物流信息、是否分销、支付信息等

获取订单详情:调用open.order.detail(获取订单详情),输入orderId(订单id,可通过步骤1获取),可以查看该订单详情,包括订单信息、商品信息、物流信息、是否分销、支付信息等。获取订单的费用信息:调用open.seller.order.fee.detail(获取订单费用详情),输入orderId(订单id,可通过步骤1获取),可以查看该订单的费用相关信息,包括货款、运费、优惠信息、商品价格、营销信息商家承担比例等。


2 订单管理

订单规格:调用open.seller.order.sku.update(修改订单规格),输入orderId(订单id)、itemId(商品id)、oldSkuId(订单商品老skuID)和newSkuId(订单商品新skuID),可修改订单的商品规格。调用条件:该订单不存在进行中的退款,也没有退款成功的售后单,且当前订单状态为“待付款”或“待发货”才可以操作修改订单规格

订单发货:在订单处于“30-已付款”状态时,商家可执行发货操作。则调用open.seller.order.goods.deliver(发货),输入orderId(订单id)、expressNo(快递单号)和expressCode(快递公司code),可执行发货操作(不支持拆单多次发货)。

平台会拦截发货的情况:当订单有关联的退款单,且退款单状态为“50-退款执行中”或“60-退款成功”时,平台会拦截发货;当订单被风控,riskCode有值时,不会返回收件人的信息,不可发货;

其他拦截发货的情况:若有商家需要按照是否有退款单和退款单是否在申请中等其他情况来拦截发货,需要开发者自行根据业务情况判断进行拦截,平台不做拦截。

修改物流:调用open.seller.order.logistics.update(物流更新),输入orderId(订单id)、新的expressNo(快递单号)和expressCode(快递公司code),可修改物流信息。调用条件:订单状态必须为已发货或是已签收状态,才能调用此接口更新物流信息

添加订单备注:调用open.seller.order.note.add(添加备注),输入orderId(订单id)和note(备注信息)可对该订单添加备注。

关闭订单:则调用open.seller.order.close(关闭订单),输入orderId(订单id)可关闭该订单。调用条件:在订单处于“待付款”状态时,商家为快速释放库存可主动发起“关闭订单”,也可在小店后台设置自动关闭订单的时间。


3 评价管理

查询评价列表:调用open.comment.list.get(查询评价列表),可以按照订单(outOrderNo)、各项评分、商品(outItemId/itemTitle)、创建时间范围内(createTimeFromfrom/createTimeTo)等筛选查看评价列表,并输出评论内容、评分、订单信息等。

回复评价:调用open.comment.add(回复评价),输入1中获取的outItemSkuId(业务方SKUID)、outOrderNo(业务方订单编号)、replyToCommentId(回复的评论id),并填写回复的内容(content)即可。


2.4 人群管理

获取买家购买次数:若应用需要买家授权,可以调用open.user.seller.get获取买家openId,再按照买家openId(openId)、生成时间(beginTime/endTime)调用open.order.buyer.order.list(获取卖家对应买家的订单列表),筛选查看订单列表,获取在选定的时间段内买家的购买次数。

获取买家评价次数:调用open.comment.list(评价列表),输入1中获取的订单号(outOrderNo),查询是否买家评价过订单。调用open.subcomment.list.get(评价列表),输入评价列表的主评论id(rootCommentId),查看买家是否追加过评价。




立即体验