购买商品（/order/buy）

/order/buy（购买商品）

请求地址:

示例地址	描述
https://{xxx.com}/order/buy	地址中的xxx.com为示例，请在会员中心的资料设置中查看ApiHost。

公共请求参数:

名称	类型	必须	描述
uid	Number	是	账号UID，在会员中心的资料设置中查看。资料中的ID号包括了站点ID和账号UID，例如：111-10088，其中111是站点ID，10088是账号UID，请勿混淆。
t	Number	是	秒级时间戳
sign	String	是	签名（查看签名算法）

请求参数:

名称	类型	必须	描述
shop_buy	Number	否	0.否 1.使用店铺同步订单的方式下单，使用店铺下单，支出多sku组合下单。
default_sku_id	Number	否	使用店铺同步下单时（shop_buy=1），设置默认商品规格SkuID。
qid	Number	否	优惠券ID（在 "会员中心" -> "优惠券" 中查看ID）
repeat	Boolean	否	是否允许重复下单（传了店铺订单号时有效）
fahuo	Boolean	否	是否立即提交发货（同步店铺订单下单时有效）
batch	Number	否	下单批次，建议使用秒级时间戳
fjid	Number	否	发件人ID（在 "会员中心" -> "发件管理" 中查看ID），如果不传发件人ID，就必须传 "sender_name、sender_mobile" 这两个参数。
sender_name	String	否	发件人姓名，如果不传发件人姓名和号码，就必须传发件人ID。
sender_mobile	String	否	发件人号码，如果不传发件人姓名和号码，就必须传发件人ID。
now	Number	否	0.否； 1.代表立即出快递单号；如果传1的情况下，不保证100%会出单号，需要自己做逻辑处理。建议每次请求不超过5单，否则可能会导致请求超时。
qiang_zhi	Number	否	1.超过最晚揽收时间下单会拦截，使用此参数可强制下单，但需自行承担揽收超时的风险； 0.不强制下单，正常拦截；
order	order[]	是	收件信息列表

order[] :

名称	类型	必须	描述
uuid	String	是	订单唯一ID，必须保证全站唯一（非账号下唯一），在获取订单的时候用的到。
pzid	Number	是	快递配置ID，通过此参数确定：电商平台类型、打单工具、快递公司。
sku_id	Number	是	本站商品SkuID，实际下单的商品规格。
shop_type	Number	否	商品没有 "实时打单" 标签时需要传（1.淘宝；2.抖音；3.拼多多；4.京东；5.快手；6.视频号；7.小红书；8.淘工厂），注意查看是否支持店铺类型。
dian_pu_id	Number	否	店铺绑定后，在 "会员中心" -> "授权店铺" 中查看店铺ID。使用店铺同步下单，支持带*号号码下单。
ding_dan_id	String	否	店铺订单ID，如果传了店铺订单ID，会检查是否重复下单，除非repeat这里指定允许重复。
shou_ren	String	是	收件-姓名
shou_hao	String	是	收件-号码（支持虚拟号）
shou_sheng	String	是	收件-省
shou_shi	String	是	收件-城市
shou_qu	String	是	收件-区/县（不传可能会出不了单号）
shou_jie	String	否	收件-街道
shou_men	String	是	收件-门牌号
xuhao	Number	否	自定义收件订单序号
num	Number	是	每单购买商品件数，默认最小为1，可不传，最大值参考 sku_list 里的 xiangou 参数。
group	String	否	此参数很复杂，非必要不要传，除非清楚此参数的作用。
buyer_uid	String	否	此参数很复杂，非必要不要传，除非清楚此参数的作用。
config	config	否	密文下单需要

config:

名称	类型	必须	描述
oaid	String	否	淘宝密文
order_id	String	否	淘宝订单ID、抖音订单ID
buyer_open_uid	String	否	淘宝参数（好像不用传）
desen_fullname	String	否	抖音密文收件人、京东密文收件人、视频号密文收件人
desen_mobile	String	否	抖音密文号码、京东密文号码、视频号密文号码
buyer_oaid	String	否	抖音订单oaid、京东订单oaid、视频号订单oaid
desen_address	String	否	抖音密文地址、京东密文地址、视频号密文地址
sellerOpenId	String	否	快手参数
sellerNick	String	否	快手参数
encryptedConsignee	String	否	快手密文收件人
encryptedMobile	String	否	快手密文号码
encryptedAddress	String	否	快手密文地址
receiver_name	String	否	拼多多密文收件人
receiver_phone	String	否	拼多多密文号码
receiver_address	String	否	拼多多密文地址
recipient_code	String	否	拼多多参数
address	String	否	拼多多密文地址

响应参数:

{
    "code": 200,
    "msg": "success",
    "data": {
	// 错误提示列表
        "errorList": [
            {
                "uuid": "9c5d9314-94b1-4dd7-b53f-a22f2b8757d4",	// 唯一ID号
                "message": "重复提交下单",            	// 错误提示信息
            }
        ],
        "number": 1,	// 提交的订单数量
	// 下单成功的唯一ID号列表
        "list": [
            "9c5d9314-94b1-4dd7-b53f-a22f2b8757d4"
        ],
	// 实时出单号列表
        "orders": [
            {
                "oid": 100222,            	// 内部订单ID
                "only_id": "9c5d9314-94b1-4dd7-b53f-a22f2b8757d4",	// 传的唯一ID号
                "order_id": "10101-21324564654",	// 店铺订单ID
                "status": 1,                	// 状态：1.正常； 2.已退款； 3.退款中； 4.黑名单； 5.异常；
                "qudanhao": 1,            	// 单号获取情况：0.未取； 1.已取； 2.进行中； 3.错误；
                "express_number": "9873434488169",	// 快递单号
                "message": ""                	// 错误提示（json字符串）
            }
        ],
        "success": true
    }
}

PHP示例代码：

function test_api(){
	$url = 'http://xxx.com/order/buy';
	$uid = '10000';
	$mobile = '18828889888';
	$apikey = '882e89203dd3b2d1cbad6e853101da99';
	$t = time();
	$post = [];
	$post['t'] = $t;
	$post['uid'] = $uid;
	$post['sign'] = md5(md5(  strtolower($apikey) . $mobile . $uid . $t  ));
	$post['shop_buy'] = '0';
	$post['default_sku_id'] =  '';
	$post['qid'] =  '';
	$post['repeat'] =  false;
	$post['fahuo'] =  false;
	$post['batch'] =  '1702873797';
	$post['fjid'] =  0;
	$post['sender_name'] =  '发件人';
	$post['sender_mobile'] =  '13825516665';
	$post['now'] =  1;
		$order = [];
			$item = [];
			$item['uuid'] = '9c5d9314-94b1-4dd7-b53f-a22f2b8757d4';
			$item['pzid'] = '115';
			$item['sku_id'] = '10000001';
			$item['dian_pu_id'] = '';
			$item['ding_dan_id'] = '10101-21324564654';
			$item['shou_ren'] = '张三';
			$item['shou_hao'] = '18812345678';
			$item['shou_sheng'] = '浙江省';
			$item['shou_shi'] = '杭州市';
			$item['shou_qu'] = '萧山区';
			$item['shou_jie'] = '';
			$item['shou_men'] = '幸福街健康路99号';
			$item['xuhao'] = '1';
		$order[] = $item;
	$post['order'] = $order;
	$resp = self::sendPost( $url, $post, 'POST', [] );
	return json($resp);
}

{{ xiaoxi.title }}