“API常见问题”的版本间的差异

2013年10月29日 (二) 17:33的版本

1. Order、Package、product区别
   • Order是一个订单，订单里面可以包含多个Package（包裹）
   • 每一个包裹里面可以有多个product（产品）
   • 建议每天只创建一个订单，创建多个订单可能影响发货速度
2. 自主开发何时申请正式的api token与userkey
   • 当客户开发完成以后，完整的下一个订单，如果公司IT检测订单信息正确（既是一个订单包含多个包裹，一个包裹包含多个信息）即可申请token和userkey，申请格式见API账号申请
3. 对于已提审的订单，如果部分包裹未能交到出口易，即当出口易收到这个订单时，未交货的这部分包裹将变为“待发货”状态
4. 美国仓有两个：仓库代码为US，NJ
5. 跟踪号出现时间
   • 不同的服务跟踪号（track_no）出现的时间是不相同的有的是收到货便有跟踪号，有些则是一下订单就有跟踪号
6. ExpressAddOrderNew与ExpressAddOrder的区别
   • ExpressAddOrderNew是新接口ExpressAddOrder是旧接口
   • ExpressAddOrder不支持新的服务，ExpressAddOrderNew支持全部服务（包括新服务）
   • 建议客户将ExpressAddOrder改为ExpressAddOrderNew以防止出现不必要的麻烦
7. V2与V3是两种不同的接口，而不是不同的版本
8. 处理地区
   • 处理地区的值就是拼音的缩写，eg.GZ（广州）
9. 订单删除
   • 订单只有初始的情况下才可以删除，删除是彻底删除，既是删除后是再也找不到那张订单的
   • 提审过后的订单是不能删除的
10. 一般来说api服务文档里有的服务就是现在所有的服务
11. Api的正式环境为api.chukou1.com
12. OutStoreAddOrderNew中的地址
    • Country只能用全称，不能使用缩写
13. 如果客户是使用第三方系统的，如果出现错误请先联系第三方，如果第三方不能解决，请让第三方的IT与我公司IT沟通
14. 提交订单时包裹中的重量可以不准确，但不要超过要使用服务的最大重量
15. 直发业务流程：两种
    • expressAddPackageNew
      1. 通过expressAddPackageNew添加包裹，每次我们会返回一个订单号，同一种服务我们会同一个订单号（自动的）
      2. 通过ExpressCompleteOrderNew提审订单（告诉我们您们要发货了），用刚才返回的订单号
      3. 用V3文档中的print-label取得打印标签打印
    • ExpressCompleteOrderNew
      1. 通过expressAddOrderNew添加订单，里面包含多个包裹，Submit参数设为True代表提审，我们会返回各个包裹的处理号
      2. 用V3文档中的print-label取得打印标签打印
      3. 每个order面向一种派送方式
      4. 每个package面向一个派送地址
      5. 每个product面向一个sku
16. 标签打印
    • 一般情况下，客户只需要打印我公司的标签就可以了
    • 标签提供一个custom字段存储客户自己的信息
    • 如果标签不符合客户的需求，可以跟我公司IT商量更改标签
17. 查询专线、海外仓的服务代码
    • 查询专线服务代码：http://demo.chukou1.cn/v3/direct-express/misc/list-all-service
    • 查询海外仓服务：http://api.chukou1.com/v3/outbound/misc/list-all-service
18. List-Share-stock 与 List-myshare-stock
    • List-Share-stock是可以看到所用共享的，是卖家使用的接口
    • List-myshare-stock是只可以看见自己共享出去的产品，此接口只提供给共享者使用（工厂或其他的共享者）