API常见问题

来自出口易_wiki
黄丽燕讨论 | 贡献2014年1月2日 (四) 10:23的版本
跳转至: 导航搜索

1、自主开发何时申请正式的api token与userkey?

  • 当客户开发完成以后,完整的下一个订单,如果我司IT检测订单信息正确(既是一个订单包含多个包裹,一个包裹包含多个信息)即可申请token和userkey,申请格式见API账号申请

2、如果客户是使用第三方系统(如:ECPP、通途、ISFES、马帮、杭州普源(网店精灵)的,如果出现错误请先联系第三方,如果第三方不能解决,请让第三方的IT与我公司IT沟通。

3、测试环境查询专线、海外仓的服务代码

4、直发业务流程:两种

  • expressAddPackageNew
    • 通过expressAddPackageNew添加包裹,每次我们会返回一个订单号,同一种服务我们会同一个订单号(自动的)
    • 通过ExpressCompleteOrderNew提审订单(告诉我们您们要发货了),用刚才返回的订单号
    • 用V3文档中的print-label取得打印标签打印
  • ExpressCompleteOrderNew
    • 通过expressAddOrderNew添加订单,里面包含多个包裹,Submit参数设为True代表提审,我们会返回各个包裹的处理号
    • 用V3文档中的print-label取得打印标签打印
    • 每个order面向一种派送方式
    • 每个package面向一个派送地址
    • 每个product面向一个sku

5、Order、Package、product区别

  • Order是一个订单,订单里面可以包含多个Package(包裹)
  • 每一个包裹里面可以有多个product(产品)
  • 建议每天只创建一个订单,创建多个订单可能影响发货速度

6、ExpressAddOrderNew与ExpressAddOrder的区别

  • ExpressAddOrderNew是新接口ExpressAddOrder是旧接口
  • ExpressAddOrder不支持新的服务,ExpressAddOrderNew支持全部服务(包括新服务)
  • 建议客户将ExpressAddOrder改为ExpressAddOrderNew以防止出现不必要的麻烦

7、List-Share-stock 与 List-myshare-stock

  • List-Share-stock是可以看到所用共享的,是卖家使用的接口
  • List-myshare-stock是只可以看见自己共享出去的产品,此接口只提供给共享者使用(工厂或其他的共享者)。

8、OutStoreAddOrderNew中的地址

  • Country只能用全称,不能使用缩写。

9、香港DHL的服务代码是HKD还是DHL?

  • 香港DHL的服务代码是DHL。但由于历史原因,在V2的API中,使用了HKD作为ExpressType枚举类型名称。除了在V2版的API中需要使用ExpressType.HKD作为参数,其他接口都是以DHL作为服务代码。

10、跟踪号出现时间

  • 不同的服务跟踪号(track_no)出现的时间是不相同的有的是收到货便有跟踪号,有些则是一下订单就有跟踪号。

11、标签打印

  • 一般情况下,客户只需要打印我公司的标签就可以了
  • 标签提供一个custom字段存储客户自己的信息

12、订单删除

  • 订单只有初始的情况下才可以删除,删除是彻底删除,既是删除后是再也找不到那张订单的
  • 提审过后的订单是不能删除的

13、处理地区

  • 处理地区的值就是拼音的缩写,eg.GZ(广州)

14、对于已提审的订单,如果部分包裹未能交到出口易,即当出口易收到这个订单时,未交货的这部分包裹将变为“待发货”状态

15、提交订单时包裹中的重量可以不准确,但不要超过要使用服务的最大重量

16、V2与V3是两种不同的接口,而不是不同的版本

17、美国仓有两个:仓库代码为US,NJ