文档中心 > API类目 > 闲鱼已验货

alibaba.idle.isv.item.publish (服务商闲鱼商品发布)

服务商ISV闲鱼商品发布

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
item_param	IdleItemApiDo	必须			商品数据参数
└ inspect_report String 可选 http://inspect_report.html [已废弃]验货报告, 此字段后续会废弃；如需使用参见: inspected_data.inspect_report └ images Number [] 必须 [] 商品图片列表，使用图片上传接口返回的文件Id，支持多张(最多9张) └ reserve_price String 必须 35.31 商品售价, 单位：元(最大99999999) └ transport_fee String 可选 5.87 邮费, 单位：元(最大99999999) └ original_price String 可选 50.02 商品原价, 单位：元(最大99999999) └ title String 必须 iphoneX手机特卖商品标题(长度<=30) └ stuff_status Number 可选 95 商品新旧程度, 值为0-100的整数，例如100代表全新，95代表95新 └ sp_biz_type String 必须 1 服务业务分类，已验货业务场景下（手机:1, 潮品:2, 家电:3, 乐器:8, 3C数码:9, 奢品:16, 母婴:17, 美妆:18, 文玩/珠宝:19, 潮玩:20, 家居:21） └ division_id Number 必须 330110 行政区划Id，最小行政单位code，若是地区级别，则为地区级别的id；否则为城市级别的id(long型，6位) └ category_id Number 必须 50025386 商品类目Id,手机: 50025386（long型，一般8～10位） └ trade_type Number 可选 0 交易方式, 仅在线交易: 0,仅线下交易: 1,线上OR线下交易: 2（int型，1位） └ desc String 必须全新，红色，超便宜商品描述(长度<=5000) └ latitude BigDecimal 可选 25.82782 纬度 └ longitude BigDecimal 可选 107.54135 经度 └ item_biz_type Number 可选 0 商品业务类型 0 已验货不入仓，1 已验货入仓，2 普通商品 └ ware_house_city String 可选杭州 [已废弃]已验货入仓城市(此字段后续会废弃；如需使用参见: inspected_data.ware_house_city) └ ware_house_time Number 可选 1615863262 [已废弃]已验货入仓时间(此字段后续会废弃；如需使用参见: inspected_data.ware_house_time) └ channel_cat_id String 可选 12345567 渠道类目id，必填，不可修改 pv_list IdleNewPubValueDo [] 可选 [] 属性的键值对信息，包括品牌、型号、内存大小（手机）等 └ property_id String 可选 21553 属性id └ property_name String 可选品牌属性名称 └ channel_cat_id String 可选 1451 渠道类目id └ value_id String 可选 12354 值id └ value_name String 可选 Apple/苹果值名称 item_sku_list IdleItemApiSkuDo [] 可选 [] sku列表 property_list IdleItemApiPvPairDo [] 可选 [] 销售属性列表(最多2个销售属性,每一个的属性值个数为2～10) └ value_text String 可选 XL 属性值文本(长度<=30) └ property_text String 可选尺码属性名文本(长度<=30) └ quantity Number 可选 5 库存 └ price Number 可选 1 价格，单位分 └ outer_id String 可选 123523462 外部商家标识(商品编码等)(长度<=30) inspected_data IdleItemApiInspectedDo 可选已验货业务数据(不可修改) └ inspect_report String 可选 http://inspect_report.html 验货报告url链接(长度<=300) └ ware_house_city String 可选深圳已验货入仓城市，入仓模式必填，不可修改 └ ware_house_time Number 可选 1620544846 已验货入仓时间，入仓模式必填，时间戳，单位秒，不可修改 └ inspect_report_id String 可选 123456 验货报告ID book_data IdleItemApiBookDo 可选图书业务数据 └ barcode String 可选 9787111302832 图书ISBN码 └ barcode_name String 可选计算机科学丛书图书ISBN码对应的书名等信息 └ quantity Number 可选 1 宝贝库存数量设置 └ template_id Number 可选 40090611110 淘宝卖家后台的运费模板id └ outer_id String 可选 190085448924 外部商家标识(商品编码等)(长度<=30) bid_data IdleItemApiBidDo 可选宝贝拍卖信息 └ bid_start_time Number 可选 1629949200000 拍卖起拍时间戳，单位毫秒 └ bid_end_time Number 可选 1629953200000 拍卖结束时间戳，单位毫秒 └ bid_bail Number 可选 2000 保证金金额，单位分 └ bid_step Number 可选 100 出价幅度，单位分；起拍价使用reserve_price └ support_task_for_free Number 可选 1 是否支持做任务免保证金（for新奥莱拍卖业务）, 0-不支持，1-支持 └ task_list String [] 可选 [] 任务列表（for新奥莱拍卖业务） └ direct_buy_price Number 可选 100 抢拍价金额，单位分 cycle_vendue_data IdleItemApiCycleVendueDO 可选周期拍信息 └ cycle_buy_remain_count Number 可选 5 活动库存，即周期拍剩余次数 └ cycle_buy_start_time Number 可选 1629949200000 拍品周期拍开拍时间戳，单位毫秒 └ cycle_buy_end_time Number 可选 1629953200000 拍品周期拍结束时间戳，单位毫秒 └ cycle_vendue Number 可选 1 是否周期拍拍品，0-不是，1-是 └ auction_type String 可选 b 商品类型，a: 拍卖， b：一口价(普通商品) └ white_bg_imgs Number [] 可选 13432534565767 商品白底图列表(目前暂时只支持一张)，使用图片上传接口返回的文件Id └ sp_guarantee String 可选 1,2,3 [已废弃]商品服务标签，用逗号分隔 \|\| 1：100%验货；2：正品鉴别；3：七天包退；4：一年质保；5：48小时发货；7：质量问题包退；8：一物一证 after_sales_data IdleItemApiAfterSalesDo 可选卖家服务信息 └ support_sdr_policy Boolean 可选 true 是否支持七天无理由 └ support_nfr_policy Boolean 可选 false 是否支持描述不符包邮退 └ support_vnr_policy Boolean 可选 false 是否支持虚拟-描述不符包退 └ support_fd24hs_policy Boolean 可选 false 是否支持极速发货-24小时 └ support_fd10ms_policy Boolean 可选 false 是否支持极速发货-10分钟 └ support_fd48hs_policy Boolean 可选 false 是否支持极速发货-48小时 └ support_gpa_policy Boolean 可选 false 是否支持正品保障 └ support_nfgc_policy Boolean 可选 false 是否支持不符必赔 real_car_verify_data IdleItemRealCarVerifyDO 可选真车认证相关信息 └ driving_license_info String 可选 123 行驶证主页图片id └ driving_license_car_photo String 可选 123 行驶证车辆页图片id └ business_license_front String 可选 123 营业执照图片id └ car_function String 可选营运使用性质 : 营运 / 非营运 └ car_vin String 可选 123123 车辆识别代码 VIN码 idle_item_yhb_do IdleItemApiYhbDO 可选验货宝信息 └ use_yhb_service Boolean 可选 true 是否开启验货宝服务 └ settings_preferences String 可选 {} 验货宝相关配置 biz_help_data IdleItemApiBizHelpDataDO 可选帮卖信息 └ first_phase_order_id Number 可选 123213 一段订单号 flash_sale_do IdleItemApiFlashSaleDO 可选特卖商品相关信息 └ tag Number 可选 1 特卖商品标签 └ food_pro_date Date 可选 2024-01-01 00:00:00 食品的生产日期 └ food_expire_date Date 可选 2024-01-01 00:00:00 食品的保质期过期时间 └ idle_template_id Number 可选 123 运费模板ID brand_bargain IdleItemApiBrandBargainDO 可选商品捡漏信息 └ item_stuff String 可选 unused_micro_defects 成色 └ produce_date String 可选 1709481600000 商品生产日期 └ shelf_life String 可选 180 保质期（天） └ supplier String 可选 xxx 供应商 └ cert_pic_id Number 可选 123 证照图片 └ inspection_report String 可选 123 验货报告 long_images IdleItemImageInfoApiDO [] 可选 1 长图id集合 └ width Number 可选 12 宽度 └ height Number 可选 12 高度 └ file_id Number 可选 12 文件id property_images IdleItemSkuImageInfoApiDO [] 可选 123123 sku属性图片信息 └ image_id Number 可选 123 图片id └ property_text String 可选颜色对应的sku属性text └ value_text String 可选红色对应的sku属性值text └ weight String 可选 9.87 运费模版重量字段 └ weight_unit String 可选 g 运费模版重量单位字段，目前支持克（g） trendy_pre_sale_do IdleItemTrendyPreSaleDO 可选预售工具参数 └ dep_model Number 可选 1 订金模式 1-收取固定金额 2-按比例收取金额 └ dep_config String 可选 10 订金配置: 1-固定金额模式存储订金金额 2-按比例金额模式，存储比例 └ start_time String 可选 1725623518000 开始时间 └ end_time String 可选 1725623518000 结束时间 └ g_time String 可选 1725623518000 出荷时间 store_group_do IdleItemApiStoreGroupDO 可选门店库参数 └ group_id Number 可选 27033 门店库Id └ group_name String 可选肯德基全国门店门店库名称 └ service_publish_source String 可选 xgj_distribution 管家分销 merchant_data_do IdleItemMerchantDataDO 可选招商活动信息 └ merchant_act_id Number 可选 3323 招商活动 id distribution_item_info IdleDistributionItemInfoDO 可选分销商品信息 └ out_sync_item_id String 可选 842472706080 外部商品id └ product_id String 可选 562455585535 货品ID └ out_sync_item_biz_code String 可选 idleDistribution 外部bizCode └ distributor_user_id String 可选 2212935862056 分销商用户ID └ source_from String 可选 1 商品来源 └ out_supply_id String 可选 2217601284340 供应商id └ primary_channel_code String 可选 tmallchaoshipm 一级渠道Id └ sub_channel_code String 可选 tmallchaoshipm_xianyu 二级渠道Id └ out_sync_inventory_grade String 可选 1 库存等级 └ out_sync_sku_id String 可选 5688665204001 外部skuId └ need_stuff_custom Boolean 可选 false 是否需要成色定制表达：千牛 └ stuff_value_id Boolean 可选 15994218 成色定制表达-valueId：千牛 └ stuff_value_name String 可选几乎全新成色定制表达-valueName：千牛 └ skip_check_raise_b Boolean 可选 false 是否跳过举手B卖弹层校验 └ sec_kill_time Number 可选 1742878665198 定时秒杀时间戳

响应参数

名称	类型	示例值	描述
result	IdleResultDo	无	返回结果
data IdleItemApiDo 无返回数据 └ item_id Number 商品id 商品Id（long型） └ notify_message String 为了保障游戏账号商品交易安全，买家需等待30天才能确认收货发布成功，编辑成功，查询场景，返回给服务商的提醒信息 └ success Boolean false 是否成功 └ err_code String PARAM_ILLEGAL 错误码 └ err_msg String 参数不合法错误信息

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleIsvItemPublishRequest req = new AlibabaIdleIsvItemPublishRequest();
AlibabaIdleIsvItemPublishRequest.IdleItemApiDo obj1 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiDo();
obj1.setInspectReport("http://inspect_report.html");
obj1.setImages(new Long[] {  };
);
obj1.setReservePrice("35.31");
obj1.setTransportFee("5.87");
obj1.setOriginalPrice("50.02");
obj1.setTitle("iphoneX手机特卖");
obj1.setStuffStatus(95L);
obj1.setSpBizType("1");
obj1.setDivisionId(330110L);
obj1.setCategoryId(50025386L);
obj1.setTradeType(0L);
obj1.setDesc("全新，红色，超便宜");
obj1.setLatitude("25.82782");
obj1.setLongitude("107.54135");
obj1.setItemBizType(0L);
obj1.setWareHouseCity("杭州");
obj1.setWareHouseTime(1615863262L);
obj1.setChannelCatId("12345567");
List<AlibabaIdleIsvItemPublishRequest.IdleNewPubValueDo> list3 = new ArrayList<AlibabaIdleIsvItemPublishRequest.IdleNewPubValueDo>();
AlibabaIdleIsvItemPublishRequest.IdleNewPubValueDo obj4 = new AlibabaIdleIsvItemPublishRequest.IdleNewPubValueDo();
list3.add(obj4);
obj4.setPropertyId("21553");
obj4.setPropertyName("品牌");
obj4.setChannelCatId("1451");
obj4.setValueId("12354");
obj4.setValueName("Apple/苹果");
obj1.setPvList(list3);
List<AlibabaIdleIsvItemPublishRequest.IdleItemApiSkuDo> list6 = new ArrayList<AlibabaIdleIsvItemPublishRequest.IdleItemApiSkuDo>();
AlibabaIdleIsvItemPublishRequest.IdleItemApiSkuDo obj7 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiSkuDo();
list6.add(obj7);
List<AlibabaIdleIsvItemPublishRequest.IdleItemApiPvPairDo> list10 = new ArrayList<AlibabaIdleIsvItemPublishRequest.IdleItemApiPvPairDo>();
AlibabaIdleIsvItemPublishRequest.IdleItemApiPvPairDo obj11 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiPvPairDo();
list10.add(obj11);
obj11.setValueText("XL");
obj11.setPropertyText("尺码");
list8.setPropertyList(list10);
obj7.setQuantity(5L);
obj7.setPrice(1L);
obj7.setOuterId("123523462");
obj1.setItemSkuList(list6);
AlibabaIdleIsvItemPublishRequest.IdleItemApiInspectedDo obj12 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiInspectedDo();
obj12.setInspectReport("http://inspect_report.html");
obj12.setWareHouseCity("深圳");
obj12.setWareHouseTime(1620544846L);
obj12.setInspectReportId("123456");
obj1.setInspectedData(obj12);
AlibabaIdleIsvItemPublishRequest.IdleItemApiBookDo obj13 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiBookDo();
obj13.setBarcode("9787111302832");
obj13.setBarcodeName("计算机科学丛书");
obj1.setBookData(obj13);
obj1.setQuantity(1L);
obj1.setTemplateId(40090611110L);
obj1.setOuterId("190085448924");
AlibabaIdleIsvItemPublishRequest.IdleItemApiBidDo obj14 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiBidDo();
obj14.setBidStartTime(1629949200000L);
obj14.setBidEndTime(1629953200000L);
obj14.setBidBail(2000L);
obj14.setBidStep(100L);
obj14.setSupportTaskForFree(1L);
obj14.setTaskList("");
obj14.setDirectBuyPrice(100L);
AlibabaIdleIsvItemPublishRequest.IdleItemApiCycleVendueDO obj15 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiCycleVendueDO();
obj15.setCycleBuyRemainCount(5L);
obj15.setCycleBuyStartTime(1629949200000L);
obj15.setCycleBuyEndTime(1629953200000L);
obj15.setCycleVendue(1L);
obj14.setCycleVendueData(obj15);
obj1.setBidData(obj14);
obj1.setAuctionType("b");
obj1.setWhiteBgImgs(new Long[] { 13432534565767 };
);
obj1.setSpGuarantee("1,2,3");
AlibabaIdleIsvItemPublishRequest.IdleItemApiAfterSalesDo obj16 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiAfterSalesDo();
obj16.setSupportSdrPolicy(true);
obj16.setSupportNfrPolicy(false);
obj16.setSupportVnrPolicy(false);
obj16.setSupportFd24hsPolicy(false);
obj16.setSupportFd10msPolicy(false);
obj16.setSupportFd48hsPolicy(false);
obj16.setSupportGpaPolicy(false);
obj16.setSupportNfgcPolicy(false);
obj1.setAfterSalesData(obj16);
AlibabaIdleIsvItemPublishRequest.IdleItemRealCarVerifyDO obj17 = new AlibabaIdleIsvItemPublishRequest.IdleItemRealCarVerifyDO();
obj17.setDrivingLicenseInfo("123");
obj17.setDrivingLicenseCarPhoto("123");
obj17.setBusinessLicenseFront("123");
obj17.setCarFunction("营运");
obj17.setCarVin("123123");
obj1.setRealCarVerifyData(obj17);
AlibabaIdleIsvItemPublishRequest.IdleItemApiYhbDO obj18 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiYhbDO();
obj18.setUseYhbService(true);
obj18.setSettingsPreferences("{}");
obj1.setIdleItemYhbDo(obj18);
AlibabaIdleIsvItemPublishRequest.IdleItemApiBizHelpDataDO obj19 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiBizHelpDataDO();
obj19.setFirstPhaseOrderId(123213L);
obj1.setBizHelpData(obj19);
AlibabaIdleIsvItemPublishRequest.IdleItemApiFlashSaleDO obj20 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiFlashSaleDO();
obj20.setTag(1L);
obj20.setFoodProDate(StringUtils.parseDateTime("2024-01-01 00:00:00"));
obj20.setFoodExpireDate(StringUtils.parseDateTime("2024-01-01 00:00:00"));
obj1.setFlashSaleDo(obj20);
obj1.setIdleTemplateId(123L);
AlibabaIdleIsvItemPublishRequest.IdleItemApiBrandBargainDO obj21 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiBrandBargainDO();
obj21.setItemStuff("unused_micro_defects");
obj21.setProduceDate("1709481600000");
obj21.setShelfLife("180");
obj21.setSupplier("xxx");
obj21.setCertPicId(123L);
obj1.setBrandBargain(obj21);
obj1.setInspectionReport("123");
List<AlibabaIdleIsvItemPublishRequest.IdleItemImageInfoApiDO> list23 = new ArrayList<AlibabaIdleIsvItemPublishRequest.IdleItemImageInfoApiDO>();
AlibabaIdleIsvItemPublishRequest.IdleItemImageInfoApiDO obj24 = new AlibabaIdleIsvItemPublishRequest.IdleItemImageInfoApiDO();
list23.add(obj24);
obj24.setWidth(12L);
obj24.setHeight(12L);
obj24.setFileId(12L);
obj1.setLongImages(list23);
List<AlibabaIdleIsvItemPublishRequest.IdleItemSkuImageInfoApiDO> list26 = new ArrayList<AlibabaIdleIsvItemPublishRequest.IdleItemSkuImageInfoApiDO>();
AlibabaIdleIsvItemPublishRequest.IdleItemSkuImageInfoApiDO obj27 = new AlibabaIdleIsvItemPublishRequest.IdleItemSkuImageInfoApiDO();
list26.add(obj27);
obj27.setImageId(123L);
obj27.setPropertyText("颜色");
obj27.setValueText("红色");
obj1.setPropertyImages(list26);
obj1.setWeight("9.87");
obj1.setWeightUnit("g");
AlibabaIdleIsvItemPublishRequest.IdleItemTrendyPreSaleDO obj28 = new AlibabaIdleIsvItemPublishRequest.IdleItemTrendyPreSaleDO();
obj28.setDepModel(1L);
obj28.setDepConfig("10");
obj28.setStartTime("1725623518000");
obj28.setEndTime("1725623518000");
obj28.setGTime("1725623518000");
obj1.setTrendyPreSaleDo(obj28);
AlibabaIdleIsvItemPublishRequest.IdleItemApiStoreGroupDO obj29 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiStoreGroupDO();
obj29.setGroupId(27033L);
obj29.setGroupName("肯德基全国门店");
obj1.setStoreGroupDo(obj29);
obj1.setServicePublishSource("xgj_distribution");
AlibabaIdleIsvItemPublishRequest.IdleItemMerchantDataDO obj30 = new AlibabaIdleIsvItemPublishRequest.IdleItemMerchantDataDO();
obj30.setMerchantActId(3323L);
obj1.setMerchantDataDo(obj30);
AlibabaIdleIsvItemPublishRequest.IdleDistributionItemInfoDO obj31 = new AlibabaIdleIsvItemPublishRequest.IdleDistributionItemInfoDO();
obj31.setOutSyncItemId("842472706080");
obj31.setProductId("562455585535");
obj31.setOutSyncItemBizCode("idleDistribution");
obj31.setDistributorUserId("2212935862056");
obj31.setSourceFrom("1");
obj31.setOutSupplyId("2217601284340");
obj31.setPrimaryChannelCode("tmallchaoshipm");
obj31.setSubChannelCode("tmallchaoshipm_xianyu");
obj31.setOutSyncInventoryGrade("1");
obj31.setOutSyncSkuId("5688665204001");
obj31.setNeedStuffCustom(false);
obj31.setStuffValueId(15994218);
obj31.setStuffValueName("几乎全新");
obj1.setDistributionItemInfo(obj31);
obj1.setSkipCheckRaiseB(false);
obj1.setSecKillTime(1742878665198L);
req.setItemParam(obj1);
AlibabaIdleIsvItemPublishResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaIdleIsvItemPublishRequest req = new AlibabaIdleIsvItemPublishRequest();
AlibabaIdleIsvItemPublishRequest.IdleItemApiDoDomain obj1 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiDoDomain();
obj1.InspectReport = "http://inspect_report.html";
obj1.Images = new long[] {  };
;
obj1.ReservePrice = "35.31";
obj1.TransportFee = "5.87";
obj1.OriginalPrice = "50.02";
obj1.Title = "iphoneX手机特卖";
obj1.StuffStatus = 95L;
obj1.SpBizType = "1";
obj1.DivisionId = 330110L;
obj1.CategoryId = 50025386L;
obj1.TradeType = 0L;
obj1.Desc = "全新，红色，超便宜";
obj1.Latitude = "25.82782";
obj1.Longitude = "107.54135";
obj1.ItemBizType = 0L;
obj1.WareHouseCity = "杭州";
obj1.WareHouseTime = 1615863262L;
obj1.ChannelCatId = "12345567";
List<AlibabaIdleIsvItemPublishRequest.IdleNewPubValueDoDomain> list3 = new List<AlibabaIdleIsvItemPublishRequest.IdleNewPubValueDoDomain>();
AlibabaIdleIsvItemPublishRequest.IdleNewPubValueDoDomain obj4 = new AlibabaIdleIsvItemPublishRequest.IdleNewPubValueDoDomain();
list3.Add(obj4);
obj4.PropertyId = "21553";
obj4.PropertyName = "品牌";
obj4.ChannelCatId = "1451";
obj4.ValueId = "12354";
obj4.ValueName = "Apple/苹果";
obj1.PvList= list3;
List<AlibabaIdleIsvItemPublishRequest.IdleItemApiSkuDoDomain> list6 = new List<AlibabaIdleIsvItemPublishRequest.IdleItemApiSkuDoDomain>();
AlibabaIdleIsvItemPublishRequest.IdleItemApiSkuDoDomain obj7 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiSkuDoDomain();
list6.Add(obj7);
List<AlibabaIdleIsvItemPublishRequest.IdleItemApiPvPairDoDomain> list9 = new List<AlibabaIdleIsvItemPublishRequest.IdleItemApiPvPairDoDomain>();
AlibabaIdleIsvItemPublishRequest.IdleItemApiPvPairDoDomain obj10 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiPvPairDoDomain();
list9.Add(obj10);
obj10.ValueText = "XL";
obj10.PropertyText = "尺码";
obj7.PropertyList= list9;
obj7.Quantity = 5L;
obj7.Price = 1L;
obj7.OuterId = "123523462";
obj1.ItemSkuList= list6;
AlibabaIdleIsvItemPublishRequest.IdleItemApiInspectedDoDomain obj11 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiInspectedDoDomain();
obj11.InspectReport = "http://inspect_report.html";
obj11.WareHouseCity = "深圳";
obj11.WareHouseTime = 1620544846L;
obj11.InspectReportId = "123456";
obj1.InspectedData= obj11;
AlibabaIdleIsvItemPublishRequest.IdleItemApiBookDoDomain obj12 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiBookDoDomain();
obj12.Barcode = "9787111302832";
obj12.BarcodeName = "计算机科学丛书";
obj1.BookData= obj12;
obj1.Quantity = 1L;
obj1.TemplateId = 40090611110L;
obj1.OuterId = "190085448924";
AlibabaIdleIsvItemPublishRequest.IdleItemApiBidDoDomain obj13 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiBidDoDomain();
obj13.BidStartTime = 1629949200000L;
obj13.BidEndTime = 1629953200000L;
obj13.BidBail = 2000L;
obj13.BidStep = 100L;
obj13.SupportTaskForFree = 1L;
obj13.TaskList = "";
obj13.DirectBuyPrice = 100L;
AlibabaIdleIsvItemPublishRequest.IdleItemApiCycleVendueDODomain obj14 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiCycleVendueDODomain();
obj14.CycleBuyRemainCount = 5L;
obj14.CycleBuyStartTime = 1629949200000L;
obj14.CycleBuyEndTime = 1629953200000L;
obj14.CycleVendue = 1L;
obj13.CycleVendueData= obj14;
obj1.BidData= obj13;
obj1.AuctionType = "b";
obj1.WhiteBgImgs = new long[] { 13432534565767 };
;
obj1.SpGuarantee = "1,2,3";
AlibabaIdleIsvItemPublishRequest.IdleItemApiAfterSalesDoDomain obj15 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiAfterSalesDoDomain();
obj15.SupportSdrPolicy = true;
obj15.SupportNfrPolicy = false;
obj15.SupportVnrPolicy = false;
obj15.SupportFd24hsPolicy = false;
obj15.SupportFd10msPolicy = false;
obj15.SupportFd48hsPolicy = false;
obj15.SupportGpaPolicy = false;
obj15.SupportNfgcPolicy = false;
obj1.AfterSalesData= obj15;
AlibabaIdleIsvItemPublishRequest.IdleItemRealCarVerifyDODomain obj16 = new AlibabaIdleIsvItemPublishRequest.IdleItemRealCarVerifyDODomain();
obj16.DrivingLicenseInfo = "123";
obj16.DrivingLicenseCarPhoto = "123";
obj16.BusinessLicenseFront = "123";
obj16.CarFunction = "营运";
obj16.CarVin = "123123";
obj1.RealCarVerifyData= obj16;
AlibabaIdleIsvItemPublishRequest.IdleItemApiYhbDODomain obj17 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiYhbDODomain();
obj17.UseYhbService = true;
obj17.SettingsPreferences = "{}";
obj1.IdleItemYhbDo= obj17;
AlibabaIdleIsvItemPublishRequest.IdleItemApiBizHelpDataDODomain obj18 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiBizHelpDataDODomain();
obj18.FirstPhaseOrderId = 123213L;
obj1.BizHelpData= obj18;
AlibabaIdleIsvItemPublishRequest.IdleItemApiFlashSaleDODomain obj19 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiFlashSaleDODomain();
obj19.Tag = 1L;
obj19.FoodProDate = DateTime.Parse(2024-01-01 00:00:00");
obj19.FoodExpireDate = DateTime.Parse(2024-01-01 00:00:00");
obj1.FlashSaleDo= obj19;
obj1.IdleTemplateId = 123L;
AlibabaIdleIsvItemPublishRequest.IdleItemApiBrandBargainDODomain obj20 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiBrandBargainDODomain();
obj20.ItemStuff = "unused_micro_defects";
obj20.ProduceDate = "1709481600000";
obj20.ShelfLife = "180";
obj20.Supplier = "xxx";
obj20.CertPicId = 123L;
obj1.BrandBargain= obj20;
obj1.InspectionReport = "123";
List<AlibabaIdleIsvItemPublishRequest.IdleItemImageInfoApiDODomain> list22 = new List<AlibabaIdleIsvItemPublishRequest.IdleItemImageInfoApiDODomain>();
AlibabaIdleIsvItemPublishRequest.IdleItemImageInfoApiDODomain obj23 = new AlibabaIdleIsvItemPublishRequest.IdleItemImageInfoApiDODomain();
list22.Add(obj23);
obj23.Width = 12L;
obj23.Height = 12L;
obj23.FileId = 12L;
obj1.LongImages= list22;
List<AlibabaIdleIsvItemPublishRequest.IdleItemSkuImageInfoApiDODomain> list25 = new List<AlibabaIdleIsvItemPublishRequest.IdleItemSkuImageInfoApiDODomain>();
AlibabaIdleIsvItemPublishRequest.IdleItemSkuImageInfoApiDODomain obj26 = new AlibabaIdleIsvItemPublishRequest.IdleItemSkuImageInfoApiDODomain();
list25.Add(obj26);
obj26.ImageId = 123L;
obj26.PropertyText = "颜色";
obj26.ValueText = "红色";
obj1.PropertyImages= list25;
obj1.Weight = "9.87";
obj1.WeightUnit = "g";
AlibabaIdleIsvItemPublishRequest.IdleItemTrendyPreSaleDODomain obj27 = new AlibabaIdleIsvItemPublishRequest.IdleItemTrendyPreSaleDODomain();
obj27.DepModel = 1L;
obj27.DepConfig = "10";
obj27.StartTime = "1725623518000";
obj27.EndTime = "1725623518000";
obj27.GTime = "1725623518000";
obj1.TrendyPreSaleDo= obj27;
AlibabaIdleIsvItemPublishRequest.IdleItemApiStoreGroupDODomain obj28 = new AlibabaIdleIsvItemPublishRequest.IdleItemApiStoreGroupDODomain();
obj28.GroupId = 27033L;
obj28.GroupName = "肯德基全国门店";
obj1.StoreGroupDo= obj28;
obj1.ServicePublishSource = "xgj_distribution";
AlibabaIdleIsvItemPublishRequest.IdleItemMerchantDataDODomain obj29 = new AlibabaIdleIsvItemPublishRequest.IdleItemMerchantDataDODomain();
obj29.MerchantActId = 3323L;
obj1.MerchantDataDo= obj29;
AlibabaIdleIsvItemPublishRequest.IdleDistributionItemInfoDODomain obj30 = new AlibabaIdleIsvItemPublishRequest.IdleDistributionItemInfoDODomain();
obj30.OutSyncItemId = "842472706080";
obj30.ProductId = "562455585535";
obj30.OutSyncItemBizCode = "idleDistribution";
obj30.DistributorUserId = "2212935862056";
obj30.SourceFrom = "1";
obj30.OutSupplyId = "2217601284340";
obj30.PrimaryChannelCode = "tmallchaoshipm";
obj30.SubChannelCode = "tmallchaoshipm_xianyu";
obj30.OutSyncInventoryGrade = "1";
obj30.OutSyncSkuId = "5688665204001";
obj30.NeedStuffCustom = false;
obj30.StuffValueId = 15994218;
obj30.StuffValueName = "几乎全新";
obj1.DistributionItemInfo= obj30;
obj1.SkipCheckRaiseB = false;
obj1.SecKillTime = 1742878665198L;
req.ItemParam_ = obj1;
AlibabaIdleIsvItemPublishResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaIdleIsvItemPublishRequest;
$item_param = new IdleItemApiDo;
$item_param->inspect_report="http://inspect_report.html";
$item_param->images="[]";
$item_param->reserve_price="35.31";
$item_param->transport_fee="5.87";
$item_param->original_price="50.02";
$item_param->title="iphoneX手机特卖";
$item_param->stuff_status="95";
$item_param->sp_biz_type="1";
$item_param->division_id="330110";
$item_param->category_id="50025386";
$item_param->trade_type="0";
$item_param->desc="全新，红色，超便宜";
$item_param->latitude="25.82782";
$item_param->longitude="107.54135";
$item_param->item_biz_type="0";
$item_param->ware_house_city="杭州";
$item_param->ware_house_time="1615863262";
$item_param->channel_cat_id="12345567";
$pv_list = new IdleNewPubValueDo;
$pv_list->property_id="21553";
$pv_list->property_name="品牌";
$pv_list->channel_cat_id="1451";
$pv_list->value_id="12354";
$pv_list->value_name="Apple/苹果";
$item_param->pv_list = $pv_list;
$item_sku_list = new IdleItemApiSkuDo;
$property_list = new IdleItemApiPvPairDo;
$property_list->value_text="XL";
$property_list->property_text="尺码";
$item_sku_list->property_list = $property_list;
$item_sku_list->quantity="5";
$item_sku_list->price="1";
$item_sku_list->outer_id="123523462";
$item_param->item_sku_list = $item_sku_list;
$inspected_data = new IdleItemApiInspectedDo;
$inspected_data->inspect_report="http://inspect_report.html";
$inspected_data->ware_house_city="深圳";
$inspected_data->ware_house_time="1620544846";
$inspected_data->inspect_report_id="123456";
$item_param->inspected_data = $inspected_data;
$book_data = new IdleItemApiBookDo;
$book_data->barcode="9787111302832";
$book_data->barcode_name="计算机科学丛书";
$item_param->book_data = $book_data;
$item_param->quantity="1";
$item_param->template_id="40090611110";
$item_param->outer_id="190085448924";
$bid_data = new IdleItemApiBidDo;
$bid_data->bid_start_time="1629949200000";
$bid_data->bid_end_time="1629953200000";
$bid_data->bid_bail="2000";
$bid_data->bid_step="100";
$bid_data->support_task_for_free="1";
$bid_data->task_list="[]";
$bid_data->direct_buy_price="100";
$cycle_vendue_data = new IdleItemApiCycleVendueDO;
$cycle_vendue_data->cycle_buy_remain_count="5";
$cycle_vendue_data->cycle_buy_start_time="1629949200000";
$cycle_vendue_data->cycle_buy_end_time="1629953200000";
$cycle_vendue_data->cycle_vendue="1";
$bid_data->cycle_vendue_data = $cycle_vendue_data;
$item_param->bid_data = $bid_data;
$item_param->auction_type="b";
$item_param->white_bg_imgs="13432534565767";
$item_param->sp_guarantee="1,2,3";
$after_sales_data = new IdleItemApiAfterSalesDo;
$after_sales_data->support_sdr_policy="true";
$after_sales_data->support_nfr_policy="false";
$after_sales_data->support_vnr_policy="false";
$after_sales_data->support_fd24hs_policy="false";
$after_sales_data->support_fd10ms_policy="false";
$after_sales_data->support_fd48hs_policy="false";
$after_sales_data->support_gpa_policy="false";
$after_sales_data->support_nfgc_policy="false";
$item_param->after_sales_data = $after_sales_data;
$real_car_verify_data = new IdleItemRealCarVerifyDO;
$real_car_verify_data->driving_license_info="123";
$real_car_verify_data->driving_license_car_photo="123";
$real_car_verify_data->business_license_front="123";
$real_car_verify_data->car_function="营运";
$real_car_verify_data->car_vin="123123";
$item_param->real_car_verify_data = $real_car_verify_data;
$idle_item_yhb_do = new IdleItemApiYhbDO;
$idle_item_yhb_do->use_yhb_service="true";
$idle_item_yhb_do->settings_preferences="{}";
$item_param->idle_item_yhb_do = $idle_item_yhb_do;
$biz_help_data = new IdleItemApiBizHelpDataDO;
$biz_help_data->first_phase_order_id="123213";
$item_param->biz_help_data = $biz_help_data;
$flash_sale_do = new IdleItemApiFlashSaleDO;
$flash_sale_do->tag="1";
$flash_sale_do->food_pro_date="2024-01-01 00:00:00";
$flash_sale_do->food_expire_date="2024-01-01 00:00:00";
$item_param->flash_sale_do = $flash_sale_do;
$item_param->idle_template_id="123";
$brand_bargain = new IdleItemApiBrandBargainDO;
$brand_bargain->item_stuff="unused_micro_defects";
$brand_bargain->produce_date="1709481600000";
$brand_bargain->shelf_life="180";
$brand_bargain->supplier="xxx";
$brand_bargain->cert_pic_id="123";
$item_param->brand_bargain = $brand_bargain;
$item_param->inspection_report="123";
$long_images = new IdleItemImageInfoApiDO;
$long_images->width="12";
$long_images->height="12";
$long_images->file_id="12";
$item_param->long_images = $long_images;
$property_images = new IdleItemSkuImageInfoApiDO;
$property_images->image_id="123";
$property_images->property_text="颜色";
$property_images->value_text="红色";
$item_param->property_images = $property_images;
$item_param->weight="9.87";
$item_param->weight_unit="g";
$trendy_pre_sale_do = new IdleItemTrendyPreSaleDO;
$trendy_pre_sale_do->dep_model="1";
$trendy_pre_sale_do->dep_config="10";
$trendy_pre_sale_do->start_time="1725623518000";
$trendy_pre_sale_do->end_time="1725623518000";
$trendy_pre_sale_do->g_time="1725623518000";
$item_param->trendy_pre_sale_do = $trendy_pre_sale_do;
$store_group_do = new IdleItemApiStoreGroupDO;
$store_group_do->group_id="27033";
$store_group_do->group_name="肯德基全国门店";
$item_param->store_group_do = $store_group_do;
$item_param->service_publish_source="xgj_distribution";
$merchant_data_do = new IdleItemMerchantDataDO;
$merchant_data_do->merchant_act_id="3323";
$item_param->merchant_data_do = $merchant_data_do;
$distribution_item_info = new IdleDistributionItemInfoDO;
$distribution_item_info->out_sync_item_id="842472706080";
$distribution_item_info->product_id="562455585535";
$distribution_item_info->out_sync_item_biz_code="idleDistribution";
$distribution_item_info->distributor_user_id="2212935862056";
$distribution_item_info->source_from="1";
$distribution_item_info->out_supply_id="2217601284340";
$distribution_item_info->primary_channel_code="tmallchaoshipm";
$distribution_item_info->sub_channel_code="tmallchaoshipm_xianyu";
$distribution_item_info->out_sync_inventory_grade="1";
$distribution_item_info->out_sync_sku_id="5688665204001";
$distribution_item_info->need_stuff_custom="false";
$distribution_item_info->stuff_value_id="15994218";
$distribution_item_info->stuff_value_name="几乎全新";
$item_param->distribution_item_info = $distribution_item_info;
$item_param->skip_check_raise_b="false";
$item_param->sec_kill_time="1742878665198";
$req->setItemParam(json_encode($item_param));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.idle.isv.item.publish' \
-d 'partner_id=apidoc' \
-d 'session=e63a1057-b268-4caf-a9ff-2273054a4ffc' \
-d 'sign=F7B553A9B8B0ACE5B7D7869BDE8CADA1' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-27+23%3A12%3A40' \
-d 'v=2.0' \
-d 'item_param=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaIdleIsvItemPublishRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.item_param=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.idle.isv.item.publish");
add_param(pRequest,"item_param","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.idle.isv.item.publish', {
	'item_param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<alibaba_idle_isv_item_publish_response>
    <result>
        <data>
            <item_id>商品id</item_id>
            <notify_message>为了保障游戏账号商品交易安全，买家需等待30天才能确认收货</notify_message>
        </data>
        <success>false</success>
        <err_code>PARAM_ILLEGAL</err_code>
        <err_msg>参数不合法</err_msg>
    </result>
</alibaba_idle_isv_item_publish_response>

{
    "alibaba_idle_isv_item_publish_response":{
        "result":{
            "data":{
                "item_id":商品id,
                "notify_message":"为了保障游戏账号商品交易安全，买家需等待30天才能确认收货"
            },
            "success":false,
            "err_code":"PARAM_ILLEGAL",
            "err_msg":"参数不合法"
        }
    }
}

异常示例

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码解释

错误码	错误描述	解决方案
WARE_HOUSE_CITY_INVALID	入仓城市不合法	仅支持白名单城市
WARE_HOUSE_TIME_INVALID	入仓时间不合法	应填2010-2050之间的秒时间戳
TOP_ITEM_ADD_FAIL	商品发布失败	根据具体错误，单独排查
TOP_ISVBIZ_NOTALLOW_ACCESS	服务商业务未准入	请联系闲鱼运营，做服务商准入
TOP_IMAGE_NOT_FOUND	找不到传入的某些图片	需要卖家确认图片传入的是否正确，必须是自己发的图片
TOP_SELLER_NOTALLOW_ACCESS	卖家未通过闲鱼招商	联系闲鱼运营，进行招商报名审核
TOP_BID_PARAM_NULL	拍卖bid_data参数信息不全	需要卖家补充参数
TOP_CATEGORY_CHECK_LIMIT	类目检查限制	需要服务商确认业务-品类对应的category_id是否匹配
TOP_INSPECTED_PARAM_NULL	已验货参数信息不全	需要卖家补充参数
TOP_BOOK_PARAM_NULL	图书参数信息不全	需要卖家补充图书信息
TOP_BID_MULTI_QUANTITY_LIMITED	拍卖宝贝不支持多库存	产品规则，发布时去掉多库存字段
TOP_SPGUARANTEE_LIMIT	服务标签不支持非优品商品	非优品去掉服务标签参数，会在业务类型选择优品
TOP_ITEM_BIZ_OFFLINE	优品部分大快消业务下线，对应的商品不再支持发布，如有疑问请联系闲鱼小二	如有疑问请联系闲鱼运营小二

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

开放平台

闲鱼已验货

alibaba.idle.isv.item.publish (服务商闲鱼商品发布)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ