文档
测试

下单校验

POST
http://channel.51zheli.com/api/order/check

接口描述

渠道方下单之前必须调用此接口校验,该接口主要按照纷来平台下单的规则进行校验基本信息和拆分订单,返回订单号、sku当前库存。由于商品库存的变动频率非常高,平台和渠道方的库存无法共享,所以渠道方需要对商品库存自行管理,当前接口返回的库存可同步到渠道方。

请求头

参数名
类型
描述
必填
channelSaleId
number
示例:1000018 渠道ID
必填
sign
string
示例:0c84b8e693c4e0a8782b48d88584127d 签名
必填

请求参数

参数名
类型
描述
必填
province
string
示例:湖南省 收货地址省
必填
city
string
示例:衡阳市 收货地址市
必填
area
string
示例:珠晖区 收货地址区
必填
detail
string
示例:72小区 收货详细地址 最多100字符
必填
consigneeNickname
string
示例:张三 收货人昵称 最多10个中文字符
必填
consigneePhone
string
示例:18788889999 收货人手机号
必填
userMessage
string
示例:测试下单 用户下单留言 最多100字符
可选
idCard
string
示例:43042219880324456X 身份证号(海淘商品必填)
可选
realName
string
示例:张三 真实姓名(海淘商品必填)最多10个中文字符
可选
skuChannelSaleList
array
数据列表 购买详情
必填
skuId
number
示例:19804 购买商品skuId
必填
buyNum
number
示例:2 购买数量
必填

响应参数

参数名
类型
描述
必填
code
string
示例:0 返回码0=成功
必填
msg
string
示例:success 提示语
必填
data
array
数据列表 返回数据
必填
orderNo
string
示例:158762396836753846520 订单号
必填
province
string
示例:湖南省
必填
city
string
示例:衡阳市
必填
area
string
示例:珠晖区
必填
detail
string
示例:72小区
必填
idCard
string
示例:43042219880324456X
必填
realName
string
示例:张三
必填
consigneeNickname
string
示例:张三
必填
consigneePhone
string
示例:18788889999
必填
channelSaleOrderDetailRespList
array
数据列表 订单详情
必填
skuId
number
示例:19801 购买的商品skuId
必填
productId
number
示例:110322 购买的商品productId
必填
buyNum
number
示例:1 下单数量
必填
freight
number
示例:0 运费
必填
stock
number
示例:95 sku库存
必填
createTime
string
示例:2020-04-23T06:39:30.176+0000 下单时间
必填
channelSaleId
number
示例:1000018
必填
userMessage
object
示例:测试下单 下单留言
必填
addressId
number
示例:100416
必填

说明 / 示例

请求示例: ```json { "province": "湖南省", "city": "株洲市", "area": "天元区", "detail": "泰山西路1号", "consigneeNickname": "易水寒", "consigneePhone": "15921578888", "userMessage":"发货优先选中通", "idCard": "430281200010139958", "realName": "易水寒", "skuChannelSaleList": [ { "buyNum": 1, "skuId": 20076 } ] } ``` 响应示例: ```json { "code": "0", "msg": "success", "data": [ { "orderNo": "160792874362335881008", "province": "湖南省", "city": "株洲市", "area": "天元区", "detail": "泰山西路1号", "idCard": "430281200010139958", "realName": "易水寒", "consigneeNickname": "易水寒", "consigneePhone": "15921578888", "createTime": "2020-12-14T06:52:24.193+0000", "channelSaleId": 1000024, "userMessage": "发货优先选中通", "addressId": 101139, "channelSaleOrderDetailRespList": [ { "skuId": 20076, "productId": 110557, "buyNum": 1, "freight": 0, "stock": 60 } ] } ] } ``` 返回异常示例: ```json { "code": "10058", "msg": "商品已下架!", "data": null } ```