Qeasy Cloud
Get Started

领星ERP 多平台 - Shopify售后订单列表 API

Platform
领星ERP
Type
WebAPI
Effect
QUERY
API Version
1.0
Adapter
\Adapter\LingXing\LXQueryAdapter
Auth Mode
OTHER
Description
多平台 / 售后订单 · POST · 请求参数 15 个(必填 3) · 响应参数 46 个 · 限流令牌桶容量 1
Updated At
2026-11-21

多平台 - Shopify售后订单列表

POST/basicOpen/openapi/multiplatform/shopify/returnOrder/list
Factory
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/openapi/multiplatform/shopify/returnOrder/list"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/openapi/multiplatform/shopify/returnOrder/list?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\"dateType\":0.0,\"endDate\":\"\",\"pageNum\":0.0,\"pageSize\":0.0,\"refundStatusList\":[],\"returnReasonList\":[],\"returnStatusList\":[],\"returnTypeList\":[],\"searchMultiValue\":[],\"searchSingleValue\":\"\",\"searchType\":0.0,\"sortField\":\"\",\"sortType\":\"\",\"startDate\":\"\",\"storeIdList\":[]}'",
  "responseExample": "{\n\t\"code\":0,\n\t\"message\":\"success\",\n\t\"error_details\":[],\n\t\"request_id\":\"a0d54debf93140f3b58d1ed81e8e3583\",\n\t\"response_time\":\"2026-07-10 12:00:00\",\n\t\"data\":{\n\t\t\"current\":0,\n\t\t\"list\":[\n\t\t\t{\n\t\t\t\t\"firstRefundTimeLocale\":\"\",\n\t\t\t\t\"firstReturnTimeLocale\":\"\",\n\t\t\t\t\"items\":[\n\t\t\t\t\t{\n\t\t\t\t\t\t\"localSku\":\"\",\n\t\t\t\t\t\t\"pname\":\"\",\n\t\t\t\t\t\t\"productImageUrl\":\"\",\n\t\t\t\t\t\t\"refundAmount\":0,\n\t\t\t\t\t\t\"refundCurrency\":\"\",\n\t\t\t\t\t\t\"refundSymbol\":\"\",\n\t\t\t\t\t\t\"restockingFee\":0,\n\t\t\t\t\t\t\"restockingFeeCurrency\":\"\",\n\t\t\t\t\t\t\"restockingFeeSymbol\":\"\",\n\t\t\t\t\t\t\"returnQuantity\":0.0,\n\t\t\t\t\t\t\"returnReason\":\"\",\n\t\t\t\t\t\t\"sku\":\"\",\n\t\t\t\t\t\t\"title\":\"\",\n\t\t\t\t\t\t\"variantId\":\"\"\n\t\t\t\t\t}\n\t\t\t\t],\n\t\t\t\t\"orderCreatedAtLocale\":\"\",\n\t\t\t\t\"orderId\":\"\",\n\t\t\t\t\"orderName\":\"\",\n\t\t\t\t\"otherRefundAmount\":0,\n\t\t\t\t\"refundItemAmount\":0,\n\t\t\t\t\"refundNote\":\"\",\n\t\t\t\t\"refundStatus\":\"\",\n\t\t\t\t\"refundStatusName\":\"\",\n\t\t\t\t\"returnShippingCurrency\":\"\",\n\t\t\t\t\"returnShippingSymbol\":\"\",\n\t\t\t\t\"returnStatus\":\"\",\n\t\t\t\t\"returnTypeList\":[],\n\t\t\t\t\"storeId\":0,\n\t\t\t\t\"storeName\":\"\",\n\t\t\t\t\"totalRefundedAmount\":0,\n\t\t\t\t\"totalRefundedCurrency\":\"\",\n\t\t\t\t\"totalRefundedSymbol\":\"\",\n\t\t\t\t\"totalReturnShippingFee\":0\n\t\t\t}\n\t\t],\n\t\t\"pages\":0,\n\t\t\"size\":0,\n\t\t\"total\":0\n\t}\n}```"
}

Request Parameters

No.FieldNameTypeDefaultRequiredDescription
1startDate开始时间string—Required开始时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
2endDate结束时间string—Required结束时间,格式 yyyy-MM-dd 或 yyyy-MM-dd HH:mm:ss
3dateType时间类型number—Required时间类型:1-订购时间 2-退款时间 3-退货时间 查询时间范围不超过一年
4pageNum查询起始位置number—Optional查询起始位置
5pageSize分页大小number—Optional分页大小
6refundStatusList退款状态array<any>—Optional退款状态:PENDING / PARTIALLY_REFUNDED / REFUNDED
7returnReasonList退货原因(子行过滤)array<any>—Optional退货原因(子行过滤):COLOR / DEFECTIVE / NOT_AS_DESCRIBED / SIZE_TOO_LARGE / SIZE_TOO_SMALL / STYLE / UNWANTED / WRONG_ITEM / UNKNOWN / OTHER
8returnStatusList退货状态array<any>—Optional退货状态:IN_PROGRESS / INSPECTION_COMPLETE / NO_RETURN / RETURN_FAILED / RETURN_REQUESTED / RETURNED
9returnTypeList售后类型筛选array<any>—Optional售后类型筛选:refund(退款)/ return(退货),支持多选
10searchMultiValue批量精确搜索关键词列表(换行分隔后传入)array<any>—Optional批量精确搜索关键词列表(换行分隔后传入)
11searchSingleValue单个模糊搜索关键词string—Optional单个模糊搜索关键词
12searchType搜索字段类型number—Optional搜索字段类型:1-平台订单号 2-商品标题 3-MSKU 4-变体ID 5-SKU 6-品名
13sortField排序字段string—Optional排序字段:orderCreatedAtLocale(默认) / firstRefundTimeLocale / firstReturnTimeLocale
14sortType排序方式string—Optional排序方式:asc / desc,默认 desc
15storeIdList店铺ID列表array<any>—Optional店铺ID列表

Response Parameters

No.FieldNameTypeDefaultRequiredDescription
1code状态码integer0Required状态码,0:成功
2message消息提示stringsuccessRequired消息提示
3error_details数据校验失败时的错误详情array<any>—Required数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583Required请求链路id
5response_time响应时间string2026-07-10 12:00:00Required响应时间
6data响应数据object—Required响应数据
6.1currentcurrentinteger—Required
6.2listlistarray<object>—Required
6.2.1firstRefundTimeLocale退款时间(站点本地时间)string—Required退款时间(站点本地时间)
6.2.2firstReturnTimeLocale退货时间(站点本地时间)string—Required退货时间(站点本地时间)
6.2.3items商品明细列表array<object>—Required商品明细列表
6.2.3.1localSkulocalSkustring—RequiredSKU(关联 all_product_info.local_sku)
6.2.3.2pnamepnamestring—Required品名(关联 all_product_info.pname)
6.2.3.3productImageUrl商品图片URL(TODOstring—Required商品图片URL(TODO:通过 feign 实时获取)
6.2.3.4refundAmount商品退款金额integer—Required商品退款金额
6.2.3.5refundCurrency退款币种string—Required退款币种
6.2.3.6refundSymbol退款币种符号string—Required退款币种符号
6.2.3.7restockingFee退货手续费integer—Required退货手续费
6.2.3.8restockingFeeCurrency退货手续费币种string—Required退货手续费币种
6.2.3.9restockingFeeSymbol退货手续费币种符号string—Required退货手续费币种符号
6.2.3.10returnQuantity退货数量number—Required退货数量
6.2.3.11returnReason退货原因string—Required退货原因
6.2.3.12skuskustring—RequiredMSKU
6.2.3.13title商品标题string—Required商品标题
6.2.3.14variantId变体IDstring—Required变体ID
6.2.4orderCreatedAtLocale订购时间(站点本地时间)string—Required订购时间(站点本地时间)
6.2.5orderId平台订单号string—Required平台订单号,7047273152793
6.2.6orderName平台参考号string—Required平台参考号,如 #1346
6.2.7otherRefundAmountotherRefundAmountinteger—Required其他退款(totalRefundedAmount - refundItemAmount,Service 层计算)
6.2.8refundItemAmountrefundItemAmountinteger—Required商品退款金额(items 中 refundAmount 的合计,Service 层计算)
6.2.9refundNote退款备注string—Required退款备注
6.2.10refundStatus退款状态原始值string—Required退款状态原始值
6.2.11refundStatusName退款状态string—Required退款状态:未退款 / 部分退款 / 全额退款
6.2.12returnShippingCurrency退货运费币种string—Required退货运费币种
6.2.13returnShippingSymbol退货运费币种符号string—Required退货运费币种符号
6.2.14returnStatus退货状态原始值string—Required退货状态原始值
6.2.15returnTypeList售后类型标签列表array<any>—Required售后类型标签列表:退款 / 退货(可同时存在)
6.2.16storeId店铺IDinteger—Required店铺ID
6.2.17storeName店铺名称string—Required店铺名称
6.2.18totalRefundedAmount订单退款总金额integer—Required订单退款总金额
6.2.19totalRefundedCurrency退款币种string—Required退款币种
6.2.20totalRefundedSymbol退款币种符号string—Required退款币种符号
6.2.21totalReturnShippingFee退货运费integer—Required退货运费
6.3pagespagesinteger—Required
6.4sizesizeinteger—Required
6.5totaltotalinteger—Required

The 多平台 - Shopify售后订单列表 API (/basicOpen/openapi/multiplatform/shopify/returnOrder/list) of 领星ERP is curated by the API asset management module of the Qeasy Cloud data integration platform and kept in sync with 领星ERP version updates.

Need to integrate this API?

Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.