订单相关

1. 拉取订单列表

接口调用基本参数 参数
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/getorderbypage?access_token=ACCESS_TOKEN
POST数据格式 json

请求数据样例

{
    "offset": 0,
    "count": 10,
    "begin_time": 0,
    "end_time": 1517454309,
    "status": 3
}
请求字段 必填 说明
offset 是 分页起始位置, 取值范围为[0, 订单总数],
count 否 拉取条数, 取值范围为[0, 20]，默认10
begin_time 否 筛选订单开始时间, unix秒级时间戳，默认为0
end_time 否 筛选订单结束时间, unix秒级时间戳，默认为最大时间
status 否 筛选订单状态，支持取值有 3：已下单，4：已发货，不填默认拉所有订单，5: 已退款

回包数据样例

{
    "errcode": 0,
    "errmsg": "success",
    "total_count": 1,
    "order_list": [
        {
            "order_id": "ojj312nnvfff123123",
            "pay_finish_time": 1517454309,
            "desc": "下单备注",
            "fee": 150,
            "trans_id": "wxpay_ojj312nnvfff123123",
            "status": 3,
            "ext_info": {
                "product_info": {
                    "item_list": [
                        {
                            "item_code": "312344221", 
                            "sku_id": "312344221_123333",
                            "amount": 2,
                            "total_fee": 100,
                            "unit_price": 50,
                            "title": "测试商品",
                            "desc": "用来测试购买"
                        }
                    ]
                },
                "express_info": {
                    "name": "测试用户", 
                    "phone": "13570000000",
                    "address": "广州市新港中路TIT创意园腾讯自编B2",
                    "price": 50
                },
                "invoice_info": {
                    "type": 0,
                    "title": "腾讯科技广州分公司"
                }    
            }
        }
    ]
}
回包字段 说明
errcode 错误码
errmsg 错误信息
total_count 订单总数，业务方可以据此算出总页数
order_list 订单列表，字段详见后面描述
order字段 说明
order_id 订单id
pay_finish_time 用户支付下单时间
desc 用户下单时填的备注信息
fee 订单支付金额，分为单位
trans_id 微信支付订单号，可以在微信支付商户平台上查询
status 订单状态：3：已下单，4：已发货
ext_info 包括product_info：商品信息，express_info：物流信息，invoice_info：发票信息
refund_pay_coin_count 退款金额，分为单位
refund_finish_time 退款完成时间，unix秒级时间戳，默认为0
product_info字段 说明
item_list 商品列表
item_code 商品id
sku_id sku id
amount 下单数量
total_fee 总价，分为单位
unit_price 商品单价，分为单位
title 商品标题
desc 商品描述
express_info字段 说明
name 收件人名字
phone 收件人手机号
address 收件人地址
price 运费
express_company_id 快递公司id，发货后有，参考发货接口
express_company_name 快递公司名称，发货后有，参考发货接口
express_code 快递单号
ship_time 订单发货时间
invoice_info字段 说明
type 发票类型，0：单位，1：个人
title 发票抬头

2. 拉取单个订单

接口调用基本参数 参数
协议 https
http请求方式 POST
请求URL https://api.weixin.qq.com/mall/getorderbyid?access_token=ACCESS_TOKEN
POST数据格式 json

请求数据样例

{
    "order_id": "xxxxxaaaaalllll"
}
请求字段 必填 说明
order_id 是 精品店订单id，注意，非支付单号

回包数据样例

{
    "errcode": 0,
    "errmsg": "success",
    "order": 
        {
            "order_id": "ojj312nnvfff123123",
            "pay_finish_time": 1517454309,
            "desc": "下单备注",
            "fee": 150,
            "trans_id": "wxpay_ojj312nnvfff123123",
            "status": 3,
            "ext_info": {
                "product_info": {
                    "item_list": [
                        {
                            "item_code": "312344221", 
                            "sku_id": "312344221_123333",
                            "amount": 2,
                            "total_fee": 100,
                            "unit_price": 50,
                            "title": "测试商品",
                            "desc": "用来测试购买"
                        }
                    ]
                },
                "express_info": {
                    "name": "测试用户", 
                    "phone": "13570000000",
                    "address": "广州市新港中路TIT创意园腾讯自编B2",
                    "price": 50
                },
                "invoice_info": {
                    "type": 0,
                    "title": "腾讯科技广州分公司"
                }    
            }
        }
}
回包字段 说明
errcode 错误码
errmsg 错误信息
order 订单信息，字段详见1.1.1订单字段描述部分