**版本：202601**

# 查询售后订单列表

**GET** `/openapi/2026-01/orders/post_sales`

获取与订单关联的售后记录列表，如退货或换货申请。

## 请求

**Query参数**

- `cursor` string

  分页游标
- `page_size` int32

  每页记录数
- `page` int32

  页码（从 1 开始），与 cursor 互斥
- `created_at_min` string

  筛选创建时间在该时间或之后的记录（如 2018-11-02T12:30:10Z）
- `created_at_max` string

  筛选创建时间在该时间或之前的记录（如 2018-11-02T12:30:10Z）
- `status` string

  售后状态：

  *   `pending`: 待处理
  *   `processing`: 处理中
  *   `finished`: 已完成

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `orders` object[]

    订单列表

    *   Array \[

    - `created_at` string

      售后记录的创建时间
    - `credit_card_number` string

      所使用信用卡的末几位数字
    - `currency_code` string

      货币代码（如 "CNY"、"USD"）
    - `customer_name` string

      顾客姓名
    - `discount_code` string

      折扣码
    - `financial_status` string

      订单的支付状态：

      *   `waiting`: 待支付
      *   `paying`: 支付审核中
      *   `authorized`: 已授权
      *   `partially_paid`: 部分支付
      *   `paid`: 已支付
      *   `cancelled`: 已取消
      *   `failed`: 支付失败
      *   `refunding`: 退款中
      *   `refund_failed`: 退款失败
      *   `refunded`: 已全退
      *   `partially_refunded`: 部分退
    - `fulfillment_status` string

      订单物流状态：

      *   `initialled`: 初始
      *   `waiting`: 待发货
      *   `partially_shipped`: 部分发货
      *   `shipped`: 全部发货
      *   `partially_finished`: 部分收货
      *   `finished`: 全部收货
      *   `cancelled`: 已取消
      *   `returning`: 退货中
      *   `partially_returned`: 部分退货
      *   `returned`: 全部退货
    - `fulfillments` object[]

      物流记录列表

      *   Array \[

      - `tracking_number` string

        快递单号
      - `created_at` string

        物流记录创建时间（如 2018-11-02T12:30:10Z）
      - `tracking_company` string

        快递公司
      *   \]
    - `id` string

      此售后记录 ID
    - `line_items` object[]

      与此售后记录关联的商品行列表

      *   Array \[

      - `compare_at_price` string

        折扣前的原始价格
      - `fulfillment_status` string

        商品行物流状态：

        *   `waiting`: 初始/待发货
        *   `shipped`: 已全发
        *   `finished`: 已全收
        *   `returning`: 退货中
        *   `returned`: 已退货
        *   `partially_shipped`: 部分发货
        *   `partially_finished`: 部分收货
        *   `partially_returned`: 部分退货
      - `id` string

        商品行 ID
      - `image` object

        图片

        - `src` string

          图片来源 URL
        - `width` int32

          图片宽度（像素）
        - `height` int32

          图片高度（像素）
        - `alt` string

          图片替代文本
      - `note` string

        与此商品行关联的备注
      - `options` object[]

        选项对象数组，通常描述规格属性（如尺码）

        *   Array \[

        - `name` string

          商品款式属性名称
        - `value` string

          商品款式属性值
        *   \]
      - `price` string

        此商品的单价
      - `product_handle` string

        商品的 handle/别名
      - `product_id` string

        商品 ID
      - `product_tags` string[]

        与此商品关联的标签数组
      - `product_title` string

        商品标题
      - `properties` string

        字符串或 JSON 格式的自定义属性
      - `quantity` int32

        购买数量（在售后申请中体现）
      - `refund_discount` string

        退款中的折扣部分
      - `refund_price` string

        退款中的价格部分
      - `refund_quantity` int32

        此商品行的退款数量
      - `refund_tax` string

        退款中的税费部分
      - `refund_total` string

        此商品行的总退款金额（含价格、税费、折扣）
      - `requires_shipping` boolean

        此商品是否需要配送
      - `sku` string

        规格的库存单位（SKU）
      - `spu` string

        库存商品单位（SPU）或通用商品代码
      - `taxable` boolean

        此商品是否需要纳税
      - `total` string

        此商品行的总费用（单价 × 数量）
      - `variant_id` string

        规格 ID
      - `variant_title` string

        描述规格属性的标题
      - `vendor` string

        此商品的供应商或品牌
      - `weight` string

        此商品的单位重量
      - `weight_unit` string

        重量单位（如 "kg"、"lb"）
      - `vendor_url` string

        供应商网站 URL
      - `oversold_quantity` int32

        超出库存的销售数量（若允许超卖）
      - `main_currency_prices` object

        主货币价格列表

        - `compare_at_price` string

          店铺/主要货币的划线价
        - `price` string

          主要货币的单价
        - `total_price` string

          总价（主要货币单价 × 数量）
        - `actual_rate` string

          实际使用的换算汇率
      - `fulfillments` object[]

        物流记录列表

        *   Array \[

        - `tracking_number` string

          快递单号
        - `created_at` string

          物流记录创建时间（如 2018-11-02T12:30:10Z）
        - `tracking_company` string

          快递公司
        *   \]
      *   \]
    - `number` string

      售后单号（通常为原始订单号加后缀）
    - `order_number` string

      原始订单号
    - `order_total` string

      原始订单总价
    - `payment_method` string

      原始订单使用的支付方式
    - `recipient_name` string

      物流信息中的收件人姓名
    - `sales_platform` string

      销售渠道（如 "shoplazza"）
    - `shipping_country` string

      收货地址的国家
    - `shipping_email` string

      用于物流通知的电子邮件地址
    - `shipping_line` object

      订单所选物流方案的信息

      - `id` string

        配送 ID
      - `name` string

        名称
      - `desc` string

        描述
      - `delivery_method` int32

        配送方式
    - `shipping_phone` string

      收货地址的电话号码
    - `source` string

      首次访问落地页
    - `source_name` string

      首次互动来源
    - `placed_at` string

      原始订单的下单时间
    - `refund_amount` string

      此售后申请的退款总金额
    - `post_sale_note` string

      此售后申请的备注
    - `last_referrer_show` string

      最后一次互动来源
    - `last_landing_url` string

      最后一次访问落地页 URL
    - `payment_lines` object[]

      支付行列表

      *   Array \[

      - `id` string

        支付行 ID
      - `payment_name` string

        支付渠道的显示名称（如 PayPal、信用卡）
      - `payment_channel` string

        交易使用的支付渠道（如 PayPal、Stripe、银行转账）
      - `payment_method` string

        渠道内使用的具体支付方式（如 Visa、MasterCard、在线支付）
      - `credit_card_number` string

        所使用信用卡的末几位数字
      - `trans_channel` string

        交易渠道
      - `trans_method` string

        交易方式
      - `transaction_no` string

        与本次支付关联的唯一交易号
      - `merchant_email` string

        商家电子邮件地址
      *   \]
    - `main_currency_prices` object

      主货币价格列表

      - `compare_at_price` string

        店铺/主要货币的划线价
      - `price` string

        主要货币的单价
      - `total_price` string

        总价（主要货币单价 × 数量）
      - `actual_rate` string

        实际使用的换算汇率
    - `delivery_method` int32

      配送方式标识符
    - `shipping_tax_total` string

      原始订单的运费税总额
    - `shipping_tax_type` int32

      运费税类型
    - `all_tax_total` string

      订单总税额
    - `shop_name` string

      订单关联的店铺名称
    - `staff_contact` string

      与此售后记录关联的员工联系信息
    - `status` string

      售后申请状态：

      *   `pending`: 待处理
      *   `processing`: 处理中
      *   `finished`: 已完成
    *   \]
  - `cursor` string

    分页游标
  - `has_more` boolean

    是否有更多记录

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "orders": [
      {
        "created_at": "string",
        "credit_card_number": "string",
        "currency_code": "string",
        "customer_name": "string",
        "discount_code": "string",
        "financial_status": "string",
        "fulfillment_status": "string",
        "fulfillments": [
          {
            "tracking_number": "string",
            "created_at": "string",
            "tracking_company": "string"
          }
        ],
        "id": "string",
        "line_items": [
          {
            "compare_at_price": "string",
            "fulfillment_status": "string",
            "id": "string",
            "image": {
              "src": "string",
              "width": 0,
              "height": 0,
              "alt": "string"
            },
            "note": "string",
            "options": [
              {
                "name": "string",
                "value": "string"
              }
            ],
            "price": "string",
            "product_handle": "string",
            "product_id": "string",
            "product_tags": [
              "string"
            ],
            "product_title": "string",
            "properties": "string",
            "quantity": 0,
            "refund_discount": "string",
            "refund_price": "string",
            "refund_quantity": 0,
            "refund_tax": "string",
            "refund_total": "string",
            "requires_shipping": true,
            "sku": "string",
            "spu": "string",
            "taxable": true,
            "total": "string",
            "variant_id": "string",
            "variant_title": "string",
            "vendor": "string",
            "weight": "string",
            "weight_unit": "string",
            "vendor_url": "string",
            "oversold_quantity": 0,
            "main_currency_prices": {
              "compare_at_price": "string",
              "price": "string",
              "total_price": "string",
              "actual_rate": "string"
            },
            "fulfillments": [
              {
                "tracking_number": "string",
                "created_at": "string",
                "tracking_company": "string"
              }
            ]
          }
        ],
        "number": "string",
        "order_number": "string",
        "order_total": "string",
        "payment_method": "string",
        "recipient_name": "string",
        "sales_platform": "string",
        "shipping_country": "string",
        "shipping_email": "string",
        "shipping_line": {
          "id": "string",
          "name": "string",
          "desc": "string",
          "delivery_method": 0
        },
        "shipping_phone": "string",
        "source": "string",
        "source_name": "string",
        "placed_at": "string",
        "refund_amount": "string",
        "post_sale_note": "string",
        "last_referrer_show": "string",
        "last_landing_url": "string",
        "payment_lines": [
          {
            "id": "string",
            "payment_name": "string",
            "payment_channel": "string",
            "payment_method": "string",
            "credit_card_number": "string",
            "trans_channel": "string",
            "trans_method": "string",
            "transaction_no": "string",
            "merchant_email": "string"
          }
        ],
        "main_currency_prices": {
          "compare_at_price": "string",
          "price": "string",
          "total_price": "string",
          "actual_rate": "string"
        },
        "delivery_method": 0,
        "shipping_tax_total": "string",
        "shipping_tax_type": 0,
        "all_tax_total": "string",
        "shop_name": "string",
        "staff_contact": "string",
        "status": "string"
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```