调用Zoho Inventory采购订单API时遇29009错误请求协助

问题重现 #

调用Zoho Inventory采购订单创建API时，使用以下JSON请求体（仅通过SKU添加行项）：

{
    "purchaseorder_number": "BBBBBBA",
    "date": "2015-05-28",
    "vendor_id": 3125431000005946221,
    "line_items": [
        {
            "SKU": "BDC9999978",
            "name":"One Playa Del Carmen"
        //   "item_id": 3125431000002004431
        }
    ]
}

收到错误响应：

{
    "code": 29009,
    "message": "无法为非采购类商品（non-purchase item）创建采购订单。"
}

错误原因 #

1. 目标商品未启用采购属性：Zoho Inventory中商品分为采购类和非采购类，只有标记为「可采购」的商品才能被添加到采购订单中。你通过SKU引用的BDC9999978商品，在系统后台未开启采购权限。
2. SKU匹配的商品类型限制：该商品可能被设置为仅销售类、服务类或其他无法用于采购的类型，这类商品不支持纳入采购订单流程。

解决办法 #

方法1：在Zoho Inventory后台修改商品属性 #

• 登录Zoho Inventory管理后台，搜索SKU为BDC9999978的商品，进入详情页
• 找到「采购设置」模块，勾选「允许采购」或将商品标记为采购类商品（不同版本界面表述可能略有差异）
• 保存修改后，重新发起API请求

方法2：优化API请求逻辑 #

• 验证商品采购属性：先调用商品查询API（GET /inventory/v1/items?organization_id=你的组织ID），通过SKU过滤商品，查看返回结果中的is_purchase_item字段是否为true，确认商品是否可采购
• 精准匹配商品：取消请求体中item_id的注释，带上该字段发起请求——相比SKU，item_id能更精准定位商品，避免SKU重复导致的匹配错误
• 更换可采购商品：如果该商品确实不需要采购属性，替换为系统中已标记为可采购的商品SKU或item_id

内容的提问来源于stack exchange，提问作者abdelfattah allam