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个包裹）

新旧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

准备材料(keyset/token/Seller id) API整合步骤 学习API文档 准备材料(keyset/token/Seller id) 下载WSDL 登陆用户注册页面，注册并接受用户条款 使用SoapUI测试API 在Sandbox环境中开发 开发完成发布到生产环境

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=GettingTokens-Getting_Tokens_for_Applications_with_Multiple_Users.html

API注册说明 1 3 2 访问ASP平台，使用您的eBay账号注册 http://apacshipping.ebay.com.hk/aspweb/login 根据您的实际使用情况，配置您的订单来源和标记订单发货 3 2 点击阅读每项使用条款，并勾选同意条款并点击”我同意”按钮 PRESENTATION TITLE GOES HERE

4 添加中国邮政物流服务商 a. 点击右上角“管理物流服务商”按钮，随后点击添加’新的物流服务商’； 选择地区‘China’，物流商’CNPOST’ b. 根据您的实际使用情况，填写您的揽收和发货地址 PRESENTATION TITLE GOES HERE

5 添加卖家ID 进入APAC Shipping Platform账户管理页面，您可以添加您的其他eBay卖家ID。 PRESENTATION TITLE GOES HERE

我们设计了如下角色以方便管理您的物流平台。 账号类型 角色 功能描述 主管理员账号 Admin 该账户是您第一次用于注册ASP时使用的eBay卖家ID。 注册完成后，该账号作为主管理员账号，可以创建或修改其他管理员和操作员权限/密码，也可以添加eBay卖家ID。 可以管理所有ASP用户习惯设定，和订单发货操作等。 删除主管理员账号将会导致ASP账户关闭。 eBay卖家ID eBay ID eBay 卖家ID只有通过ASP管理员才能被添加到系统中用于同步eBay订单。 eBay ID绑定到一个ASP账号后，该ID将无法用于注册其他ASP账号，也无法被其他ASP账号绑定。 无法用于登陆ASP平台或管理订单发货等。 管理员 管理员权限可以创建或修改其他用户权限/密码，可以添加eBay卖家ID。 操作员 Basic 操作员权限可以用于管理订单发货操作等。但无法修改部分的用户习惯设定。无法从ASP添加或删除eBay ID。 客户ID Customer reference ID 该ID作为和eBay卖家ID对应的唯一客户号仅用于和物流服务商对账使用。 PRESENTATION TITLE GOES HERE

Seller’s eBay API token 获取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 Seller’s eBay API token APIDevUserId Authentication APISellerUserToken AppCert AppID APISellerUserId MessageId 4.0.0 Version Carrier CNPOST, TNT, or FEDEX eBay ASP Seller API

开发注意事项（详情参照开发文档） 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

FAQ 问：如何防止重复发货？ 答：请在自己的系统中记录每笔交易使用哪一个平台处理过，防止重复处理。 尽量避免同时在新老平台上操作相同账号订单。 问：是否需要数据备份？ 答：需要备份， 请在自己的系统中详细记录自己交易的处理状态并及时备份，以便处理因为系统原因导致订单信息不一致或丢失等情况。 问：发现系统问题如何处理？ 答：请及时联系eBay相关人员，您可以发邮件到 DL-eBay-APAC-Feedback@ebay.com 或联系您的客户经理。为了让技术人员尽快找到问题，请尽量提供request/response xml，或者至少是response中的Timestamp, InvocationID和错误信息。 问：我是否应该将全部账号一起迁移到新平台？ 答：目前的阶段，建议您先从小账号起开始，当您对新的API完全熟悉之后，再逐步迁移所有账号。 问：迁移到新平台后，老平台上的未处理和已处理订单该怎么办？ 答：建议将该账号老平台上的未处理订单全部处理完成后再迁移至新平台，个案可以到E邮宝网站手工处理。已处理订单可以继续通过老平台查询追踪信息。 PRESENTATION TITLE GOES HERE

FAQ 问：一旦我的账号迁移到了新平台，我是否可以迁移回老平台？ 答：可以，但反复迁移可能造成重复发货等问题因此在新平台稳定的情况下不推荐迁移回老平台。 问：如果我的账号由于使用新的API产生问题(BBE, 买家投诉)，该如何处理？ 答：如果由于使用新API问题产生的账号问题，可以通过现有的申诉渠道进行申诉。请详细描述问题原因并提供相应的订单信息，包括Track code, ItemID, TransactionID或买家ID。eBay相应部门会审核并帮助卖家解决账号问题。 问：使用新的API之后，我的包裹投递时效会不会受到影响？ 答：新API不会影响包裹投递时效。 问：我该如何区分新老平台的订单？ 答：从追踪号无法区分新老平台订单，请及时对新平台订单进行加注（如：新平台发货，状态：已打印）以区分新老平台订单。 问：我是否需要重新对第三方工具进行授权？ 答：您需要同意新平台的卖家使用条款，并对第三方工具进行重新授权。 PRESENTATION TITLE GOES HERE

寻求帮助 新平台的技术支持邮箱：DL-eBay-APAC-Feedback@ebay.com 有用的链接： 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_XML_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