订单创建

开发者向“订单创建”接口发起订单创建请求，创建成功后，就进入口袋定制的订单流中。

请求地址

环境	HTTP请求地址
正式环境	https://api.koudaidingzhi.com/api/v1/orders
测试环境	http://staging.api.flashmaking.com/api/v1/orders

公共请求参数

请点击查看《公共请求参数》

请求参数

http method

POST

koudaidingzhi.order.create

订单主体参数

参数	类型	是否必填	最大长度	描述	示例值
out_order_number	String	是	64	开发者订单系统中的订单号	20150320010101001
receiver_name	String	是	-	收件人	朱竹青
receiver_phone	String	是	-	手机号	[phone]
receiver_province	String	是	-	省份名称	上海市
receiver_city	String	是	-	城市名称	宝山区
receiver_district	String	是	-	区县名称	松南镇
receiver_detail_address	String	是	-	详细地址	逸仙路3000号2号楼505室
placed_at	String	是	-	下单时间	"2018-05-17 14:34:08"
line_items	String	是	-	商品明细	line_items 参数
remark	String	否	-	订单备注	我要的比较急，可不可以，优先发货

line_items 参数

参数	类型	是否必填	最大长度	描述	示例值
line_item_number	String	是	64	订单中line_item的具体编号，用于记录跟踪订单中的line_item	“81912893”
sku_code	String	是	64	SKU编号	"TY010102"
quantity	Integer	是	3	数量	1
image01	String	否	-	正面设计图	"http://www.test.com/xxx.png"
image02	String	否	-	背面设计图	"http://www.test.com/xxx.png"

请求示例

{
  "app_id": "s0jrkq4srt47mm1h",
  "sign": "43f410f853c31fba679bafb4f83b0731fc3543e26c20292d7473fbfd76bede97",
  "method": "koudaidingzhi.order.create",
  "timestamp": "2018-01-01 12:02:48", 
  "biz_content":'{
    "out_order_number": "20150320010101001",
    "receiver_name": "朱竹青",
    "receiver_phone": "[phone]",
    "receiver_province": "上海市",
    "receiver_city": "宝山区",
    "receiver_district": "淞南镇",
    "receiver_detail_address": "逸仙路3000号2号楼505室",
    "placed_at": "2018-05-17 14:34:08",
    "remark": "我要的比较急，可不可以，优先发货",
    "line_items":[
     {
      "line_item_number": "8273818377",
      "sku_code": "TY010102",
      "quantity": 1,
      "image01": "http://www.test.com/xxx.png",
      "image02": "http://www.test.com/xxx.png"
     },
     {
      "line_item_number": "8273818378",
      "sku_code": "TY020204",
      "quantity": 2,
      "image01": "http://www.test.com/xxx.png",
      "image02": "http://www.test.com/xxx.png"
      },
     {
      "line_item_number": "8273818379",
      "sku_code": "DY020202",
      "quantity": 1,
      "image01": "http://www.test.com/xxx.png",
      "image02": "http://www.test.com/xxx.png"
      }
    ] 
  }'
}

响应参数

响应主体参数

参数	类型	是否必填	最大长度	描述	示例值
out_order_number	String	是	64	开发者订单号
order_index	String	是	-	订单层级，这里代表主订单（父订单）	"parent"
child_order	String	否	-

child_order 参数

参数	类型	是否必填	最大长度	描述	示例值
order_index	String	是		订单层级，这里代表子订单	"child"
order_number	String	是	64	本接口系统生成的子订单号
line_items	String	是	-	分配到此子订单的line_item数组	查看 line_items 参数

line_items 参数

参数	类型	是否必填	最大长度	描述	示例值
line_item_number	String	是	64	订单中line_item的具体编号，用于记录跟踪订单中的line_item。与上文开发者请求的参数相同

公共响应参数

请点击查看《公共响应参数》

响应参数示例

{     
  "app_id": "2017120100007148",
  "sign": "b1844ba14d86d5a3d62dc6506ce878770b70bc4e28b2c89f6465f0f4d9f7530f",
  "method": "koudaidingzhi.order.create",
  "timestamp": "2018-01-01 12:02:48", 
  "biz_content":{
    "out_order_number": "20150320010101001",
    "order_index": "parent",
    "child_order":[
     {
      "order_index": "child",
      "order_number": "2017120100007234",
      "line_items": [
        {
         "line_item_number": "8273818377",
         "sku_code": "TY010102",
         "quantity": 1,
         "image01": "http://www.test.com/xxx.png",
         "image02": "http://www.test.com/xxx.png"
        },
        {
         "line_item_number": "8273818378",
         "sku_code": "TY020204",
         "quantity": 2,
         "image01": "http://www.test.com/xxx.png",
         "image02": "http://www.test.com/xxx.png"
         }
        ]
     },
     {
      "order_index": "child",
      "order_number": "2017120100007236",
      "line_items": [
        {
         "line_item_number": "8273818379",
         "sku_code": "DY020202",
         "quantity": 1,
         "image01": "http://www.test.com/xxx.png",
         "image02": "http://www.test.com/xxx.png"
         }
        ]
     }
    ] 
  }
}

业务错误码

公共错误码

公共错误码	业务错误码	错误描述
40001	missing_out_order_number	缺少订单号
	missing_receiver_name	缺少收件人姓名
	missing_receiver_phone	缺少收件人联系电话
	missing_receiver_province	缺少收件人省份
	missing_receiver_city	缺少收件人城市
	missing_receiver_detail_address	缺少收件人详细地址
	missing_placed_at	缺少下单时间
	missing_quantity	缺少数量
	missing_line_items	缺少订单详情
	missing_sku_code	缺少SKU编号
40002	invalid_out_order_number	无效的订单号
	invalid_order_lines	无效的订单条目
	invalid_receiver_phone	无效的手机号码
	invalid_sku_code	无效的SKU编号
	invalid_quantity	无效的数量类型

异常示例

{
  "code": 40002,
  "message": "无效的参数",
  "sub_code": {
    "invalid_out_order_number": "无效的订单号"
  }
}