eBay亚太物流平台API介绍
Download
Report
Transcript eBay亚太物流平台API介绍
eBay物流平台API培训
版本 4.0.0
培训内容
•API概述
•API功能介绍
•API整合步骤
•注意事项
•FAQ
•寻求帮助
API概述
•集成中国邮政，TNT，FedEx物流服务商
•申请跟踪号，标签批量打印，线上发货，
状态查询
•完善的授权机制。稳定，高速，可拓展的
平台
API功能介绍
API 名称
功能说明
AddAPACShippingPackage
上传一个包裹信息至物流平台，同时从物流供应商
申请一个包裹跟踪号。
CancelAPACShippingPackage
取消并删除“交运”前的包裹信息。
ConfirmAPACShippingPackage
对已上传包裹进行“交运”操作，包裹信息将被上
传到相应物流供应商。
GetAPACShippingLabel
获取已上传包裹打印标签流。
GetAPACShippingPackage
获取已上传包裹详细信息。
GetAPACShippingPackageStatus
获取已上传包裹当前状态信息。
GetAPACShippingRate
根据包裹重量、运输服务等获取包裹运费信息。
VerifyAPACShippingUser
验证API授权是否成功。
RecreateAPACShippingPackage
对已上传的包裹进行“重新发送”操作。
GetAPACShippingTrackCode
根据ItemID及TransactionID取回一个物品的包裹跟
踪号
GetAPACShippingLabels
根据包裹跟踪号，批量获取打印标签流（最多80个
包裹）
4
新旧API区别说明
•授权方式改成了eBay标准Token，用户能够和使用其他eBay API一样的方式
使用eBay物流平台API。(详见API说明文档)
•新版API(V4.0.0)在请求中引入字段Carrier，支持中国邮政，TNT，FedEx
物流供应商。
•新的授权方式和引入新的字段会带来新的错误信息种类，用户须做好处理。
(详见API说明文档)
•新的Sandbox连接方式，eBay物流平台直接与eBay测试环境对接，用户可以
使用eBay测试环境Token作为Sandbox的使用凭证。
PRESENTATION TITLE GOES HERE
5
API整合步骤
学习API文档
准备材料(keyset/token/Seller id)
下载WSDL
登陆用户注册页面，注册并接受用户条款
使用SoapUI测试API
在Sandbox环境中开发
开发完成发布到生产环境
6
eBay API授权流程
• 第一步：加入eBay开发者行列
– https://developer.ebay.com/devzone/account
• 第二步：得到Sandbox和Production环境的Keyset
– Application Key是eBay用于识别开发者或是应用程序的唯一标识。你可以随时在My Account页面
中生成或是检索到你的Key。
• 第三步：获取eBay token的方式
– 如果您是卖家：
使用eBay Token生成工具获取您的Token
https://developer.ebay.com/DevZone/account/tokens
– 如果您是第三方工具开发者：
使用auth & auth 流程获取用户token
http://developer.ebay.com/DevZone/XML/docs/WebHelp/wwhelp/wwhimpl/common/html/wwhelp.htm
?context=eBay_XML_API&file=GettingTokensGetting_Tokens_for_Applications_with_Multiple_Users.html
7
API注册说明
1
2
访问ASP平台，使用您的eBay账号注册
http://apacshipping.ebay.com.hk/aspweb/login
3
根据您的实际使用情况，配置您的订单来
源和标记订单发货
点击阅读每项使用条款，并勾选同意条款
并点击”我同意”按钮
PRESENTATION TITLE GOES HERE
8
4
添加中国邮政物流服务商
a. 点击右上角“管理物流服务
商”按钮，随后点击添加’新的
物流服务商’；
选择地区‘China’，物流
商’CNPOST’
b. 根据您的实际使用情况，填写您的揽
收和发货地址
PRESENTATION TITLE GOES HERE
9
5 添加卖家ID
进入APAC Shipping Platform账户管理页面，您可以添加您的其他eBay卖家ID。
PRESENTATION TITLE GOES HERE
10
我们设计了如下角色以方便管理您的物流平台。
账号类型
角色
主管理员账号 Admin
功能描述
该账户是您第一次用于注册ASP时使用的eBay卖家ID。
注册完成后，该账号作为主管理员账号，可以创建或修改
其他管理员和操作员权限/密码，也可以添加eBay卖家ID。
可以管理所有ASP用户习惯设定，和订单发货操作等。
删除主管理员账号将会导致ASP账户关闭。
eBay 卖家ID只有通过ASP管理员才能被添加到系统中用
于同步eBay订单。
eBay ID绑定到一个ASP账号后，该ID将无法用于注册其
他ASP账号，也无法被其他ASP账号绑定。
无法用于登陆ASP平台或管理订单发货等。
管理员权限可以创建或修改其他用户权限/密码，可以添加
eBay卖家ID。
可以管理所有ASP用户习惯设定，和订单发货操作等。
eBay卖家ID
eBay ID
管理员
Admin
操作员
Basic
操作员权限可以用于管理订单发货操作等。但无法修改部
分的用户习惯设定。无法从ASP添加或删除eBay ID。
客户ID
Customer
reference
ID
该ID作为和eBay卖家ID对应的唯一客户号仅用于和物流服
务商对账使用。
PRESENTATION TITLE GOES HERE
11
API整合说明
• 获取API WSDL文件:
沙盒：https://api.apacshipping.sandbox.ebay.com.hk/aspapi/v4/ApacShippingService?WSDL
产品线：https://api.apacshipping.ebay.com.hk/aspapi/v4/ApacShippingService?WSDL
• 支持的格式: XML, SOAP
Sellers
Applications
APIDevUserId
A
u
t
h
e
n
t
i
c
a
t
i
o
n
eBay ASP
Seller API
APISellerUserToken
Seller’s eBay API
token
AppCert
AppID
APISellerUserId
MessageId
Version
4.0.0
Carrier
CNPOST, TNT,
or FEDEX
开发注意事项（详情参照开发文档）
TNT/FedEx仅支持英文，请确保所有物品描述，标题等信息为英文。(5.1.2.1)
新增长宽高字段，CNP为选填，TNT/FedEx为必填。（5.1.2.1）
揽收地址信息，CNP需填入对应省份城市代码，TNT/FedEx需填入省份城市拼音。
（请参考揽收地址)
Country字段验证机制改变，PA验证国家名拼音，ASP将验证国家代码。（6.2）
新增Service字段，用于选择所需的物流服务种类，如标准或者经济型。目前CNP
请填EPCAK， TNT请填EXPR_15N，FedEx请填INT_EC。（5.1.2.1）
新增PickUpRequestDateTime字段，通知物流商上门揽收时间，该值仅对
TNT/FedEx有效。(5.1.4.1)
新增CarrierConfirmId字段，该值由TNT/FedEx返回，是揽收申请的唯一标识号，
如遇到TNT/FedEx无人揽收情况，请致电物流商客服，并提供此字段。（5.1.4.2）
PRESENTATION TITLE GOES HERE
13
FAQ
• 问：如何防止重复发货？
答：请在自己的系统中记录每笔交易使用哪一个平台处理过，防止重复处理。
尽量避免同时在新老平台上操作相同账号订单。
• 问：是否需要数据备份？
答：需要备份， 请在自己的系统中详细记录自己交易的处理状态并及时备份，以便处理因为系统原因导致
订单信息不一致或丢失等情况。
• 问：发现系统问题如何处理？
答：请及时联系eBay相关人员，您可以发邮件到 [email protected] 或联系您的客户经
理。为了让技术人员尽快找到问题，请尽量提供request/response xml，或者至少是response中的
Timestamp, InvocationID和错误信息。
• 问：我是否应该将全部账号一起迁移到新平台？
答：目前的阶段，建议您先从小账号起开始，当您对新的API完全熟悉之后，再逐步迁移所有账号。
• 问：迁移到新平台后，老平台上的未处理和已处理订单该怎么办？
答：建议将该账号老平台上的未处理订单全部处理完成后再迁移至新平台，个案可以到E邮宝网站手工处理。
已处理订单可以继续通过老平台查询追踪信息。
PRESENTATION TITLE GOES HERE
14
FAQ
• 问：一旦我的账号迁移到了新平台，我是否可以迁移回老平台？
答：可以，但反复迁移可能造成重复发货等问题因此在新平台稳定的情况下不推荐迁移回老平台。
• 问：如果我的账号由于使用新的API产生问题(BBE, 买家投诉)，该如何处理？
答：如果由于使用新API问题产生的账号问题，可以通过现有的申诉渠道进行申诉。请详细描述问题原因并
提供相应的订单信息，包括Track code, ItemID, TransactionID或买家ID。eBay相应部门会审核并帮助
卖家解决账号问题。
• 问：使用新的API之后，我的包裹投递时效会不会受到影响？
答：新API不会影响包裹投递时效。
• 问：我该如何区分新老平台的订单？
答：从追踪号无法区分新老平台订单，请及时对新平台订单进行加注（如：新平台发货，状态：已打印）
以区分新老平台订单。
• 问：我是否需要重新对第三方工具进行授权？
答：您需要同意新平台的卖家使用条款，并对第三方工具进行重新授权。
PRESENTATION TITLE GOES HERE
15
寻求帮助
• 新平台的技术支持邮箱：[email protected]
• 有用的链接：
– eBay API快速入门
http://www.ebay.cn/developer/quickstart/
– eBay Sandbox环境
http://www.sandbox.ebay.com
– eBay token生成工具
https://developer.ebay.com/DevZone/account/tokens
– eBay auth & auth 流程说明
http://developer.ebay.com/DevZone/XML/docs/WebHelp/wwhelp/wwhimpl/common/html/wwhelp.htm?context=eBay_XM
L_API&file=GettingTokens-Getting_Tokens_for_Applications_with_Multiple_Users.html
– eBay物流平台API卖家使用条款
http://api.apacshipping.ebay.com.hk/aspapi/apacshippingtooltermsandconditions
– eBay物流平台API测试地址
https://api.apacshipping.sandbox.ebay.com.hk/aspapi/v4/ApacShippingService
– eBay物流平台API正式地址
https://api.apacshipping.ebay.com.hk/aspapi/v4/ApacShippingService
PRESENTATION TITLE GOES HERE
16