API接口文档／2.6 订单服务／2.6.1 订单预提交服务（预下单）

2.6.1 订单预提交服务（预下单）

通过该接口进行预下单，下单后锁定库存等资源，等待确认接口后再发货；所有订单默认开明细发票

请求方式/参数格式
POST/JSON

请求URL
https://域名/submit

请求入参说明

参数名称	必填	类型	长度	示例值
token	是	String	100	授权接口获取的access token
po_order	是	String	50	客户订单编号
sku	是	Array		订单详情
└sku	是	String	50	商品编码
└num	是	int		商品数量
└price	是	number		价格
└yanbao	否	Array		如果商品有选择延保服务,此项必填
└└sku	是	String	50	延保编号
└└num	是	int		延保数量
└└price	是	number		价格
name	是	number	30	收货人
province	是	String	30	一级地址
city	是	String	30	二级地址
county	是	String	30	三级地址
address	是	String	100	详细地址
zip	是	String		邮编
phone	是	String	30	座机号 (与mobile其中一个有值即可)
mobile	是	String	30	手机号 (与phone其中一个有值即可)
email	是	String	50	邮箱
remark	否	String	200	备注（少于100字）
dep_name	否	String	50	采购单位名称
invoice_title	是	String	50	发票抬头，个人或公司名称
invoice_type	是	int		1普通发票;2增值税发票；3 电子发票；默认为普通发票
invoice_org_code	是	String	50	纳税人识别号
invoice_name	否	String	100	增值票收票人,备注：当invoice_type=2 时,则此字段必填
invoice_phone	否	String	30	注册电话,备注：当invoice_type=2 时,则此字段必填
invoice_bank	否	String	50	开户银行,备注：当invoice_type=2 时,则此字段必填
invoice_bank_code	否	String	100	开户行帐号,备注：当invoice_type=2 时,则此字段必填
invoice_address	否	String	100	注册地址，当invoice_type=2 时,则此字段必填
invoice_mobile	否	String	50	收票联系电话
invoice_receipt_address	否	String	200	收票地址
payment	是	int		支付方式：1：统一支付2：在线支付，默认1
order_price	是	number	50	订单金额（包含运费）
freight	是	number		运费
mode	是	int		订单模式：1-协议价（默认）

返回结果

名称	类型	必填	备注
success	boolean	是	true\|false，根据该字段判断接口是否调用成功，若为false，则解析error_response字段查看具体失败原因
result	Object	是	数据对象，数据节点
└mall_order_id	String	是	订单编号
└freight	number	否	运费
└orderPrice	number	是	订单金额（包含运费）
└sku	Array	是	数组对象, 商品子节点
└└sku	String	是	商品编码
└└num	int	是	数量
└└price	number	是	价格

错误码

错误码	错误描述	解决方案
ERR-000114	SKU不能为空
ERR-000115	收货人不能为空
ERR-000116	一级地址不能为空
ERR-000117	二级地址不能为空
ERR-000118	三级地址不能为空
ERR-000119	详细地址不能为空
ERR-000120	邮编不能为空
ERR-000121	座机号与mobile不能都为空
ERR-000122	邮箱不能为空
ERR-000123	发票抬头，个人或公司名称不能为空
ERR-000124	发票分类不能为空
ERR-000125	纳税人识别号不能为空
ERR-000126	增值票收票人不能为空
ERR-000127	注册电话不能为空
ERR-000128	T开户银行不能为空
ERR-000129	开户行帐号不能为空
ERR-000130	注册地址不能为空
ERR-000131	支付方式不能为空
ERR-000132	订单金额（包含运费）不能为空
ERR-000133	运费不能为空
ERR-000134	订单模式不能为空

请求示例

{
  "token": "cb0bd9f8-ae67-4365-b14d-566ee96886a8",
  "po_order": "133331444111111",
  "sku": [
    {
      "sku": "30060020",
      "num": 2,
      "price": 23.01,
      "yanbao":[
        {
          "sku":"30060020",
          "price": 99,
          "num": 2
        }
      ]
    },
    {
      "sku": "30060021",
      "num": 4,
      "price": 23.04
    },
    {
      "sku": "30060022",
      "num": 5,
      "price": 23.44
    }
  ],
  "name": "哈尔滨南岗区政府采购网上商城",
  "province": "1",
  "city": "1",
  "county": "1",
  "address": "1",
  "zip": "1",
  "phone": "1",
  "mobile": "1",
  "email": "lei@lei.com",
  "remark": "1",
  "dep_name": "1",
  "invoice_title": "哈尔滨市南岗区文化社区卫生服务中心",
  "invoice_type": 1,
  "invoice_org_code": "1",
  "invoice_name": "1",
  "invoice_phone": "1",
  "invoice_bank": "1",
  "invoice_bank_code": "1",
  "invoice_address": "1",
  "invoice_mobile": "1",
  "invoice_receipt_address": "1",
  "payment": 1,
  "order_price": 1,
  "freight": 1,
  "mode": 1
}

返回示例

{
  "result": {
    "mall_order_id": "LINK20190821340000004",
    "freight": "0",
    "orderPrice": 339.6,
    "sku": [
      {
        "price": "7",
        "num": "2",
        "sku": "10302374"
      },
      {
        "price": "12.6",
        "num": "4",
        "sku": "10302373"
      },
      {
        "price": "34.4",
        "num": "8",
        "sku": "10302370"
      }
    ]
  },
  "success": true
}