商品采购统一下单接口(url时效5分钟

接口地址

https://activity.m.duiba.com.cn/gaw/supply/purchase

接口支持http或https协议访问,响应内容中链接的协议头也会自适应转换。

注意: 若接口返回“发生系统错误”(响应码:9999999)或接口网络异常(如超时等异常情况),请勿直接认为下单失败,需调用 订单状态查询接口 ,确认订单状态。

请求方式: post

注意: 下单接口为form表单形式请求提交,使用post请求,且勿使用json格式请求发送数据,否则接口会报错

请求参数:

参数参数 类型 是否必填 限制长度 描述
appKey string Y 255 应用唯一标注
timestamp string Y 20 1970.1.1开始的毫秒数
sign string Y 255 签名(详见签名规则)
appItemId long Y 20 商品id
skuId long Y 20 商品skuId,注:如果商品为话费请填0
thirdOrderNum string Y 255 第三方订单号
account string N 32 商品为虚拟商品充值类,则传对应的充值账号
wxCouponValue long N 20 微信立减金-面额>=100,单位分,不定额立减金时必传
wxCouponMinimum long N 32 微信立减金-发放门槛>=101,单位分,不定额立减金时必传
phoneDegree long N 20 商品为多档位话费时,话费的档位面额,单位分
phone string N 32 实物和话费商品必传;实物为收货人手机号;话费为充值手机号
address string N 255 实物商品收货详细地址(实物商品必传)
province string N 255 实物商品收货地址 省份(实物商品必传)
city string N 255 实物商品收货地址 市(实物商品必传)
district string N 255 实物商品收货地址 区、县(实物商品必传)
street string N 255 实物商品收货地址 街道
name string N 32 实物商品收货人姓名(实物商品必传)

响应参数:

参数参数 类型 是否必填 限制长度 描述
success boolean Y 是否成功
code string Y 255 参见‘响应码明细表’
desc string Y 255 参见‘响应码明细表
timestamp string Y 20 系统时间戳
data object Y 参见‘data明细表’

响应码明细表:

code desc
0000000000 成功
9999999 发生系统错误
1100001 appKey不能为空
1100002 appKey错误
1100003 签名验证失败
1100004 第三方订单号重复
1100005 appItemId不能为空
1100006 skuId不能为空
1100007 实物商品收货信息不能为空
1100008 第三方订单号不能为空
1100009 商品不存在
1100010 商品已下架
1100011 不支持购买自有商品
1100012 下单失败稍后再试(库存不足)
1100013 订单不存在
1100014 签名不能为空
1100015 时间戳不能为空
1100016 请求已过期
1100017 appItemIds错误
1100018 非兑吧采购商品
1100019 无权访问该商品
1100020 该地区限制下单
1100021 该商品该地区不发货
1100022 虚拟商品充值账号不能为空
1100023 当前app无接口使用权限
1100024 今日采购优惠券已达上限
1100025 当前商品库存不足
1100026 多档位话费的档位不能为空
1100027 话费商品充值手机号不能为空
1100028 手机号码归属地查询异常
1100029 话费价格非法,无法进行充值兑换
1100030 话费商品档位配置有误
1100031 手机号无合适供应商
1100032 多档位话费的档位有误
1100033 该商品不支持采购,请联系运营或技术支持
1100034 立减金面额和门槛不可为空
1100035 立减金不支持自定义面额和门槛

data明细表

参数参数 类型 是否必填 限制长度 描述
orderNum string Y 255 兑吧订单号

响应示例:

{
    "success":true,
    "code":"0000000000",
    "desc":"OK",
    "timestamp":1561392321796,
    "data":{
        "orderNum":"123032948572"
    }
}

results matching ""

    No results matching ""