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