eBay亚太物流平台API.pptx

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