轻易云
注册体验

领星ERP查询FBA库存列表 - v2接口

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

查询FBA库存列表 - v2

POST/basicOpen/openapi/storage/fbaWarehouseDetail
加工厂
{
  "operation": {
    "method": "POST",
    "path": "/basicOpen/openapi/storage/fbaWarehouseDetail"
  },
  "protocol": "HTTPS",
  "host": "https://openapi.lingxing.com",
  "rateLimit": {
    "tokenBucketCapacity": 1,
    "text": ""
  },
  "requestExample": "curl --location 'https://openapi.lingxing.com/basicOpen/openapi/storage/fbaWarehouseDetail?access_token=value&timestamp=value&sign=value&app_key=value' \\\n--header 'Content-Type: application/json' \\\n--data '{\n    \"cid\": \"value\",\n    \"bid\": \"value\",\n    \"sid\": \"value\",\n    \"attribute\": \"value\",\n    \"asin_principal\": \"value\",\n    \"search_field\": \"value\",\n    \"search_value\": \"value\",\n    \"is_cost_page\": value,\n    \"status\": \"value\",\n    \"senior_search_list\": \"value\",\n    \"offset\": value,\n    \"length\": value,\n    \"fulfillment_channel_type\": \"value\",\n    \"is_hide_zero_stock\": \"value\",\n    \"is_parant_asin_merge\": \"value\",\n    \"is_contain_del_ls\": \"value\"\n}'",
  "responseExample": {
    "code": 0,
    "message": "success",
    "error_details": [],
    "request_id": "4683c92968ca47ccbff50f1ea8e4fb7a.165.17299260210002027",
    "response_time": "2024-10-26 15:00:21",
    "data": [
      {
        "name": "韧啸-US美国仓",
        "sid": 136,
        "asin": "B0D6XVLTJL",
        "parent_asin": "B0ABC73590",
        "product_name": "无线鼠标",
        "small_image_url": "https://image.distributetop.com/erp-vue/90128554873982976/20240802/027e8b7698414d899f7f0a2e77f97268.jpeg",
        "seller_sku": "20240613-1",
        "fnsku": "X004A0PW6J",
        "sku": "shubiao_1",
        "category_text": "电子设备\\鼠标",
        "cid": 3318,
        "product_brand_text": "罗技",
        "bid": 1173,
        "share_type": 0,
        "total": 2,
        "total_price": 40,
        "available_total": 42,
        "available_total_price": "840.00",
        "afn_fulfillable_quantity": 0,
        "afn_fulfillable_quantity_price": "0.00",
        "reserved_fc_transfers": 0,
        "reserved_fc_transfers_price": "0.00",
        "reserved_fc_processing": 0,
        "reserved_fc_processing_price": "0.00",
        "reserved_customerorders": 0,
        "reserved_customerorders_price": "0.00",
        "quantity": 0,
        "quantity_price": "0.00",
        "afn_unsellable_quantity": 0,
        "afn_unsellable_quantity_price": "0.00",
        "afn_inbound_working_quantity": 47,
        "afn_inbound_working_quantity_price": "940.00",
        "afn_inbound_shipped_quantity": 2,
        "afn_inbound_shipped_quantity_price": "40.00",
        "afn_inbound_receiving_quantity": 0,
        "afn_inbound_receiving_quantity_price": "0.00",
        "stock_up_num": 42,
        "stock_up_num_price": "840.00",
        "afn_researching_quantity": 0,
        "afn_researching_quantity_price": "0.00",
        "total_fulfillable_quantity": 0,
        "inv_age_0_to_90_days": 0,
        "inv_age_0_to_90_price": "0.00",
        "inv_age_271_to_365_days": 0,
        "inv_age_271_to_365_price": "0.00",
        "inv_age_0_to_30_days": 0,
        "inv_age_0_to_30_price": "0.00",
        "inv_age_31_to_60_days": 0,
        "inv_age_31_to_60_price": "0.00",
        "inv_age_61_to_90_days": 0,
        "inv_age_61_to_90_price": "0.00",
        "inv_age_91_to_180_days": 0,
        "inv_age_91_to_180_price": "0.00",
        "inv_age_181_to_270_days": 0,
        "inv_age_181_to_270_price": "0.00",
        "inv_age_271_to_330_days": 0,
        "inv_age_271_to_330_price": "0.00",
        "inv_age_331_to_365_days": 0,
        "inv_age_331_to_365_price": "0.00",
        "inv_age_365_plus_days": 0,
        "inv_age_365_plus_price": "0.00",
        "recommended_action": "",
        "sell_through": 0,
        "estimated_excess_quantity": 0,
        "estimated_storage_cost_next_month": 0,
        "fba_minimum_inventory_level": 0,
        "fba_inventory_level_health_status": "",
        "historical_days_of_supply": 0,
        "historical_days_of_supply_price": "0.00",
        "low_inventory_level_fee_applied": "",
        "fulfillment_channel": "AMAZON_NA",
        "cg_price": "",
        "cg_transport_costs": "AMAZON_NA",
        "warehouse_damaged_quantity": 0,
        "customer_damaged_quantity": 0,
        "carrier_damaged_quantity": 0,
        "distributor_damaged_quantity": 0,
        "defective_quantity": 0,
        "expired_quantity": 0,
        "fba_storage_quantity_list": [
          {
            "sid": 39,
            "name": "ouzhou001-MX",
            "quantity_for_local_fulfillment": 10
          },
          {
            "sid": 38,
            "name": "ouzhou001-IT",
            "quantity_for_local_fulfillment": 10
          }
        ]
      }
    ],
    "total": 1
  }
}

接口请求参数

序号字段名称类型默认值必填描述
1offset分页偏移量integer—可选分页偏移量,默认0
2length分页长度integer—可选分页长度,默认20,仅支持20、50、100、200、500、1000、2000、5000
3search_field搜索维度string—可选搜索维度: sku product_name seller_sku fnsku asin parent_asin spu spu_name
4search_value搜索值string—可选搜索值
5is_cost_page展示维度integer—可选展示维度: 0 数量维度展示 1 成本维度展示 默认0数量维度
6cid分类string—可选分类
7sid店铺id(支持多个string—可选店铺id(支持多个,使用,分隔)
8bid品牌string—可选品牌
9attribute属性string—可选属性
10asin_principalListing负责人uidstring—可选Listing负责人uid,对应查询ERP用户信息列表uid字段 多个使用,分隔
11status在售状态string—可选在售状态: 0 停售 1 在售
12senior_search_list高级搜索列表string—可选高级搜索列表,详情见附加说明
13fulfillment_channel_type配送方式string—可选配送方式: FBA FBM
14is_hide_zero_stock是否隐藏零库存行string—可选是否隐藏零库存行: 0 不隐藏零库存行 1 隐藏零库存行
15is_parant_asin_merge是否合并父ASINstring—可选是否合并父ASIN: 0 不合并父ASIN 1 合并父ASIN
16is_contain_del_ls是否显示已删除Listingstring—可选是否显示已删除Listing: 0 不显示已删除Listing 1 显示已删除Listing
17query_fba_storage_quantity_listtrue 是、false 否boolean—可选true 是、false 否;默认false,如果传入true,则出参数据中的欧洲共享仓会将出参字段-fba_storage_quantity_list的值返回

接口响应参数

序号字段名称类型默认值必填描述
1code状态码integer0必填状态码,0:成功
2message消息提示stringsuccess必填消息提示
3error_details数据校验失败时的错误详情array<any>—必填数据校验失败时的错误详情
4request_id请求链路idstringa0d54debf93140f3b58d1ed81e8e3583.178.17255922733991817必填请求链路id
5response_time响应时间string2024-09-06 11:11:13必填响应时间
6data响应数据array<object>—必填响应数据
6.1name仓库名string仓库4必填仓库名
6.2storage_type_name仓储类型string—必填仓储类型
6.3seller_group_name共享仓店铺名string—必填共享仓店铺名
6.4sid店铺id【当仓库为共享仓时integer3必填店铺id【当仓库为共享仓时,sid为0返回】
6.5asinasinstringB0ABC80784必填ASIN
6.6parent_asin父ASINstringB0ABC73590必填父ASIN
6.7asin_principal_list负责人array<any>—必填负责人
6.8product_name品名stringSony 儿童耳机必填品名
6.9small_image_url预览图链接string—必填预览图链接
6.10seller_skuseller_skustringMSKUFDA5E30必填MSKU
6.11fnskufnskustringFNC020467必填FNSKU
6.12skuskustringSKU9E12CC2必填SKU
6.13category_text分类文本string分类2必填分类文本
6.14cid分类Idinteger2必填分类Id
6.15product_brand_text品牌文本string品牌3必填品牌文本
6.16bid品牌Idinteger3必填品牌Id
6.17share_type共享类型integer0必填共享类型: 0 非共享 1 北美共享 2 欧洲共享
6.18total总数integer0必填总数
6.19total_price总价number0必填总价
6.20available_total可用总数integer0必填可用总数
6.21available_total_price可用总数成本价string—必填可用总数成本价
6.22afn_fulfillable_quantityFBA可售integer0必填FBA可售
6.23afn_fulfillable_quantity_priceFBA可售成本价string0必填FBA可售成本价
6.24afn_reserved_quantityFBA预留string0必填FBA预留
6.25afn_reserved_quantity_priceFBA预留成本string0必填FBA预留成本
6.26reserved_fc_transfers待调仓integer0必填待调仓
6.27reserved_fc_transfers_price待调仓成本价string0必填待调仓成本价
6.28reserved_fc_processing调仓中integer0必填调仓中
6.29reserved_fc_processing_price调仓中成本价string0必填调仓中成本价
6.30reserved_customerorders待发货integer0必填待发货
6.31reserved_customerorders_price待发货成本价string0必填待发货成本价
6.32quantityFBM可售integer0必填FBM可售
6.33quantity_priceFBM可售成本价string0必填FBM可售成本价
6.34afn_unsellable_quantity不可售integer0必填不可售
6.35afn_unsellable_quantity_price不可售成本价string0必填不可售成本价
6.36afn_inbound_working_quantity计划入库integer0必填计划入库
6.37afn_inbound_working_quantity_price计划入库成本价string0必填计划入库成本价
6.38afn_inbound_shipped_quantity在途integer0必填在途
6.39afn_inbound_shipped_quantity_price在途成本价string0必填在途成本价
6.40afn_inbound_receiving_quantity入库中integer0必填入库中
6.41afn_inbound_receiving_quantity_price入库中成本价string0必填入库中成本价
6.42stock_up_num实际在途integer0必填实际在途
6.43stock_up_num_price实际在途成本价string0必填实际在途成本价
6.44afn_researching_quantity调查中数量integer0必填调查中数量
6.45afn_researching_quantity_price调查中数量成本价string0必填调查中数量成本价
6.46total_fulfillable_quantity总可用库存integer0必填总可用库存: 可售+待调仓+调仓中 【非ERP页面对应总库存】
6.47inv_age_0_to_30_days0-1个月库龄integer0必填0-1个月库龄
6.48inv_age_0_to_30_price0-1个月库龄成本价string0必填0-1个月库龄成本价
6.49inv_age_31_to_60_days1-2个月库龄integer0必填1-2个月库龄
6.50inv_age_31_to_60_price1-2个月库龄成本价string0必填1-2个月库龄成本价
6.51inv_age_61_to_90_days2-3个月库龄integer0必填2-3个月库龄
6.52inv_age_61_to_90_price2-3个月库龄成本价string0必填2-3个月库龄成本价
6.53inv_age_0_to_90_days0-3个月库龄integer0必填0-3个月库龄
6.54inv_age_0_to_90_price0-3个月库龄成本价string0必填0-3个月库龄成本价
6.55inv_age_91_to_180_days3-6个月库龄integer0必填3-6个月库龄
6.56inv_age_91_to_180_price3-6个月库龄成本价string0必填3-6个月库龄成本价
6.57inv_age_181_to_270_days6-9个月库龄integer0必填6-9个月库龄
6.58inv_age_181_to_270_price6-9个月库龄成本价string0必填6-9个月库龄成本价
6.59inv_age_271_to_330_days9-11个月库龄integer0必填9-11个月库龄
6.60inv_age_271_to_330_price9-11个月库龄成本价string0必填9-11个月库龄成本价
6.61inv_age_271_to_365_days9-12个月库龄integer0必填9-12个月库龄
6.62inv_age_271_to_365_price9-12个月库龄成本价string0必填9-12个月库龄成本价
6.63inv_age_331_to_365_days11-12个月库龄integer0必填11-12个月库龄
6.64inv_age_331_to_365_price11-12个月库龄成本价string0必填11-12个月库龄成本价
6.65inv_age_365_plus_days12个月以上库龄integer0必填12个月以上库龄
6.66inv_age_365_plus_price12个月以上库龄成本价string0必填12个月以上库龄成本价
6.67recommended_action推荐操作string—必填推荐操作
6.68sell_through售出率number0必填售出率
6.69estimated_excess_quantity预计冗余数量number0必填预计冗余数量
6.70estimated_storage_cost_next_month预计30天仓储费用number0必填预计30天仓储费用
6.71fba_minimum_inventory_level最低库存水平number0必填最低库存水平
6.72fba_inventory_level_health_status库存水平健康度string—必填库存水平健康度
6.73historical_days_of_supply历史供货天数number0必填历史供货天数
6.74historical_days_of_supply_price历史供货天数成本价string0必填历史供货天数成本价
6.75low_inventory_level_fee_applied低库存水平费收取情况string—必填低库存水平费收取情况
6.76fulfillment_channel配送方式stringAMAZON_NA必填配送方式
6.77cg_price单位采购成本string—必填单位采购成本
6.78cg_transport_costs单位头程费用string—必填单位头程费用
6.79warehouse_damaged_quantity不可售详情integer—必填不可售详情:房屋残损
6.80customer_damaged_quantity不可售详情integer—必填不可售详情:买家残损
6.81carrier_damaged_quantity不可售详情integer—必填不可售详情:承运人残损
6.82distributor_damaged_quantity不可售详情integer—必填不可售详情:分销商残损
6.83defective_quantity不可售详情integer—必填不可售详情:存在瑕疵
6.84expired_quantity不可售详情integer—必填不可售详情:已过期
6.85fba_storage_quantity_listFBA可售信息列表array<object>—可选FBA可售信息列表,当仓库为共享仓库时,该字段才返回
6.85.1sid店铺idinteger—必填店铺id
6.85.2name店铺名称string—必填店铺名称
6.85.3quantity_for_local_fulfillmentFBA可售数量integer—必填FBA可售数量
7total总数integer1必填总数

领星ERP的接口:查询FBA库存列表 - v2(/basicOpen/openapi/storage/fbaWarehouseDetail),由轻易云数据集成平台 API 资产管理模块整理收纳,并随领星ERP版本更新同步更新。

需要对接这个接口?

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