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

来自出口易_wiki
跳转至: 导航搜索
 
(未显示2个用户的9个中间版本)
第1行: 第1行:
1、自主开发何时申请正式的api token与userkey?
+
# 自主开发何时申请正式的api token与userkey?
*当客户开发完成以后,完整的下一个订单,如果我司IT检测订单信息正确(既是一个订单包含多个包裹,一个包裹包含多个信息)即可申请token和userkey,申请格式见[[API账号申请]]
+
#*当客户开发完成以后,完整的下一个订单,如果我司IT检测订单信息正确(订单备注中有特定的信息,如:xxx 测试订单)即可申请token和userkey,申请格式见[[API账号申请]]
 
+
#*开发资料请看:[[API开发技术支持资料下载与说明]]
 
+
# 如果客户是使用第三方系统(如:ECPP、通途、ISFES、马帮、杭州普源网店精灵)的,如果出现错误请先联系第三方,如果第三方不能解决,再让第三方的IT与我公司IT沟通。
2、如果客户是使用第三方系统的,如果出现错误请先联系第三方,如果第三方不能解决,请让第三方的IT与我公司IT沟通。
+
[[文件:viewfile.png]]
 
+
# 测试环境查询专线、海外仓的服务代码
 
+
#*查询专线服务代码:http://demo.chukou1.cn/v3/direct-express/misc/list-all-service?token=887E99B5F89BB18BEA12B204B620D236&user_key=wr5qjqh4gj
3、测试环境查询专线、海外仓的服务代码
+
#*或 http://demo.chukou1.cn/client/commonpage/ExpressServiceList.aspx
*查询专线服务代码:http://demo.chukou1.cn/v3/direct-express/misc/list-all-service?token=887E99B5F89BB18BEA12B204B620D236&user_key=wr5qjqh4gj
+
#*查询海外仓服务:http://demo.chukou1.cn/v3/outbound/misc/list-all-service?token=887E99B5F89BB18BEA12B204B620D236&user_key=wr5qjqh4gj&warehouse=us (这里以us为例,如果需查询其他仓库,请自行指定仓库,如澳洲仓:warehouse=au)
*查询海外仓服务:http://demo.chukou1.cn/v3/outbound/misc/list-all-service?token=887E99B5F89BB18BEA12B204B620D236&user_key=wr5qjqh4gj&warehouse=us (这里以us为例,如果需查询其他仓库,请自行指定仓库,如澳洲仓:warehouse=au)
+
#*或 http://demo.chukou1.cn/client/commonpage/OutboundServiceList.aspx
 
+
# 正式环境查询专线、海外仓的服务代码
 
+
#*查询专线服务代码:http://yewu.chukou1.cn/client/commonpage/ExpressServiceList.aspx
4、直发业务流程:两种
+
#*查询海外仓服务:http://yewu.chukou1.cn/client/commonpage/OutboundServiceList.aspx
*expressAddPackageNew
+
# 直发业务流程:两种
**通过expressAddPackageNew添加包裹,每次我们会返回一个订单号,同一种服务我们会同一个订单号(自动的)
+
#*expressAddPackageNew
**通过ExpressCompleteOrderNew提审订单(告诉我们您们要发货了),用刚才返回的订单号
+
#**通过expressAddPackageNew添加包裹,每次我们会返回一个订单号,同一种服务我们会同一个订单号(自动的)
**用V3文档中的print-label取得打印标签打印
+
#**通过ExpressCompleteOrderNew提审订单(告诉我们您们要发货了),用刚才返回的订单号
 
+
#**用V3文档中的print-label取得打印标签打印
*ExpressCompleteOrderNew
+
#*ExpressCompleteOrderNew
**通过expressAddOrderNew添加订单,里面包含多个包裹,Submit参数设为True代表提审,我们会返回各个包裹的处理号
+
#**通过expressAddOrderNew添加订单,里面包含多个包裹,Submit参数设为True代表提审,我们会返回各个包裹的处理号
**用V3文档中的print-label取得打印标签打印
+
#**用V3文档中的print-label取得打印标签打印
**每个order面向一种派送方式
+
#**每个order面向一种派送方式
**每个package面向一个派送地址
+
#**每个package面向一个派送地址
**每个product面向一个sku
+
#**每个product面向一个sku
 
+
# Order、Package、product区别
5、Order、Package、product区别
+
#*Order是一个订单,订单里面可以包含多个Package(包裹)
*Order是一个订单,订单里面可以包含多个Package(包裹)
+
#*每一个包裹里面可以有多个product(产品)
*每一个包裹里面可以有多个product(产品)
+
#*一个订单可以包含一个包裹,也可以包含多个包裹(注意,这里的包裹对应一个销售订单)
*建议每天只创建一个订单,创建多个订单可能影响发货速度
+
# ExpressAddOrderNew与ExpressAddOrder的区别
 
+
#*ExpressAddOrderNew是新接口,ExpressAddOrder是旧接口
6、ExpressAddOrderNew与ExpressAddOrder的区别
+
#*ExpressAddOrder不支持新的服务,ExpressAddOrderNew支持全部服务(包括新服务)
*ExpressAddOrderNew是新接口ExpressAddOrder是旧接口
+
#*建议客户将ExpressAddOrder改为ExpressAddOrderNew以防止出现不必要的麻烦
*ExpressAddOrder不支持新的服务,ExpressAddOrderNew支持全部服务(包括新服务)
+
# List-Share-stock 与 List-myshare-stock
*建议客户将ExpressAddOrder改为ExpressAddOrderNew以防止出现不必要的麻烦
+
#*List-Share-stock是可以看到所用共享的,是卖家使用的接口
 
+
#*List-myshare-stock是只可以看见自己共享出去的产品,此接口只提供给共享者使用(工厂或其他的共享者)。
7、List-Share-stock 与 List-myshare-stock
+
# OutStoreAddOrderNew中的地址
*List-Share-stock是可以看到所用共享的,是卖家使用的接口
+
#*Country可以使用全称,也可以使用二字简码。
*List-myshare-stock是只可以看见自己共享出去的产品,此接口只提供给共享者使用(工厂或其他的共享者)。
+
# 香港DHL的服务代码是HKD还是DHL?
 
+
#*香港DHL的服务代码是DHL。但由于历史原因,在V2的API中,使用了HKD作为ExpressType枚举类型名称。除了在V2版的API中需要使用ExpressType.HKD作为参数,其他接口都是以DHL作为服务代码。
8、OutStoreAddOrderNew中的地址
+
#跟踪号出现时间
*Country只能用全称,不能使用缩写。
+
#*不同的服务跟踪号(track_no)出现的时间是不相同的,有的是下单后一分钟左右有跟踪号,有的是收到货便有跟踪号,有些则是一下订单就有跟踪号。
 
+
# 标签打印
9、香港DHL的服务代码是HKD还是DHL?
+
#*一般情况下,客户只需要打印我公司的标签就可以了
*香港DHL的服务代码是DHL。但由于历史原因,在V2的API中,使用了HKD作为ExpressType枚举类型名称。除了在V2版的API中需要使用ExpressType.HKD作为参数,其他接口都是以DHL作为服务代码。
+
#*标签提供一个custom字段存储客户自己的信息
 
+
# 订单删除
10、跟踪号出现时间
+
#*订单只有初始的情况下才可以删除,删除是彻底删除,既是删除后是再也找不到那张订单的
*不同的服务跟踪号(track_no)出现的时间是不相同的有的是收到货便有跟踪号,有些则是一下订单就有跟踪号。
+
#*提审过后的订单是不能删除的
 
+
#处理地区
11、标签打印
+
#*处理地区的值就是拼音的缩写,eg.GZ(广州)
*一般情况下,客户只需要打印我公司的标签就可以了
+
# 对于已提审的订单,如果部分包裹未能交到出口易,即当出口易收到这个订单时,未交货的这部分包裹将变为“待发货”状态
*标签提供一个custom字段存储客户自己的信息
+
# 提交订单时包裹中的重量可以不准确,但不要超过要使用服务的最大重量
 
+
# V2与V3是两种不同的接口,而不是不同的版本
12、订单删除
+
# 美国仓有两个:仓库代码为US,NJ
*订单只有初始的情况下才可以删除,删除是彻底删除,既是删除后是再也找不到那张订单的
 
*提审过后的订单是不能删除的
 
 
 
13、处理地区
 
*处理地区的值就是拼音的缩写,eg.GZ(广州)
 
 
 
14、对于已提审的订单,如果部分包裹未能交到出口易,即当出口易收到这个订单时,未交货的这部分包裹将变为“待发货”状态
 
 
 
15、提交订单时包裹中的重量可以不准确,但不要超过要使用服务的最大重量
 
 
 
16、V2与V3是两种不同的接口,而不是不同的版本
 
 
 
17、美国仓有两个:仓库代码为US,NJ
 

2019年4月26日 (五) 17:46的最新版本

  1. 自主开发何时申请正式的api token与userkey?
  2. 如果客户是使用第三方系统(如:ECPP、通途、ISFES、马帮、杭州普源网店精灵)的,如果出现错误请先联系第三方,如果第三方不能解决,再让第三方的IT与我公司IT沟通。

Viewfile.png

  1. 测试环境查询专线、海外仓的服务代码
  2. 正式环境查询专线、海外仓的服务代码
  3. 直发业务流程:两种
    • expressAddPackageNew
      • 通过expressAddPackageNew添加包裹,每次我们会返回一个订单号,同一种服务我们会同一个订单号(自动的)
      • 通过ExpressCompleteOrderNew提审订单(告诉我们您们要发货了),用刚才返回的订单号
      • 用V3文档中的print-label取得打印标签打印
    • ExpressCompleteOrderNew
      • 通过expressAddOrderNew添加订单,里面包含多个包裹,Submit参数设为True代表提审,我们会返回各个包裹的处理号
      • 用V3文档中的print-label取得打印标签打印
      • 每个order面向一种派送方式
      • 每个package面向一个派送地址
      • 每个product面向一个sku
  4. Order、Package、product区别
    • Order是一个订单,订单里面可以包含多个Package(包裹)
    • 每一个包裹里面可以有多个product(产品)
    • 一个订单可以包含一个包裹,也可以包含多个包裹(注意,这里的包裹对应一个销售订单)
  5. ExpressAddOrderNew与ExpressAddOrder的区别
    • ExpressAddOrderNew是新接口,ExpressAddOrder是旧接口
    • ExpressAddOrder不支持新的服务,ExpressAddOrderNew支持全部服务(包括新服务)
    • 建议客户将ExpressAddOrder改为ExpressAddOrderNew以防止出现不必要的麻烦
  6. List-Share-stock 与 List-myshare-stock
    • List-Share-stock是可以看到所用共享的,是卖家使用的接口
    • List-myshare-stock是只可以看见自己共享出去的产品,此接口只提供给共享者使用(工厂或其他的共享者)。
  7. OutStoreAddOrderNew中的地址
    • Country可以使用全称,也可以使用二字简码。
  8. 香港DHL的服务代码是HKD还是DHL?
    • 香港DHL的服务代码是DHL。但由于历史原因,在V2的API中,使用了HKD作为ExpressType枚举类型名称。除了在V2版的API中需要使用ExpressType.HKD作为参数,其他接口都是以DHL作为服务代码。
  9. 跟踪号出现时间
    • 不同的服务跟踪号(track_no)出现的时间是不相同的,有的是下单后一分钟左右有跟踪号,有的是收到货便有跟踪号,有些则是一下订单就有跟踪号。
  10. 标签打印
    • 一般情况下,客户只需要打印我公司的标签就可以了
    • 标签提供一个custom字段存储客户自己的信息
  11. 订单删除
    • 订单只有初始的情况下才可以删除,删除是彻底删除,既是删除后是再也找不到那张订单的
    • 提审过后的订单是不能删除的
  12. 处理地区
    • 处理地区的值就是拼音的缩写,eg.GZ(广州)
  13. 对于已提审的订单,如果部分包裹未能交到出口易,即当出口易收到这个订单时,未交货的这部分包裹将变为“待发货”状态
  14. 提交订单时包裹中的重量可以不准确,但不要超过要使用服务的最大重量
  15. V2与V3是两种不同的接口,而不是不同的版本
  16. 美国仓有两个:仓库代码为US,NJ