订单接口区别说明
在鸟系统中创建订单有三种方法 :
A 是直接创建订单再添加产品 , 这种方式一次创建单个订单并处理,适合于订单量少,需要逐条交互的场景。
B 是上传批量订单再转换成标准订单 , 这种方式一次创建多个临时订单及产品,然后批量转换成正式订单,适合于订单量大,需要批量处理的场景。
C 是直接上传订单为待处理状态 , 这种方式一次创建多个正式订单及产品,并自动修改成待处理状态,类似于一键完成的效果,高度自动化,适用于订单量大,需要批量处理的场景。但前提是要确保上传的数据正常无误, 出错时,会自动撤消所插入的订单(但是不支持并发,只能单线程提交)
三种方案的比较:
(A) 标准接口 | (B) 批量订单接口 | (C) Pending订单接口 | ||
---|---|---|---|---|
地址 | /client/Consignment | /client/consignment-upload/Temp-Consignment-Json | /client/Consignment/Post-Pending-Consignment-With-Products-Json | |
Content-Type | application/x-www-form-urlencoded | application/json | application/json | |
支持的订单类型 | 本地订单 (LOCAL) | √ | √ | √ |
专线订单 (DIRECT) | √ | √ | √ | |
退货订单 (RETURN) | √ | √ | √ | |
代理专线订单 (AGENT_DIRECT) | √ | √ | √ | |
客户专线订单 (CLIENT_DIRECT) | √ | x | x | |
FBA订单 (FBA) | √ | x | x | |
额外支持的产品 | 普通共享产品 | √ | √ | √ |
定向共享产品 | √ | √ | √ | |
产品参数可用客户SKU | x | √ (需要客户端设置批量订单产品字段用客户SKU) | √ (传id/client_sku/reference参数) | |
邮递服务参数可用名称 | x | √ (批量订单只能用delivery_service_name) | √ (传delivery_service_name参数) | |
是否可一次传多个订单 | x | √ (传json数组) | √ (传json数组) | |
成功后的订单状态 | PREPARING | PENDING (只是批量订单,还未创建正式订单, 要处理成本地订单) | PENDING |