管理库存

库存是商家跟踪并用于开展业务的一组物品，包括物理在仓库中可供出售的货品、即将入库的货品以及用于预留或检查的库存。商家通过实时监控库存，既能避免销售已售罄的产品，也能及时补充库存，确保供应链高效运转。

库存管理应用程序提供了多种方法来查询和调整库存数量，帮助商家在多渠道销售中保持库存数据的准确性，从而防止超卖、优化供应链并实现高效履约。此外，应用程序和第三方物流服务可以通过 Genstore 提供的 RESTful 接口自动化库存管理流程，包括库存查询、调整以及绑定产品变体到仓库的操作。

本节介绍如何使用 Genstore 提供的 RESTful 接口来管理库存，包括库存的查询、调整和绑定仓库操作，同时阐述了库存管理在业务流程中的角色和关键注意事项。

工作原理

库存是商家用于跟踪和管理货品的关键数据。库存管理系统涵盖以下环节：

• 订单创建：当客户下单后，系统会从可售库存中扣减相应的库存数量，并将其转为承诺库存，直至订单完成。
• 库存调整：应用程序或第三方物流服务可以代表商家调整库存数量，实现库存的实时更新。
• 仓库绑定：通过绑定产品变体到指定仓库，确保每个仓库的库存数据独立管理并精确跟踪。

下图展示了订单生命周期中库存管理的一些典型活动：

• 客户：发出订单，订单中包含产品变体信息。
• Genstore：在订单创建时减少可售库存，并增加承诺库存；订单完成后，系统再相应调整库存数据。
• 应用程序/第三方物流：通过查询和调整库存，实现库存数据的自动化管理。
• 商家/履约服务：在 Genstore 系统中跟踪库存并履行订单。

库存状态

库存状态用于描述产品在特定位置的库存数量或已承诺的数量。常见的库存状态包括：

库存状态	描述
可售库存	用户在浏览产品页面时所看到的库存数量，代表实际可下单的库存，不包含承诺库存。
现货库存	记录实际仓库库存，以便进行仓库管理、库存补货以及对供应链进行优化。 - 场景 1：预售场景中，产品的现货库存可为 0，但有入库计划时，商家可开启预售或预订功能； - 场景 2：在退货处理中，退回商品进入现货库存，经处理后再上架为可售库存。
承诺	当客户下单后，从可售库存中扣除的部分，直至订单完成前保持承诺状态，防止超卖（即售出超过实际库存的商品）。
不可用库存	预留给特定客户或暂不销售的库存，通常用于保证服务质量或应急备用。
传入	正在运输途中，将入库的库存数量。

API 总览

库存是电商运营的关键，通常涉及多个产品变体的数量跟踪，包括不同颜色、尺寸或其他属性。Genstore 提供了一系列 RESTful 接口来支持库存管理，如创建、读取、更新和删除等操作。以下是主要的 API 接口及其功能描述：

API Endpoint	功能描述
/api/202412/inventory/connect	绑定变体到仓库
/api/202412/inventory/{variantId}	更新变体库存
/api/202412/inventory	查询库存列表

业务场景说明：

• 绑定接口用于将某个产品变体与仓库建立关联，确保库存操作针对具体仓库。
• 更新接口支持对单个产品变体的库存进行调整，适用于订单创建或库存校正。
• 查询接口用于获取某个或多个仓库中所有产品变体的库存状态，以便实时监控库存数据。

业务场景

库存管理的常见用例包括但不限于：

• 订单履约控制：确保顾客下单时显示的库存是真实可用的，防止超卖。
• 供应链管理：集中管理来自多个仓库和渠道的库存数据，优化库存补货和分配。
• 库存预警：监控库存动态，及时通知商家何时需要补充库存或调整库存策略。
• 跨渠道销售：支持多仓库、多渠道库存整合，保证线上线下库存数据一致。

使用限制

请注意，您不能使用 REST API 来调整或移动处于承诺状态的库存数量。承诺库存仅由订单的创建和履约操作影响，开发者应在操作库存时考虑这一限制，确保库存调整逻辑与订单系统保持一致。