搜索
微信客服
获取订单列表(/dingdan/liebiao)
更新于: 2024-06-26 15:41:26 阅读数: 1535

/dingdan/liebiao(获取订单列表)

请求地址:

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

 

公共请求参数:

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

 

请求参数:

名称 类型 必须 描述
uuid String / uuid[] 下单时传的唯一ID号,传字符串只查1单,传数组批量查询。示例 [ "xxx-01", "xxx-02" ] 
times time[] 筛选订单下单时间区间,示例 [ "2023-12-11 00:00:00", "2023-12-17 00:00:00" ] ,为空时查询最近7天的订单。
batch Number 下单批次,在下单时传的相关参数。
status Number 订单状态,1.正常订单; 2.已退款; 3.退款中; 4.异常订单
wuliu Number 物流状态,99.无物流; 1.运输中; 2.已签收; 3.异常
order_id String 店铺中的订单号
express String 快递单号
page Number 页码
limit Number 每一页返回订单数量

 

响应参数:

{
    "code": 200,
    "msg": "success",
    "data": {
        "success": true,
        "list": [
            {
		// 仓库信息
                "cangku": {
                    "ckid": 103,
                    "name": "广州大源",
                    "logo": "xxx.png"
                },
		// 快递信息
                "kuaidi": {
                    "kdid": 103,
                    "name": "韵达快递",
                    "icon": "xx.png"
                },
		// 电商平台
                "shop_type": {
                    "name": "拼多多",
                    "icon": "gyl-pinduoduo",
                    "type": "pdd",
                    "id": 3
                },
                "message": [],	// 错误提示
                "create_time": "08-08 08:08:08",	// 下单时间
                "goods_image": "xxx.png",        	// 商品图片
                "oid": 1000000088,            	// 订单号
                "uuid": xxx-xxx-xxx,            	// 唯一ID号
                "ckid": 103,                	// 仓库ID
                "pzid": 888,                	// 快递配置信息
                "order_id": "",                	// 店铺中的订单ID
                "price": "8.88",                // 下单单价
                "user_shop_name": "",        	// 店铺名称
                "express_number": "463290198888888",	// 快递单号
                "sender_name": "xx",        	// 发件-姓名
                "sender_mobile": "18812345678",    	// 发件-号码
                "sender_province": "广东省",    	// 发件-省份
                "sender_city": "广州市",        	// 发件-城市
                "sender_district": "白云区",    	// 发件-地区
                "sender_address": "大源镇大源东路63号",	// 发件-街道
                "receiver_name": "收件人",		// 收件-姓名
                "receiver_mobile": "18812345678",	// 收件-号码
                "receiver_province": "湖北省",    	// 收件-省份
                "receiver_city": "孝感市",    	// 收件-城市
                "receiver_district": "大悟县",    	// 收件-地区
                "receiver_town": "",        	// 收件-街道
                "receiver_address": "城关镇幸福路11号",	// 收件-门牌
                "goods_id": 100341,            	// 商品ID
                "sku_id": 800078,            	// 商品SkuID
                "goods_title": "商品标题",     	// 商品标题
                "sku_name": "韩版黑【1只】",    	// 商品Sku名称
                "exp_step": 0,            	// 物流状态:0.无物流 1.途中 2.签收 3.异常
                "status": 1,              	// 订单状态:1.正常 2.已退款 3.退款中 4.黑名单 5.异常
                "goods_list": []            	// 多订单下的商品
            }
        ],
        "isOld": false	// 无用参数
    }
}

 

PHP示例代码:

function test_api(){
	$url = 'http://xxx.com/dingdan/liebiao';
	$uid = '188888';
	$mobile = '18899999999';
	$apikey = '8d2e89203dd3b2d1cbad6e853101da99';
	$t = time();
	$post = [];
	$post['t'] = $t;
	$post['uid'] = $uid;
	$post['sign'] = md5(md5(strtolower($apikey).$mobile.$uid.$t));
	$post['uuid'] = [ "xxx-01", "xxx-02" ];
	$post['page'] = 1;
	$post['limit'] = 20;
	$resp = self::sendPost( $url, $post, 'POST', [] );
	return json($resp);
}