/erp/sc/data/mws/listing{
"operation": {
"method": "POST",
"path": "/erp/sc/data/mws/listing"
},
"protocol": "HTTPS",
"host": "https://openapi.lingxing.com",
"rateLimit": {
"tokenBucketCapacity": 1,
"text": ""
},
"requestExample": {
"sid": "1,16",
"is_pair": 1,
"is_delete": 0,
"pair_update_start_time": "2022-01-01 12:01:21",
"pair_update_end_time": "2022-10-01 12:01:21",
"listing_update_start_time": "2021-09-01 01:22:00",
"listing_update_end_time": "2022-10-01 11:22:00",
"search_field": "asin",
"search_value": [
"asin1",
"asin2"
],
"exact_search": 1,
"store_type": 1,
"offset": 0,
"length": 15
},
"responseExample": "{\n \"code\": 0,\n \"message\": \"success\",\n \"error_details\": [],\n \"request_id\": \"83AAED7E-A5CF-6A09-6446-36F51AA3EEBA\",\n \"response_time\": \"2023-10-30 15:38:54\",\n \"total\": 10,\n \"data\": [\n {\n \"listing_id\": \"0623ZI1F5EF11\",\n \"seller_sku\": \"msku-1\",\n \"fnsku\": \"B085NPWXXX\",\n \"item_name\": \"xxxx \",\n \"local_sku\": \"n2\",\n \"local_name\": \"组合2\",\n \"price\": \"11.10\",\n \"list_price\": \"2.22\",\n \"remark\": \"这是Listing备注\",\n \"quantity\": 11,\n \"asin\": \"B0B4WP82XX\",\n \"parent_asin\": \"B0B4WP82XX\",\n \"small_image_url\": \"https://XXX/XXX.jpg\",\n \"status\": 1,\n \"is_delete\": 0,\n \"afn_fulfillable_quantity\": 0,\n \"reserved_fc_transfers\": 0,\n \"reserved_fc_processing\": 0,\n \"reserved_customerorders\": 0,\n \"afn_inbound_shipped_quantity\": 0,\n \"afn_unsellable_quantity\": 0,\n \"afn_inbound_working_quantity\": 0,\n \"afn_inbound_receiving_quantity\": 0,\n \"currency_code\": \"USD\",\n \"landed_price\": \"11.10\",\n \"listing_price\": \"11.10\",\n \"open_date\": \"2022-06-23 03:55:12 PDT\",\n \"listing_update_date\": \"2023-06-28 17:44:14\",\n \"seller_rank\": 1112193,\n \"seller_brand\": \"str\",\n \"seller_category\": \"[\\\"Beauty & Personal Care\\\"]\",\n \"review_num\": 0,\n \"last_star\": \"0.0\",\n \"fulfillment_channel_type\": \"FBM\",\n \"open_date_display\": \"2022-06-23 03:55:12 -07:00\",\n \"principal_info\": [],\n \"shipping\": \"0.00\",\n \"points\": \"0\",\n \"sid\": 101,\n \"store_type\": 1,\n \"total_volume\": 100,\n \"yesterday_volume\": 100,\n \"fourteen_volume\": 100,\n \"thirty_volume\": 100,\n \"yesterday_amount\": \"110.00\",\n \"seven_amount\": \"200.00\",\n \"thirty_amount\": \"300.00\",\n \"average_seven_volume\": 100,\n \"average_fourteen_volume\": 100,\n \"average_thirty_volume\": 100\n \"dimension_info\": [\n {\n \"item_height\": \"0.00\",\n \"item_height_units_type\": \"\",\n \"item_length\": \"0.00\",\n \"item_length_units_type\": \"\",\n \"item_width\": \"0.00\",\n \"item_width_units_type\": \"\",\n \"item_weight\": \"0.00\",\n \"item_weight_units_type\": \"\",\n \"package_height\": \"0.00\",\n \"package_height_units_type\": \"\",\n \"package_length\": \"0.00\",\n \"package_length_units_type\": \"\",\n \"package_width\": \"0.00\",\n \"package_width_units_type\": \"\",\n \"package_weight\": \"0.00\",\n \"package_weight_units_type\": \"\"\n }\n ],\n \"pair_update_time\": \"2023-10-30 15:25:51\",\n \"small_rank\": [\n {\n \"category\": \"Hair Elastics & Ties\",\n \"rank\": 13758\n }\n ],\n \"on_sale_time\": \"2023-10-04\",\n \"global_tags\":[\n {\n \"globalTagId\": \"907204347399528686\",\n \"tagName\": \"TEST-005\",\n \"color\": \"#3BB84C\"\n }\n ],\n \"variant\": [\n {\n \"attr_name\": \"color\",\n \"attr_value\": \"Sliver\"\n }\n ],\n \"first_order_time\": \"\",\n \"marketplace\": \"美国\",\n \"seller_category_new\": [\n \"Beauty & Personal Care\"\n ] \n }\n ]\n}"
}| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | sid | 店铺id | string | — | 必填 | 店铺id,多个使用英文逗号分隔 ,对应查询亚马逊店铺列表接口对应字段【sid】 |
| 2 | is_pair | 是否配对 | integer | — | 可选 | 是否配对:1 已配对,2 未配对 |
| 3 | is_delete | 是否删除 | integer | — | 可选 | 是否删除:0 未删除,1 已删除 |
| 4 | pair_update_start_time | 【配对更新时间】的开始时间(此为北京时间 | string | — | 可选 | 【配对更新时间】的开始时间(此为北京时间,格式:Y-m-d H:i:s),用此时间查询要求 is_pair=1 |
| 5 | pair_update_end_time | 【配对更新时间】的结束时间(此为北京时间 | string | — | 可选 | 【配对更新时间】的结束时间(此为北京时间,格式:Y-m-d H:i:s),用此时间查询要求 is_pair=1 |
| 6 | listing_update_start_time | listing_update_start_time | string | — | 可选 | 【All Listing报表更新时间】的开始时间(此为零时区时间,格式Y-m-d H:i:s) |
| 7 | listing_update_end_time | listing_update_end_time | string | — | 可选 | 【All Listing报表更新时间】的结束时间(此为零时区时间,格式Y-m-d H:i:s) |
| 8 | search_field | 搜索支持字段 | string | — | 可选 | 搜索支持字段:seller_sku、asin、sku |
| 9 | search_value | 搜索值 | array<any> | — | 可选 | 搜索值,上限10个 |
| 10 | exact_search | 搜索模式 | integer | — | 可选 | 搜索模式:0 模糊搜索,1 精确搜索【默认值】 |
| 11 | store_type | 商品类型 | integer | — | 可选 | 商品类型,1-非低价商店 ,2-低价商店商品 |
| 12 | offset | 分页偏移量 | integer | — | 可选 | 分页偏移量,默认0 |
| 13 | length | 分页长度 | integer | — | 可选 | 分页长度,默认1000,上限1000 |
| 序号 | 字段 | 名称 | 类型 | 默认值 | 必填 | 描述 |
|---|---|---|---|---|---|---|
| 1 | code | 状态码 | integer | 0 | 必填 | 状态码,0 成功 |
| 2 | message | 消息提示 | string | success | 必填 | 消息提示 |
| 3 | error_details | 错误信息 | array<any> | [] | 必填 | 错误信息 |
| 4 | request_id | 请求链路id | string | 83AAED7E-A5CF-6A09-6446-36F51AA3EEBA | 必填 | 请求链路id |
| 5 | response_time | 响应时间 | string | 2020-05-18 11:23:47 | 必填 | 响应时间 |
| 6 | total | 总数 | integer | 1 | 必填 | 总数 |
| 7 | data | 响应数据 | array<object> | — | 必填 | 响应数据 |
| 7.1 | fba_fee | 预估FBA费-API | string | — | 必填 | 预估FBA费-API:API口径预估FBA费 |
| 7.2 | fba_fee_update_time | 预估FBA费-API-更新时间 | string | — | 必填 | 预估FBA费-API-更新时间:API口径预估FBA费更新时间 |
| 7.3 | report_fba_fee | 预估FBA费-报表 | string | — | 必填 | 预估FBA费-报表:报表口径预估FBA费 |
| 7.4 | report_fba_fee_update_time | 预估FBA费-报表-更新时间 | string | — | 必填 | 预估FBA费-报表-更新时间:报表口径预估FBA费更新时间 |
| 7.5 | estimated_referral_fee_rate | 平台费率 | string | — | 必填 | 平台费率,格式如15.0%,无法计算时为空字符串 |
| 7.6 | estimated_referral_fee | 平台费 | string | — | 必填 | 平台费:报表口径平台费 |
| 7.7 | estimated_referral_fee_update_time | 平台费-更新时间 | string | — | 必填 | 平台费-更新时间:平台费报表更新时间 |
| 7.8 | listing_id | 亚马逊定义的listing的id【可能为空】 | string | xx | 必填 | 亚马逊定义的listing的id【可能为空】 |
| 7.9 | sid | 店铺id | integer | — | 必填 | 店铺id |
| 7.10 | marketplace | 国家 | string | 美国 | 必填 | 国家 |
| 7.11 | seller_sku | seller_sku | string | xxxx | 必填 | MSKU |
| 7.12 | fnsku | fnsku | string | xxxx | 必填 | FNSKU |
| 7.13 | asin | asin | string | xxxxx | 必填 | ASIN |
| 7.14 | parent_asin | 父ASIN | string | xxx | 必填 | 父ASIN |
| 7.15 | small_image_url | 商品缩略图地址 | string | https://xxx/xxx.gif | 必填 | 商品缩略图地址 |
| 7.16 | status | 状态 | integer | 1 | 必填 | 状态:0 停售,1 在售 |
| 7.17 | is_delete | 是否删除 | integer | 0 | 必填 | 是否删除:0 否,1 是 |
| 7.18 | item_name | 标题 | string | xxxx | 必填 | 标题 |
| 7.19 | local_sku | 本地产品SKU | string | xxxx | 必填 | 本地产品SKU |
| 7.20 | local_name | 品名 | string | product xxxx | 必填 | 品名 |
| 7.21 | currency_code | 币种 | string | USD | 必填 | 币种 |
| 7.22 | price | 价格【不包含促销 | string | 0.00 | 必填 | 价格【不包含促销,运费,积分】 |
| 7.23 | list_price | List Price | string | 2.22 | 必填 | List Price |
| 7.24 | remark | 备注 | string | 这是Listing备注 | 必填 | 备注 |
| 7.25 | landed_price | 总价【包含了促销、运费、积分】 | string | 19.99 | 必填 | 总价【包含了促销、运费、积分】 |
| 7.26 | listing_price | 优惠价 | string | 19.99 | 必填 | 优惠价 |
| 7.27 | shipping | 运费 | string | 0.00 | 必填 | 运费 |
| 7.28 | points | 积分 | string | — | 必填 | 积分,日本站才有 |
| 7.29 | quantity | FBM库存 | integer | 0 | 必填 | FBM库存 |
| 7.30 | afn_fulfillable_quantity | FBA可售 | integer | 0 | 必填 | FBA可售 |
| 7.31 | afn_unsellable_quantity | FBA不可售 | integer | 0 | 必填 | FBA不可售 |
| 7.32 | reserved_fc_transfers | 待调仓 | integer | 0 | 必填 | 待调仓 |
| 7.33 | reserved_fc_processing | 调仓中 | integer | 0 | 必填 | 调仓中 |
| 7.34 | reserved_customerorders | 待发货 | integer | 0 | 必填 | 待发货 |
| 7.35 | afn_inbound_shipped_quantity | 在途 | integer | 0 | 必填 | 在途 |
| 7.36 | afn_inbound_working_quantity | 计划入库 | integer | 0 | 必填 | 计划入库 |
| 7.37 | afn_inbound_receiving_quantity | 入库中 | integer | 0 | 必填 | 入库中 |
| 7.38 | open_date | 商品创建时间 | string | 2021-02-04 01:15:58 PST | 必填 | 商品创建时间 |
| 7.39 | open_date_display | 商品创建时间 | string | 2021-02-04 01:15:58 -08:00 | 必填 | 商品创建时间,格式:Y-m-d H:i:s+时区 |
| 7.40 | listing_update_date | All Listing报表更新时间 (注意 | string | 2021-03-14 06:53:24 | 必填 | All Listing报表更新时间 (注意:此为零时区时间) |
| 7.41 | seller_rank | 排名 | integer | 38214 | 必填 | 排名 |
| 7.42 | seller_brand | 亚马逊品牌 | string | 38214 | 必填 | 亚马逊品牌 |
| 7.43 | seller_category | 排名所属的类别(后续不再维护 | string | Lighting | 必填 | 排名所属的类别(后续不再维护,改用seller_category_new) |
| 7.44 | review_num | 评论条数 | integer | 0 | 必填 | 评论条数 |
| 7.45 | last_star | 星级评分 | string | 0 | 必填 | 星级评分 |
| 7.46 | fulfillment_channel_type | 配送方式 | string | FBM | 必填 | 配送方式 |
| 7.47 | principal_info | 负责人信息 | array<object> | — | 必填 | 负责人信息 |
| 7.47.1 | principal_uid | 负责人用户id | integer | xx | 必填 | 负责人用户id |
| 7.47.2 | principal_name | 负责人姓名 | string | xxx | 必填 | 负责人姓名 |
| 7.48 | seller_category_new | 排名所属的类别 | array<any> | ["Beauty & Personal Care"] | 必填 | 排名所属的类别 |
| 7.49 | pair_update_time | 配对更新时间 (注意 | string | 2022-02-23 18:10:45 | 必填 | 配对更新时间 (注意:此为北京时间) |
| 7.50 | first_order_time | 首单时间 | string | 2023-01-11 | 必填 | 首单时间,格式:Y-m-d |
| 7.51 | on_sale_time | 开售时间 | string | 2023-02-01 | 必填 | 开售时间,格式:Y-m-d |
| 7.52 | store_type | 商品类型 | integer | 1 | 必填 | 商品类型,1-非低价商店 ,2-低价商店商品 |
| 7.53 | total_volume | 销量-7天 | string | 100 | 必填 | 销量-7天 |
| 7.54 | yesterday_volume | 销量-昨天 | string | 100 | 必填 | 销量-昨天 |
| 7.55 | fourteen_volume | 销量-14天 | string | 100 | 必填 | 销量-14天 |
| 7.56 | thirty_volume | 销量-30天 | string | 100 | 必填 | 销量-30天 |
| 7.57 | yesterday_amount | 销售额-昨天 | string | 110.00 | 必填 | 销售额-昨天 |
| 7.58 | seven_amount | 销售额-7天 | string | 200.00 | 必填 | 销售额-7天 |
| 7.59 | fourteen_amount | 销售额-14天 | string | 200.00 | 必填 | 销售额-14天 |
| 7.60 | thirty_amount | 销售额-30天 | string | 300.00 | 必填 | 销售额-30天 |
| 7.61 | average_seven_volume | 日均销量-7日 | string | 100 | 必填 | 日均销量-7日 |
| 7.62 | average_fourteen_volume | 日均销量-14日 | string | 100 | 必填 | 日均销量-14日 |
| 7.63 | average_thirty_volume | 日均销量-30日 | string | 100 | 必填 | 日均销量-30日 |
| 7.64 | dimension_info | 尺寸信息 | array<object> | — | 必填 | 尺寸信息,没有尺寸信息时是空 |
| 7.64.1 | item_height | 商品高度 | string | 22.68 | 必填 | 商品高度 |
| 7.64.2 | item_height_units_type | 商品高度单位 | string | inch | 必填 | 商品高度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.3 | item_length | 商品长度 | string | 95.36 | 必填 | 商品长度 |
| 7.64.4 | item_length_units_type | 商品长度单位 | string | inch | 必填 | 商品长度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.5 | item_width | 商品宽度 | string | 20.55 | 必填 | 商品宽度 |
| 7.64.6 | item_width_units_type | 商品宽度单位 | string | inch | 必填 | 商品宽度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.7 | item_weight | 商品重量 | string | 5.41 | 必填 | 商品重量 |
| 7.64.8 | item_weight_units_type | 商品重量单位 | object | unknown | 必填 | 商品重量单位: unkown未知单位 空字符串 pounds(ce(盎司,o磅,ib) kg(千克,kg) ounce(盎司,oz) gram(克,g) carat(克拉,ct) |
| 7.64.9 | package_height | 包装高度 | string | 95.63 | 必填 | 包装高度 |
| 7.64.10 | package_height_units_type | 包装高度单位 | string | foot | 必填 | 包装高度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.11 | package_length | 包装长度 | string | 84.37 | 必填 | 包装长度 |
| 7.64.12 | package_length_units_type | 包装长度单位 | string | — | 必填 | 包装长度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.13 | package_width | 包装宽度 | string | 55.46 | 必填 | 包装宽度 |
| 7.64.14 | package_width_units_type | 包装宽度单位 | string | — | 必填 | 包装宽度单位: unkown未知单位 空字符串 inches(英寸复数,in) inch(英寸单数,in) centimeter(厘米,cm) yard(码,yd) veron(弗隆,fur) foot(英尺,ft) |
| 7.64.15 | package_weight | 包装重量 | string | 11.74 | 必填 | 包装重量 |
| 7.64.16 | package_weight_units_type | 包装重量单位 | string | pounds | 必填 | 包装重量单位: unkown未知单位 空字符串 pounds(ce(盎司,o磅,ib) kg(千克,kg) ounce(盎司,oz) gram(克,g) carat(克拉,ct) |
| 7.65 | small_rank | 小类排名信息 | array<object> | — | 必填 | 小类排名信息 |
| 7.65.1 | category | 小类名称 | string | Laptop Stands | 必填 | 小类名称 |
| 7.65.2 | rank | 小类排名 | string | 223 | 必填 | 小类排名 |
| 7.66 | global_tags | 全局标签 | array<object> | — | 必填 | 全局标签 |
| 7.66.1 | globalTagId | 全局标签ID | string | 907204347399528686 | 必填 | 全局标签ID |
| 7.66.2 | tagName | 标签名称 | string | TEST-005 | 必填 | 标签名称 |
| 7.66.3 | color | 颜色 | string | #3BB84C | 必填 | 颜色 |
| 7.67 | variant | 变体属性 | array<object> | — | 必填 | 变体属性 |
| 7.67.1 | attr_name | 属性名称 | string | color | 必填 | 属性名称 |
| 7.67.2 | attr_value | 属性值 | string | Sliver | 必填 | 属性值 |
领星ERP的接口:查询亚马逊Listing(/erp/sc/data/mws/listing),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。