# 获取订单详情 > 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。 接口英文名：getorder 可通过该接口获取订单的详细信息。 相关事件通知： - [订单下单事件推送](/apishow?id=1000196) - [订单取消事件推送](/apishow?id=1000197) - [订单支付成功事件推送](/apishow?id=1000198) - [订单待发货事件推送](/apishow?id=1000199) - [订单发货事件推送](/apishow?id=1000200) - [订单确认收货事件推送](/apishow?id=1000201) - [订单结算成功事件推送](/apishow?id=1000202) - [订单其他信息更新](/apishow?id=1000203) ## 1. 调用方式 ### HTTPS 调用 ```bash POST https://api.weixin.qq.com/channels/ec/order/get?access_token=ACCESS_TOKEN ``` ### 云调用 - 调用方法：channels.ec.order.get - 出入参和 HTTPS 调用相同，调用方式可查看 [云调用](/doc/oplatform/developers/dev/cloudCall.md) 说明文档。 ### 第三方调用 - 本接口支持第三方平台代商家调用。 - 该接口所属的权限集 id 为：131 - 服务商获得其中之一权限集授权后，可通过使用 [authorizer_access_token](/doc/oplatform/developers/dev/AuthorizerAccessToken.md) 代商家进行调用，具体可查看 [第三方调用](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/call_interface.md) 说明文档。 ## 2. 请求参数 ### 查询参数 `Query String Parameters` ```json [ { "参数名": "access_token", "类型": "string", "必填": "是", "说明": "接口调用凭证，可使用 [access_token](/doc/channels/api/basic/api_getaccesstoken)、[authorizer_access_token](/doc/oplatform/openApi/ticket-token/api_getauthorizeraccesstoken.md)" } ] ``` ### 请求体 `Request Payload` ```json [ { "参数名": "order_id", "类型": "string", "必填": "是", "示例": "3700000000000000001", "说明": "订单 ID，可通过 [获取订单列表](/doc/store/shop/API/channels-shop-order/api_getorderlist.md) 接口获取" } ] ``` ## 3. 返回参数 ### 返回体 `Response Payload` ```json [ { "参数名": "errcode", "类型": "number", "示例": "0", "说明": "错误码" }, { "参数名": "errmsg", "类型": "string", "示例": "ok", "说明": "错误信息" }, { "参数名": "order", "类型": "object", "示例": "", "说明": "订单结构" } ] ``` ### Res.order `Object Payload` 订单结构 ```json [ { "参数名": "order_id", "类型": "number", "说明": "订单ID", "枚举": "-" }, { "参数名": "create_time", "类型": "number", "说明": "创建时间，秒级时间戳", "枚举": "-" }, { "参数名": "update_time", "类型": "number", "说明": "更新时间，秒级时间戳", "枚举": "-" }, { "参数名": "status", "类型": "number", "说明": "订单状态", "枚举": "枚举值" }, { "参数名": "order_detail", "类型": "object", "说明": "订单详细数据信息", "枚举": "-" }, { "参数名": "aftersale_detail", "类型": "object", "说明": "售后信息", "枚举": "-" }, { "参数名": "openid", "类型": "string", "说明": "订单归属人身份标识，在自购场景为支付者（买家），在礼物场景为收礼者", "枚举": "-" }, { "参数名": "unionid", "类型": "string", "说明": "订单归属人在开放平台的唯一标识符，在自购场景为支付者（买家），在礼物场景为收礼者，若当前微信小店已绑定到微信开放平台账号下，绑定成功后产生的订单会返回，详见[UnionID 机制说明](/doc/store/shop/dev_before/UnionID.md)", "枚举": "-" }, { "参数名": "is_present", "类型": "boolean", "说明": "是否礼物订单", "枚举": "-" }, { "参数名": "present_order_id", "类型": "number", "说明": "礼物id【废弃】", "枚举": "-" }, { "参数名": "present_note", "类型": "string", "说明": "礼物订单留言", "枚举": "-" }, { "参数名": "present_giver_openid", "类型": "string", "说明": "礼物订单赠送者openid,仅送礼订单返回该字段", "枚举": "-" }, { "参数名": "present_giver_unionid", "类型": "string", "说明": "礼物订单赠送者在开放平台的唯一标识符，若当前微信小店已绑定到微信开放平台账号下，绑定成功后产生的订单会返回，详见[UnionID 机制说明](/doc/store/shop/dev_before/UnionID.md)", "枚举": "-" }, { "参数名": "present_order_id_str", "类型": "number", "说明": "礼物订单ID", "枚举": "-" }, { "参数名": "present_send_type", "类型": "number", "说明": "礼物单类型", "枚举": "枚举值" }, { "参数名": "order_present_info", "类型": "object", "说明": "订单对应礼物单信息", "枚举": "-" }, { "参数名": "is_flash_sale_order", "类型": "boolean", "说明": "是否闪购订单", "枚举": "-" }, { "参数名": "intra_city_order_info", "类型": "object", "说明": "同城单信息", "枚举": "-" }, { "参数名": "voucher_order_status", "类型": "number", "说明": "本地生活订单预约状态", "枚举": "枚举值" }, { "参数名": "user_info", "类型": "object", "说明": "潮玩订单用户信息", "枚举": "-" }, { "参数名": "risk_info", "类型": "object", "说明": "订单风控信息", "枚举": "-" } ] ``` ### Res.order.order_detail `Object Payload` 订单详细数据信息 ```json [ { "参数名": "product_infos", "类型": "objarray", "说明": "商品列表" }, { "参数名": "pay_info", "类型": "object", "说明": "支付信息" }, { "参数名": "price_info", "类型": "object", "说明": "价格信息" }, { "参数名": "delivery_info", "类型": "object", "说明": "配送信息" }, { "参数名": "ext_info", "类型": "object", "说明": "额外信息" }, { "参数名": "coupon_info", "类型": "object", "说明": "优惠券信息" }, { "参数名": "commission_infos", "类型": "objarray", "说明": "分佣信息" }, { "参数名": "sharer_info", "类型": "object", "说明": "分享员信息【已经下线，不再维护】" }, { "参数名": "settle_info", "类型": "object", "说明": "结算信息" }, { "参数名": "sku_sharer_infos", "类型": "objarray", "说明": "分享员信息【已经下线，不再维护】" }, { "参数名": "agent_info", "类型": "object", "说明": "授权账号信息" }, { "参数名": "source_infos", "类型": "objarray", "说明": "订单来源信息" }, { "参数名": "refund_info", "类型": "object", "说明": "订单退款信息" }, { "参数名": "greeting_card_info", "类型": "object", "说明": "需代写的商品贺卡信息" }, { "参数名": "custom_info", "类型": "object", "说明": "商品定制信息" }, { "参数名": "guide_info", "类型": "object", "说明": "订单导购信息" } ] ``` "> ### Res.order.order_detail.product_infos(Array) `Object Payload` 商品列表 ```json [ { "参数名": "product_id", "类型": "number", "说明": "商品id" }, { "参数名": "sku_id", "类型": "number", "说明": "商品skuid" }, { "参数名": "thumb_img", "类型": "string", "说明": "sku小图" }, { "参数名": "sale_price", "类型": "number", "说明": "售卖单价，单位为分" }, { "参数名": "sku_cnt", "类型": "number", "说明": "sku数量" }, { "参数名": "title", "类型": "string", "说明": "商品标题" }, { "参数名": "on_aftersale_sku_cnt", "类型": "number", "说明": "正在售后/退款流程中的 sku 数量" }, { "参数名": "finish_aftersale_sku_cnt", "类型": "number", "说明": "完成售后/退款的 sku 数量" }, { "参数名": "sku_code", "类型": "string", "说明": "sku编码（商家自定义编码）" }, { "参数名": "market_price", "类型": "number", "说明": "市场单价，单位为分" }, { "参数名": "sku_attrs", "类型": "objarray", "说明": "sku属性" }, { "参数名": "real_price", "类型": "number", "说明": "sku实付总价，取estimate_price和change_price中较小值" }, { "参数名": "out_product_id", "类型": "string", "说明": "商品外部spuid" }, { "参数名": "out_sku_id", "类型": "string", "说明": "商品外部skuid" }, { "参数名": "is_discounted", "类型": "boolean", "说明": "是否有商家优惠金额，非必填，默认为false" }, { "参数名": "estimate_price", "类型": "number", "说明": "使用所有优惠后sku总价，非必填，有优惠金额时必填" }, { "参数名": "is_change_price", "类型": "boolean", "说明": "是否修改过价格，非必填，默认为false" }, { "参数名": "change_price", "类型": "number", "说明": "改价后sku总价，非必填，is_change_price为true时有值" }, { "参数名": "out_warehouse_id", "类型": "string", "说明": "区域库存id" }, { "参数名": "sku_deliver_info", "类型": "object", "说明": "商品发货信息" }, { "参数名": "extra_service", "类型": "object", "说明": "商品额外服务信息" }, { "参数名": "use_deduction", "类型": "boolean", "说明": "是否使用了会员积分抵扣" }, { "参数名": "deduction_price", "类型": "number", "说明": "会员积分抵扣金额，单位为分" }, { "参数名": "voucher_list", "类型": "objarray", "说明": "本地生活券码信息" }, { "参数名": "order_product_coupon_info_list", "类型": "objarray", "说明": "商品优惠券信息。逐步替换 order.order_detail.coupon_info" }, { "参数名": "delivery_deadline", "类型": "number", "说明": "商品发货时效，超时此时间未发货即为发货超时" }, { "参数名": "merchant_discounted_price", "类型": "number", "说明": "商家优惠金额，单位为分" }, { "参数名": "finder_discounted_price", "类型": "number", "说明": "达人优惠金额，单位为分" }, { "参数名": "is_free_gift", "类型": "number", "说明": "是否赠品，非必填，赠品商品返回，1:是赠品" }, { "参数名": "vip_discounted_price", "类型": "number", "说明": "订单内商品维度会员权益优惠金额" }, { "参数名": "product_unique_id", "类型": "string", "说明": "商品常量编号，订单内商品唯一标识，下单后不会发生变化" }, { "参数名": "change_sku_info", "类型": "object", "说明": "收礼后发货前更换sku信息" }, { "参数名": "free_gift_info", "类型": "object", "说明": "赠品信息" }, { "参数名": "bulkbuy_discounted_price", "类型": "number", "说明": "订单内商品维度一起买优惠金额" }, { "参数名": "national_subsidy_discounted_price", "类型": "number", "说明": "订单内商品维度国补优惠金额" }, { "参数名": "dropship_info", "类型": "object", "说明": "代发单相关信息" }, { "参数名": "is_flash_sale", "类型": "boolean", "说明": "是否闪购商品" }, { "参数名": "national_subsidy_merchant_discounted_price", "类型": "number", "说明": "订单内商品维度地方补贴优惠金额(商家出资)" }, { "参数名": "platform_activity_merchant_discounted_price", "类型": "number", "说明": "订单内商品维度活动商家补贴，即参与平台补贴活动时商家通过活动报名价优惠的部分" }, { "参数名": "cash_coupon_discounted_price", "类型": "number", "说明": "订单内商品维度平台券优惠金额" }, { "参数名": "limited_discount_discounted_price", "类型": "number", "说明": "限时抢购优惠金额" }, { "参数名": "normal_friends_like_discounted_price", "类型": "number", "说明": "商家点赞买优惠金额" }, { "参数名": "supply_order_product_info", "类型": "object", "说明": "供货单相关信息" }, { "参数名": "custom_info", "类型": "object", "说明": "商品定制信息" }, { "参数名": "sku_merchant_receive_amount", "类型": "number", "说明": "订单内商品维度商家实收金额（含平台补贴分摊）" }, { "参数名": "accept_change_sku_info", "类型": "object", "说明": "收礼更换sku相关信息" }, { "参数名": "order_product_item_list", "类型": "object", "说明": "订单中同一sku_id下每件商品的具体信息" }, { "参数名": "voucher_product_info", "类型": "object", "说明": "本地生活信息" }, { "参数名": "dropship_info_list", "类型": "objarray", "说明": "商品代发信息列表（拆件分配场景，每份对应一条；整体分配请使用 dropship_info）" }, { "参数名": "point_discounted_price", "类型": "number", "说明": "订单内商品维度小店金币抵扣优惠金额" } ] ``` __sku_attrs"> ### Res.order.order_detail.product_infos(Array).sku_attrs `Object Payload` sku属性 ```json [ { "参数名": "attr_key", "类型": "string", "说明": "属性键（属性自定义用）" }, { "参数名": "attr_value", "类型": "string", "说明": "属性值value（属性自定义用），参数规则如下：\n● 当[获取类目信息接口](/doc/store/shop/API/channels-shop-category/api_getallcategory.md)中返回的type：为 select_many，\nattr_value的格式：多个选项用分号;隔开\n示例：某商品的适用人群属性，选择了：青年、中年，则 attr_value的值为：青年;中年\n● 当[获取类目信息接口](/doc/store/shop/API/channels-shop-category/api_getallcategory.md)中返回的type：为 integer_unit/decimal4_unit\nattr_value格式：数值 单位，用单个空格隔开\n示例：某商品的重量属性，要求integer_unit属性类型，数值部分为 18，单位选择为kg，则 attr_value的值为：18 kg\n● 当[获取类目信息接口](/doc/store/shop/API/channels-shop-category/api_getallcategory.md)中返回的type：为 integer/decimal4\nattr_value 的格式：字符串形式的数字" } ] ``` __sku_deliver_info"> ### Res.order.order_detail.product_infos(Array).sku_deliver_info `Object Payload` 商品发货信息 ```json [ { "参数名": "stock_type", "类型": "number", "说明": "商品发货类型：0：现货，1：全款预售" }, { "参数名": "predict_delivery_time", "类型": "number", "说明": "预计发货时间(stock_type=1时返回该字段)" }, { "参数名": "full_payment_presale_delivery_type", "类型": "number", "说明": "预售类型0：付款后n天发货 , 1:预售结束后n天发货" } ] ``` __extra_service"> ### Res.order.order_detail.product_infos(Array).extra_service `Object Payload` 商品额外服务信息 ```json [ { "参数名": "seven_day_return", "类型": "number", "说明": "7天无理由：0：不支持，1：支持" }, { "参数名": "freight_insurance", "类型": "number", "说明": "商家运费险：0：不支持，1：支持" } ] ``` __voucher_list"> ### Res.order.order_detail.product_infos(Array).voucher_list `Object Payload` 本地生活券码信息 ```json [ { "参数名": "voucher_code", "类型": "string", "说明": "团购优惠券码", "枚举": "-" }, { "参数名": "time_index", "类型": "number", "说明": "次序号标识。\n次卡返回此参数，非次卡不返回此参数", "枚举": "-" }, { "参数名": "voucher_type", "类型": "number", "说明": "券类型", "枚举": "枚举值" }, { "参数名": "voucher_buy_amount", "类型": "number", "说明": "券的售卖价格（分），如果有平台补贴，即为用户实际支付金额加上平台补贴金额。\n如为次卡，则为单次（次序号）对应的售卖价格", "枚举": "-" } ] ``` __order_product_coupon_info_list"> ### Res.order.order_detail.product_infos(Array).order_product_coupon_info_list `Object Payload` 商品优惠券信息。逐步替换 order.order_detail.coupon_info ```json [ { "参数名": "user_coupon_id", "类型": "string", "说明": "用户优惠券id", "枚举": "-" }, { "参数名": "coupon_type", "类型": "number", "说明": "优惠券类型", "枚举": "枚举值" }, { "参数名": "discounted_price", "类型": "number", "说明": "优惠金额，单位为分，该张优惠券、抵扣该商品的金额", "枚举": "-" }, { "参数名": "coupon_id", "类型": "string", "说明": "优惠券id", "枚举": "-" } ] ``` __change_sku_info"> ### Res.order.order_detail.product_infos(Array).change_sku_info `Object Payload` 收礼后发货前更换sku信息 ```json [ { "参数名": "preshipment_change_sku_state", "类型": "number", "说明": "发货前更换sku状态。3：等待商家处理，4：商家审核通过，5：商家拒绝，6：用户主动取消，7：超时默认拒绝" }, { "参数名": "old_sku_id", "类型": "number", "说明": "原sku_id" }, { "参数名": "new_sku_id", "类型": "number", "说明": "用户申请更换的sku_id" }, { "参数名": "ddl_time_stamp", "类型": "number", "说明": "商家处理请求的最后时间，只有当前换款请求处于\"等待商家处理\"才有值" } ] ``` __free_gift_info"> ### Res.order.order_detail.product_infos(Array).free_gift_info `Object Payload` 赠品信息 ```json [ { "参数名": "main_product_list", "类型": "objarray", "说明": "赠品对应的主品信息" } ] ``` __free_gift_info__main_product_list"> ### Res.order.order_detail.product_infos(Array).free_gift_info.main_product_list `Object Payload` 赠品对应的主品信息 ```json [ { "参数名": "gift_cnt", "类型": "number", "说明": "赠品数量" }, { "参数名": "task_id", "类型": "number", "说明": "活动id" }, { "参数名": "product_id", "类型": "number", "说明": "商品id" }, { "参数名": "sku_id", "类型": "number", "说明": "主品sku_id" } ] ``` __dropship_info"> ### Res.order.order_detail.product_infos(Array).dropship_info `Object Payload` 代发单相关信息 ```json [ { "参数名": "ds_order_id", "类型": "number", "说明": "代发单号" } ] ``` __supply_order_product_info"> ### Res.order.order_detail.product_infos(Array).supply_order_product_info `Object Payload` 供货单相关信息 ```json [ { "参数名": "supply_order_id", "类型": "number", "说明": "供货单号" } ] ``` __custom_info"> ### Res.order.order_detail.product_infos(Array).custom_info `Object Payload` 商品定制信息 ```json [ { "参数名": "custom_img_url", "类型": "string", "说明": "定制图片，custom_type=2时返回", "枚举": "-" }, { "参数名": "custom_word", "类型": "string", "说明": "定制文字，custom_type=1时返回", "枚举": "-" }, { "参数名": "custom_type", "类型": "number", "说明": "定制类型", "枚举": "枚举值" }, { "参数名": "custom_preview_img_url", "类型": "string", "说明": "定制预览图片，开启了定制预览时返回", "枚举": "-" } ] ``` __accept_change_sku_info"> ### Res.order.order_detail.product_infos(Array).accept_change_sku_info `Object Payload` 收礼更换sku相关信息 ```json [ { "参数名": "change_sku", "类型": "number", "说明": "收礼是否更换sku，1表示收礼进行了更换" }, { "参数名": "old_sku_id", "类型": "number", "说明": "change_sku=1展示，表示旧sku_id" }, { "参数名": "receiver_choose_sku", "类型": "number", "说明": "收礼者是否拉起过选一款半屏，1表示拉起过" } ] ``` __order_product_item_list"> ### Res.order.order_detail.product_infos(Array).order_product_item_list `Object Payload` 订单中同一sku_id下每件商品的具体信息 ```json [ { "参数名": "item_unique_id", "类型": "string", "说明": "订单中某件商品的常量编号，订单内每一件商品的唯一标识，下单后不会发生变化" }, { "参数名": "blind_box_info", "类型": "object", "说明": "潮玩拆盒信息" } ] ``` __order_product_item_list__blind_box_info"> ### Res.order.order_detail.product_infos(Array).order_product_item_list.blind_box_info `Object Payload` 潮玩拆盒信息 ```json [ { "参数名": "blind_box_series_id", "类型": "string", "说明": "盲盒系列id" }, { "参数名": "out_series_id", "类型": "string", "说明": "盲盒系列外部id" }, { "参数名": "blind_box_item_id", "类型": "string", "说明": "盲盒款式id" }, { "参数名": "title", "类型": "string", "说明": "盲盒款式标题" }, { "参数名": "img_url", "类型": "string", "说明": "盲盒款式图片链接" }, { "参数名": "unwrap_time", "类型": "number", "说明": "拆盒时间" } ] ``` __voucher_product_info"> ### Res.order.order_detail.product_infos(Array).voucher_product_info `Object Payload` 本地生活信息 ```json [ { "参数名": "need_appointment", "类型": "number", "说明": "是否需要预约" } ] ``` ### Res.order.order_detail.pay_info `Object Payload` 支付信息 ```json [ { "参数名": "payment_method", "类型": "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)本字段为空\n[查询订单流水列表](/doc/store/shop/API/funds/funds/api_listorderflow.md)", "枚举": "-" } ] ``` ### Res.order.order_detail.price_info `Object Payload` 价格信息 ```json [ { "参数名": "product_price", "类型": "number", "说明": "商品总价，单位为分" }, { "参数名": "order_price", "类型": "number", "说明": "用户实付金额，单位为分order_price=original_order_price-discounted_price-finder_discounted_price-deduction_price-change_down_price-bulkbuy_discounted_price-national_subsidy_discounted_price-cash_coupon_discounted_price-\nnational_subsidy_merchant_discounted_price-\nplatform_activity_merchant_discounted_price-point_discounted_price" }, { "参数名": "freight", "类型": "number", "说明": "运费，单位为分" }, { "参数名": "discounted_price", "类型": "number", "说明": "商家优惠金额，单位为分，非必填，有商家优惠时返回" }, { "参数名": "is_discounted", "类型": "boolean", "说明": "是否有商家优惠券优惠" }, { "参数名": "original_order_price", "类型": "number", "说明": "订单原始价格，单位为分，original_order_price=product_price+freigh" }, { "参数名": "estimate_product_price", "类型": "number", "说明": "商品预估价格，单位为分" }, { "参数名": "change_down_price", "类型": "number", "说明": "改价后降低金额，单位为分" }, { "参数名": "change_freight", "类型": "number", "说明": "改价后运费，单位为分" }, { "参数名": "is_change_freight", "类型": "boolean", "说明": "是否修改运费" }, { "参数名": "use_deduction", "类型": "boolean", "说明": "是否使用了会员积分抵扣" }, { "参数名": "deduction_price", "类型": "number", "说明": "会员积分抵扣金额，单位为分" }, { "参数名": "merchant_receieve_price", "类型": "number", "说明": "商家实收金额，单位为分" }, { "参数名": "merchant_discounted_price", "类型": "number", "说明": "商家优惠金额，单位为分，含义同discounted_price，必填" }, { "参数名": "finder_discounted_price", "类型": "number", "说明": "达人优惠金额，单位为分" }, { "参数名": "vip_discounted_price", "类型": "number", "说明": "订单维度会员权益优惠金额" }, { "参数名": "bulkbuy_discounted_price", "类型": "number", "说明": "订单维度一起买优惠金额" }, { "参数名": "national_subsidy_discounted_price", "类型": "number", "说明": "订单维度国补优惠金额" }, { "参数名": "cash_coupon_discounted_price", "类型": "number", "说明": "订单维度平台券优惠金额" }, { "参数名": "national_subsidy_merchant_discounted_price", "类型": "number", "说明": "订单维度地方补贴优惠(商家出资)" }, { "参数名": "platform_activity_merchant_discounted_price", "类型": "number", "说明": "活动商家补贴，即参与平台补贴活动时商家通过活动报名价优惠的部分" }, { "参数名": "limited_discount_discounted_price", "类型": "number", "说明": "限时抢购优惠金额" }, { "参数名": "normal_friends_like_discounted_price", "类型": "number", "说明": "商家点赞买优惠金额" }, { "参数名": "point_discounted_price", "类型": "number", "说明": "订单维度小店金币抵扣优惠金额" } ] ``` ### Res.order.order_detail.delivery_info `Object Payload` 配送信息 ```json [ { "参数名": "address_info", "类型": "object", "说明": "地址信息" }, { "参数名": "delivery_product_info", "类型": "objarray", "说明": "发货物流信息" }, { "参数名": "ship_done_time", "类型": "number", "说明": "发货完成时间，秒级时间戳" }, { "参数名": "deliver_method", "类型": "number", "说明": "订单发货方式，0：普通物流，1/3 虚拟发货，由商品的同名字段决定" }, { "参数名": "address_under_review", "类型": "object", "说明": "用户下单后申请修改收货地址，商家同意后该字段会覆盖订单地址信息" }, { "参数名": "address_apply_time", "类型": "number", "说明": "修改地址申请时间，秒级时间戳" }, { "参数名": "recharge_info", "类型": "object", "说明": "当deliver_method=3的时候返回，虚拟商品充值账户信息" }, { "参数名": "ewaybill_order_code", "类型": "string", "说明": "电子面单跨店铺取号的订单密钥" }, { "参数名": "quality_inspect_type", "类型": "number", "说明": "订单质检类型\n2：生鲜类质检；\n1：珠宝玉石类质检；\n0：不需要；\n不传递本字段表示不需要" }, { "参数名": "quality_inspect_info", "类型": "object", "说明": "质检信息，quality_inspect_type>0时返回" }, { "参数名": "dropship_flag", "类型": "number", "说明": "供货商代发标记：\n0: 不可代发;\n1: 未分配代发;\n2: 部分分配;\n3: 已分配.\n可结合商品列表 dropship_info 判断具体商品维度代发情况。订单分配逻辑，详见[订单分配API](/doc/store/shop/API/supplier/order/api_dropship_assign.md)" }, { "参数名": "predict_delivery_time", "类型": "number", "说明": "预计发货时间" }, { "参数名": "delivery_time_type", "类型": "number", "说明": "发货时效类型：\n1: 正常发货；\n2: 发货协商；\n3: 发货报备.\n4: 用户预约;\n100: 用户预约暂不发货." }, { "参数名": "intracity_delivery_flag", "类型": "number", "说明": "同城发货标记：\n1：同城发货;" }, { "参数名": "express_type", "类型": "number", "说明": "物流履约方式，枚举值见ExpressType。\n枚举1=偏远中转" }, { "参数名": "sn_code_flag", "类型": "number", "说明": "SN码标记 1: 发货时需要传入SN码" }, { "参数名": "sn_info", "类型": "object", "说明": "SN码信息" } ] ``` ### Res.order.order_detail.delivery_info.address_info `Object Payload` 地址信息 ```json [ { "参数名": "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", "类型": "object", "说明": "额外的联系方式信息（虚拟号码相关）" }, { "参数名": "use_tel_number", "类型": "number", "说明": "0：不使用虚拟号码，1：使用虚拟号码" }, { "参数名": "hash_code", "类型": "string", "说明": "标识当前店铺下一个唯一的用户收货地址" } ] ``` ### Res.order.order_detail.delivery_info.address_info.tel_number_ext_info `Object Payload` 额外的联系方式信息（虚拟号码相关） ```json [ { "参数名": "real_tel_number", "类型": "string", "说明": "脱敏手机号" }, { "参数名": "virtual_tel_number", "类型": "string", "说明": "完整的虚拟号码" }, { "参数名": "virtual_tel_expire_time", "类型": "number", "说明": "虚拟号过期时间" }, { "参数名": "has_delay_times", "类型": "number", "说明": "已延期次数" } ] ``` "> ### Res.order.order_detail.delivery_info.delivery_product_info(Array) `Object Payload` 发货物流信息 ```json [ { "参数名": "waybill_id", "类型": "string", "说明": "快递单号", "枚举": "-" }, { "参数名": "delivery_id", "类型": "string", "说明": "快递公司编码", "枚举": "-" }, { "参数名": "product_infos", "类型": "objarray", "说明": "包裹中商品信息", "枚举": "-" }, { "参数名": "delivery_name", "类型": "string", "说明": "快递公司名称", "枚举": "-" }, { "参数名": "delivery_time", "类型": "number", "说明": "发货时间，秒级时间戳", "枚举": "-" }, { "参数名": "deliver_type", "类型": "number", "说明": "配送方式", "枚举": "枚举值" }, { "参数名": "extra_logistics_info", "类型": "objarray", "说明": "偏远中转订单的B段运单信息，A段单号为原waybill_id字段", "枚举": "-" } ] ``` __product_infos"> ### Res.order.order_detail.delivery_info.delivery_product_info(Array).product_infos `Object Payload` 包裹中商品信息 ```json [ { "参数名": "product_id", "类型": "number", "说明": "商品id" }, { "参数名": "sku_id", "类型": "number", "说明": "sku_id" }, { "参数名": "product_cnt", "类型": "number", "说明": "商品数量" } ] ``` __extra_logistics_info"> ### Res.order.order_detail.delivery_info.delivery_product_info(Array).extra_logistics_info `Object Payload` 偏远中转订单的B段运单信息，A段单号为原waybill_id字段 ```json [ { "参数名": "waybill_id", "类型": "string", "说明": "B段快递单号" }, { "参数名": "delivery_id", "类型": "string", "说明": "B段快递公司编码" }, { "参数名": "warehouse_address", "类型": "object", "说明": "中转仓信息（B段运单发货地）" } ] ``` __extra_logistics_info__warehouse_address"> ### Res.order.order_detail.delivery_info.delivery_product_info(Array).extra_logistics_info.warehouse_address `Object Payload` 中转仓信息（B段运单发货地） ```json [ { "参数名": "name", "类型": "string", "说明": "中转仓收货人姓名" }, { "参数名": "mobile", "类型": "string", "说明": "联系方式（中转仓官方客服电话）" }, { "参数名": "province", "类型": "string", "说明": "中转仓所在省份" }, { "参数名": "city", "类型": "string", "说明": "中转仓所在城市" }, { "参数名": "country", "类型": "string", "说明": "中转仓所在区域" }, { "参数名": "street", "类型": "string", "说明": "中转仓所在街道" }, { "参数名": "address", "类型": "string", "说明": "中转仓详细地址" } ] ``` ### Res.order.order_detail.delivery_info.address_under_review `Object Payload` 用户下单后申请修改收货地址，商家同意后该字段会覆盖订单地址信息 ```json [ { "参数名": "user_name", "类型": "string", "说明": "收货人姓名" }, { "参数名": "postal_code", "类型": "string", "说明": "邮编" }, { "参数名": "province_name", "类型": "string", "说明": "省份" }, { "参数名": "city_name", "类型": "string", "说明": "城市" }, { "参数名": "county_name", "类型": "string", "说明": "区" }, { "参数名": "detail_info", "类型": "string", "说明": "详细地址" }, { "参数名": "tel_number", "类型": "string", "说明": "联系方式" }, { "参数名": "house_number", "类型": "string", "说明": "门牌号码" }, { "参数名": "virtual_order_tel_number", "类型": "string", "说明": "虚拟发货订单联系方式(deliver_method=1时返回)，具体结构请参考TelNumberExtInfo结构体" }, { "参数名": "tel_number_ext_info", "类型": "object", "说明": "额外的联系方式信息（虚拟号码相关）" }, { "参数名": "use_tel_number", "类型": "number", "说明": "0：不使用虚拟号码，1：使用虚拟号码" }, { "参数名": "hash_code", "类型": "string", "说明": "标识当前店铺下一个唯一的用户收货地址" } ] ``` ### Res.order.order_detail.delivery_info.address_under_review.tel_number_ext_info `Object Payload` 额外的联系方式信息（虚拟号码相关） ```json [ { "参数名": "real_tel_number", "类型": "string", "说明": "脱敏手机号" }, { "参数名": "virtual_tel_number", "类型": "string", "说明": "完整的虚拟号码" }, { "参数名": "get_virtual_tel_cnt", "类型": "number", "说明": "主动兑换虚拟号码次数" }, { "参数名": "virtual_tel_expire_time", "类型": "number", "说明": "主动兑换的虚拟号码过期时间" } ] ``` ### Res.order.order_detail.delivery_info.recharge_info `Object Payload` 当deliver_method=3的时候返回，虚拟商品充值账户信息 ```json [ { "参数名": "account_no", "类型": "string", "说明": "虚拟商品充值账号，当account_type=qq或phone_number或mail的时候返回" }, { "参数名": "account_type", "类型": "string", "说明": "账号充值类型，可选项: weixin(微信号),qq(qq),phone_number(电话号码),mail(邮箱)" }, { "参数名": "wx_openid", "类型": "string", "说明": "当account_type=\"weixin\"的时候返回" } ] ``` ### Res.order.order_detail.delivery_info.quality_inspect_info `Object Payload` 质检信息，quality_inspect_type>0时返回 ```json [ { "参数名": "inspect_status", "类型": "number", "说明": "质检状态", "枚举": "枚举值" } ] ``` ### Res.order.order_detail.delivery_info.sn_info `Object Payload` SN码信息 ```json [ { "参数名": "sn_code", "类型": "string", "说明": "-" } ] ``` ### Res.order.order_detail.ext_info `Object Payload` 额外信息 ```json [ { "参数名": "customer_notes", "类型": "string", "说明": "用户备注", "枚举": "-" }, { "参数名": "merchant_notes", "类型": "string", "说明": "商家备注", "枚举": "-" }, { "参数名": "confirm_receipt_time", "类型": "number", "说明": "确认收货时间，包括用户主动确认收货和超时自动确认收货", "枚举": "-" }, { "参数名": "finder_id", "类型": "string", "说明": "视频号id", "枚举": "-" }, { "参数名": "live_id", "类型": "string", "说明": "直播id", "枚举": "-" }, { "参数名": "order_scene", "类型": "number", "说明": "下单场景", "枚举": "枚举值" }, { "参数名": "vip_order_session_id", "类型": "string", "说明": "会员权益-session_id", "枚举": "-" }, { "参数名": "commission_handling_progress", "类型": "number", "说明": "用于判断分佣单是否已生成【0：未生成 1:已生成】", "枚举": "-" }, { "参数名": "merchant_notes_tag_color", "类型": "number", "说明": "商家备注颜色", "枚举": "-" } ] ``` ### Res.order.order_detail.coupon_info `Object Payload` 优惠券信息 ```json [ { "参数名": "user_coupon_id", "类型": "number", "说明": "用户优惠券id" } ] ``` "> ### Res.order.order_detail.commission_infos(Array) `Object Payload` 分佣信息 ```json [ { "参数名": "sku_id", "类型": "number", "说明": "商品skuid" }, { "参数名": "nickname", "类型": "string", "说明": "分账方昵称" }, { "参数名": "type", "类型": "number", "说明": "分账方类型，0：达人【对应的可能为 finder_id，或者为 talent_id】，1：带货机构" }, { "参数名": "status", "类型": "number", "说明": "分账状态， 1：未结算，2：已结算" }, { "参数名": "amount", "类型": "number", "说明": "分账金额" }, { "参数名": "finder_id", "类型": "string", "说明": "达人视频号id" }, { "参数名": "openfinderid", "类型": "string", "说明": "达人openfinderid" }, { "参数名": "talent_id", "类型": "string", "说明": "新带货达人 id" }, { "参数名": "agency_id", "类型": "string", "说明": "带货机构 id" } ] ``` ### Res.order.order_detail.sharer_info `Object Payload` 分享员信息【已经下线，不再维护】 ```json [ { "参数名": "sharer_openid", "类型": "string", "说明": "分享员openid", "枚举": "-" }, { "参数名": "sharer_unionid", "类型": "string", "说明": "分享员unionid", "枚举": "-" }, { "参数名": "sharer_type", "类型": "number", "说明": "分享员类型，0：普通分享员，1：店铺分享员", "枚举": "-" }, { "参数名": "share_scene", "类型": "number", "说明": "分享场景", "枚举": "枚举值" }, { "参数名": "handling_progress", "类型": "number", "说明": "分享员数据是否已经解析完成【1:解析完成 0:解析中】", "枚举": "-" } ] ``` ### Res.order.order_detail.settle_info `Object Payload` 结算信息 ```json [ { "参数名": "predict_commission_fee", "类型": "number", "说明": "预计技术服务费，单位为分" }, { "参数名": "commission_fee", "类型": "number", "说明": "实际技术服务费，单位为分（未发起结算时本字段为空）" }, { "参数名": "predict_wecoin_commission", "类型": "number", "说明": "预计人气卡返佣金额，单位为分" }, { "参数名": "wecoin_commission", "类型": "number", "说明": "实际人气卡返佣金额，单位为分（未发起结算时本字段为空）" }, { "参数名": "settle_time", "类型": "number", "说明": "商家结算时间" } ] ``` "> ### Res.order.order_detail.sku_sharer_infos(Array) `Object Payload` 分享员信息【已经下线，不再维护】 ```json [ { "参数名": "sharer_openid", "类型": "string", "说明": "分享员openid", "枚举": "-" }, { "参数名": "sharer_unionid", "类型": "string", "说明": "分享员unionid", "枚举": "-" }, { "参数名": "sharer_type", "类型": "number", "说明": "分享员类型，0：普通分享员，1：店铺分享员", "枚举": "-" }, { "参数名": "share_scene", "类型": "number", "说明": "分享场景", "枚举": "枚举值" }, { "参数名": "sku_id", "类型": "string", "说明": "商品skuid", "枚举": "-" }, { "参数名": "from_wecom", "类型": "boolean", "说明": "是否来自企微分享", "枚举": "-" } ] ``` ### Res.order.order_detail.agent_info `Object Payload` 授权账号信息 ```json [ { "参数名": "agent_finder_id", "类型": "string", "说明": "授权视频号id" }, { "参数名": "agent_finder_nickname", "类型": "string", "说明": "授权视频号昵称" } ] ``` "> ### Res.order.order_detail.source_infos(Array) `Object Payload` 订单来源信息 ```json [ { "参数名": "sku_id", "类型": "string", "说明": "商品skuid" }, { "参数名": "account_type", "类型": "number", "说明": "带货账户类型，1：视频号，2：公众号，3：小程序，4：企业微信，5：带货达人，6：服务号，1000：带货机构" }, { "参数名": "account_id", "类型": "string", "说明": "带货账户id，如果带货账户类型是视频号，此id为视频号id; 如果带货类型为 公众号/小程序， 此id 为对应 公众号/小程序 的appid" }, { "参数名": "sale_channel", "类型": "number", "说明": "销售渠道， 0：关联账号，1：合作账号，100：联盟达人带货，101：联盟带货机构推广" }, { "参数名": "account_nickname", "类型": "string", "说明": "带货账户昵称" }, { "参数名": "content_type", "类型": "number", "说明": "带货内容类型，1：企微成员转发" }, { "参数名": "content_id", "类型": "string", "说明": "带货内容id，取决于带货内容类型（企微成员user_id）" }, { "参数名": "promoter_head_supplier_id", "类型": "string", "说明": "自营推客推广的带货机构id" }, { "参数名": "original_id", "类型": "string", "说明": "公众号/服务号 id，仅在account_type=2/6的情况下返回" } ] ``` ### Res.order.order_detail.refund_info `Object Payload` 订单退款信息 ```json [ { "参数名": "refund_freight", "类型": "number", "说明": "退还运费金额，礼物订单(is_present=true)可能存在" } ] ``` ### Res.order.order_detail.greeting_card_info `Object Payload` 需代写的商品贺卡信息 ```json [ { "参数名": "giver_name", "类型": "string", "说明": "贺卡落款，用户选填" }, { "参数名": "receiver_name", "类型": "string", "说明": "贺卡称谓，用户选填" }, { "参数名": "greeting_message", "类型": "string", "说明": "贺卡内容，用户必填" } ] ``` ### Res.order.order_detail.custom_info `Object Payload` 商品定制信息 ```json [ { "参数名": "custom_img_url", "类型": "string", "说明": "定制图片，custom_type=2时返回", "枚举": "-" }, { "参数名": "custom_word", "类型": "string", "说明": "定制文字，custom_type=1时返回", "枚举": "-" }, { "参数名": "custom_type", "类型": "number", "说明": "定制类型", "枚举": "枚举值" }, { "参数名": "custom_preview_img_url", "类型": "string", "说明": "定制预览图片，开启了定制预览时返回", "枚举": "-" } ] ``` ### Res.order.order_detail.guide_info `Object Payload` 订单导购信息 ```json [ { "参数名": "wecom_guide_infos", "类型": "objarray", "说明": "企微导购信息" } ] ``` "> ### Res.order.order_detail.guide_info.wecom_guide_infos(Array) `Object Payload` 企微导购信息 ```json [ { "参数名": "sku_id", "类型": "string", "说明": "商品skuid" }, { "参数名": "corp_id", "类型": "string", "说明": "企业ID" }, { "参数名": "user_id", "类型": "string", "说明": "企微用户ID" }, { "参数名": "staff_id", "类型": "string", "说明": "工号" }, { "参数名": "share_time", "类型": "number", "说明": "分享时间，秒级时间戳" }, { "参数名": "remark", "类型": "string", "说明": "备注信息" } ] ``` ### Res.order.aftersale_detail `Object Payload` 售后信息 ```json [ { "参数名": "aftersale_order_list", "类型": "objarray", "说明": "售后单列表" }, { "参数名": "on_aftersale_order_cnt", "类型": "number", "说明": "正在售后流程的售后单数" } ] ``` "> ### Res.order.aftersale_detail.aftersale_order_list(Array) `Object Payload` 售后单列表 ```json [ { "参数名": "aftersale_order_id", "类型": "number", "说明": "售后单ID" }, { "参数名": "status", "类型": "number", "说明": "售后单状态(已废弃，请勿使用，售后信息请调用售后接口）" } ] ``` ### Res.order.order_present_info `Object Payload` 订单对应礼物单信息 ```json [ { "参数名": "present_note", "类型": "string", "说明": "礼物订单留言" }, { "参数名": "present_giver_openid", "类型": "string", "说明": "礼物订单赠送者openid,仅送礼订单返回该字段" }, { "参数名": "present_giver_unionid", "类型": "string", "说明": "礼物订单赠送者在开放平台的唯一标识符，若当前微信小店已绑定到微信开放平台账号下，绑定成功后产生的订单会返回，详见[UnionID 机制说明](/doc/store/shop/dev_before/UnionID.md)" }, { "参数名": "present_order_id_str", "类型": "number", "说明": "礼物订单ID" }, { "参数名": "present_send_type", "类型": "number", "说明": "礼物单类型" }, { "参数名": "is_b2c_free_present", "类型": "boolean", "说明": "礼物单是否付款\ntrue：无需付款。商家选择自己店铺的商品在公众号/服务号/企业微信/小程序/小游戏/直播间等场景送礼物时，无需付款；且在支付信息（Res.order.order_detail.pay_info）的返回参数中，仅有支付方式（payment_method），其余参数为空\nfalse：已付款" } ] ``` ### Res.order.intra_city_order_info `Object Payload` 同城单信息 ```json [ { "参数名": "shop_id", "类型": "string", "说明": "门店id", "枚举": "-" }, { "参数名": "predict_arrive_start_time", "类型": "number", "说明": "预计送达开始时间", "枚举": "-" }, { "参数名": "predict_arrive_end_time", "类型": "number", "说明": "预计送达结束时间", "枚举": "-" }, { "参数名": "predict_arrive_time_type", "类型": "number", "说明": "配送类型", "枚举": "枚举值" } ] ``` ### Res.order.user_info `Object Payload` 潮玩订单用户信息 ```json [ { "参数名": "head_img_url", "类型": "string", "说明": "头像图片链接" }, { "参数名": "nickname", "类型": "-", "说明": "用户昵称" } ] ``` ### Res.order.risk_info `Object Payload` 订单风控信息 ```json [ { "参数名": "risk_items", "类型": "objarray", "说明": "订单风控信息列表" } ] ``` "> ### Res.order.risk_info.risk_items(Array) `Object Payload` 订单风控信息列表 ```json [ { "参数名": "risk_type", "类型": "number", "说明": "风控类型", "枚举": "枚举值" }, { "参数名": "risk_status", "类型": "number", "说明": "风控状态", "枚举": "枚举值" }, { "参数名": "risk_desc", "类型": "string", "说明": "风控信息描述", "枚举": "-" } ] ``` ## 4. 枚举信息 ### Res.order.status `Enum` 订单状态 ```json [ { "枚举值": "10", "描述": "待付款" }, { "枚举值": "12", "描述": "礼物待收下" }, { "枚举值": "20", "描述": "待发货" }, { "枚举值": "13", "描述": "一起买待成团" }, { "枚举值": "17", "描述": "支付成功待核销" }, { "枚举值": "21", "描述": "部分发货" }, { "枚举值": "30", "描述": "待收货" }, { "枚举值": "100", "描述": "完成" }, { "枚举值": "200", "描述": "全部商品售后之后，订单取消" }, { "枚举值": "250", "描述": "未付款用户主动取消或超时未付款订单自动取消" } ] ``` ### Res.order.present_send_type `Enum` 礼物单类型 ```json [ { "枚举值": "0", "描述": "普通单聊" }, { "枚举值": "1", "描述": "普通群聊" }, { "枚举值": "2", "描述": "公众号/服务号送礼" }, { "枚举值": "3", "描述": "视频号送礼" }, { "枚举值": "4", "描述": "企微单聊" }, { "枚举值": "5", "描述": "企微群聊" }, { "枚举值": "7", "描述": "小程序/小游戏送礼" }, { "枚举值": "8", "描述": "评价抽奖送礼" }, { "枚举值": "9", "描述": "橱窗送礼" }, { "枚举值": "10", "描述": "见面礼" }, { "枚举值": "11", "描述": "商品抽奖送礼" } ] ``` ### Res.order.voucher_order_status `Enum` 本地生活订单预约状态 ```json [ { "枚举值": "1", "描述": "已预约" } ] ``` __voucher_list__voucher_type"> ### Res.order.order_detail.product_infos(Array).voucher_list.voucher_type `Enum` 券类型 ```json [ { "枚举值": "1", "描述": "兑换券" }, { "枚举值": "2", "描述": "代金券" }, { "枚举值": "3", "描述": "次卡" } ] ``` __order_product_coupon_info_list__coupon_type"> ### Res.order.order_detail.product_infos(Array).order_product_coupon_info_list.coupon_type `Enum` 优惠券类型 ```json [ { "枚举值": "1", "描述": "商家优惠" }, { "枚举值": "2", "描述": "达人优惠（已下线）" }, { "枚举值": "3", "描述": "平台优惠" }, { "枚举值": "4", "描述": "国家补贴" }, { "枚举值": "5", "描述": "地方补贴" }, { "枚举值": "6", "描述": "活动商家补贴" }, { "枚举值": "7", "描述": "限时抢购" }, { "枚举值": "8", "描述": "商家点赞买" }, { "枚举值": "9", "描述": "会员权益" }, { "枚举值": "10", "描述": "一起买" }, { "枚举值": "11", "描述": "小店金币" } ] ``` __custom_info__custom_type"> ### Res.order.order_detail.product_infos(Array).custom_info.custom_type `Enum` 定制类型 ```json [ { "枚举值": "1", "描述": "文字定制" }, { "枚举值": "2", "描述": "图片定制" }, { "枚举值": "3", "描述": "小程序定制" } ] ``` ### Res.order.order_detail.pay_info.payment_method `Enum` 支付方式，已支付订单会返回本字段 ```json [ { "枚举值": "1", "描述": "微信支付" }, { "枚举值": "2", "描述": "先用后付" }, { "枚举值": "3", "描述": "抽奖商品0元订单" }, { "枚举值": "4", "描述": "会员积分兑换订单" } ] ``` __deliver_type"> ### Res.order.order_detail.delivery_info.delivery_product_info(Array).deliver_type `Enum` 配送方式 ```json [ { "枚举值": "1", "描述": "自寄快递" }, { "枚举值": "2", "描述": "在线签约快递单 （已废弃）" }, { "枚举值": "3", "描述": "虚拟商品无需物流发货" }, { "枚举值": "4", "描述": "在线快递散单 （已废弃）" } ] ``` ### Res.order.order_detail.delivery_info.quality_inspect_info.inspect_status `Enum` 质检状态 ```json [ { "枚举值": "0", "枚举解释": "待录入送检信息", "类型": "珠宝玉石" }, { "枚举值": "1", "枚举解释": "待送检", "类型": "珠宝玉石" }, { "枚举值": "2", "枚举解释": "未入库已取消", "类型": "珠宝玉石" }, { "枚举值": "3", "枚举解释": "入库异常", "类型": "珠宝玉石" }, { "枚举值": "4", "枚举解释": "已入库", "类型": "珠宝玉石" }, { "枚举值": "5", "枚举解释": "质检中", "类型": "珠宝玉石" }, { "枚举值": "6", "枚举解释": "待出库", "类型": "珠宝玉石" }, { "枚举值": "7", "枚举解释": "出库异常", "类型": "珠宝玉石" }, { "枚举值": "8", "枚举解释": "待自提", "类型": "珠宝玉石" }, { "枚举值": "10", "枚举解释": "已取消已自提", "类型": "珠宝玉石" }, { "枚举值": "11", "枚举解释": "已发货", "类型": "珠宝玉石" }, { "枚举值": "12", "枚举解释": "待重新送检", "类型": "珠宝玉石" }, { "枚举值": "13", "枚举解释": "已达送检上限", "类型": "珠宝玉石" }, { "枚举值": "14", "枚举解释": "待驿站入库", "类型": "珠宝玉石" }, { "枚举值": "15", "枚举解释": "已送检（自寄）", "类型": "珠宝玉石" }, { "枚举值": "100", "枚举解释": "待上传打包信息", "类型": "生鲜类" }, { "枚举值": "200", "枚举解释": "质检中", "类型": "生鲜类" }, { "枚举值": "201", "枚举解释": "质检不通过", "类型": "生鲜类" }, { "枚举值": "202", "枚举解释": "质检通过", "类型": "生鲜类" } ] ``` ### Res.order.order_detail.ext_info.order_scene `Enum` 下单场景 ```json [ { "枚举值": "1", "描述": "其他" }, { "枚举值": "2", "描述": "直播间" }, { "枚举值": "3", "描述": "短视频" }, { "枚举值": "4", "描述": "商品分享" }, { "枚举值": "5", "描述": "商品橱窗主页" }, { "枚举值": "6", "描述": "公众号文章商品卡片" } ] ``` ### Res.order.order_detail.sharer_info.share_scene `Enum` 分享场景 > 以下参数使用相同枚举： > > - Res.order.order_detail.sku_sharer_infos(Array).share_scene ： 分享场景 ```json [ { "枚举值": "1", "描述": "直播间" }, { "枚举值": "2", "描述": "橱窗" }, { "枚举值": "3", "描述": "短视频" }, { "枚举值": "4", "描述": "视频号主页" }, { "枚举值": "5", "描述": "商品详情页" }, { "枚举值": "6", "描述": "带商品的公众号文章" }, { "枚举值": "7", "描述": "商品链接" }, { "枚举值": "8", "描述": "商品二维码" }, { "枚举值": "9", "描述": "商品短链" }, { "枚举值": "10", "描述": "分享直播间" }, { "枚举值": "11", "描述": "分享直播间" }, { "枚举值": "12", "描述": "视频号橱窗的短链" }, { "枚举值": "13", "描述": "视频号橱窗的二维码" } ] ``` ### Res.order.order_detail.custom_info.custom_type `Enum` 定制类型 ```json [ { "枚举值": "1", "描述": "文字定制" }, { "枚举值": "2", "描述": "图片定制" }, { "枚举值": "3", "描述": "小程序定制" } ] ``` ### Res.order.intra_city_order_info.predict_arrive_time_type `Enum` 配送类型 ```json [ { "枚举值": "0", "描述": "立即配送" }, { "枚举值": "1", "描述": "预约配送" } ] ``` __risk_type"> ### Res.order.risk_info.risk_items(Array).risk_type `Enum` 风控类型 ```json [ { "枚举值": "1", "描述": "限制发货" } ] ``` __risk_status"> ### Res.order.risk_info.risk_items(Array).risk_status `Enum` 风控状态 ```json [ { "枚举值": "0", "描述": "未生效" }, { "枚举值": "1", "描述": "生效中" } ] ``` ## 5. 注意事项 本接口无特殊注意事项 ## 6. 代码示例 请求示例 ```json { "order_id": "37423523451235145" } ``` 返回示例 ```json { "errcode": 0, "errmsg": "ok", "order": { "order_id": "37423523451235145", "status": 20, "create_time": 1658505600, "update_time": 1658505600, "order_detail": { "product_infos": [ { "product_id": 234245, "sku_id": 23424, "sku_cnt": 10, "on_aftersale_sku_cnt": 10, "finish_aftersale_sku_cnt": 0, "title": "健身环", "thumb_img": "https://mmecimage.cn/p/wx37f38d59298839c3/HJE9eJaEc5bJk-eaArVdILSB7MMaHgdK2-JIn51nMQ", "sale_price": 2000, "market_price": 2000, "sku_attrs": [ { "attr_key": "产地", "attr_value": "四川成都" }, { "attr_key": "材质", "attr_value": "玻璃" }, { "attr_key": "适用人群", "attr_value": "青年;中年" }, { "attr_key": "数量", "attr_value": "33" }, { "attr_key": "精度", "attr_value": "3.001" }, { "attr_key": "重量", "attr_value": "38 mg" }, { "attr_key": "毛重", "attr_value": "380 kg" } ] } ], "pay_info": { "prepay_id": "42526234625", "transaction_id": "131456479687", "prepay_time": 1658509200, "pay_time": 1658509200, "payment_method":1 }, "price_info": { "product_price": 20000, "order_price": 10500, "freight": 500, "discounted_price": 10000, "is_discounted": true }, "delivery_info": { "address_info": { "user_name": "陈先生", "postal_code": "2435245", "province_name": "广东", "city_name": "广州", "county_name": "海珠区", "detail_info": "大塘", "tel_number": "24534252" }, "delivery_product_info": [ { "waybill_id": "134654612313", "delivery_id": "STO", "delivery_time": 1620738080, "deliver_type": 1, "product_infos": [ { "product_id": "234245", "sku_id": "23424", "product_cnt": 1 } ] } ], "ship_done_time": 1620738080, "deliver_method":0 }, "coupon_info":{ "user_coupon_id":"301234567890" }, "ext_info": { "customer_notes": "发顺丰", "merchant_notes": "库存不足，取消", "merchant_notes_tag_color": 1, "finder_id": "sph3FZbOEY46mAB", "live_id": "export/UzFfAgtgekIEAQAAAAAAt40WWe5njQAAAAstQy6ubaLX4KHWvLEZgBPE5KNoYRJdUeaEzNPgMJq4tEJ8QSCaA2N_Iua2abcd", "order_scene": 2 }, "sharer_info":{ "sharer_openid": "SHAREROPENID", "sharer_unionid": "SHARERUNIONID", "sharer_type": 1, "share_scene": 1, "handling_progress": 1 }, "settle_info":{ "commission_fee" : 10, "predict_commission_fee": 10 }, "sku_sharer_infos":[ { "sharer_openid": "SHAREROPENID", "sharer_unionid": "SHARERUNIONID", "sharer_type": 1, "share_scene": 1, "sku_id": "23424" } ] }, "aftersale_detail": { "aftersale_order_list": [ { "aftersale_order_id": "1234", "status": 13 } ], "on_aftersale_order_cnt": 1 }, "openid": "OPENID" } } ``` ## 7. 错误码 以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/oplatform/developers/errCode/README.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。 ```json [ { "错误码": "40097", "错误描述": "请求体参数不正确，请检查各个参数是否按规范填写，具体原因请查看errmsg" }, { "错误码": "47001", "错误描述": "请求体格式不正确，请检查请求体中各个参数的类型是否正确请求体参数不正确，请检查各个参数是否按规范填写，具体原因请查看errmsg" }, { "错误码": "48001", "错误描述": "无权调用本api，请检查相关权限是否已开通" }, { "错误码": "100002", "错误描述": "订单不存在，请检查订单号与 token 是否正确" } ] ``` ## 8. 适用范围 本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（29条） 2026 年 10 月 10 日新增 `point_discounted_price` 字段， `order_price` 计算式加入「point_discounted_price」， `coupon_type` 新增「小店金币」枚举选项 2026 年 10 月 09 日新增 `warehouse_address` 中转仓信息子字段，含收货人、联系方式、省市区域及详细地址等7个字段。 2026 年 10 月 05 日`dropship_info_list` 字段新增，用于拆件分配场景的商品代发信息。 2026 年 08 月 14 日新增 `voucher_product_info` 字段， `need_appointment` 字段新增 2026 年 08 月 04 日新增 merchant_notes_tag_color 商家备注颜色字段 2026 年 07 月 30 日新增 `risk_info` 订单风控信息字段 2026 年 07 月 24 日新增 `express_type` 、 `extra_logistics_info` 、 `waybill_id` 、 `delivery_id` 字段， `is_b2c_free_present` 字段描述更新 2026 年 07 月 21 日新增 `user_info` 、 `order_product_item_list` 、 `item_unique_id` 等 6 个字段 2026 年 07 月 14 日企微导购信息字段 `wecom_guide_info` 更名为 `wecom_guide_infos` 2026 年 07 月 09 日新增收礼换款相关信息 2026 年 07 月 07 日`present_send_type` 字段新增「商品抽奖送礼」枚举值 2026 年 07 月 03 日order_detail.delivery_info枚举值修改 2026 年 07 月 01 日订单配送信息delivery_info中新增同城发货标记字段intracity_delivery_flag 2026 年 07 月 01 日`delivery_time_type` 字段新增「用户预约」「用户预约暂不发货」等2个选项 2026 年 06 月 23 日新增订单本地生活预约子状态&补充本地生活券码信息字段 2026 年 06 月 04 日新增guide_info订单导购信息，其下新增wecom_guide_info企微导购信息 2026 年 05 月 28 日新增订单内商品维度商家实收金额（含平台补贴分摊）字段sku_merchant_receive_amount 2026 年 05 月 21 日新增SKU维度 `custom_info` 字段，其下新增 `custom_img_url` 等 4 个字段 2026 年 05 月 14 日新增 supply_order_product_info 供货单信息字段，包含供货单号 2026 年 04 月 24 日`is_b2c_free_present` 字段描述更新 2026 年 04 月 22 日`account_type` 字段新增「带货机构」枚举值 2026 年 04 月 10 日新增coupon_type枚举值：一起买和会员权益优惠 2026 年 04 月 01 日新增商家点赞买相关字段normal_friends_like_discounted_price, 优惠类型新增商家点赞买 2026 年 01 月 30 日新增限时抢购优惠金额字段limited_discount_discounted_price, 优惠类型枚举值CouponType新增限时抢购优惠 2026 年 01 月 28 日修正虚拟号码相关字段描述 2025 年 12 月 16 日补充质检状态 2025 年 12 月 10 日新增present_send_type枚举值，新增评价抽奖送礼，橱窗送礼，见面礼几种礼物单类型 2025 年 11 月 25 日新增了活动商家补贴字段'national_subsidy_merchant_discounted_price'，新增了订单中商品维度平台券优惠字段'cash_coupon_discounted_price'，优惠券类型新增'活动商家补贴' 2025 年 11 月 20 日新增 `national_subsidy_merchant_discounted_price` 字段， `order_price` 字段描述更新，「优惠券类型」新增 `地方补贴` 枚举