查询订单详情

本文介绍查询订单详情的 API。

接口描述

根据商城 code、店铺 code、买家 UID 和订单 ID，查询订单详情信息。

接口地址

GET: /v1.0/mall/plugin/order/{order_id}

请求参数

参数名	类型	参数位置	是否必填	说明
mall_code	String	query	true	商城 code
shop_code	String	query	true	店铺 code
user_id	String	query	true	买家 UID
order_id	String	uri	true	订单号

返回参数

参数名	类型	说明
result	OrderDetailOpenApiVO	返回结果

result 说明

参数名	类型	说明
mall_code	String	商城 code
shop_code	String	店铺 code
order_id	String	订单号
pay_status	String	支付状态
delivery_status	String	发货状态
created_time	Long	创建时间
current_total_price	BigDecimal	当前总价格
total_shipping_price	BigDecimal	总邮费
total_tax_price	BigDecimal	总税费
total_price	BigDecimal	总价格
currency	String	币种
delivery_list	List	物流信息
cancel_reason	String	订单取消原因
canceled_time	Long	订单取消时间
commodity_list	List	订单商品行信息
billing_address	AddressModelOpenApiVO	支付人账单地址
shipping_address	AddressModelOpenApiVO	支付人收货地址

commodity_list 说明

参数名	类型	说明
title	String	商品名称
sku	String	SKU code
available	Boolean	商品是否在售
price	PriceModelOpenApiVO	价格
weight	BigDecimal	重量
quantity	Integer	购买数量
image	String	商品图片链接
selected_options	List	商品属性

delivery_list 说明

参数名	类型	说明
logistics_company	String	快递公司
logistics_no	String	快递单号
logistics_url	String	链接

billing_address 说明

参数名	类型	说明
country_code	String	国家或地区 code
province_code	String	省份 code
country	String	国家或地区名称
province	String	省份名称
city	String	城市名称
address	String	详细地址
zip	String	邮编
latitude	String	纬度
longitude	String	经度
name	String	名字
first_name	String	名
last_name	String	姓
phone	String	手机号码

shipping_address 说明

参数名	类型	说明
country_code	String	国家或地区 code
province_code	String	省份 code
country	String	国家或地区名称
province	String	省份名称
city	String	城市名称
address	String	详细地址
zip	String	邮编
latitude	String	纬度
longitude	String	经度
name	String	名字
first_name	String	名
last_name	String	姓
phone	String	手机号码

selected_options 说明

参数名	类型	说明
name	String	属性名称
value	String	属性值

price 说明

参数名	类型	说明
amount	BigDecimal	金额
currency	String	币种

请求示例

GET: /v1.0/mall/plugin/order/1234567?mall_code=MALL_CODE&shop_code=SHOP_CODE&user_id=USER_ID&order_id=ORDER_ID

{
  "mall_code": "testMallCode",
  "shop_code": "testShopCode",
  "user_id": "testUserId",
  "order_id": "testOrderId"
}

返回示例

{
    "created_time": "20220901",
    "subtotal_price": 2,
    "canceled_time": "20220902",
    "total_price": 2,
    "shop_code": "testShopCode",
    "delivery_list": [
        {
            "logistics_no": "1Z2345",
            "logistics_url": "https://tools.usps.com/go/TrackConfirmAction_input?qtc_tLabels1=1Z2***",
            "logistics_company": "USPS"
        }
    ],
    "total_tax_price": 1,
    "billing_address": {
        "zip": "40202",
        "country": "United States",
        "address": "Chestnut Street ***",
        "city": "Louisville",
        "latitude": "45.41634",
        "last_name": "Norman",
        "province_code": "KY",
        "country_code": "US",
        "province": "Kentucky",
        "phone": "555-625-11**",
        "name": "Bob Norman",
        "first_name": "Bob",
        "longitude": "-75.6868"
    },
    "total_shipping_price": 1,
    "commodity_list": [
        {
            "image": "xxx",
            "quantity": 1,
            "selected_options": [
                {
                    "name": "颜色",
                    "value": "蓝色"
                }
            ],
            "available": true,
            "weight": 10,
            "title": "IPod Nano - 8gb",
            "price": {
                "amount": 2,
                "currency": "USD"
            },
            "id": 466157049,
            "sku": "IPOD2008*****"
        }
    ],
    "pay_status": "paid",
    "cancel_reason": "取消原因",
    "mall_code": "testMallCode",
    "current_total_price": 10,
    "currency": "USD",
    "shipping_address": {
        "zip": "40202",
        "country": "United States",
        "address": "Chestnut Street **",
        "city": "Louisville",
        "latitude": "45.41634",
        "last_name": "Norman",
        "province_code": "KY",
        "country_code": "US",
        "province": "Kentucky",
        "phone": "555-625-11**",
        "name": "Bob Norman",
        "first_name": "Bob",
        "longitude": "-75.6868"
    },
    "order_id": "testOrderId",
    "delivery_status": "shipped"
}

错误码

参考 错误码。