轻易云
注册体验

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

所属平台
领星ERP
类型
WebAPI
作用
QUERY
接口版本
1.0
适配器
\Adapter\LingXing\LXQueryAdapter
授权方式
OTHER
描述
多平台 / 售后订单 · POST · 请求参数 15 个(必填 3) · 响应参数 46 个 · 限流令牌桶容量 1
更新日期
2026-11-21

多平台 - Shopify售后订单列表

POST/basicOpen/openapi/multiplatform/shopify/returnOrder/list
加工厂
{
  "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}```"
}

接口请求参数

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

接口响应参数

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

领星ERP的接口:多平台 - Shopify售后订单列表(/basicOpen/openapi/multiplatform/shopify/returnOrder/list),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

轻易云已预置该接口的适配能力,联系我们即可开始配置数据集成。