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
}