Lingxing
切换旧版

统计 - 查询退货分析

POST/basicOpen/salesAnalysis/returnOrder/analysisLists

支持统计-查询退货分析

接口信息

API Path请求协议请求方式令牌桶容量
/basicOpen/salesAnalysis/returnOrder/analysisListsHTTPSPOST1

请求参数

endDatestring
结束日期,格式:yyyy-MM-dd,与startDate配合使用,最多支持366天范围
lengthinteger
分页长度,每页数据条数
offsetinteger
分页偏移量,当前页码
startDatestring
开始日期,格式:yyyy-MM-dd,与endDate配合使用,最多支持366天范围
asinTypestring
维度类型,枚举值:msku, asin, parentAsin, sku, spu(注意:不支持sid、country、category、band)
dateTypeinteger
时间类型,枚举值:0-退货时间, 1-下单时间
midsarray<any>
国家ID列表(mid)
principalUidarray<any>
负责人ID列表
searchFieldstring
搜索字段类型,枚举值:msku-MSKU, asin-ASIN, parentAsin-父ASIN, localSku-SKU, localName-品名, spu-SPU, spuName-款名
searchValuearray<any>
搜索值列表,与searchField配合使用
sortFieldstring
排序字段,枚举值:curReturnGoodsCount-退货量, returnGoodsCountRatio-退货量环比, curVolume-销量, curReturnGoodsVolumeRatio-退货率, returnGoodsVolumeRatioDiff-退货率环比差异
sortTypestring
排序类型,枚举值:ASC-升序, DESC-降序
storeIdarray<any>
店铺ID列表

请求cURL示例

curl --location 'https://openapi.lingxing.com/basicOpen/salesAnalysis/returnOrder/analysisLists?access_token=value&timestamp=value&sign=value&app_key=value' \
--header 'Content-Type: application/json' \
--data '{
    "endDate": "2024-11-12",
    "length": 20,
    "offset": 0,
    "startDate": "2024-11-01",
    "asinType": "msku",
    "dateType": 0,
    "mids": [1,2,3],
    "principalUid": [1234567890,9876543210],
    "searchField": "msku",
    "searchValue": ["TEST-SKU-001","TEST-SKU-002"],
    "sortField": "curReturnGoodsCount",
    "sortType": "DESC",
    "storeId": [123456789012345]
}'

返回结果

Json Object

codeinteger必填
响应码
dataobject必填
返回数据
隐藏子属性
recordsarray<object>必填
退货分析记录列表
隐藏子属性
asinsListarray<object>必填
ASIN列表
隐藏子属性
asinstring必填
ASIN,亚马逊标准识别号
示例 B08XYZ123AB
asinUrlstring必填
ASIN商品详情页URL地址
curReturnGoodsCountinteger必填
当期退货量
示例 30
curReturnGoodsCountDistributionobject必填
当期退货量分布明细(FBA/FBM)
隐藏子属性
fbaQuantityinteger必填
FBA退货数量
示例 25
fbmQuantityinteger必填
FBM退货数量
示例 5
curReturnGoodsItemsinteger必填
当期退货订单数
示例 20
curReturnGoodsItemsDistributionobject必填
当期退货订单数分布明细(FBA/FBM)
隐藏子属性
fbaQuantityinteger必填
FBA退货订单数
示例 15
fbmQuantityinteger必填
FBM退货订单数
示例 5
curReturnGoodsVolumeRatiostring必填
当期退货率
示例 5.00%
curVolumeinteger必填
当期销量
示例 600
eventDatestring
买家之声-后台更新时间,格式:yyyy-MM-dd,仅MSKU维度有此字段
示例 2024-06-10
fnskuInfoListarray<object>必填
FNSKU信息列表
隐藏子属性
fnskustring必填
FNSKU,亚马逊物流SKU
示例 X001ABC123
mskustring必填
MSKU,卖家SKU
示例 TEST-MSKU-001
infoDTOListarray<object>必填
综合信息列表(包含商品、店铺、分类等详细信息)
隐藏子属性
asinstring必填
ASIN,亚马逊标准识别号
示例 B08XYZ123AB
asinUrlstring必填
ASIN商品详情页URL地址
示例 3
bidinteger必填
品牌ID
示例 9876543210
brandTitlestring必填
品牌标题
示例 MyBrand
categoryTitlestring必填
商品分类标题
示例 服装
cidstring必填
分类ID
示例 12345
countrystring必填
国家代码
示例 US
fnskustring必填
FNSKU,亚马逊物流SKU
示例 X001ABC123
fulfillmentChannelstring必填
配送渠道,枚举值:FBA-亚马逊配送, FBM-卖家自配送
示例 FBA
localNamestring必填
本地商品名称,品名
示例 男士圆领T恤
localSkustring必填
本地SKU
示例 LOCAL-SKU-001
mskustring必填
MSKU,卖家SKU
示例 TEST-MSKU-001
sellerNamestring必填
店铺名称
示例 MyAmazonStore
sidinteger必填
店铺ID
示例 1234567890
smallImageUrlstring必填
商品小图片URL地址
示例 g
spustring必填
SPU编码
示例 SPU-2024-001
spuNamestring必填
SPU名称,款名
示例 夏季T恤系列
isParentstring必填
是否为父ASIN
示例 1
localSkuInfoListarray<object>必填
本地SKU信息列表
隐藏子属性
localNamestring必填
本地商品名称,品名
示例 男士圆领T恤
localSkustring必填
本地SKU
示例 LOCAL-SKU-001
mostCommonReturnReasonBucketstring
买家之声-Top NCX Reason,最常见的不满意原因,仅MSKU维度有此字段
示例 产品质量问题
mskustring必填
MSKU,卖家SKU
示例 TEST-MSKU-001
ncxCountinteger
买家之声-不满意订单数,仅MSKU/ASIN/父ASIN维度有此字段
示例 7
ncxRatestring
买家之声-不满意率,百分比格式,仅MSKU/ASIN/父ASIN维度有此字段
示例 3.50%
orderCountinteger
买家之声-订单总数,仅MSKU/ASIN/父ASIN维度有此字段
示例 200
parentAsinsListarray<any>必填
父ASIN列表
示例 ["B08XYZABC1","B09ABCXYZ2"]
pcxHealthstring
买家之声-满意度状况,枚举值:Good-良好, Fair-一般, Poor-差,仅MSKU维度有此字段
示例 Good
preReturnGoodsCountinteger必填
上期退货量
示例 25
preReturnGoodsItemsinteger必填
上期退货订单数
示例 15
preReturnGoodsVolumeRatiostring必填
上期退货率
示例 5.00%
preVolumeinteger必填
上期销量
示例 500
returnBadgestring
退货标记,仅MSKU/ASIN/父ASIN维度有此字段
示例 高退货率
returnGoodsCountRatiostring必填
退货量环比,相对于上期的增长率
示例 20.00%
returnGoodsVolumeRatioDiffstring必填
退货率环比差异,当期退货率与上期退货率的差值
示例 1.50%
selFnskuSkuInfoListarray<object>必填
店铺FNSKU+SKU综合信息列表
隐藏子属性
countrystring必填
国家代码
示例 US
fnskustring必填
FNSKU,亚马逊物流SKU
示例 X001ABC123
localNamestring必填
本地商品名称,品名
示例 男士圆领T恤
localSkustring必填
本地SKU
示例 LOCAL-SKU-001
mskustring必填
MSKU,卖家SKU
示例 TEST-MSKU-001
sellerNamestring必填
店铺名称
示例 MyAmazonStore
sidinteger必填
店铺ID
示例 1234567890
selfnskuInfoListarray<object>必填
店铺FNSKU信息列表
隐藏子属性
countrystring必填
国家代码
示例 US
fnskustring必填
FNSKU,亚马逊物流SKU
示例 X001ABC123
mskustring必填
MSKU,卖家SKU
示例 TEST-MSKU-001
sellerNamestring必填
店铺名称
示例 MyAmazonStore
sidinteger必填
店铺ID
示例 1234567890
sellerInfoListarray<object>必填
店铺信息列表
隐藏子属性
countrystring必填
国家代码
示例 US
sellerNamestring必填
店铺名称
示例 MyAmazonStore
sidinteger必填
店铺ID
示例 1234567890
sidinteger必填
店铺ID
示例 1234567890
spuInfoListarray<object>必填
SPU信息列表
隐藏子属性
spustring必填
SPU编码
示例 SPU-2024-001
spuNamestring必填
SPU名称,款名
示例 夏季T恤系列
totalinteger必填
总记录数
示例 100
error_detailsarray<any>必填
错误详情
messagestring必填
提示信息
request_idstring必填
请求id
response_timestring必填
响应时间
totalinteger必填
总记录数

返回成功示例

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