Page Comparison

在鸟系统中创建订单有三种方法 ：

A 是直接创建订单再添加产品 ,  这种方式一次创建单个订单并处理，适合于订单量少，需要逐条交互的场景。

B 是上传批量订单再转换成标准订单 , 这种方式一次创建多个临时订单及产品，然后批量转换成正式订单，适合于订单量大，需要批量处理的场景。

C 是直接上传订单为待处理状态 , 这种方式一次创建多个正式订单及产品，并自动修改成待处理状态，类似于一键完成的效果，高度自动化，适用于订单量大，需要批量处理的场景。但前提是要确保上传的数据正常无误, 出错时，会自动撤消所插入的订单

三种方案的比较:

 以下是具体介绍：

一. 建立连接

在创建订单前， 我们先要了解如何建立连接。

鸟系统是使用Restful API与第三方系统交互的。为了识别用户身份，需要在每个请求中包含身份标识，这个动作我们称为建立连接， 可参考链接 ：建立连接

二. 用直接创建订单的方式添加订单

1.直接创建订单

创建订单主要是将订单需要的邮递服务，联系人，邮编，地址等信息post给服务器，

接口如下：

{
    "success":true,
    "data":{
		"id":"2006143004830001",
		"delivery_service_id":"12010433",
		"...":"..."
	}
}

请注意，订单的邮递服务ID，是和你当前所在的仓库和联系人国家相关的，如果在提交的时候发生邮递服务的错误，请优先检查这部分的问题。 

2. 往订单中添加产品

在上一步的返回结果信息中，我们会包含id字段作为订单ID. 这一步我们往这个ID所表示的订单中添加产品。

{
    "success":true,
    "data":{
		"id":"1124955",
		"consignment_id":"2006143004830001",
		"product_id":"334422",
		"...":"..."
	}
}

请注意，一次请求只能添加一种产品，如果添加多种产品，请发多个请求。

3. 修改订单的状态为待处理

往订单中添加完产品后，我们就可以将订单的状态修改为待处理，待处理即表示提交给仓库处理。

{
    "success":true
}

三 用上传批量订单的方式添加订单

1.上传批量订单

2.处理批量订单

四 用直接上传订单为待处理状态的方式添加订单

五 获取面单

订单到待处理后, 会在后台异步对接, 大约5-10分钟内会对接服务商.

获取面单的接口,参考  打印地址贴

为了让客户能第一时间知晓 您的订单已经对接好服务商,生成了面单, 我们提供 了webhook来通知客户. Webhook创建及使用接口

六 等待仓库处理订单

经过上面步骤二或者步骤三或者步骤四以后，订单已提交到仓库进行处理，用户只需隔一段时间后刷新查询结果即可.

仓库处理状态流依次是： 待处理->待拣货->拣货中->完成

七 常见错误

1.添加订单时报余额不足

这是由于客户帐户中可用余额不足造成的，不能再发订单，需要充值后再使用

2.往订单添加产品时报库存不足

这是由于指定产品的库存不够造成的，只能设法补货

3.往订单添加产品时报邮递服务不合适

造成这类问题原因通常有：

  (1)  邮递服务在目标国家没有开通服务、

  (2)  订单中产品重量、规格超过该邮递服务所能处理的范围

  (3)  订单中产品包含有海关禁运属性

遇到邮递服务不合适的情况时，请咨询我们客服，以便获得详细的解答