视频号订单详情

# 获取订单详情

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/order/get?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	说明
order_id	string	是	订单ID，可从获取订单列表中获得
encode_sensitive_info	bool	否	用于商家提前测试订单脱敏效果，如果传true，即对订单进行脱敏，后期会默认对所有订单脱敏

# 回包参数说明

参数	类型	说明
errcode	number	错误码
errmsg	string	错误信息
order	object Order	订单结构

# Order

字段名	类型	说明
create_time	number	秒级时间戳
update_time	number	秒级时间戳
order_id	string	订单号
status	number	订单状态，枚举值见OrderStatus
openid	string	买家身份标识
unionid	string	买家在开放平台的唯一标识符，若当前视频号小店已绑定到微信开放平台账号下，绑定成功后产生的订单会返回，详见UnionID 机制说明
order_detail	object OrderDetail	订单详细数据信息
aftersale_detail	object AfterSaleDetail	售后信息

# OrderDetail

字段名	类型	说明
product_infos	array ProductInfo	商品列表
price_info	object PriceInfo	价格信息
pay_info	object PayInfo	支付信息
delivery_info	object DeliveryInfo	配送信息
coupon_info	object CouponInfo	优惠券信息
ext_info	object ExtInfo	额外信息
commission_infos	array CommissionInfo	分佣信息
sharer_info	object SharerInfo	分享员信息
settle_info	object SettleInfo	结算信息
sku_sharer_infos	array SkuSharerInfo	分享员信息
agent_info	object AgentInfo	授权账号信息

# ProductInfo

字段名	类型	说明
product_id	number	商品spuid
sku_id	number	商品skuid
thumb_img	string	sku小图
sku_cnt	number	sku数量
sale_price	number	售卖单价（单位：分）
title	string	商品标题
on_aftersale_sku_cnt	number	正在售后/退款流程中的 sku 数量
finish_aftersale_sku_cnt	number	完成售后/退款的 sku 数量
sku_code	string	商品编码
market_price	number	市场单价（单位：分）
sku_attrs	array AtrrInfo	sku属性
real_price	number	sku实付总价，取estimate_price和change_price中较小值
out_product_id	string	商品外部spuid
out_sku_id	string	商品外部skuid
is_discounted	bool	是否有优惠金额，非必填，默认为false
estimate_price	number	优惠后sku总价，非必填，is_discounted为true时有值
is_change_price	bool	是否修改过价格，非必填，默认为false
change_price	number	改价后sku总价，非必填，is_change_price为true时有值
out_warehouse_id	string	区域库存id
sku_deliver_info	SkuDeliverInfo	商品发货信息
extra_service	ProductExtraService	商品额外服务信息
use_deduction	bool	是否使用了会员积分抵扣
deduction_price	number	会员积分抵扣金额，单位为分

# SkuDeliverInfo

字段名	类型	说明
stock_type	number	商品发货类型：0：现货，1：全款预售
predict_delivery_time	number	预计发货时间(stock_type=1时返回该字段)

# ProductExtraService

字段名	类型	说明
seven_day_return	number	7天无理由：0：不支持，1：支持
freight_insurance	number	商家运费险：0：不支持，1：支持

# AttrInfo

字段名	类型	说明
attr_key	string	属性键（属性自定义用）
attr_value	string	属性值（属性自定义用）

# PayInfo

字段名	类型	说明
prepay_id	string	预支付id
prepay_time	number	预支付时间，秒级时间戳
pay_time	number	支付时间，秒级时间戳, 先用后付订单(payment_method=2)本字段的值为用户确认先用后付订单的时间，抽奖0元订单(payment_method=3)或者会员积分兑换订单(payment_method=4)没有发生实际支付，本字段的值为下单时间
transaction_id	string	支付订单号，先用后付订单(payment_method=2)在用户实际扣款前(确认收货时)本字段为空, 抽奖0元订单(payment_method=3)或者会员积分兑换订单(payment_method=4)本字段为空
payment_method	number	支付方式，已支付订单会返回本字段，枚举值见PaymentMethod

# PriceInfo

字段名	类型	说明
product_price	number	商品总价，单位为分
order_price	number	订单金额，单位为分，order_price=original_order_price-discounted_price-deduction_price-change_down_price
freight	number	运费，单位为分
discounted_price	number	优惠券优惠金额，单位为分
is_discounted	bool	是否有优惠券优惠
original_order_price	number	订单原始价格，单位为分，original_order_price=product_price+freight
estimate_product_price	number	商品预估价格，单位为分
change_down_price	number	改价后降低金额，单位为分
change_freight	number	改价后运费，单位为分
is_change_freight	bool	是否修改运费
use_deduction	bool	是否使用了会员积分抵扣
deduction_price	number	会员积分抵扣金额，单位为分

# DeliveryInfo

字段名	类型	说明
address_info	object AddressInfo	地址信息
delivery_product_info	array DeliveryProductInfo	发货物流信息
ship_done_time	number	发货完成时间，秒级时间戳
deliver_method	number	订单发货方式，0：普通物流，1：虚拟发货，由商品的同名字段决定
address_under_review	object AddressInfo	用户下单后申请修改收货地址，商家同意后该字段会覆盖订单地址信息
address_apply_time	number	修改地址申请时间，秒级时间戳
ewaybill_order_code	string	电子面单代发时的订单密文

# DeliveryProductInfo

字段名	类型	说明
waybill_id	string	快递单号
delivery_id	string	快递公司编码
product_infos	array FreightProductInfo	包裹中商品信息
delivery_name	string	快递公司名称
delivery_time	number	发货时间，秒级时间戳
deliver_type	number	配送方式，枚举值见DeliveryType
delivery_address	object AddressInfo	发货地址

# FreightProductInfo

字段名	类型	说明
product_id	string	商品id
sku_id	string	sku_id
product_cnt	number	商品数量

# AddressInfo

字段名	类型	说明
user_name	string	收货人姓名
postal_code	string	邮编
province_name	string	省份
city_name	string	城市
county_name	string	区
detail_info	string	详细地址
national_code	string	国家码，已废弃，请勿使用
tel_number	string	联系方式
house_number	string	门牌号码
virtual_order_tel_number	string	虚拟发货订单联系方式(deliver_method=1时返回)
tel_number_ext_info	TelNumberExtInfo	额外的联系方式信息（虚拟号码相关）
use_tel_number	number	0：不使用虚拟号码，1：使用虚拟号码
hash_code	string	标识当前店铺下一个唯一的用户收货地址

# TelNumberExtInfo

字段名	类型	说明
real_tel_number	string	脱敏手机号
virtual_tel_number	string	完整的虚拟号码
virtual_tel_expire_time	number	主动兑换的虚拟号码过期时间
get_virtual_tel_cnt	number	主动兑换虚拟号码次数

# CouponInfo

字段名	类型	说明
user_coupon_id	string	用户优惠券id

# AfterSaleDetail

字段名	类型	说明
on_aftersale_order_cnt	number	正在售后流程的售后单数
aftersale_order_list	array AfterSaleOrderInfo	售后单列表

# AfterSaleOrderInfo

字段名	类型	说明
aftersale_order_id	number	售后单ID
status	number	售后单状态(已废弃，请勿使用，售后信息请调用售后接口）

# ExtInfo

字段名	类型	说明
customer_notes	string	用户备注
merchant_notes	string	商家备注

# CommissionInfo

字段名	类型	说明
sku_id	number	商品skuid
nickname	string	分账方昵称
type	number	分账方类型，0：达人，1：团长
status	number	分账状态， 1：未结算，2：已结算
amount	number	分账金额
finder_id	string	达人视频号id
openfinderid	string	达人openfinderid

# SharerInfo

字段名	类型	说明
sharer_openid	string	分享员openid
sharer_unionid	string	分享员unionid
sharer_type	number	分享员类型，0：普通分享员，1：店铺分享员
share_scene	number	分享场景，枚举值见ShareScene

# SkuSharerInfo

字段名	类型	说明
sharer_openid	string	分享员openid
sharer_unionid	string	分享员unionid
sharer_type	number	分享员类型，0：普通分享员，1：店铺分享员
share_scene	number	分享场景，枚举值见ShareScene
sku_id	string	商品skuid
from_wecom	bool	是否来自企微分享

# SettleInfo

字段名	类型	说明
predict_commission_fee	number	预计技术服务费（单位为分）
commission_fee	number	实际技术服务费（单位为分）（未结算时本字段为空）
predict_wecoin_commission	number	预计人气卡返佣金额（单位为分）（未发起结算时本字段为空）
wecoin_commission	number	实际人气卡返佣金额（单位为分）（未结算时本字段为空）

# AgentInfo

字段名	类型	说明
agent_finder_id	string	授权视频号id
agent_finder_nickname	string	授权视频号昵称

# 枚举-OrderStatus

枚举值	描述
10	待付款
20	待发货
21	部分发货
30	待收货
100	完成
200	全部商品售后之后，订单取消
250	未付款用户主动取消或超时未付款订单自动取消

# 枚举-DeliveryType

枚举值	描述
1	自寄快递
2	在线签约快递单
3	虚拟商品无需物流发货
4	在线快递散单

# 枚举-ShareScene

枚举值	描述
1	直播间
2	橱窗
3	短视频
4	视频号主页
5	商品详情页
6	带商品的公众号文章

# 枚举-PaymentMethod

枚举值	描述
1	微信支付
2	先用后付
3	抽奖商品0元订单
4	会员积分兑换订单