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