如何通过bulkCreateOrReplaceInventoryItem API批量创建商品时设置分类

云上老周

2026-7-18

如何在ebay bulkCreateOrReplaceInventoryItem API中设置商品分类ID

要给批量创建的商品指定正确分类，你需要在每个inventory item的根层级添加primaryCategory字段（若需二级分类可追加secondaryCategory），该字段并非嵌套在product对象内，这是你之前遗漏的关键配置。

字段说明

primaryCategory.categoryId：必填的一级分类ID，需使用对应ebay站点的有效分类ID值
secondaryCategory.categoryId：可选的二级分类ID，仅部分分类体系支持二级层级

修改后的请求Payload示例

foreach ($data as $key => $item) {
    $o = array(
        "sku" => $item['sku'],
        "locale" => $item['locale'],
        // 添加一级分类配置
        "primaryCategory" => array(
            "categoryId" => $item['categoryId']
        ),
        // 如需二级分类可取消注释
        // "secondaryCategory" => array(
        //     "categoryId" => $item['secondaryCategoryId']
        // ),
        "product" => array(
            "title" => $item['title'],
            "description" => $item['description'],
            "aspects" => $item['aspects'],
            "brand" => $item['brand'],
            "mpn" => $item['mpn'],
            "imageUrls" => $item['images']
        ),
        "condition" => $item['condition'],
        "availability" => array(
            "shipToLocationAvailability" => array(
                "quantity" => $item['quantity']
            )
        ),
    );
    if ($item['condition'] != 'NEW') {
        $o['conditionDescription'] = $item['conditionDescription'];
    }
    $object[] = $o;
}
$object = array('requests' => $object);