/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×tamp=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
}
}| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | endDate | 结束日期 | string | — | Optional | 结束日期,格式:yyyy-MM-dd,与startDate配合使用,最多支持366天范围 |
| 2 | length | 分页长度 | integer | — | Optional | 分页长度,每页数据条数 |
| 3 | offset | 分页偏移量 | integer | — | Optional | 分页偏移量,当前页码 |
| 4 | startDate | 开始日期 | string | — | Optional | 开始日期,格式:yyyy-MM-dd,与endDate配合使用,最多支持366天范围 |
| 5 | asinType | 维度类型 | string | — | Optional | 维度类型,枚举值:msku, asin, parentAsin, sku, spu(注意:不支持sid、country、category、band) |
| 6 | dateType | 时间类型 | integer | — | Optional | 时间类型,枚举值:0-退货时间, 1-下单时间 |
| 7 | mids | 国家ID列表(mid) | array<any> | — | Optional | 国家ID列表(mid) |
| 8 | principalUid | 负责人ID列表 | array<any> | — | Optional | 负责人ID列表 |
| 9 | searchField | 搜索字段类型 | string | — | Optional | 搜索字段类型,枚举值:msku-MSKU, asin-ASIN, parentAsin-父ASIN, localSku-SKU, localName-品名, spu-SPU, spuName-款名 |
| 10 | searchValue | 搜索值列表 | array<any> | — | Optional | 搜索值列表,与searchField配合使用 |
| 11 | sortField | 排序字段 | string | — | Optional | 排序字段,枚举值:curReturnGoodsCount-退货量, returnGoodsCountRatio-退货量环比, curVolume-销量, curReturnGoodsVolumeRatio-退货率, returnGoodsVolumeRatioDiff-退货率环比差异 |
| 12 | sortType | 排序类型 | string | — | Optional | 排序类型,枚举值:ASC-升序, DESC-降序 |
| 13 | storeId | 店铺ID列表 | array<any> | — | Optional | 店铺ID列表 |
| No. | Field | Name | Type | Default | Required | Description |
|---|---|---|---|---|---|---|
| 1 | code | 响应码 | integer | — | Required | 响应码 |
| 2 | data | 返回数据 | object | — | Required | 返回数据 |
| 2.1 | records | 退货分析记录列表 | array<object> | — | Required | 退货分析记录列表 |
| 2.1.1 | asinsList | ASIN列表 | array<object> | — | Required | ASIN列表 |
| 2.1.1.1 | asin | asin | string | B08XYZ123AB | Required | ASIN,亚马逊标准识别号 |
| 2.1.1.2 | asinUrl | ASIN商品详情页URL地址 | string | — | Required | ASIN商品详情页URL地址 |
| 2.1.2 | curReturnGoodsCount | 当期退货量 | integer | 30 | Required | 当期退货量 |
| 2.1.3 | curReturnGoodsCountDistribution | 当期退货量分布明细(FBA/FBM) | object | — | Required | 当期退货量分布明细(FBA/FBM) |
| 2.1.3.1 | fbaQuantity | FBA退货数量 | integer | 25 | Required | FBA退货数量 |
| 2.1.3.2 | fbmQuantity | FBM退货数量 | integer | 5 | Required | FBM退货数量 |
| 2.1.4 | curReturnGoodsItems | 当期退货订单数 | integer | 20 | Required | 当期退货订单数 |
| 2.1.5 | curReturnGoodsItemsDistribution | 当期退货订单数分布明细(FBA/FBM) | object | — | Required | 当期退货订单数分布明细(FBA/FBM) |
| 2.1.5.1 | fbaQuantity | FBA退货订单数 | integer | 15 | Required | FBA退货订单数 |
| 2.1.5.2 | fbmQuantity | FBM退货订单数 | integer | 5 | Required | FBM退货订单数 |
| 2.1.6 | curReturnGoodsVolumeRatio | 当期退货率 | string | 5.00% | Required | 当期退货率 |
| 2.1.7 | curVolume | 当期销量 | integer | 600 | Required | 当期销量 |
| 2.1.8 | eventDate | 买家之声-后台更新时间 | string | 2024-06-10 | Optional | 买家之声-后台更新时间,格式:yyyy-MM-dd,仅MSKU维度有此字段 |
| 2.1.9 | fnskuInfoList | FNSKU信息列表 | array<object> | — | Required | FNSKU信息列表 |
| 2.1.9.1 | fnsku | fnsku | string | X001ABC123 | Required | FNSKU,亚马逊物流SKU |
| 2.1.9.2 | msku | msku | string | TEST-MSKU-001 | Required | MSKU,卖家SKU |
| 2.1.10 | infoDTOList | 综合信息列表(包含商品、店铺、分类等详细信息) | array<object> | — | Required | 综合信息列表(包含商品、店铺、分类等详细信息) |
| 2.1.10.1 | asin | asin | string | B08XYZ123AB | Required | ASIN,亚马逊标准识别号 |
| 2.1.10.2 | asinUrl | ASIN商品详情页URL地址 | string | 3 | Required | ASIN商品详情页URL地址 |
| 2.1.10.3 | bid | 品牌ID | integer | 9876543210 | Required | 品牌ID |
| 2.1.10.4 | brandTitle | 品牌标题 | string | MyBrand | Required | 品牌标题 |
| 2.1.10.5 | categoryTitle | 商品分类标题 | string | 服装 | Required | 商品分类标题 |
| 2.1.10.6 | cid | 分类ID | string | 12345 | Required | 分类ID |
| 2.1.10.7 | country | 国家代码 | string | US | Required | 国家代码 |
| 2.1.10.8 | fnsku | fnsku | string | X001ABC123 | Required | FNSKU,亚马逊物流SKU |
| 2.1.10.9 | fulfillmentChannel | 配送渠道 | string | FBA | Required | 配送渠道,枚举值:FBA-亚马逊配送, FBM-卖家自配送 |
| 2.1.10.10 | localName | 本地商品名称 | string | 男士圆领T恤 | Required | 本地商品名称,品名 |
| 2.1.10.11 | localSku | 本地SKU | string | LOCAL-SKU-001 | Required | 本地SKU |
| 2.1.10.12 | msku | msku | string | TEST-MSKU-001 | Required | MSKU,卖家SKU |
| 2.1.10.13 | sellerName | 店铺名称 | string | MyAmazonStore | Required | 店铺名称 |
| 2.1.10.14 | sid | 店铺ID | integer | 1234567890 | Required | 店铺ID |
| 2.1.10.15 | smallImageUrl | 商品小图片URL地址 | string | g | Required | 商品小图片URL地址 |
| 2.1.10.16 | spu | SPU编码 | string | SPU-2024-001 | Required | SPU编码 |
| 2.1.10.17 | spuName | SPU名称 | string | 夏季T恤系列 | Required | SPU名称,款名 |
| 2.1.11 | isParent | 是否为父ASIN | string | 1 | Required | 是否为父ASIN |
| 2.1.12 | localSkuInfoList | 本地SKU信息列表 | array<object> | — | Required | 本地SKU信息列表 |
| 2.1.12.1 | localName | 本地商品名称 | string | 男士圆领T恤 | Required | 本地商品名称,品名 |
| 2.1.12.2 | localSku | 本地SKU | string | LOCAL-SKU-001 | Required | 本地SKU |
| 2.1.13 | mostCommonReturnReasonBucket | 买家之声-Top NCX Reason | string | 产品质量问题 | Optional | 买家之声-Top NCX Reason,最常见的不满意原因,仅MSKU维度有此字段 |
| 2.1.14 | msku | msku | string | TEST-MSKU-001 | Required | MSKU,卖家SKU |
| 2.1.15 | ncxCount | 买家之声-不满意订单数 | integer | 7 | Optional | 买家之声-不满意订单数,仅MSKU/ASIN/父ASIN维度有此字段 |
| 2.1.16 | ncxRate | 买家之声-不满意率 | string | 3.50% | Optional | 买家之声-不满意率,百分比格式,仅MSKU/ASIN/父ASIN维度有此字段 |
| 2.1.17 | orderCount | 买家之声-订单总数 | integer | 200 | Optional | 买家之声-订单总数,仅MSKU/ASIN/父ASIN维度有此字段 |
| 2.1.18 | parentAsinsList | 父ASIN列表 | array<any> | ["B08XYZABC1","B09ABCXYZ2"] | Required | 父ASIN列表 |
| 2.1.19 | pcxHealth | 买家之声-满意度状况 | string | Good | Optional | 买家之声-满意度状况,枚举值:Good-良好, Fair-一般, Poor-差,仅MSKU维度有此字段 |
| 2.1.20 | preReturnGoodsCount | 上期退货量 | integer | 25 | Required | 上期退货量 |
| 2.1.21 | preReturnGoodsItems | 上期退货订单数 | integer | 15 | Required | 上期退货订单数 |
| 2.1.22 | preReturnGoodsVolumeRatio | 上期退货率 | string | 5.00% | Required | 上期退货率 |
| 2.1.23 | preVolume | 上期销量 | integer | 500 | Required | 上期销量 |
| 2.1.24 | returnBadge | 退货标记 | string | 高退货率 | Optional | 退货标记,仅MSKU/ASIN/父ASIN维度有此字段 |
| 2.1.25 | returnGoodsCountRatio | 退货量环比 | string | 20.00% | Required | 退货量环比,相对于上期的增长率 |
| 2.1.26 | returnGoodsVolumeRatioDiff | 退货率环比差异 | string | 1.50% | Required | 退货率环比差异,当期退货率与上期退货率的差值 |
| 2.1.27 | selFnskuSkuInfoList | 店铺FNSKU+SKU综合信息列表 | array<object> | — | Required | 店铺FNSKU+SKU综合信息列表 |
| 2.1.27.1 | country | 国家代码 | string | US | Required | 国家代码 |
| 2.1.27.2 | fnsku | fnsku | string | X001ABC123 | Required | FNSKU,亚马逊物流SKU |
| 2.1.27.3 | localName | 本地商品名称 | string | 男士圆领T恤 | Required | 本地商品名称,品名 |
| 2.1.27.4 | localSku | 本地SKU | string | LOCAL-SKU-001 | Required | 本地SKU |
| 2.1.27.5 | msku | msku | string | TEST-MSKU-001 | Required | MSKU,卖家SKU |
| 2.1.27.6 | sellerName | 店铺名称 | string | MyAmazonStore | Required | 店铺名称 |
| 2.1.27.7 | sid | 店铺ID | integer | 1234567890 | Required | 店铺ID |
| 2.1.28 | selfnskuInfoList | 店铺FNSKU信息列表 | array<object> | — | Required | 店铺FNSKU信息列表 |
| 2.1.28.1 | country | 国家代码 | string | US | Required | 国家代码 |
| 2.1.28.2 | fnsku | fnsku | string | X001ABC123 | Required | FNSKU,亚马逊物流SKU |
| 2.1.28.3 | msku | msku | string | TEST-MSKU-001 | Required | MSKU,卖家SKU |
| 2.1.28.4 | sellerName | 店铺名称 | string | MyAmazonStore | Required | 店铺名称 |
| 2.1.28.5 | sid | 店铺ID | integer | 1234567890 | Required | 店铺ID |
| 2.1.29 | sellerInfoList | 店铺信息列表 | array<object> | — | Required | 店铺信息列表 |
| 2.1.29.1 | country | 国家代码 | string | US | Required | 国家代码 |
| 2.1.29.2 | sellerName | 店铺名称 | string | MyAmazonStore | Required | 店铺名称 |
| 2.1.29.3 | sid | 店铺ID | integer | 1234567890 | Required | 店铺ID |
| 2.1.30 | sid | 店铺ID | integer | 1234567890 | Required | 店铺ID |
| 2.1.31 | spuInfoList | SPU信息列表 | array<object> | — | Required | SPU信息列表 |
| 2.1.31.1 | spu | SPU编码 | string | SPU-2024-001 | Required | SPU编码 |
| 2.1.31.2 | spuName | SPU名称 | string | 夏季T恤系列 | Required | SPU名称,款名 |
| 2.2 | total | 总记录数 | integer | 100 | Required | 总记录数 |
| 3 | error_details | 错误详情 | array<any> | — | Required | 错误详情 |
| 4 | message | 提示信息 | string | — | Required | 提示信息 |
| 5 | request_id | 请求id | string | — | Required | 请求id |
| 6 | response_time | 响应时间 | string | — | Required | 响应时间 |
| 7 | total | 总记录数 | integer | — | Required | 总记录数 |
The 统计 - 查询退货分析 API (/basicOpen/salesAnalysis/returnOrder/analysisLists) 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.
Qeasy ships with prebuilt adaptation for this API — contact us to start configuring data integration.