文档中心 > API文档

API变更历史及一些重要通知

更新时间：2022/01/11 访问次数：142100

2022-01-11

新增内容

近期在和ERP服务联调过程中发现部分商家有混合使用新老接口发货操作，导致发货报错问题。

技术排查结论：
一个交易单,如果创建物流单、申明发货、修改申明发货使用的是老接口,那么不能使用新接口进行申明发货和修改申明发货;
新老接口混合申明发货,可能会存在申明发货状态不更新为全部申明发货.

举个例子,针对一个交易单有以下几个场景:
场景1:使用老接口创建物流单;申明发货、修改申明发货都只能使用对应老的接口.

场景2:使用新接口创建物流单;可以通过主交易单的维度继续使用老的申明发货和修改申明发货接口,但是使用老的申明/修改申明发货之后就不能使用新的接口.

场景3:使用新接口创建物流单;如果使用了新的接口做了申明发货,那么修改申明发货也要使用新接口,如果使用老接口修改申明发货会提示找不到对应的申明发货记录.

2022-01-10

新增内容

查询可用物流服务、创建物流单、申明发货、修改申明发货旧接口下线通知

尊敬的全球速卖通发货相关第三方ERP服务商和自研ERP商家伙伴们：
近期我们收到商家反馈目前使用ERP发货流程与页面操作较为繁琐，影响部分订单的发货效率。因此菜鸟计划对商家使用的发货工具（ERP）进行如下四个模块的改造（查询可用物流服务、创建物流单、申明发货、修改申明发货），提升商家发货操作体验。

一、改造说明：
1. 本次四个模块内容ERP改造在原有基础功能上新增子单发货功能，新接口菜鸟侧已于2021年9月18日上线正式环境。
2. 时间：（查询可用物流服务、创建物流单、申明发货、修改申明发货）旧版接口将于2022年2月14日正式下线，不再开放使用。
请各位发货相关第三方ERP服务商和自研ERP商家根据以下接口改造指导尽快完成内部改造，并联系菜鸟进行联调测试，最迟需于2022年2月14日前正式上线新功能版本，否则将影响线上发货。
3. 若有疑问请各位发货相关第三方ERP服务商和自研ERP商家加入“发货体验ERP优化改造答疑群”钉钉群（群号：33521851）进行沟通，入群请各位修改群名称备注，格式“ERP-公司名字”。

二、API文档：

1.查询线上物流服务列表
原接口名称:aliexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid
接口文档:https://open.taobao.com/api.htm?docId=30137&docType=2
新接口名称:aliexpress.logistics.service.query
接口文档:https://open.taobao.com/api.htm?docId=58008&docType=2
改动点:基于原接口做了升级,增加了“子交易单列表:sub_order_list”字段,具体明细见新接口文档

2.子交易单创建物流订单
原接口名称:aliexpress.logistics.createwarehouseorder
接口文档:https://open.taobao.com/api.htm?docId=30198&docType=2
新接口名称:aliexpress.logistics.order.createorder
接口文档:https://open.taobao.com/api.htm?docId=58035&docType=2
改动点:入參和原来接口一致,本次在declare_product_d_t_os中增加了child_order_id字段,具体细节见新接口文档

3.子交易单申明发货
原接口
接口1名称:aliexpress.logistics.sellershipmentsupportsubtradeorder
接口1文档:https://open.taobao.com/api.htm?docId=30154&docType=2
接口2名称:aliexpress.logistics.sellershipmentfortop
接口2文档:https://open.taobao.com/api.htm?docId=30146&docType=2
新接口
接口名称:aliexpress.logistics.order.shipment
接口文档:https://open.taobao.com/api.htm?docId=58036&docType=2
改动点:入參和原来接口一致,但是新的接口增加了子交易单的校验.如果之前是用的是交易单维度的申明发货接口需要切换成当前接口

4.修改子交易单申明发货
原接口
接口1名称:aliexpress.logistics.redefining.sellermodifiedshipmentsupportsubtradeorder
接口1文档:https://open.taobao.com/api.htm?docId=30155&docType=2
接口2名称:aliexpress.logistics.sellermodifiedshipmentfortop
接口2文档:https://open.taobao.com/api.htm?docId=30147&docType=2
新接口
接口名称:aliexpress.logistics.order.modifyshipment
接口文档:https://open.taobao.com/api.htm?docId=58024&docType=2
改动点:入參和原来接口一致,但是新的接口增加了子交易单的校验..如果之前是用的是交易单维度修改申明发货接口需要切换成当前接口
?

三、改造后的反馈：
请在完成发货改造后进行反馈，反馈链接如下：https://yida.alibaba-inc.com/o/FHGZQK

四、需知：
发货相关第三方ERP服务商和自研ERP商家：请在2022年2月14日前务必确认改造完成，如果未完成改造，请通知商家使用商家后台的菜鸟线上发货页面进行发货，以免影响商家发货受限。

2021-08-16

新增内容

AE（海外）仓发接口API文档跟新

背景：
ISV通过AE开放平台提供的声明发货接口或修改声明发货接口主动回传的海外仓库实际的尾程配送服务的code，速卖通侧解析对应的承运商信息，自动获取的物流轨迹。
解决痛点：
解决由于商家回传的物流服务名称和实际的物流服务不一致，导致系统无法识别准确的carrier信息，最终无法获取物流轨迹的问题。
https://www.yuque.com/ruilirui/kb/yk33ev

行动点：
STEP 1（已有）：ISV 获取对应海外仓支持的尾程物流服务，需要ISV通过接口：“基础物流产品信息查询” 获取对应的物流服务产品
注：不同的WMS物流服务的叫法略有差异，递四方定义为：logistics_product_code，谷仓定义为：shipping_method
STEP 2（已有）：ISV获取AliExpress平台订单后根据订单及卖家要求，通过接口：“创建出库委托” 创建出库单同步至仓库
STEP 3（调整）：出库单生成运单号后，ISV通过AE开放平台接口：“声明发货” 将logistics_product_code的作为 actual_carrier 字段的同步给到AE平台
STEP 4（可选）：仓库出库使用物流产品变更情况下，ISV通过AE开放平台接口： “修改声明发货”将logistics_product_code的内容作为 actual_carrier 字段的填充内容，同步给到AE平台
注意：AE 部分业务不支持：凡使用“卖家自定义-中国”物流服务（service_name=“OTHER”）发货的订单，这块之前有特殊逻辑，不适用该规则，其他 AE 订单都可按照上述逻辑调整

2021-08-05

新增内容

【ERP获取字段提醒通知】

尊敬的全球速卖通发货相关第三方ERP服务商和自研ERP商家伙伴们：
随着全球速卖通平台陆续上线欧盟国家含税价展示（以下简称“含税价”），若您使用ERP进行速卖通发货，再次提醒各位服务商确保ERP的API接口字段已正确接入，避免出现获取金额与实际运用有偏差影响商家的店铺运营。可能的影响如下但并不限于：使用订单金额判断履约线路、使用订单金额财务对账月结等。

重点API文档：

一、关务所需的申报清关字段aliexpress.taxation.calculate.open.query
1）详情：https://open.taobao.com/api.htm?docId=56229&docType=2&source=search
2）背景及应用场景：欧盟新的电商增值税法规出台后，用于透传给线下发货物流商在海关侧的申报清关，仅限用于线下已税子订单的申报，可查询到子订单商品税金及税率等信息。
如果商家需要获取商品的最终税前价格或不含税价格，需要从此API中获取。
字段名称：order_tax_excluded_amount；字段含义：商品未含税总价

二、新版交易订单详情查询aliexpress.trade.new.redefining.findorderbyid
1）详情：https://open.taobao.com/api.htm?docId=34813&docType=2
2）背景及应用场景：此API接口为交易订单详情信息，包含了所有交易订单的字段。
含税价上线之后，产品总金额及订单金额都会含税表达。
字段名称：order_amount；字段含义：订单金额（含税价全部上线后英国及欧盟订单含税金）
字段名称：init_oder_amount；字段含义：产品总金额（含税价全部上线后英国及欧盟订单含税金）
税改ERP改造内容：https://www.yuque.com/vincent-30iiy/gnbgw1/gok61z

2021-07-15

新增内容

【必看】含税价必做
北京时间2021年7月1日凌晨6:00起速卖通根据欧盟的新版增值税法规，对于符合征税条件的商品代收代缴增值税(VAT)；同步速卖通将于近期全面上线欧盟VAT含税价的全链路展示；

为帮助商家朋友更好的理解欧盟VAT含税价发布的前后差异和必要待办，于7月14日下午14点进行了直播；现将直播视频及内容整合如下，供商家伙伴回顾解读：

一、含税价必看：https://www.yuque.com/docs/share/da59a064-55fd-4a28-b2b5-bc083b08a086?#%20

二、含税价直播：https://learning.aliexpress.com/course/learn?id=1755&type=video&login=skip

三、欧盟VAT回顾：https://www.yuque.com/vincent-30iiy/gnbgw1/ydyehf

2021-06-26

新增内容

【最新】欧盟税改发货ERP改造公告
?
尊敬的全球速卖通发货相关第三方ERP服务商和自研ERP商家伙伴们：
?2021年7月1日0点（UTC+2时间）即北京时间2021年7月1日凌晨6:00起欧盟27国将执行新版增值税法规。速卖通全部站点将根据欧盟的法规要求做出相应的技术调整，对于商家使用线上发货进行面向欧盟国家的跨境发货，需要对商家使用的发货工具（含ERP）进行如下四点改造，以便避免欧盟税改以后影响商家的发货操作：
（1）【新增】①发货页面添加平台IOSS字段填写框，并明确提醒商家平台代收代缴的已税包裹使用非16条菜鸟线上发货线路，但未填写平台IOSS编号给线下物流服务商，进口时消费者将可能被二次征收增值税或产生清关手续费。本次创建物流接口升级我们会更新：
aliexpress.logistics.sellershipmentsupportsubtradeorde及aliexpress.logistics.sellershipmentfortop两个接口，在接口入参中增加名为“IOSS”的可选参数，7月1日起当商家平台代收代缴的已税包裹使用非16条菜鸟线上发货线路声明发货时，会需要传入IOSS参数；如不传入则申明发货会报错。
API接口jar包及API说明页面会在6月25日更新，请ISV朋友们在6月25日下午3点后获取最新的jar包并升级自己软件的发货逻辑。
②希望ERP参考类似AE申明发货的IOSS编号提醒，希望是第一次是不勾选，后续支持商家默认勾选。（点击查看示例）
（2）平台会对全球速卖通交易端进行下发已税和未税标识到交易子单维度，ISV接收全球速卖通传的税标；
简介：税标是针对面向欧盟国家买家的跨境包裹根据平台是否已经代收代缴增值税打在子订单上的标识，将在2021年7月1日起开始使用。
- 已税：平台代收代缴包裹，到目的国海关时需要使用平台IOSS编号进行目的国海关申报；
- 未税：平台没有代收代缴增值税，不可使用平台的IOSS编号进行目的国海关申报。
（3）菜鸟从ERP接收基于交易子订单维度的已税标识和未税标识，同时ERP要传子订单明细给到菜鸟；
（4）限制跨主订单合并发货；
?
以上改造国家范围仅限于欧盟27国：
奥地利、比利时、保加利亚、塞浦路斯、克罗地亚、捷克共和国、丹麦、爱沙尼亚、芬兰、法国、德国、希腊、匈牙利、爱尔兰、意大利、拉脱维亚、立陶宛、卢森堡、马耳他、荷兰、波兰、葡萄牙、罗马尼亚、斯洛伐克、斯洛文尼亚、西班牙、瑞典；
注意：除外国家不涉及到任何改造。

时间：请各位发货相关第三方ERP服务商和自研ERP商家根据以下接口改造指导于6月30日前完成改造，否则将影响线上发货。

若有疑问请发货相关第三方ERP服务商和自研ERP商家加入“欧盟税改ISV发货改造沟通群”钉钉群（群号：34262205）进行沟通，入群请各位备注“ERP-公司名字”（入群请更改名字）。
?
已经在对接中/仍未对接的服务商及自研ERP，请务必进入钉群，尽快完成发货改造。
目前平台已在沟通对接中的常见服务商如下，如果商家使用以下ERP无需担心：
店小秘、全球交易助手、普源云ERP&普源网店精灵、马帮ERP、通途ERP、芒果店长、速脉ERP、赛盒ERP。
?
二、API文档
1.声明发货接口（6月25日新增）
-aliexpress.logistics.sellershipmentfortop
https://open.taobao.com/api.htm?docId=30146&docType=2
-aliexpress.logistics.sellershipmentsupportsubtradeorder
https://open.taobao.com/api.htm?docId=30154&docType=2
2.
AE新版交易订单详情查询
（修改点：新增already_taxed字段， I_TAXED 表示跨境已税，U_TAXED 表示海外仓已税。）
https://open.taobao.com/api.htm?docId=34813&docType=2

新增如下两个API接口-用于子交易订单商品维度税金信息查询：
-背景及使用场景：欧盟新的电商增值税法规出台后，用于透传给线下发货物流商在海关侧的申报清关，仅使使用于线下已税子订单的申报
-关务所需的申报清关字段：可查询到子订单商品税金及税率等信息
https://open.taobao.com/api.htm?docId=56229&docType=2&source=search
入参：order_id;
出参：quantity,
order_tax_excluded_amount, delivery_amount,order_tax_amount, delivery_tax_amount,
tax_rates, delivery_tax_rates, sub_order_id, currency
-平台固定参数获取：可查询到平台IOSS编号
https://open.taobao.com/api.htm?docId=56215&docType=2&source=search
入参：无
出参：ioss_number
4.菜鸟创建线上物流订单接口
https://open.taobao.com/api.htm?docId=30198&docType=2
?
三、改造后的反馈
请在完成发货改造后进行反馈，反馈链接如下：
https://yida.alibaba-inc.com/o/FHGZ
?
四、需知
第三方ERP服务商和自研ERP商家：请在6月30日前务必确认改造完成，如果未完成改造，请通知商家使用商家后台的菜鸟线上发货页面进行发货，以免影响商家发货受限。
?
全球速卖通 & 菜鸟

2021-06-11

新增内容

欧盟推出新的电商增值税法规，从2021年7月1日生效，新政会影响ERP向欧盟发货的要求，请各位ERP服务商务必查阅以下文档并完成相关的改造。https://www.yuque.com/docs/share/0bab482e-d1a8-4f5d-8a1b-ea4e0336de8d?# 《【欧盟税改】发货ERP改造公告》

另外，近期已经有部分ERP服务商加入到“欧盟税改ISV发货改造沟通群”钉钉群（群号33156687），两个群里的信息同步、改造方案是一致的。

2021-04-08

新增内容

各位ISV伙伴，
以下是上午沟通的AE平台即将上线的动态藏邮功能说明资料，请参考：

《动态藏邮功能上线说明–业务背景》，详见以下文档：（内含各个API接口说明链接）
?https://www.yuque.com/siyeneal/mnmqu6/ssxdxh?

涉及商品API变更说明，详见以下文档：
https://www.yuque.com/zhitong-sdlwo/xnw8mm/gigg6a

涉及交易API变更说明，详情见以下文档：
https://www.yuque.com/docs/share/af26c256-4709-4707-b150-d8994b1ef5fd?# 《动态包邮—交易相关api的变更》

营销相关的API变更说明，详情见以下文档：https://www.yuque.com/docs/share/ae50e6de-1677-444e-b241-a45d424969f1?#

物流-运费模板相关的API没有变更

2020-08-13

新增内容

接口名称： aliexpress.ugc.product.video.upload( 新增商品主图短视频 )
使用场景： 通过API批量上传商品时，可以通过该接口，上传商品对应的视频到AliExpress。上传后，视频内容会同步到该商品在AE的主图位置；
商家价值：
①短视频作为今年的核心内容业务之一，会和AE站内外的各大渠道打通（首猜、Feeds、大促会场透出、站外社群等）。有视频的商品将有机会在站内外获取更多流量和曝光；
②短视频的表达形式，对于提升商品的点击效率、展示价值有极大助益。有短视频的商品在对应指标上，对比无视频商品提升30%左右；
③增强买家对商家、商品的信任度，提升沟通效率，更好的传递商品信息。
接口信息： ?https://developers.aliexpress.com/doc.htm?docId=51659&docType=2

2020-08-03

新增内容

AE货值保障升级服务ISV接入
aliexpress.logistics.createwarehouseorder( 创建线上物流订单 ) 接口增加货值保障字段

新增接口
aliexpress.logistics.valueadded.insurance.estimate( 物流包裹货值保费估算接口 )
AE货值保障升级服务ISV接入文档：https://www.yuque.com/docs/share/45a841ea-4f88-43e1-9032-5c088fc51cf4?spm=5261.notice_detail.Text.4.3db24edfMqjjJO

2020-06-12

新增内容

合单/十日达项目接口改造文档 https://www.yuque.com/xv3ikh/gv34lb/satu6a

1）交易订单详情接口
aliexpress.trade.new.redefining.findorderbyid( 新版交易订单详情查询 )子订单列表内tags(target.child_order_list.tags )标签新增合单满升级（HBA_UP_EXPRESS）、十日达(leadTimeTag#10)标签。
2）根据交易订单id获取线上发货物流服务列表接口
aliexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid( 根据交易订单获取线上发货物流服务列表 )
出参增加可用物流服务列表available_logistic_service_list，用以注明该店铺主交易订单可用的所有物流线路中，哪些为合单活动可使用的物流线路。如果物流线路为非合单线路，则该属性值为空；如果物流线路为合单线路，则会在code和name中返回为合单线路。
3）声明发货接口
[aliexpress.logistics.sellershipmentfortop( 声明发货接口 )](aliexpress.logistics.sellershipmentfortop( 声明发货接口 ))
接口入参增加字段package_type,非必传项，可选值consolidation(合单包裹)。如果在声明发货环节希望将某个包裹标记为合单包裹，则需要在接口中回传consolidation；如果不需要做特别的标记，则保持此字段为空即可。目前暂不支持将包裹由合单包裹标记为非合单包裹。
4）修改声明发货接口
aliexpress.logistics.sellermodifiedshipmentfortop( 修改声明发货 )
接口入参新增package_type字段，非必传项，可选值consolidation(合单包裹)。如果在修改声明发货环节希望将某个包裹标记为合单包裹，则需要在接口中回传consolidation；如果不需要做特别的标记，则保持此字段为空即可。目前暂不支持将包裹由合单包裹标记为非合单包裹。

2020-05-12

营销接口下线通知
现这两个旧接口将于2020年05月30日下线，请及时迁移到新接口。

旧接口	新接口
aliexpress.marketing.redefining.querypromotionlistresultforproduct （查询一个商品参加的所有活动）	aliexpress.marketing.storepromotions.querybyproduct( 查询一个商品参加的有效的店铺活动 )
aliexpress.marketing.redefining.queryproductlistresultforpromotion （查询一个活动中的所有商品）	aliexpress.marketing.storepromotion.products.query( 查询一个单品折扣活动中的所有商品 )

2020-05-09

变更内容

aliexpress.postproduct.redefining.getremainingwindows( 获取卖家可用橱窗数 )
aliexpress.postproduct.redefining.getwindowproducts( 卖家橱窗使用详情查询 )
aliexpress.postproduct.redefining.setshopwindowproduct( 商品橱窗设置 )
三个接口将于2020年5月15日下线。现在橱窗管理服务升级，橱窗的发放，设置使用功能都发生了较大的变化（从原橱窗的设置不可更换商品，不可见效果，升级为可更换商品，数据效果可见），需要新开发一套完整的API接口（包括查询橱窗，查询橱窗商品，设置/更换橱窗商品，效果查看等），预计6月底完成。因此这三个接口不再使用，将于2020年5月15日下线。

影响
使用该接口的用户需移除相应的业务，避免接口下线后这些业务报错。

2020-04-13

变更内容

由于菜鸟结算逻辑变更，导致原接口aliexpress.logistics.querylogisticsorderdetail( 查询物流订单信息（推荐） )返回的logistics_fee值不准确。为了使商家获取到准确的运费，接口新增了一个运费列表字段来返回运费，含人民币费用或美金费用或两者皆有。
返回样例如下：

"logistics_fee_list": {
        "money": [
            {
                "amount": 3,
                "cent": 300,
                "currency_code": "USD"
            },
            {
                "amount": 58.59,
                "cent": 5859,
                "currency_code": "CNY"
            }
        ]
    }

2020-03-05

新增内容

尊敬的速卖通卖家&ISV朋友：
为提升参加商家针对AEplus订单发货效率，需要商家自研ERP以及服务市场的ISV，提前根据速卖通交易API
接口升级ERP。ERP升级后，且交易功能发布后，商家可通过ERP快速识别AEplus订单，方便发货。
为了不影响AEplus卖家考核结果，期望大家尽快启动升级。速卖通将在3月12号发布上线。届时大家可以进行联调、测试并使用。最终期望不晚于3月15号完成升级，否则卖家将无法识别出AEplus订单，从而影响卖家发货效率。
升级内容：
1）对接方案说明：
两个查询AE订单接口将对AEPlus订单新返回AEPlus标记
2）返回样例：
A，订单详情查询接口 aliexpress.trade.new.redefining.findorderbyid

<child_order_list>
  <aeop_tp_child_order_dto>
    <tags>
      <string>AE_PLUS_RU</string>
    </tags>
  </aeop_tp_child_order_dto>
</child_order_list>

B，订单列表查询接口 aliexpress.trade.seller.orderlist.get

<aeop_order_item_dto>
    <product_list>
      <aeop_order_product_dto>
        <tags>
          <string>AE_PLUS_RU</string>
        </tags>
      </aeop_order_product_dto>
    </product_list>
</aeop_order_item_dto>

2019-10-11

自2019年11月25日起，所有通过线上创建的物流订单，在创建物流订单时必须填写“退件地址信息”，请及时修改，避免在发货时因退件地址信息未填写导致无法创建线上物流订单。

aliexpress.logistics.createwarehouseorder( 创建线上物流订单 )的address_d_t_os->refund必须填写；必填字段：address_id，其他字段可以不填。

2019-07-31

新版交易订单详情查询（aliexpress.trade.new.redefining.findorderbyid）新增cancel_request_reason字段，为买家申请取消订单的原因，仅对取消中的订单有效（当卖家拒绝、同意取消或者买家撤回后，此字段不返回，因此仅可用于卖家同意或者拒绝买家的取消申请的场景），仅限于新订单（7.18-8.15期间创建的部分订单及8.15以后创建的所有订单）。

2019-07-23

新版交易订单详情查询（aliexpress.trade.new.redefining.findorderbyid）新增new_order_amount字段，它比order_amount更准确，考虑了卖家调价及COD费用。仅限于新订单（7.18-8.15期间创建的部分订单及8.15以后创建的所有订单）。这个字段跟网站上的订单金额、订单列表查询（aliexpress.trade.seller.orderlist.get）的pay_amount是一致的。

2019-07-16

7月18日之后创建的一些订单的消息将会所变更，请参考7月18日交易消息相关变动

2019-07-08

交易API变动新增内容，同时变动时间更改到7月12日，详情参考：交易API相关变动

2019-07-02

7月8日的交易API变动新增内容，详情参考：交易API相关变动

2019-06-26

变更内容

7月8日起交易、营销、商品API将会发生一些变动（其中商品的变动已经开始），一开始影响部分卖家，然后逐步扩大范围，直至7月18日对所有卖家生效。请根据以下文档查看对自己的影响并做相应修改

2019-05-30

变更内容

aliexpress.marketing.redefining.restocklimiteddiscountpromproduct (店铺限时限量活动商品补库存)将于2019年6月20日下线。现在店铺限时限量活动库存模式升级，取消原有活动库存模式，改为与全店铺打折活动一致的普通库存模式。设置限时限量活动后，库存同步于您在产品发布时设置的普通库存数，普通库存售罄后即展示原价，补充库存后可恢复活动价。因此这个接口不再有意义，将于2019年6月20日下线。

影响

使用该接口的用户需移除相应的业务，避免接口下线后这些业务报错。

2019-04-17

变更内容

aliexpress.offer.ds.product.simplequery( Dropshipper查询单个商品的简易信息 )增加商品SKU属性对象列表的返回字段

2019-04-16

交易旧接口下线通知

以下旧接口很早以前已经声明不再维护，替代的新接口也已经提供了很长时间。现这两个旧接口将于2019年06月01日下线，请及时迁移到新接口。

旧接口	新接口
aliexpress.trade.redefining.findorderlistquery( 交易订单列表查询）	aliexpress.trade.seller.orderlist.get( 订单列表查询 )
aliexpress.trade.redefining.findorderbyid( 订单详情查询）	aliexpress.trade.new.redefining.findorderbyid( 新版交易订单详情查询 )

2019-04-11

变更内容

查询订单详情的奇门接口
增加是否是货到付款的返回字段

2019-04-10

变更内容

查询订单详情的接口增加是否是货到付款的返回字段
增加查询卖家资料的接口用于查询当前卖家的国家和报价币种

2019-03-26

物流地址本地化二期上线，详情：https://developers.aliexpress.com/doc.htm?docId=109639&docType=1

2019-03-12

变更内容

奇门接口qimen.aliexpress.trade.findorderbyid增加字段：result -> child_order_list -> logistics_warehouse_type。具体背景及新字段含义请参考下面3月11日的变更

2019-03-11

变更内容

预计2019年3月15日，速卖通的海外仓业务将上线菜鸟认证海外仓。届时，速卖通的订单中会增加菜鸟认证海外仓发货的订单（订单标识会打标在子订单上），
这类订单（子订单）将由菜鸟系统下发海外仓系统，进行订单履行，商家ERP需进行过滤此类型的订单（子订单），否则可能产生重复发货，导致资损。

在aliexpress.trade.new.redefining.findorderbyid( 新版交易订单详情查询 )里，增加一个字段：target -> child_order_list -> logistics_warehouse_type。这个字段目前除了空之外，只有一个可选值。“cainiaoInternationalWarehouse”表示是菜鸟认证海外仓发货的，这类订单（子订单）将由菜鸟系统下发海外仓系统，进行订单履行，商家ERP需进行过滤此类型的订单（子订单）。其他情况为空。目前该字段没有值，待业务上线后，这个字段才可能有值。

影响

对于AliExpress开放平台的跟物流发货相关的应用，为避免新业务上线后，卖家重复发货导致资损， 请在3月15日前修改代码逻辑 ：如果获取到的订单详情的某个子订单里这个新字段的值为cainiaoInternationalWarehouse，则不需要进行订单履行；如果值为空，则跟以前一样处理。

2019-03-08

变更内容

商品的分国家报价配置（aeop_national_quote_configuration）格式变更。涉及以下API

旧格式

当configuration_type为

percentage：基于基准价格按比例配置，此时percentage是相对于基准价的调价比例（百分比整数，支持负数，当前限制>=-30 && <=100））
relative：相对原价涨或跌多少，此时percentage是基于基准价格按涨或者跌多少

时格式如下

[
    {"shiptoCountry":"US","percentage":"5"},
    {"shiptoCountry":"RU","percentage":"-2"}
]

当configuration_type为absolute（直接报价）时格式如下。其中absoluteQuoteMap（价格调整信息）的key的格式是“ : ”；如果有多个sku属性，则用“;”分隔；如果没有sku属性，则直接用空字符串示例为"“, ”14:173“, ”14:173;3:2034781"

[
    {"absoluteQuoteMap":{"14:193":84.99,"14:771":84.99},"shiptoCountry":"FR"},
    {"absoluteQuoteMap":{"14:193":89.99,"14:771":89.99},"shiptoCountry":"ES"}
]

新格式

新格式将不再使用percentage字段，统一用absoluteQuoteMap。旧格式使用percentage或者relative的时候只能对所有sku统一调价。新格式使用absoluteQuoteMap可以对任意一个或者多个sku调价。absoluteQuoteMap的值的含义根configuration_type的值有关。absoluteQuoteMap的key的格式不变

configuration_type	absoluteQuoteMap的值的含义
percentage	相对于基准价的调价比例（百分比整数，支持负数，当前限制>=-30 && <=100）
relative	相对基准价的调整值，支持负数
absolute	直接设置具体数值，不支持负数

例子

[
    {"absoluteQuoteMap":{"14:193":1.0},"shiptoCountry":"RU"},
    {"absoluteQuoteMap":{"14:193":2.0},"shiptoCountry":"US"}
]

影响

目前输入分国家报价的时候，新旧格式都可以用，但建议尽快切换到新格式上，一是以后旧格式会不支持，二是同步下来的部分商品数据里可能已经是新格式了
获取商品信息时，当前有可能返回新格式，也有可能返回旧格式。请做兼容处理。等以后统一返回新格式后，去除兼容处理。

2019-02-20

2月21日起，在调用aliexpress.logistics.createwarehouseorder( 创建线上物流订单 )时，系统会判断如果卖家是石油卖家（石油卖家是指有商品加入石油计划的）且未签署过石油计划协议的，将无法使用该接口并返回相应的报错。报错内容为：“由于您尚未签署石油计划的协议，暂时无法使用发货功能。请点此链接：https://sellercenter.aliexpress.com/protocol/protocolInfo.htm?protocolId=10000011001前往协议页面签署后，再尝试使用。”。点击链接前往签署后可正常使用该接口。

2019-02-13

变更内容

新增aliexpress.offer.draftproducts.get( 查询草稿箱里的商品列表 )和aliexpress.offer.draftproduct.get( 查询草稿箱里的产品信息 )。

注意：要发布草稿箱里的商品，请使用aliexpress.postproduct.redefining.postaeproduct( 发布产品信息 )，而不是编辑接口；另外输入参数product_id需要填草稿箱商品的product_id。

2019-01-02

变更内容

1月3日起，在调用aliexpress.logistics.createwarehouseorder( 创建线上物流订单 )时，系统会判断如果卖家是石油卖家（石油卖家是指有商品加入石油计划的）且未签署过石油计划协议的，将无法使用该接口并返回相应的报错。报错内容为：“由于您尚未签署石油计划的协议，暂时无法使用发货功能。请点此链接：https://sellercenter.aliexpress.com/seller/index.htm前往卖家后台首页签署后，再尝试使用，谢谢”。点击链接前往签署后可正常使用该接口。

2019-01-02

变更内容

aliexpress.trade.redefining.findorderreceiptinfo( 订单收货信息查询 )返回结果里添加了国家英文全称（country_name）。

2018-12-04

变更内容

qimen.aliexpress.trade.findorderbyid( 交易订单详情查询 )返回结果里添加了买家备注（result -> child_order_list -> buyer_memo），详情请参考2018-11-30变更内容

2018-11-30

变更内容

aliexpress.trade.new.redefining.findorderbyid( 新版交易订单详情查询 )返回结果里添加了订单备注（target -> child_order_list -> buyer_memo）

原先target -> memo表示买家备注，这个字段只适用于只有一个子订单的主订单，新增的buyer_memo字段是针对每个子订单的买家备注。如果一个主订单有多个子订单，target -> memo是null，只有target -> child_order_list -> buyer_memo才可能有值；如果一个主订单只有一个子订单，则有买家备注的情况下，target -> memo和target -> child_order_list -> buyer_memo是一致的。所以可以用target -> child_order_list -> buyer_memo获取买家备注，忽略target -> memo。

2018-11-30

纠纷接口下线通知

以下旧接口将于2018年12月30日下线，请及时迁移到新接口

旧接口	新接口
aliexpress.issue.redefining.queryissuelist( 查询纠纷列表信息(已停止维护))	aliexpress.issue.issuelist.get( 获取纠纷列表 )
aliexpress.issue.redefining.findissuedetailbyissueid( 根据纠纷ID，获取协商数据（已停止维护）)	aliexpress.issue.detail.get( 获取纠纷详情 )

2018-11-27

变更内容

aliexpress.offer.ds.product.simplequery( Dropshipper查询单个商品的简易信息 )

修复当商品无sku时，aeop_ae_product_s_k_us里的sku_bulk_order、offer_bulk_sale_price、offer_sale_price属性无值的问题
aeop_ae_product_s_k_us里的子元素里增加了s_k_u_available_stock表示可用的活动库存
增加了item_offer_site_sale_price和total_available_stock

aliexpress.postproduct.redefining.findaeproductbyidfordropshipper( Dropshipper查找商品信息接口 )

修复当商品无sku时，aeop_ae_product_s_k_us里的sku_bulk_order、offer_bulk_sale_price、offer_sale_price、s_k_u_available_stock无值的问题
修复aeop_ae_product_s_k_us.aeop_s_k_u_propertys里的sku_property_name和sku_property_value为空的问题
返回结果增加如下字段：
– 店铺信息（store_info），包括店铺名称（store_name）、ID（store_id）、店铺DSR三项数值（communication_rating、item_as_descriped_rating、shipping_speed_rating）
– 商品信息，包括订单数（order_count ）、商品评价数（evaluation_count）、商品评价星级（avg_evaluation_rating）

2018-09-12

变更内容

新增API

卖家拒绝取消订单aliexpress.trade.seller.order.refusecancel。
卖家同意取消订单aliexpress.trade.seller.order.acceptcancel。

2018-08-14

营销接口下线通知

使用以下营销API会导致大促活动占用活动资源（时长和次数），导致日常活动没有活动资源：

请尽快迁移到新的接口，新的接口里大促活动不占用活动资源（时长和次数）.

以下接口都将在2018年9月15日下线，请及时迁移到新接口。

旧接口	新接口
aliexpress.marketing.redefining.createlimitdiscountpromotion( 创建店铺限时限量活动(已停止维护) )	aliexpress.marketing.limitdiscountpromotion.create( 创建店铺限时限量活动 )
aliexpress.marketing.redefining.updatelimiteddiscountpromotion( 店铺限时限量活动更新 )	aliexpress.marketing.limitdiscountpromotion.edit( 修改店铺限时限量活动 ) 及 aliexpress.marketing.limitdiscountpromotionproduct.edit( 修改店铺限时限量活动商品 )
aliexpress.marketing.redefining.adjustlimiteddiscountpromendtimebeta( 店铺限时限量活动预计结束时间调整 )	aliexpress.marketing.limitdiscountpromotion.edit( 修改店铺限时限量活动 )
aliexpress.marketing.redefining.joinlimiteddiscountpromotion( 店铺限时限量活动报名，已停止维护 )	aliexpress.marketing.limiteddiscountpromotion.addpromotionproduct( 限时限量活动商品添加 )
aliexpress.marketing.redefining.batchlimiteddiscountpromstockmanagementbeta( 批量店铺库存管理 )	aliexpress.marketing.limitdiscountpromotionproduct.edit( 修改店铺限时限量活动商品 )
aliexpress.marketing.redefining.resetplatformpromotionstock( 重置平台活动库存 )	aliexpress.marketing.limitdiscountpromotionproduct.edit( 修改店铺限时限量活动商品 )
aliexpress.marketing.redefining.exitlimiteddiscountpromotion( 店铺限时限量活动商品退出活动 )	aliexpress.marketing.limitdiscountpromotionproduct.del( 店铺限时限量活动删除商品 )

2018-08-06

石油计划中新增AliExrepss Direct无忧集运线路。
声明发货场景
卖家可以使用aliexpress.logistics.redefining.listlogisticsservice API获取平台所有可用于声明发货的线路信息。
此次新增 CAINIAO_CONSOLIDATION_AE(无忧集运-阿联酋)，CAINIAO_CONSLIDATION_SA(无忧集运-沙特)，卖家可以对石油交易订单做声明发货。
线上发货场景
卖家可以使用aliexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid 获取指定交易订单可用的线上发货物流线路信息。
注意：只有在交易订单中包含石油商品时此接口才会返回无忧集运线路。
卖家创建线上发货物流订单中指定的线路名称必须是aliexpress.logistics.redefining.getonlinelogisticsservicelistbyorderid API中返回的线路信息。

2018-07-25

请阅读开放平台公网IP信息变更通知。如果你都是使用域名的话则没有影响；如果你直接使用VIP，或者绑定VIP，或者本地用来做ACL限制，则请按文档里的说明处理。

2018-06-06

变更内容

新增API

订单列表查询aliexpress.trade.seller.orderlist.get。
1.增加了 buyerLoginId作为入参，出参中的money类做了下删减。
2.订单列表的奇门官方场景入参已同步修改，出参中的money类需要开发适配下。
3.接口透出所有时间相关字段改为美国时间，格式为 2018-01-01 12:12
4.修复接口透出所有金额相关字段amount为0问题。
5.原有订单列表查询接口停止维护。

优化API

新版交易订单详情查询接口新增以下4个出参：
product_img_url 商品主图Url
product_snap_url 快照Url
goods_prepare_time 备货时间
logistics_service_name 物流服务

bug修复

修复限时限量活动商品添加接口入参中 terminal为 MOBILE or ALL aliexpress.marketing.limiteddiscountpromotion.addpromotionproduct

2018-05-17

变更内容

新增站内信faq API

站内信faq新建欢迎词 aliexpress.message.faqwelcome.add。
站内信faq获取欢迎词aliexpress.message.faqwelcome.get。
站内信faq删除欢迎词aliexpress.message.faqwelcome.del。
站内信faq修改欢迎词aliexpress.message.faqwelcome.edit。
站内信faq获取问题列表aliexpress.message.faq.list。
站内信faq删除一个问题 aliexpress.message.faq.del。
站内信faq修改一个问题 aliexpress.message.faq.edit。
站内信faq创建一个问题 aliexpress.message.faq.add。
站内信faq 获取一个问题 aliexpress.message.faq.get。

2018-05-11

变更内容

修改API

商品列表查询接口 aliexpress.postproduct.redefining.findproductinfolistquery 新增商品创建时间，最后修改时间入参。

2018-04-27

变更内容

新增营销API

查询店铺活动列表 aliexpress.marketing.promotion.list。
创建店铺限时限量活动aliexpress.marketing.limitdiscountpromotion.create。
修改店铺限时限量活动aliexpress.marketing.limitdiscountpromotion.edit。
限时限量活动商品添加aliexpress.marketing.limiteddiscountpromotion.addpromotionproduct。
店铺限时限量活动删除商品aliexpress.marketing.limitdiscountpromotionproduct.del。
修改店铺限时限量活动商品 aliexpress.marketing.limitdiscountpromotionproduct.edit。

修改API

新版订单详情aliexpress.trade.new.redefining.findorderbyid。
增加当前状态超时日期；
增加子订单维度的退款信息和放款信息；
对应的订单详情奇门API官方场景也做了修改；

站内信新消息推送API：aliexpress_message_Pushnewmsg 。
归属子帐号的消息同步推送给主帐号。
卖家发送的消息也推送。

影响

营销老接口
aliexpress.marketing.redefining.createlimitdiscountpromotion( 创建店铺限时限量活动 )
aliexpress.marketing.redefining.adjustlimiteddiscountpromendtimebeta( 店铺限时限量活动预计结束时间调整 )
aliexpress.marketing.redefining.joinlimiteddiscountpromotion( 店铺限时限量活动报名 )
aliexpress.marketing.redefining.exitlimiteddiscountpromotion( 店铺限时限量活动商品退出活动 )
aliexpress.marketing.redefining.updatelimiteddiscountpromotion( 店铺限时限量活动更新 )
已停止维护，将逐步下线

2018-04-25

变更内容

修改API

纠纷API有以下修改：
通过纠纷id查询纠纷详情aliexpress.issue.detail.get。
增加纠纷过程记录（过程记录会对应图片附件信息（如有），如有视频会提示有无视频）
卖家新增(拒绝某个买家方案)or修改方案aliexpress.issue.solution.save。
收到货纠纷，增加seller方案时，可以选择类型（退货or退货退款），若退货须提供退货地址id。售后宝纠纷，小二修改为普通的，允许操作。

2018-04-23

变更内容

新增API

类目新增以下API：
aliexpress.category.redefining.getallchildattributesresult（根据发布类目id、父属性路径（可选）获取子属性信息，返回全部品牌信息）

bug修复

修复新订单详情接口aliexpress.trade.new.redefining.findorderbyid 订单结束原因为空的问题。

2018-04-16

变更内容

新增API

获取纠纷列表aliexpress.issue.issuelist.get。
通过纠纷id查询纠纷详情aliexpress.issue.detail.get。
卖家新增(拒绝某个买家方案)or修改方案aliexpress.issue.solution.save。
卖家同意普通纠纷方案aliexpress.issue.solution.agree。
卖家上传纠纷证据图片aliexpress.issue.image.upload。

影响

纠纷老接口
aliexpress.issue.redefining.findissuedetailbyissueid
aliexpress.issue.redefining.queryissuelist
已停止维护，将逐步下线

2018-04-02

变更内容

新增API

回复已生效的订单评价aliexpress.evaluation.evaluation.reply。
查询已生效的评价信息aliexpress.evaluation.listorderevaluation.get。

站内信新消息推送aliexpress_message_Pushnewmsg
订阅该消息即可收到发送给卖家的新消息。

bug修复

根据发布类目id、父属性路径aliexpress.category.redefining.getchildattributesresultbypostcateidandpath接口中返回参数里增加valuetags。
修复该接口品牌类目权限不一致问题。

2018-03-28

变更内容

奇门官方场景qimen.aliexpress.logistics.createwarehouseorder( 创建线上物流订单 )里入参address_d_t_os.receiver.address_id从必填改成选填。

2018-03-27

变更内容

发送站内信接口aliexpress.message.redefining.versiontwo.addmsg 的参数 channel_id 已废弃。

影响

可以不用调用aliexpress.message.redefining.versiontwo.querymsgchannelidbybuyerid 去获取channelId。

2018-03-22

变更内容

修复qimen.aliexpress.logistics.getnextleveladdressdata( 读取下一级别的地址信息 )无法通过验签的问题，增加了error_code字段，请按新的验签错误格式返回验签错误。

2018-03-19

变更内容

修复aliexpress.postproduct.redefining.getproductgrouplist( 获取当前会员的产品分组 )的SDK无法使用的错误，创建了新APIaliexpress.product.productgroups.get来替代它。

影响

推荐使用新API：aliexpress.product.productgroups.get替换旧API：aliexpress.postproduct.redefining.getproductgrouplist( 获取当前会员的产品分组 )。旧API自己解析返回结果的仍然可以使用，但后续会下线掉，建议有空的时候迁移到新API。

2018-03-14

变更内容

修改了以下接口的列表型入参的大小限制
- 编辑产品类目、属性、SKU（aliexpress.postproduct.redefining.editproductcidattidsku），product_skus、product_skus.aeop_s_k_u_property、product_properties三个参数的大小限制从20提高到999
- 批量获取线上发货标签（aliexpress.logistics.redefining.getprintinfos），warehouse_order_query_d_t_os参数的大小限制从20提高到200

2018-03-12

变更内容

修改了奇门官方接口：qimen.aliexpress.trade.findorderbyid。支持新版订单详情接口aliexpress.trade.new.redefining.findorderbyid新增加的出参。

2018-03-08

变更内容

API－订单详情接口 aliexpress.trade.new.redefining.findorderbyid
新版订单详情接口发布：和原有接口出参相比数据基本兼容。增加了以下出参数据：
1.纠纷信息（原有接口是空的）：同时增加纠纷创建时间
2.订单的实际付款金额payAmountBySettlementCur，结算币种 settlementCurrency
3.订单中商品的图片快照地址
4.sendGoodsOperator（发货类型）
5.增加退款金额、成功退款时间
6.接口透出所有时间相关字段改为美国时间，格式为 2018-01-01 12:12
7.修复接口透出所有金额相关字段amount为0问题。
https://developers.aliexpress.com/doc.htm?spm=0.0.0.0.WvheOH#?docType=2&docId=34813
老接口aliexpress.trade.redefining.findorderbyid不再维护，3个月后将下线。

2018-03-07

变更内容

API - 通过模板ID获取单个运费模板内容 aliexpress.freight.redefining.getfreightsettingbytemplatequery
- 修复响应参数freight_setting_list类型错误，从AeopFreightSelfdefine[]变更为AeopFreightSetting[]，相应的响应结果里freight_setting_list的子元素从aeop_freight_selfdefine变更为aeop_freight_setting

影响

使用SDK调用API - 通过模板ID获取单个运费模板内容的用户，原先无法正常使用，现在可以正常使用
直接使用API - 通过模板ID获取单个运费模板内容获取返回XML/JSON数据自己解析的用户，原先可以正常使用，现在无法正常使用，需要更改解析代码（freight_setting_list的子元素从aeop_freight_selfdefine变更为aeop_freight_setting）

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

淘宝开放平台

API文档

API变更历史及一些重要通知

2022-01-11

新增内容

2022-01-10

新增内容

2021-08-16

新增内容

2021-08-05

新增内容

2021-07-15

新增内容

2021-06-26

新增内容

2021-06-11

新增内容

2021-04-08

新增内容

2020-08-13

新增内容

2020-08-03

新增内容

2020-06-12

新增内容

合单/十日达项目接口改造文档 https://www.yuque.com/xv3ikh/gv34lb/satu6a

2020-05-12

2020-05-09

变更内容

2020-04-13

变更内容

2020-03-05

新增内容

2019-10-11

2019-07-31

2019-07-23

2019-07-16

2019-07-08

2019-07-02

2019-06-26

变更内容

2019-05-30

变更内容

影响

2019-04-17

变更内容

2019-04-16

2019-04-11

变更内容

2019-04-10

变更内容

2019-03-26

2019-03-12

变更内容

2019-03-11

变更内容

影响

2019-03-08

变更内容

旧格式

新格式

影响

2019-02-20

2019-02-13

变更内容

2019-01-02

变更内容

2019-01-02

变更内容

2018-12-04

变更内容

2018-11-30

变更内容

2018-11-30

2018-11-27

变更内容

2018-09-12

变更内容

新增API

2018-08-14