简体中文

English

简体中文

English

显示模式

关于 库存 ​

访问范围

需要多个访问范围—请参阅每个端点以了解访问范围要求。

需要访问受保护的客户数据。

库存 是电商运营的关键，通常涉及多个产品变体的数量跟踪，包括不同颜色、尺寸或其他属性。Genstore 提供了一系列的 RESTful 接口，实现对商品库存的精确管理。该模块支持库存项的创建、读取、更新和删除等操作，为电商平台和供应链管理系统提供了高效的库存管理能力。

核心功能

  • 变体绑定仓库：为特定产品变体添加库存配置。
  • 获取库存列表：检索所有库存项的详细信息。
  • 查询仓库库存：根据仓库 ID 查询库存信息。
  • 查询店铺仓库：根据店铺 ID 查询库存信息。
  • 更新变体库存：修改现有库存项的信息。
  • 变体解绑仓库：解除变体与仓库的绑定关系。

应用场景 ​

  • 库存监控与预警：运营团队可监控实时库存水平、配置阈值告警、管理异常工作流，确保及时响应库存变化并防止断货。
  • 仓储作业管理：仓库管理员可协调收货流程、管理发货任务、执行库存盘点，通过标准化工作流保持实物与系统库存的准确性。
  • 智能库存分析：供应链分析师可利用历史库存数据、生成需求预测、优化补货策略，提升库存效率并降低持有成本。

接口

POST /api/202412/inventory/connect: 绑定变体到仓库

PUT /api/202412/inventory/{variantId}: 更新变体库存

GET /api/202412/inventory: 查询库存列表

库存 对象 ​

产品库存业务域对象。

属性 ​

inventoryobject
库存对象。
- 收起属性
productIdnumber
产品唯一标识符。
variantIdnumber
变体唯一标识符。
inventoryCountsarray
变体关联地点的库存数量统计信息。
+ 展开属性
bash
{
  "inventory": {
    "productId": "102744589756584",
    "variantId": "107362235756584",
    "inventoryCounts": [
      {
        "locationId": "54002",
        "available": "100"
      }
    ]
  }
}

POST 绑定变体到仓库 ​

通过在指定位置创建产品，实现产品库存与位置的关联。

访问范围

需要以下任意访问权限: write_products

接口

POST /api/202412/inventory/connect 

请求参数

locationIdnumber
变体所属地点的唯一标识符。
variantIdnumber
变体唯一标识符。
productIdnumber
产品唯一标识符。

响应数据

inventoryobject
库存对象。
- 收起属性
productIdstring
产品唯一标识符。
variantIdstring
变体唯一标识符。
inventoryCountsarray
变体关联地点的库存数量统计信息。
+ 展开属性
bash
curl -X POST \ 
https://{shop}.genmystore.com/api/202412/inventory/connect" \ 
-H "X-Genstore-Access-Token: {access_token}" \ 
-H "Content-Type: application/json" \ 
-d '{
	"productId":"102744589756584",
	"locationId":"54002",
	"variantId":"107362235756584"
}'
json
HTTP/1.1 200 OK
{
  "inventory": {
    "productId": "102744589756584",
    "variantId": "107362235756584",
    "inventoryCounts": [
      {
        "locationId": "54002",
        "available": "100"
      }
    ]
  }
}

PUT 更新变体库存 ​

设置指定地点的变体的可用库存。如果指定的地点和变体未绑定，则会先自动绑定。

访问范围

需要以下任意访问权限: write_products

接口

PUT /api/202412/inventory/{variantId} 

请求参数

locationIdnumber
产品唯一标识符。
productIdnumber
地点唯一标识符。
availablenumber
可售库存。

响应数据

inventoryobject
库存对象。
- 收起属性
productIdstring
产品唯一标识符。
variantIdstring
变体唯一标识符。
inventoryCountsarray
变体关联地点的库存数量统计信息。
+ 展开属性
bash
curl -X PUT \ 
https://{shop}.genmystore.com/api/202412/inventory/{variantId}" \ 
-H "X-Genstore-Access-Token: {access_token}" \ 
-H "Content-Type: application/json" \ 
-d '{
	"productId":"102744589756584",
	"locationId":"54002",
	"available":"100"
}'
json
HTTP/1.1 200 OK
{
  "inventory": {
    "productId": "102744589756584",
    "variantId": "107362235756584",
    "inventoryCounts": [
      {
        "locationId": "54002",
        "available": "100"
      }
    ]
  }
}

GET 查询库存列表 ​

查询库存列表。

访问范围

需要以下任意访问权限: write_products read_products

接口

GET /api/202412/inventory 

请求参数

locationIdnumber
地点唯一标识符。
variantIdsarray
变体唯一标识符列表。

响应数据

inventorysarray
库存对象。
- 收起属性
productIdnumber
产品唯一标识符。
variantIdnumber
变体唯一标识符。
inventoryCountsarray
变体关联地点的库存数量统计信息。
+ 展开属性
bash
curl -X GET \ 
https://{shop}.genmystore.com/api/202412/inventory" \ 
-H "X-Genstore-Access-Token: {access_token}" \
json
HTTP/1.1 200 OK
{
  "inventorys": [
    {
      "productId": "102744589756584",
      "variantId": "107362235756584",
      "inventoryCounts": [
        {
          "locationId": "54002",
          "available": "100"
        }
      ]
    }
  ]
}