查询售后订单列表

GET 
/openapi/2026-07/orders/post_sales

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

请求

Query参数

cursor string

分页游标

page_size int32

每页记录数

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

数据结构

数据结构

codestring

错误码

messagestring

错误信息

data object

orders object[]

订单列表

Array [

created_atstring

售后记录的创建时间

credit_card_numberstring

所使用信用卡的末几位数字

currency_codestring

货币代码（如 "CNY"、"USD"）

customer_namestring

顾客姓名

discount_codestring

折扣码

financial_statusstring

订单的支付状态：

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

fulfillment_statusstring

订单物流状态：

• initialled: 初始
• waiting: 待发货
• partially_shipped: 部分发货
• shipped: 全部发货
• partially_finished: 部分收货
• finished: 全部收货
• cancelled: 已取消
• returning: 退货中
• partially_returned: 部分退货
• returned: 全部退货

fulfillments object[]

物流记录列表

Array [

tracking_numberstring

快递单号

created_atstring

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

tracking_companystring

快递公司

]

idstring

此售后记录 ID

line_items object[]

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

Array [

compare_at_pricestring

折扣前的原始价格

fulfillment_statusstring

商品行物流状态：

• waiting: 初始/待发货
• shipped: 已全发
• finished: 已全收
• returning: 退货中
• returned: 已退货
• partially_shipped: 部分发货
• partially_finished: 部分收货
• partially_returned: 部分退货

idstring

商品行 ID

image object

图片

srcstring

图片来源 URL

widthint32

图片宽度（像素）

heightint32

图片高度（像素）

altstring

图片替代文本

notestring

与此商品行关联的备注

options object[]

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

Array [

namestring

商品款式属性名称

valuestring

商品款式属性值

]

pricestring

此商品的单价

product_handlestring

商品的 handle/别名

product_idstring

商品 ID

product_tagsstring[]

与此商品关联的标签数组

product_titlestring

商品标题

propertiesstring

字符串或 JSON 格式的自定义属性

quantityint32

购买数量（在售后申请中体现）

refund_discountstring

退款中的折扣部分

refund_pricestring

退款中的价格部分

refund_quantityint32

此商品行的退款数量

refund_taxstring

退款中的税费部分

refund_totalstring

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

requires_shippingboolean

此商品是否需要配送

skustring

规格的库存单位（SKU）

spustring

库存商品单位（SPU）或通用商品代码

taxableboolean

此商品是否需要纳税

totalstring

此商品行的总费用（单价 × 数量）

variant_idstring

规格 ID

variant_titlestring

描述规格属性的标题

vendorstring

此商品的供应商或品牌

weightstring

此商品的单位重量

weight_unitstring

重量单位（如 "kg"、"lb"）

vendor_urlstring

供应商网站 URL

oversold_quantityint32

超出库存的销售数量（若允许超卖）

main_currency_prices object

主货币价格列表

compare_at_pricestring

店铺/主要货币的划线价

pricestring

主要货币的单价

total_pricestring

总价（主要货币单价 × 数量）

actual_ratestring

实际使用的换算汇率

fulfillments object[]

物流记录列表

Array [

tracking_numberstring

快递单号

created_atstring

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

tracking_companystring

快递公司

]

]

numberstring

售后单号（通常为原始订单号加后缀）

order_numberstring

原始订单号

order_totalstring

原始订单总价

payment_methodstring

原始订单使用的支付方式

recipient_namestring

物流信息中的收件人姓名

sales_platformstring

销售渠道（如 "shoplazza"）

shipping_countrystring

收货地址的国家

shipping_emailstring

用于物流通知的电子邮件地址

shipping_line object

订单所选物流方案的信息

idstring

配送 ID

namestring

名称

descstring

描述

delivery_methodint32

配送方式

shipping_phonestring

收货地址的电话号码

sourcestring

首次访问落地页

source_namestring

首次互动来源

placed_atstring

原始订单的下单时间

refund_amountstring

此售后申请的退款总金额

post_sale_notestring

此售后申请的备注

last_referrer_showstring

最后一次互动来源

last_landing_urlstring

最后一次访问落地页 URL

payment_lines object[]

支付行列表

Array [

idstring

支付行 ID

payment_namestring

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

payment_channelstring

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

payment_methodstring

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

credit_card_numberstring

所使用信用卡的末几位数字

trans_channelstring

交易渠道

trans_methodstring

交易方式

transaction_nostring

与本次支付关联的唯一交易号

merchant_emailstring

商家电子邮件地址

]

main_currency_prices object

主货币价格列表

compare_at_pricestring

店铺/主要货币的划线价

pricestring

主要货币的单价

total_pricestring

总价（主要货币单价 × 数量）

actual_ratestring

实际使用的换算汇率

delivery_methodint32

配送方式标识符

shipping_tax_totalstring

原始订单的运费税总额

shipping_tax_typeint32

运费税类型

all_tax_totalstring

订单总税额

shop_namestring

订单关联的店铺名称

staff_contactstring

与此售后记录关联的员工联系信息

statusstring

售后申请状态：

• pending: 待处理
• processing: 处理中
• finished: 已完成

]

cursorstring

分页游标

has_moreboolean

是否有更多记录

示例

{
  "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
  }
}