文档中心 > API类目 > 零售终端API

tmall.nrt.item.main.synchronize (家装新零售主商品同步至阿里)

同步卖场存量线下商品到阿里

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
booth_id String 必须 1234 摊位id
cid Number 必须 50019997 叶子类目id
props CategoryPropDto [] 可选
  • 最大列表长度:100
  • 类目属性
    • └ property_id
    • Number
    • 必须
    • 20000
    • 属性id
    • └ property_name
    • String
    • 可选
    • 品牌
    • 属性名
    • └ value_id
    • Number
    • 可选
    • 1234567
    • 属性值ID
    • └ value_text
    • String
    • 可选
    • 测试品牌
    • 属性值名称
    dealer_code String 必须 dealer001 经销商编码
    mall_id String 必须 1234 卖场id
    outer_id String 可选 123456 商家编码
    outer_props MacallineItemExtDto 可选 系统自动生成
    • └ brand_series_id
    • String
    • 可选
    • 123A
    • 品牌系列ID
    • └ brand_series_name
    • String
    • 可选
    • 系列A
    • 品牌系列名称
    • └ charge_unit
    • String
    • 可选
    • BM
    • 计价单位
    • └ grade
    • Number
    • 可选
    • 1
    • 等级
    • └ label_price_type
    • Number
    • 可选
    • 1
    • 标签价格类型
    • original_location
    • LocationDto
    • 可选
    • 产地
    • └ city
    • String
    • 可选
    • 杭州
    • 城市名
    • └ city_id
    • Number
    • 可选
    • 1
    • 城市ID
    • └ prov
    • String
    • 可选
    • 浙江
    • 省份名
    • └ prov_id
    • Number
    • 可选
    • 1
    • 省份ID
    • └ type
    • Number
    • 可选
    • 1
    • 类型,1:国内,2:国外
    • └ price_type
    • Number
    • 可选
    • 1
    • 价格类型
    • └ pricer
    • String
    • 可选
    • 007
    • 物价员
    • └ secondary_steel
    • String
    • 可选
    • 测试
    • 辅材
    • └ specification
    • String
    • 可选
    • 10
    • 规格
    • └ specification_unit
    • String
    • 可选
    • kg
    • 规格单位
    • └ substrate
    • String
    • 可选
    • 测试
    • 基材
    • └ support_return_goods
    • Boolean
    • 可选
    • true
    • 是否支持退换货
    • └ veneer
    • String
    • 可选
    • 饰面
    • 饰面
    price String 可选 99.9 价格
    title String 可选 商品名

    响应参数

    名称 类型 示例值 描述
    tmall_nrt_item_main_synchronize ResultDo 返回结果
    • data
    • NrtItemSyncResultDto
    • 返回值
    • └ s_item_id
    • Number
    • 123
    • 摊位商品ID
    • └ m_item_id
    • Number
    • 234
    • 主商品ID
    • └ succ
    • Boolean
    • true
    • 调用是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallNrtItemMainSynchronizeRequest req = new TmallNrtItemMainSynchronizeRequest();
    req.setBoothId("1234");
    req.setCid(50019997L);
    List<TmallNrtItemMainSynchronizeRequest.CategoryPropDto> list2 = new ArrayList<TmallNrtItemMainSynchronizeRequest.CategoryPropDto>();
    TmallNrtItemMainSynchronizeRequest.CategoryPropDto obj3 = new TmallNrtItemMainSynchronizeRequest.CategoryPropDto();
    list2.add(obj3);
    obj3.setPropertyId(20000L);
    obj3.setPropertyName("品牌");
    obj3.setValueId(1234567L);
    obj3.setValueText("测试品牌");
    req.setProps(list2);
    req.setDealerCode("dealer001");
    req.setMallId("1234");
    req.setOuterId("123456");
    TmallNrtItemMainSynchronizeRequest.MacallineItemExtDto obj4 = new TmallNrtItemMainSynchronizeRequest.MacallineItemExtDto();
    obj4.setBrandSeriesId("123A");
    obj4.setBrandSeriesName("系列A");
    obj4.setChargeUnit("BM");
    obj4.setGrade(1L);
    obj4.setLabelPriceType(1L);
    TmallNrtItemMainSynchronizeRequest.LocationDto obj5 = new TmallNrtItemMainSynchronizeRequest.LocationDto();
    obj5.setCity("杭州");
    obj5.setCityId(1L);
    obj5.setProv("浙江");
    obj5.setProvId(1L);
    obj5.setType(1L);
    obj4.setOriginalLocation(obj5);
    obj4.setPriceType(1L);
    obj4.setPricer("007");
    obj4.setSecondarySteel("测试");
    obj4.setSpecification("10");
    obj4.setSpecificationUnit("kg");
    obj4.setSubstrate("测试");
    obj4.setSupportReturnGoods(true);
    obj4.setVeneer("饰面");
    req.setOuterProps(obj4);
    req.setPrice("99.9");
    req.setTitle("床");
    TmallNrtItemMainSynchronizeResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_nrt_item_main_synchronize_response>
        <tmall_nrt_item_main_synchronize>
            <data>
                <s_item_id>123</s_item_id>
                <m_item_id>234</m_item_id>
            </data>
            <succ>true</succ>
        </tmall_nrt_item_main_synchronize>
    </tmall_nrt_item_main_synchronize_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    BIZ_INVALID_EASYHOME_BRAND 缺少品牌信息 无需处理
    IC_IC_CATEGORY_FREEZE 商品类目的错误码提示 无需处理
    IC_IC_PUBLISH_ITEM_INVALID_ITEM_ID 发布商品时使用了无效的商品ID:[653978812177] 无需处理
    IC_ERR_RULE_TITLE_SECURITY_CHAR_LIMITATION 标题/卖点/短标题禁止使用半角符号“ <> ” 符号,但可以使用全角符号“ <>” 无需处理
    IC_IC_CHECKSTEP_BEYOND_LOW_PRICE_LIMIT 您当前发布的宝贝价格异常,低于所在类目宝贝的常规最低值[*],请核实并规范标价行为后发布:]] 无需处理
    CHK_MAIN_ITEM_BRAND_SERIES 此商品品牌系列不在该摊位的经营范围内,请重新选择! 无需处理
    CHK_BASIC_ONEOF 品牌系列输入值不在预期范围之内 无需处理
    IC_IC_CHECKSTEP_INPUT_PROPERTY_ERROR_1 输入属性值不能包括 其他 、其它、其她, [[其他]]:] 无需处理
    THD_BRAND_SERIES_GRANT_SERVICE_ERROR 品牌/系列授权查询出错 无需处理
    IC_IC_PRICE_UNSUPPORT_ZERO_PRICE 此商品或者SKU的价格不允许设定0元 无需处理
    CHK_BASIC_LENGTH_LONG_BYTE 规格值不能超过30个汉字或60个字符 无需处理
    CHK_MAIN_ITEM_BRAND 此商品品牌不在经营范围内,请重新选择! 无需处理
    IC_IC_CHECKSTEP_BEYOND_HIGHT_PRICE_LIMIT 您当前发布的宝贝价格异常,高于所在类目宝贝的常规最高值[10,000],请核实并规范标价行为后发布 无需处理
    CE003 必须是正常营业摊位 无需处理
    CHK_BASIC_MAXVALUE 商品吊牌价输入的数字大小不能大于指定的值100000000:,sku:CHK_BASIC_MAXVALUE:销售规格商品吊牌价(元): 输入的数字大小不能大于指定的值100000000: 无需处理
    系统错误,请稍后重试 系统超时 重试
    SYS_ITEN_UNAPPROVE 主商品审核未通过 需审核通过
    PUB_BIZCHECK_ITEM_NOTEXIST 宝贝不存在 无需处理
    THD_THRONES_API_ERROR 接口调用异常 重试

    API工具

    如何获得此API

    FAQ

    返回
    顶部