多源库存(MSI)场景下添加商品至报价单报错问题求助

核心问题分析 #

启用多源库存（MSI）后，商品可售性校验逻辑不再依赖单一库存项，而是需要结合库存源分配、网站关联、配送地址等多维度判断。直接使用Product::load()和quote->addProduct()无法适配MSI的库存校验规则，导致误判商品不可售。

解决步骤及代码修正 #

1. 替换不规范的商品加载方式 #

直接调用ObjectManager加载商品不符合Magento开发规范，且无法确保加载包含MSI库存信息的商品实例。改用依赖注入的ProductRepositoryInterface加载商品，同时指定当前店铺ID，确保获取到正确的店铺关联商品数据。

2. 用MSI兼容接口校验可售性 #

使用IsProductSalableInterface接口，传入商品ID、网站ID和购买数量，精准校验商品在当前场景下的可售状态，避免误判。

3. 适配MSI的商品添加逻辑 #

改用InventoryQuoteManagement的addProduct方法替代原生quote->addProduct，该方法专门适配MSI的库存分配逻辑，确保商品正确添加至报价单。

修正后的完整代码示例 #

首先在类的构造函数注入所需依赖：

protected $customerFactory;
protected $quoteFactory;
protected $storeManager;
protected $cartManagement;
protected $productRepository;
protected $isProductSalable;
protected $inventoryQuoteManagement;

public function __construct(
    \Magento\Customer\Model\CustomerFactory $customerFactory,
    \Magento\Quote\Model\QuoteFactory $quoteFactory,
    \Magento\Store\Model\StoreManagerInterface $storeManager,
    \Magento\Quote\Model\QuoteManagement $cartManagement,
    \Magento\Catalog\Api\ProductRepositoryInterface $productRepository,
    \Magento\InventorySalesApi\Api\IsProductSalableInterface $isProductSalable,
    \Magento\InventoryQuote\Model\InventoryQuoteManagement $inventoryQuoteManagement
) {
    $this->customerFactory = $customerFactory;
    $this->quoteFactory = $quoteFactory;
    $this->storeManager = $storeManager;
    $this->cartManagement = $cartManagement;
    $this->productRepository = $productRepository;
    $this->isProductSalable = $isProductSalable;
    $this->inventoryQuoteManagement = $inventoryQuoteManagement;
}

修改createOrder方法：

public function createOrder($customerId, $productData)
{
    // 加载客户
    $customer = $this->customerFactory->create()->load($customerId);
    
    // 创建报价单
    $quote = $this->quoteFactory->create();
    $quote->setCustomer($customer);
    $quote->setStore($this->storeManager->getStore());

    foreach ($productData as $productId => $qty) {
        try {
            // 加载当前店铺下的商品
            $product = $this->productRepository->getById(
                $productId,
                false, // 不加载已删除商品
                $this->storeManager->getStore()->getId()
            );
            
            // MSI兼容的可售性检查
            $salableResult = $this->isProductSalable->execute(
                (int)$productId,
                $this->storeManager->getStore()->getWebsiteId(),
                $qty
            );
            
            if (!$salableResult->isSalable()) {
                throw new \Exception(
                    '商品不可售：' . implode(', ', $salableResult->getErrors())
                );
            }
            
            // 适配MSI的商品添加逻辑
            $this->inventoryQuoteManagement->addProduct($quote, $product, $qty);
        } catch (\Exception $e) {
            // 异常处理：可根据需求记录日志或抛出
            throw new \Exception('添加商品失败：' . $e->getMessage());
        }
    }

    // 设置账单地址
    $quote->getBillingAddress()->setData([
        'firstname' => $customer->getFirstname(),
        'lastname' => $customer->getLastname(),
        'street' => ['Street Address'],
        'city' => 'City',
        'region' => 'Region',
        'postcode' => '12345',
        'country_id' => 'US',
        'telephone' => '123456789',
        'email' => $customer->getEmail(),
    ]);

    // 设置配送地址（与账单地址一致）
    $quote->getShippingAddress()->setSameAsBilling(1);

    // 收集报价单总计
    $quote->collectTotals();
    
    // 保存报价单
    $quote->save();

    // 转换为订单并提交
    $order = $this->cartManagement->submit($quote);

    return $order;
}

额外检查项 #

• 确认商品已关联至当前店铺所属网站，且商品状态为启用
• 检查库存源是否已分配给当前网站的库存配置
• 若使用基于配送地址的源选择算法，需确保配送地址设置正确，否则可能导致库存分配失败
• 验证商品是否存在特殊库存限制（如最低购买数量、限购数量等）

内容的提问来源于stack exchange，提问作者Ankita Sarkar