# 获取订单详情

# 接口调用请求说明

可以按照支付单号或者外部订单号来查询业务单详情、支付单详情、支付单状态。

http请求方式:POST
https://api.weixin.qq.com/shop/order/get?access_token=xxxxxxxxx

# 请求参数

{
    "order_id": 3302968738502279424,
    "out_order_id": "***************",
    "openid": "oTVP50O53a7jgmawAmxKukNlq3XI"
}

# 回包示例

{
    "errcode": 0,
    "errmsg": "ok",
    "order": {
        "order_id": 3302968738502279424,
        "out_order_id": "***************",
        "status": 20,
        "path": "/pages/order.html?out_order_id=xxxxx",
        "default_receiving_address": {
            "city": "广州市",
            "country": "中国",
            "detailed_address": "龙洞250号",
            "province": "广东省",
            "receiver_name": "我爱我家",
            "tel_number": "18712345678",
            "town": "温柔乡"
        },
        "order_detail": {
            "promotion_info": {
                "promoter_id": "PROMOTER_ID",
                "finder_nickname": "FINDER_NICKNAME",
                "sharer_openid": "SHARER_OPENID"
            },
            "product_infos": [
                {
                    "out_product_id": "12345",
                    "out_sku_id": "23456",
                    "product_cnt": 10,
                    "sale_price": 200,
                    "path": "pages/productDetail/productDetail?productId=2176180",
                    "title": "标题",
                    "head_img": "http://img10.360buyimg.com/n1/s450x450_jfs/t1/85865/39/13611/488083/5e590a40E4bdf69c0/55c9bf645ea2b727.jpg",
                    "real_price": 200
                }
            ],
            "pay_info": {
                "pay_method": "微信支付",
                "prepay_id": "42526234625",
                "prepay_time": "2020-03-25 14:04:25",
                "transaction_id": "131456479687",
                "pay_time": "2020-03-25 14:05:25",
                "pay_method_type": 0
            },
            "price_info": {
                "order_price": 1600,
                "freight": 500,
                "discounted_price": 1000,
                "additional_price": 100,
                "additional_remarks": "税费"
            },
            "delivery_detail": {
                "delivery_type": 1,
                "finish_all_delivery": 1,
                "delivery_list": [
                    {
                        "waybill_id": "SFXXXX",
                        "delivery_id": "SF",
                    }
                ]
            }
        }
    }
}

# 请求参数说明

参数 类型 是否必需 说明
order_id number(uint64) 微信侧订单id (订单 id 二选一)
out_order_id string 商家自定义订单ID (订单 id 二选一)
openid string 用户的openid

# 回包参数说明

字段名 类型 说明
errcode number 错误码
errmsg string 错误信息
data Order 订单信息

# Order

字段名 类型 说明
create_time string 创建时间,yyyy-MM-dd HH:mm:ss,与微信服务器不得超过5秒
out_order_id string 商家自定义订单ID(字符集包括大小写字幕数字,长度小于128个字符)
openid string 用户的openid
scene number 下单小程序场景值
order_detail OrderDetail 订单详细数据
delivery_detail DeliveryDetail 配送信息
status number 商品状态
path string 订单详情页路径
address_info AddressInfo 地址信息
settlement_info SettlementInfo 订单资金结算信息
refund_info RefundInfo 订单退款信息
related_aftersale_info RelatedAfterSaleInfo 售后单信息
fund_type number 订单类型:0,普通单,1,二级商户单
expire_time number 秒级时间戳,订单超时时间,获取支付参数将使用此时间作为prepay_id 过期时间;时间到期之后,微信会流转订单超时取消(status = 181)
aftersale_duration number 确认收货之后多久禁止发起售后,单位:天,需>=5天,default=5天
promotion_info PromotionInfo 推广员、分享员信息
default_receiving_address AddressInfo 默认退货地址

# OrderDetail

字段名 类型 说明
product_infos OrderProductInfo[] 商品列表
price_info PriceInfo 价格信息
pay_info PayInfo 支付信息

# DeliveryDetail

字段名 类型 说明
delivery_type enum 1: 正常快递, 2: 无需快递, 3: 线下配送, 4: 用户自提,视频号场景目前只支持 1,正常快递
finish_all_delivery number 是否发货完成
delivery_list DeliveryInfo[] 物流信息
delivery_list[].delivery_id string 快递公司ID,通过获取快递公司列表获取
delivery_list[].waybill_id string 快递单号
delivery_list[].product_info_list DeliveryProduct[] 商品信息
delivery_list[].product_info_list[].out_product_id string 商家侧spu id
delivery_list[].product_info_list[].out_sku_id string 商家侧sku id

# RelatedAftersaleInfo

字段名 类型 说明
aftersale_list RelatedAfterSale[] 售后单信息
aftersale_list[].aftersale_id number 微信侧售后单id
aftersale_list[].out_aftersale_id string 商家侧售后单id

# PayInfo

字段名 类型 说明
pay_method_type number 0: 微信支付(目前只有微信支付)
prepay_id string 预支付ID
prepay_time string 预付款时间(拿到prepay_id的时间)
transaction_id string 微信支付流水单号
pay_time string 付款时间,yyyy-MM-dd HH:mm:ss
promotion_detail_info PromotionDetailInfo 微信支付券信息

# PromotionDetailInfo

字段名 类型 说明
promotion_detail_list PromotionDetail[]

# PromotionDetail

字段名 类型 说明
coupon_id string 券ID
name string 优惠名称
scope string 优惠范围
GLOBAL:全场代金券
SINGLE:单品优惠
type string 优惠类型:
CASH:充值型代金券
NOCASH:免充值型代金券
amount number 优惠券面额
stock_id string 活动ID
wechatpay_contribute number 微信出资
merchant_contribute number 商户出资
other_contribute numver 其他出资
goods_detail GoodsDetail[] 单品列表信息

# GoodsDetail

字段名 类型 说明
goods_id string 商品编码
quantity number 商品数量
unit_price number 商品单价
discount_amount number 商品优惠金额
goods_reamark string 商品备注

# OrderProductInfo

字段名 类型 说明
product_id number 商品spuid
out_product_id string 外部商品spuid
sku_id number 商品skuid
out_sku_id string 外部商品skuid
product_cnt number 商品个数
sale_price number 生成订单时商品的售卖价(单位:分),可以跟上传商品接口的价格不一致
sku_real_price number sku总实付价
title string 生成订单时商品的标题
head_img string 生成订单时商品的头图
path string 绑定的小程序商品路径

# AddressInfo

字段名 类型 说明
receiver_name string 收件人姓名
detailed_address string 详细收货地址信息
tel_number string 收件人手机号码
country string 国家
province string 省份
city string 城市
town string 乡镇

# PriceInfo

字段名 类型 说明
freight number 运费
discounted_price number 折扣费用
additional_price number 其他费用
additional_remarks string 其他费用说明
order_price number 订单总价

# PromotionInfo

字段名 类型 说明
promoter_id string 推广员唯一ID
promoter_openid string 推广员openid(废弃,请勿使用)
finder_nickname string 推广员视频号昵称
sharer_openid string 分享员openid

# SettlementInfo

字段名 类型 说明
settlement_list SettlementRecord[] 结算列表
handing_fee number 结算最终收取的支付手续费
settle_status number 商家结算状态,枚举值见settle_status
settle_time string 商家结算时间
settle_abnormal_reason string 结算异常原因

# SettlementRecord

字段名 类型 说明
type number 分账方类型,枚举值见settlement_type
amount number 金额,单位为分
settle_no string 视频号系统分账单号
settle_id string 微信支付系统分账单号
create_time string 分账创建时间
finish_time string 分账完成时间
result string 分账结果,枚举值见settlement_result
fail_reason string 分账失败原因
is_finished number 是否完成分账,0:未完成,1:已完成

# RefundInfo

字段名 类型 说明
refund_list RefundRecord[] 退款列表

# RefundRecord

字段名 类型 说明
type number 退款类型,1:售后退款
amount number 金额,单位为分
refund_no string 视频号系统退款单号
refund_id string 微信支付系统退款单号
create_time string 分账创建时间
finish_time string 分账完成时间
result string 退款结果,枚举值见result_result
fail_reason string 分账失败原因

# status enum

枚举值 描述
10 待付款
11 收银台支付完成(自动流转,对商家来说和10同等对待即可)
20 待发货(即支付完成)
21 部分发货
30 待收货
100 完成
181 超时未支付取消
200 全部商品售后之后取消
250 用户取消

# settle_status enum

枚举值 描述
1 待结算
2 已结算
3 已关闭
4 交易异常

# settlement_type enum

枚举值 描述
0 商家
1 服务商

# settlement_result enum

枚举值 描述
PENDING 待分账
SUCCESS 分账成功
CLOSED 已关闭

# refund_result enum

枚举值 描述
SUCCESS 退款成功
CLOSE 退款关闭
PROCESSING 退款处理中
ABNORMAL 退款异常