轻易云
注册体验

领星ERP统计 - 查询退货分析接口

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

统计 - 查询退货分析

POST/basicOpen/salesAnalysis/returnOrder/analysisLists
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/salesAnalysis/returnOrder/analysisLists"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/salesAnalysis/returnOrder/analysisLists?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"endDate\": \"2024-11-12\",\n    \"length\": 20,\n    \"offset\": 0,\n    \"startDate\": \"2024-11-01\",\n    \"asinType\": \"msku\",\n    \"dateType\": 0,\n    \"mids\": [1,2,3],\n    \"principalUid\": [1234567890,9876543210],\n    \"searchField\": \"msku\",\n    \"searchValue\": [\"TEST-SKU-001\",\"TEST-SKU-002\"],\n    \"sortField\": \"curReturnGoodsCount\",\n    \"sortType\": \"DESC\",\n    \"storeId\": [123456789012345]\n}'",
  "responseExample": {
    "code": 0,
    "data": {
      "records": [
        {
          "asinsList": [
            {
              "asin": "B08XYZ123AB",
              "asinUrl": ""
            }
          ],
          "curReturnGoodsCount": 30,
          "curReturnGoodsCountDistribution": {
            "fbaQuantity": 25,
            "fbmQuantity": 5
          },
          "curReturnGoodsItems": 20,
          "curReturnGoodsItemsDistribution": {
            "fbaQuantity": 15,
            "fbmQuantity": 5
          },
          "curReturnGoodsVolumeRatio": "5.00%",
          "curVolume": 600,
          "eventDate": "2024-06-10",
          "fnskuInfoList": [
            {
              "fnsku": "X001ABC123",
              "msku": "TEST-MSKU-001"
            }
          ],
          "infoDTOList": [
            {
              "asin": "B08XYZ123AB",
              "asinUrl": "",
              "bid": 9876543210,
              "brandTitle": "MyBrand",
              "categoryTitle": "服装",
              "cid": "12345",
              "country": "US",
              "fnsku": "X001ABC123",
              "fulfillmentChannel": "FBA",
              "localName": "男士圆领T恤",
              "localSku": "LOCAL-SKU-001",
              "msku": "TEST-MSKU-001",
              "sellerName": "MyAmazonStore",
              "sid": 1234567890,
              "smallImageUrl": "",
              "spu": "SPU-2024-001",
              "spuName": "夏季T恤系列"
            }
          ],
          "isParent": "1",
          "localSkuInfoList": [
            {
              "localName": "男士圆领T恤",
              "localSku": "LOCAL-SKU-001"
            }
          ],
          "mostCommonReturnReasonBucket": "产品质量问题",
          "msku": "TEST-MSKU-001",
          "ncxCount": 7,
          "ncxRate": "3.50%",
          "orderCount": 200,
          "parentAsinsList": "[\"B08XYZABC1\",\"B09ABCXYZ2\"]",
          "pcxHealth": "Good",
          "preReturnGoodsCount": 25,
          "preReturnGoodsItems": 15,
          "preReturnGoodsVolumeRatio": "5.00%",
          "preVolume": 500,
          "returnBadge": "高退货率",
          "returnGoodsCountRatio": "20.00%",
          "returnGoodsVolumeRatioDiff": "1.50%",
          "selFnskuSkuInfoList": [
            {
              "country": "US",
              "fnsku": "X001ABC123",
              "localName": "男士圆领T恤",
              "localSku": "LOCAL-SKU-001",
              "msku": "TEST-MSKU-001",
              "sellerName": "MyAmazonStore",
              "sid": 1234567890
            }
          ],
          "selfnskuInfoList": [
            {
              "country": "US",
              "fnsku": "X001ABC123",
              "msku": "TEST-MSKU-001",
              "sellerName": "MyAmazonStore",
              "sid": 1234567890
            }
          ],
          "sellerInfoList": [
            {
              "country": "US",
              "sellerName": "MyAmazonStore",
              "sid": 1234567890
            }
          ],
          "sid": 1234567890,
          "spuInfoList": [
            {
              "spu": "SPU-2024-001",
              "spuName": "夏季T恤系列"
            }
          ]
        }
      ],
      "total": 100
    },
    "error_details": [],
    "message": "value",
    "request_id": "value",
    "response_time": "value",
    "total": 0
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1endDate结束日期string—可选结束日期,格式:yyyy-MM-dd,与startDate配合使用,最多支持366天范围
2length分页长度integer—可选分页长度,每页数据条数
3offset分页偏移量integer—可选分页偏移量,当前页码
4startDate开始日期string—可选开始日期,格式:yyyy-MM-dd,与endDate配合使用,最多支持366天范围
5asinType维度类型string—可选维度类型,枚举值:msku, asin, parentAsin, sku, spu(注意:不支持sid、country、category、band)
6dateType时间类型integer—可选时间类型,枚举值:0-退货时间, 1-下单时间
7mids国家ID列表(mid)array<any>—可选国家ID列表(mid)
8principalUid负责人ID列表array<any>—可选负责人ID列表
9searchField搜索字段类型string—可选搜索字段类型,枚举值:msku-MSKU, asin-ASIN, parentAsin-父ASIN, localSku-SKU, localName-品名, spu-SPU, spuName-款名
10searchValue搜索值列表array<any>—可选搜索值列表,与searchField配合使用
11sortField排序字段string—可选排序字段,枚举值:curReturnGoodsCount-退货量, returnGoodsCountRatio-退货量环比, curVolume-销量, curReturnGoodsVolumeRatio-退货率, returnGoodsVolumeRatioDiff-退货率环比差异
12sortType排序类型string—可选排序类型,枚举值:ASC-升序, DESC-降序
13storeId店铺ID列表array<any>—可选店铺ID列表

接口响应参数

序号字段名称类型默认值必填描述
1code响应码integer—必填响应码
2data返回数据object—必填返回数据
2.1records退货分析记录列表array<object>—必填退货分析记录列表
2.1.1asinsListASIN列表array<object>—必填ASIN列表
2.1.1.1asinasinstringB08XYZ123AB必填ASIN,亚马逊标准识别号
2.1.1.2asinUrlASIN商品详情页URL地址string—必填ASIN商品详情页URL地址
2.1.2curReturnGoodsCount当期退货量integer30必填当期退货量
2.1.3curReturnGoodsCountDistribution当期退货量分布明细(FBA/FBM)object—必填当期退货量分布明细(FBA/FBM)
2.1.3.1fbaQuantityFBA退货数量integer25必填FBA退货数量
2.1.3.2fbmQuantityFBM退货数量integer5必填FBM退货数量
2.1.4curReturnGoodsItems当期退货订单数integer20必填当期退货订单数
2.1.5curReturnGoodsItemsDistribution当期退货订单数分布明细(FBA/FBM)object—必填当期退货订单数分布明细(FBA/FBM)
2.1.5.1fbaQuantityFBA退货订单数integer15必填FBA退货订单数
2.1.5.2fbmQuantityFBM退货订单数integer5必填FBM退货订单数
2.1.6curReturnGoodsVolumeRatio当期退货率string5.00%必填当期退货率
2.1.7curVolume当期销量integer600必填当期销量
2.1.8eventDate买家之声-后台更新时间string2024-06-10可选买家之声-后台更新时间,格式:yyyy-MM-dd,仅MSKU维度有此字段
2.1.9fnskuInfoListFNSKU信息列表array<object>—必填FNSKU信息列表
2.1.9.1fnskufnskustringX001ABC123必填FNSKU,亚马逊物流SKU
2.1.9.2mskumskustringTEST-MSKU-001必填MSKU,卖家SKU
2.1.10infoDTOList综合信息列表(包含商品、店铺、分类等详细信息)array<object>—必填综合信息列表(包含商品、店铺、分类等详细信息)
2.1.10.1asinasinstringB08XYZ123AB必填ASIN,亚马逊标准识别号
2.1.10.2asinUrlASIN商品详情页URL地址string3必填ASIN商品详情页URL地址
2.1.10.3bid品牌IDinteger9876543210必填品牌ID
2.1.10.4brandTitle品牌标题stringMyBrand必填品牌标题
2.1.10.5categoryTitle商品分类标题string服装必填商品分类标题
2.1.10.6cid分类IDstring12345必填分类ID
2.1.10.7country国家代码stringUS必填国家代码
2.1.10.8fnskufnskustringX001ABC123必填FNSKU,亚马逊物流SKU
2.1.10.9fulfillmentChannel配送渠道stringFBA必填配送渠道,枚举值:FBA-亚马逊配送, FBM-卖家自配送
2.1.10.10localName本地商品名称string男士圆领T恤必填本地商品名称,品名
2.1.10.11localSku本地SKUstringLOCAL-SKU-001必填本地SKU
2.1.10.12mskumskustringTEST-MSKU-001必填MSKU,卖家SKU
2.1.10.13sellerName店铺名称stringMyAmazonStore必填店铺名称
2.1.10.14sid店铺IDinteger1234567890必填店铺ID
2.1.10.15smallImageUrl商品小图片URL地址stringg必填商品小图片URL地址
2.1.10.16spuSPU编码stringSPU-2024-001必填SPU编码
2.1.10.17spuNameSPU名称string夏季T恤系列必填SPU名称,款名
2.1.11isParent是否为父ASINstring1必填是否为父ASIN
2.1.12localSkuInfoList本地SKU信息列表array<object>—必填本地SKU信息列表
2.1.12.1localName本地商品名称string男士圆领T恤必填本地商品名称,品名
2.1.12.2localSku本地SKUstringLOCAL-SKU-001必填本地SKU
2.1.13mostCommonReturnReasonBucket买家之声-Top NCX Reasonstring产品质量问题可选买家之声-Top NCX Reason,最常见的不满意原因,仅MSKU维度有此字段
2.1.14mskumskustringTEST-MSKU-001必填MSKU,卖家SKU
2.1.15ncxCount买家之声-不满意订单数integer7可选买家之声-不满意订单数,仅MSKU/ASIN/父ASIN维度有此字段
2.1.16ncxRate买家之声-不满意率string3.50%可选买家之声-不满意率,百分比格式,仅MSKU/ASIN/父ASIN维度有此字段
2.1.17orderCount买家之声-订单总数integer200可选买家之声-订单总数,仅MSKU/ASIN/父ASIN维度有此字段
2.1.18parentAsinsList父ASIN列表array<any>["B08XYZABC1","B09ABCXYZ2"]必填父ASIN列表
2.1.19pcxHealth买家之声-满意度状况stringGood可选买家之声-满意度状况,枚举值:Good-良好, Fair-一般, Poor-差,仅MSKU维度有此字段
2.1.20preReturnGoodsCount上期退货量integer25必填上期退货量
2.1.21preReturnGoodsItems上期退货订单数integer15必填上期退货订单数
2.1.22preReturnGoodsVolumeRatio上期退货率string5.00%必填上期退货率
2.1.23preVolume上期销量integer500必填上期销量
2.1.24returnBadge退货标记string高退货率可选退货标记,仅MSKU/ASIN/父ASIN维度有此字段
2.1.25returnGoodsCountRatio退货量环比string20.00%必填退货量环比,相对于上期的增长率
2.1.26returnGoodsVolumeRatioDiff退货率环比差异string1.50%必填退货率环比差异,当期退货率与上期退货率的差值
2.1.27selFnskuSkuInfoList店铺FNSKU+SKU综合信息列表array<object>—必填店铺FNSKU+SKU综合信息列表
2.1.27.1country国家代码stringUS必填国家代码
2.1.27.2fnskufnskustringX001ABC123必填FNSKU,亚马逊物流SKU
2.1.27.3localName本地商品名称string男士圆领T恤必填本地商品名称,品名
2.1.27.4localSku本地SKUstringLOCAL-SKU-001必填本地SKU
2.1.27.5mskumskustringTEST-MSKU-001必填MSKU,卖家SKU
2.1.27.6sellerName店铺名称stringMyAmazonStore必填店铺名称
2.1.27.7sid店铺IDinteger1234567890必填店铺ID
2.1.28selfnskuInfoList店铺FNSKU信息列表array<object>—必填店铺FNSKU信息列表
2.1.28.1country国家代码stringUS必填国家代码
2.1.28.2fnskufnskustringX001ABC123必填FNSKU,亚马逊物流SKU
2.1.28.3mskumskustringTEST-MSKU-001必填MSKU,卖家SKU
2.1.28.4sellerName店铺名称stringMyAmazonStore必填店铺名称
2.1.28.5sid店铺IDinteger1234567890必填店铺ID
2.1.29sellerInfoList店铺信息列表array<object>—必填店铺信息列表
2.1.29.1country国家代码stringUS必填国家代码
2.1.29.2sellerName店铺名称stringMyAmazonStore必填店铺名称
2.1.29.3sid店铺IDinteger1234567890必填店铺ID
2.1.30sid店铺IDinteger1234567890必填店铺ID
2.1.31spuInfoListSPU信息列表array<object>—必填SPU信息列表
2.1.31.1spuSPU编码stringSPU-2024-001必填SPU编码
2.1.31.2spuNameSPU名称string夏季T恤系列必填SPU名称,款名
2.2total总记录数integer100必填总记录数
3error_details错误详情array<any>—必填错误详情
4message提示信息string—必填提示信息
5request_id请求idstring—必填请求id
6response_time响应时间string—必填响应时间
7total总记录数integer—必填总记录数

领星ERP的接口:统计 - 查询退货分析(/basicOpen/salesAnalysis/returnOrder/analysisLists),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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