有赞开放API接口更新日志

各位合作伙伴，

有赞云是一个开放合作的平台，为了各位更好地接入有赞云，更公开透明地沟通，我们把所有接口及接入文档的更新，通过此帖子记录下来。

你可以通过这篇帖子了解，最新发布了哪些API，哪些API字段增加了，新发布了哪些文档，哪些文档做了修改优化等，如果对发布内容有疑问，或者有新的相关需求，都可以直接跟帖回复，跟帖请详细说明问题或需求的业务背景，以方便快速定位问题和需求。

更新日志

2017-11-02

1.优惠券接口更新

发优惠券接口youzan.ump.coupon.take增加支持三方用户功能，可以通过open_user_id给三方用户发优惠券。主要适用于AppSDK用户，用以打通App优惠券体系与有赞商城优惠券体系，提供更佳的用户体验。

2.销售员接口更新

新增销售员统计接口youzan.salesman.account.score.search，可用于查询销售员的业绩，并且集成到系统里用于账务结账。新增订单号查销售员接口youzan.salesman.trades.account.get，可用于分析订单是哪个销售员带来的，以前开发者需要将订单列表和销售员订单列表拉取出来，一一核对，通过此接口可以直接通过订单号查询到对应销售员，减轻系统压力及人员工作量。

3.商品接口增加更新时间字段

出售中的商品接口youzan.items.onsale.get和库存中的商品接口youzan.items.inventory.get，增加入参update_time_start和update_time_end，用于增量查询某段时间内有更新的商品，避免全量拉取商品，减轻系统压力。

2017-10-26

新增商品规格信息推送

只要开发者在控制台订阅商品规格信息事件，且商家也授权推送该事件，则有赞店铺内商品规格的增加、删除以及价格库存的更新等，都会实时推送到开发者配置好的推送地址，以帮助开发者及时地做好商品信息的同步。详细内容参考：https://www.youzanyun.com/docs/guide/push/704

2017-10-19

1.积分及会员卡接口更新

积分接口组增加支持三方用户功能，可以通过open_user_id查询操作用户的积分。主要适用于AppSDK用户，用以打通App积分体系与有赞商城积分体系，提供更佳的用户体验会员卡接口组增加支持三方用户功能，可以通过open_user_id查询操作用户的会员卡。主要适用于AppSDK用户，用以打通App会员体系与有赞商城积分体系，提供更佳的用户体验

涉及接口：youzan.scrm.customer.card.grant.3.0.0youzan.scrm.customer.card.delete.3.0.0youzan.scrm.customer.card.list.3.0.0youzan.crm.customer.points.increase.3.0.1youzan.crm.customer.points.changelog.get.3.0.1youzan.crm.customer.points.decrease.3.0.1youzan.crm.fans.points.get.3.0.1

2.积分推送更新

积分推送增加支持三方用户功能，可以通过open_user_id匹配到三方用户

3.用户接口更新

增加删除用户标签接口youzan.users.weixin.follower.tags.delete.3.0.0

2017-10-12

1.新增商家删除会员卡接口youzan.scrm.card.delete

2.用户删除会员卡接口youzan.scrm.customer.card.delete增加卡号card_no字段

3.交易接口支持小程序下单用户粉丝信息的查询，具体粉丝信息可在返回的fans_info字段里查到

2017-09-28

新增会员场景文档

第三方合作伙伴可以参考此文档，与有赞进行会员数据打通

详情可参考：https://www.youzanyun.com/docs/guide/common/1248

2017-09-27

新增酒店房态更新接口youzan.item.hotel.room.update

开发者可以一次设置房间未来任意30天的库存和价格

详情可参考：https://www.youzanyun.com/apilist/detail/group_item/item/youzan.item.hotel.room.update

2017-09-22

新增优惠券/码消息推送

包含商家端创建、更新、失效优惠券/码消息，用户端领取、核销优惠券/码消息等，

开发者可以实时接收消息，同步到系统，保持有赞和系统的数据一致。

详情可参考：https://www.youzanyun.com/docs/guide/push/1233

2017-09-21

1.交易详情接口 youzan.trade.get 增加新的交易明细字段new_oid，原来oid字段保持不变。

2.退款消息推送，新增加一个new_oid字段，原来oid字段保持不变。

new_oid长度大于oid长度，目前暂时没有业务会用到new_oid，对商家或开发者来说没有影响。

2017-09-14

1.优惠码优惠券接口组youzan.ump.coupon.consume.verifylogs.get接口增加promocard_id、promocode_id字段

2.优惠码优惠券接口组youzan.ump.coupon.consume.fetchlogs.get接口增加promocard_id、promocode_id字段

3.优惠码优惠券接口组youzan.ump.coupon.consume.get接口增加promocode、promocard_id、promocode_id字段

2017-09-07

1.商品API组youzan.item.get接口增加返回参数规格图片字段sku_images

2.商品接口调用场景文档发布，请参考https://www.youzanyun.com/docs/guide/common/1209

2017-08-24

1.商品API组新增youzan.item.hotel.room.set接口，用于酒店类商品设置房态

2.商品API组youzan.item.create接口增加规格图片字段sku_images，youzan.item.update接口增加规格图片字段sku_images

2017-08-17

1.粉丝查询接口youzan.users.weixin.followers.get增加only_follow字段，用于同时拉取已关注和已跑路粉丝

2.物流API组新增youzan.logistics.expressbyorderno.search，用于通过订单号查询所有包裹的物流信息

2017-08-07

1.交易推送消息发布新版：订单状态事件 TRADE_ORDER_STATE（付款、发货、关闭等主状态变更），退款事件 TRADE_ORDER_REFUND（买家发起退款、卖家处理退款等退款状态变更），物流事件 TRADE_ORDER_EXPRESS（订单发货

2.商品推送消息发布新版：商品状态事件 ITEM_STATE（售罄、上下架等商品主状态变更），商品基础信息事件 ITEM_INFO（新建商品、商品更新等信息变更）

3.推送事件细分，支持开发者按需订阅，请前往控制台-应用设置-开发信息启用

新版消息推送事件更加细致、明晰，细分后消息实时性更强，开发者可根据自身需要订阅事件。同时，老版本的交易/商品推送不受影响，可正常使用，暂定2017年12月31日停止老版本消息推送

2017-07-31

1.发布1.0.1版本的.Net SDK，解决使用GET方法创建/更新商品可能出现的中文乱码问题，建议使用.Net SDK的开发者升级

2.开放.Net SDK的源码，开发者可fork根据自身需要迭代，也欢迎提交代码，Github地址：https://github.com/ph0ly/open-sdk-csharp

2017-07-24

1.用户接口新增youzan.user.weixin.openid.get接口，可通过手机号查询粉丝的open_id （仅支持绑定认证服务号的店铺，且要查询的粉丝已绑定有赞手机号）

2.有赞云控制台-应用设置-应用详情富文本编辑器升级，支持表情、图片上传以及更丰富的编辑样式

3.发布全渠道解决方案文档和多网点场景文档帮助开发者梳理接口调用场景，更好的进行开发

2017-07-11

1.有赞云控制台新增订阅通知功能，目前支持开发者订阅API更新通知、消息推送服务亚健康通知、产品新功能上线或功能下线通知三种类型的通知。建议订阅消息推送服务亚健康通知，当开发者的推送网址服务亚健康时，系统会立即发送邮件通知，提醒开发者及时处理

2.有赞云控制台新增失败消息重推功能，开发者可以对失败的消息进行再次推送操作，将消息补回

3.亚健康状态的失败次数阈值放宽，从“连续失败25次”改为“连续失败100次”

2017-07-04

1.消息推送新增支持会员卡消息推送，支持消息事件：商家进行新增/编辑/删除/启用/禁用会员卡操作、用户领取/删除会员卡

2.新增数据中心API组，共发布5个新接口，支持获取微商城来源监控功能的相关数据

注意：数据中心API需要在“有赞云控制台-能力配置”去申请开通权限，方可调用

2017-06-23

1.有赞API文档页全新改版，按业务类型进行分组，支持JAVA/.Net/PHP/Node.js/Python五种主流语言请求示例，示例与服务端SDK保持一致

2.服务端PHP-SDK更新，新增支持自用型、工具型、平台型的token获取

2017-06-19

1.有赞云控制台二期发布：自用型应用升级、回调地址拓展支持10个、消息推送支持开发者自定义订阅、全新的授权页面

2.商品接口发布youzan.item.delete发布

3.销售员接口youzan.salesman.accounts.get和youzan.salesman.customers.get的单次返回数据最大限制由20增大到100

4.服务端JAVA-SDK更新2.0.1版本，新增非模型化HTTP请求支持，方便开发者在无模型类时也能正常使用SDK

2017-06-15

1.商品接口发布新更新商品接口youzan.item.update，新增支持更新虚拟商品、电子卡券商品、酒店商品的商品信息，支持更新sku重量信息，支持更新商品时使用remove_image_ids字段，字段指定商品图片id去删除相应的图片

2.商品接口发布新根据商家编码查询商品接口youzan.items.custom.get

2017-06-13

1.PHP-SDK升为2.0.0版本，支持新的图片上传接口

2.新上线素材管理接口组，新上线图片素材上传接口youzan.materials.storage.platform.img.upload。该接口为全新接口，在此6月13日之前申请的应用需要在有赞云控制台-能力配置处申请权限，我们将在1工作日内审核通过

3.商品接口发布新创建商品接口youzan.item.create，除普通商品外，新增支持创建虚拟商品、电子卡券商品、酒店商品，支持创建商品时传入sku重量信息，并对冗余字段进行了一系列优化

注意：为了提高创建商品效率，请先调用上传图片接口传好图片后取image_id用于商品创建。避免老接口在上传商品的同时上传图片串行导致创建商品时间过长的情况。

2017-06-09

1.多网点接口youzan.multistore.offline.create和youzan.multistore.offline.update新增local_delivery_scope_type、local_delivery_polygon两个参数，支持通过接口设置网点同城配送半径或多边形范围

2.物流接口新上线顺延周期购配送时间接口youzan.logistics.online.delay和取消顺延周期购配送时间接口youzan.logistics.online.canceldelay

2017-06-08

1.销售员接口youzan.salesman.account.get和youzan.salesman.accounts.get返回值新增邀请人手机号from_buyer_mobile、店铺自有粉丝的fans_id

2.商品接口上线查询单商品信息、查询在售商品列表、查询仓库中商品列表三个接口的3.0.0版本

3.商家管理订单接口youzan.trade.get针对周期购订单返回值新增周期购数据结构period_order_detail

4.物流接口youzan.logistics.online.confirm新增支持周期购订单按期次发货，入参字段issue

2017-04-28

1.会员卡API组新增youzan.scrm.customer.info.get，可通过用户的会员卡号查询会员信息

2.youzan.scrm.card.create、youzan.scrm.card.update、youzan.scrm.card.get

返回值中新增CardRights结构

2017-04-25

1.原开放平台全新升级为有赞云，全新的有赞云官网、开发者控制台

2.接口全面升级为3.0.0版本，新增50+个接口，接口更丰富

3.接口权限申请全面自动化，登录“开发者控制台-能力配置”即可申请权限

4.新增API调用监控报表

5.新增消息推送日志查询

6.AppSDK全新升级为基础版和原生版两个版本

以前老的更新日志请参考：https://bbs.youzan.com/thread-474205-1-1.html

youzan.trade.qrcode.ext.create 接口 out_source 如何申请

请问什么时候可以支持通过api修改商品会员价格，现在有1000款产品，手动修改会员价格，每改一次就想死一次。

您好 ， 我想请教个问题，有赞客服能与外部第三方客服平台打通吗？因为我们还有APP电商，所以想共用一套客服+CRM系统，APP是我们自己开发的可以对接过去，有赞的客服功能有API能对接过去吗？谢谢！