您所在位置: 首页 > > 商品API
  • gome.goods.crossBorderProduct.add添加产品的基本信息(跨境专用)

  • 简要描述
  • 系统级输入参数
  • 应用级输入参数
  • 请求示例
  • 返回结果参数
  • 返回示例
  • 异常码
  • 系统级异常码
  • API工具
  • 名称 类型 必须 描述
    $app String 应用的app_key
    $method String API接口名称
    $sign String 签名
    $token String 采用OAuth授权方式为必填参数
    $v String API协议版本,可选值:1.0.0
  • 名称 类型 必须 示例值 描述
    cbGoodsNo String 跨境商品ID,商家自定义的唯一的 SKU 标识,商家可填内部货号或者保税仓账册备案料号,改sku 编码将透传给仓储物流服务商,是仓库料号级管理及发货操作的依据
    cbBondedWarehouseId String CB0007 保税仓ID,枚举:CB0001广东卓志保税仓、 CB0002广州捷晟保税仓、 CB0003宁波宁兴优贝保税仓、 CB0004宁波富立保税仓、 CB0005河南易通保税仓,CB0006义乌云铭供应链有限公司,CB0007温州市云仓供应链管理有限公司
    cbBondedWarehouseName String 保税仓名称,非必填
    cbHsTaxNo String HS税号
    cbHsName String HS名称
    cbFirstLegalNnit String 第一法定计量单位
    cbFirstLegalNum String 第一法定数量
    cbSecLegalNnit String 第二法定计量单位
    cbSecLegalNum String 第二法定数量
    cbOriginCountry String 美国 原产地,https://bytedance.feishu.cn/sheets/shtcnjlc29Me3KD950FxJJfzEkf
    cbOriginCountryCode String US 原产地Code,https://bytedance.feishu.cn/sheets/shtcnjlc29Me3KD950FxJJfzEkf
    cbGoodsSource String 货源地,https://bytedance.feishu.cn/sheets/shtcnjlc29Me3KD950FxJJfzEkf
    cbGoodsSourceCode String 货源地Code,https://bytedance.feishu.cn/sheets/shtcnjlc29Me3KD950FxJJfzEkf
    cbBrandLocation String 美国 品牌所在地,https://bytedance.feishu.cn/sheets/shtcnjlc29Me3KD950FxJJfzEkf
    cbBrandLocationCode String US 品牌所在地Code,https://bytedance.feishu.cn/sheets/shtcnjlc29Me3KD950FxJJfzEkf
    cbTaxpayer String 税金承担方,枚举:1商家、2买家,一期仅支持传1商家承担
    cbWeight String 商品净重,单位kg
    cbGoodsUse String 用途,商品按照用途分类,填写食品用品、衣着用品、日用品、文化用品、家用电器、保健食品这几类,pop 境外商家维护或API 对接
    cbSpecifications String 规格型号,满足海关归类、审价以及监察要求为准。包括:品名、牌名、规格、型号、成份、含量、等级等。 例如:科颜氏高保湿面膜125ml,规格型号可表述为:科颜氏/面膜/面部护肤/125ml
    cbBrand String 品牌,以注册商标名称为准。需填写商品品牌中外文。 顺序应该是先外文后中文,无中文可不填写但是外文一定要填写。如:Nutrilon 荷兰牛栏
    goods String 情况一:如果templateId输入的是0,1,2,3,goods还是按照原来的要求来填写如:outId~P901,color~红色,goodsAnxl~1||2||3||4||5,sell_price~99,goods_version~3.5,goods_tax~0.13,stock~100,tmp_bar_code~131313,image~http://www.cdntaobao.com/1.jpg||http://www.cdntaobao.com/2.jpg,pros~cpjtSpec_property_3=大卡||cpjtSpec_property_2=2*2cm;outId~P902,color~蓝色,goodsAnxl~1||2||3||4||5,sell_price~876,goods_version~2.5,stock~200,tmp_bar_code~231511,image~http://www.cdntaobao.com/3.jpg||http://www.cdntaobao.com/4.jpg,pros~T31_58=8-40个||S8_85=30升及以上。 情况二:如果templateId输入的是4,即销售属性,需要按照下面规范来填写:outId~bht220,goodsProp~c80c62c4448d:H||8ac55c9d2cf8:蓝色,goodsAnxl~1||2||3||4||5,sell_price~100,goods_tax~0.13,stock~100,image~http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg; 其中goodsProp为销售属性标识,c80c62c4448d:H分别为销售属性id和值,对于多个id和值的情况,用||分开,goodsAnxl代表安迅代储需要的长(cm)、高(cm)、宽(cm)、毛重(kg)、保质期天数,用||分开。invoiceType支持的发票类型,支持多种组合非必输 1:电子普票 2:纸质普票 3:增值税专用,默认1,2 商品信息(如果tmp_bar_code[条形码]输入项不为空,条形码限制为不超过18位字符,只能为数字)
    catalogId String cat18000340 商城分类ID,商品三级分类ID
    shopCtgyId String 292056;222085;130188 店铺分类ID,多个按分号分隔。
    brandId String 19106 商品品牌ID
    productName String 商品名称
    description String 这是一件商品 商品描述
    unit String 计量单位
    packingList String 包装清单
    saleService String 售后服务
    templateId String 3 模板id(和goods中的颜色尺码相关联,只能输入0或1或2或3或4;templateId为0时代表无颜色无版本,为1时代表有颜色无版本,为2时代表无颜色有版本,为3时代表有颜色有版本,为4时代表销售属性)
    props String S1111_11572=其他_,S1111_10238=其他_,T1092_10495=OL通勤_,T1092_10156=其他_,T1092_10664=其他_,T1092_11077=长裙_,T1092_11137=短袖_,T1092_10238=150_ 数据来自于gome.goods.itemProps.get根据子类目id获得子类目属性信息;属性串(格式为key=value,多个属性用英文逗号隔开,属性值长度不超过150个字符,如果属性值value是复选,多个值之间用“#@#”分隔,例如:fuZhuangSpec_property_5=400ml以下@#50升-80升#@#50升以上
    gift String 降 价 促 销 广告语
    keyWord String 液晶电视,电视,创维液晶电视 搜索关健词,长度限制128个字符,以英文逗号分隔
    propTempletId String fuZhuangSpec 商品模板ID
    freightTempletId String 运费模板ID(非必输,不填默认去店铺的默认运费模板)
    mobileDescription String 手机简介内容
    productAnxl String 安迅代储产品级,非必输
  • Java


    GmosClient client = new DefaultGmosClient(url, appKey, secret, token);
    GomeGoodsCrossBorderProductAddRequest request = new GomeGoodsCrossBorderProductAddRequest();
      //详细参数信息请参考API详情页面。
        request.setCbGoodsNo("");
        request.setCbBondedWarehouseId("CB0007");
        request.setCbBondedWarehouseName("");
        request.setCbHsTaxNo("");
        request.setCbHsName("");
        request.setCbFirstLegalNnit("");
        request.setCbFirstLegalNum("");
        request.setCbSecLegalNnit("");
        request.setCbSecLegalNum("");
        request.setCbOriginCountry("美国");
        request.setCbOriginCountryCode("US");
        request.setCbGoodsSource("");
        request.setCbGoodsSourceCode("");
        request.setCbBrandLocation("美国");
        request.setCbBrandLocationCode("US");
        request.setCbTaxpayer("");
        request.setCbWeight("");
        request.setCbGoodsUse("");
        request.setCbSpecifications("");
        request.setCbBrand("");
        request.setGoods("情况一:如果templateId输入的是0,1,2,3,goods还是按照原来的要求来填写如:outId~P901,color~红色,goodsAnxl~1||2||3||4||5,sell_price~99,goods_version~3.5,goods_tax~0.13,stock~100,tmp_bar_code~131313,image~http://www.cdntaobao.com/1.jpg||http://www.cdntaobao.com/2.jpg,pros~cpjtSpec_property_3=大卡||cpjtSpec_property_2=2*2cm;outId~P902,color~蓝色,goodsAnxl~1||2||3||4||5,sell_price~876,goods_version~2.5,stock~200,tmp_bar_code~231511,image~http://www.cdntaobao.com/3.jpg||http://www.cdntaobao.com/4.jpg,pros~T31_58=8-40个||S8_85=30升及以上。 情况二:如果templateId输入的是4,即销售属性,需要按照下面规范来填写:outId~bht220,goodsProp~c80c62c4448d:H||8ac55c9d2cf8:蓝色,goodsAnxl~1||2||3||4||5,sell_price~100,goods_tax~0.13,stock~100,image~http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg; 其中goodsProp为销售属性标识,c80c62c4448d:H分别为销售属性id和值,对于多个id和值的情况,用||分开,goodsAnxl代表安迅代储需要的长(cm)、高(cm)、宽(cm)、毛重(kg)、保质期天数,用||分开。invoiceType支持的发票类型,支持多种组合非必输 1:电子普票 2:纸质普票 3:增值税专用,默认1,2");
        request.setCatalogId("cat18000340");
        request.setShopCtgyId("292056;222085;130188");
        request.setBrandId("19106");
        request.setProductName("");
        request.setDescription("这是一件商品");
        request.setUnit("件");
        request.setPackingList("");
        request.setSaleService("");
        request.setTemplateId("3");
        request.setProps("S1111_11572=其他_,S1111_10238=其他_,T1092_10495=OL通勤_,T1092_10156=其他_,T1092_10664=其他_,T1092_11077=长裙_,T1092_11137=短袖_,T1092_10238=150_");
        request.setGift("降 价 促 销");
        request.setKeyWord("液晶电视,电视,创维液晶电视");
        request.setPropTempletId("fuZhuangSpec");
        request.setFreightTempletId("");
        request.setMobileDescription("");
        request.setProductAnxl("");
    GomeGoodsCrossBorderProductAddResponse response = client.execute(request);
    System.out.println(response.getBody());


    PHP


    require_once('GmosSdk.php');
    
    $client = new GmosClient;
      $client -> appkey = "";
      $client -> secretKey = "";
      $client -> session = "";
      $client -> gatewayUrl = "";
    
      $request = new GomeGoodsCrossBorderProductAddRequest;
      //详细参数信息请参考API详情页面。
        $request -> setCbGoodsNo("");
        $request -> setCbBondedWarehouseId("CB0007");
        $request -> setCbBondedWarehouseName("");
        $request -> setCbHsTaxNo("");
        $request -> setCbHsName("");
        $request -> setCbFirstLegalNnit("");
        $request -> setCbFirstLegalNum("");
        $request -> setCbSecLegalNnit("");
        $request -> setCbSecLegalNum("");
        $request -> setCbOriginCountry("美国");
        $request -> setCbOriginCountryCode("US");
        $request -> setCbGoodsSource("");
        $request -> setCbGoodsSourceCode("");
        $request -> setCbBrandLocation("美国");
        $request -> setCbBrandLocationCode("US");
        $request -> setCbTaxpayer("");
        $request -> setCbWeight("");
        $request -> setCbGoodsUse("");
        $request -> setCbSpecifications("");
        $request -> setCbBrand("");
        $request -> setGoods("情况一:如果templateId输入的是0,1,2,3,goods还是按照原来的要求来填写如:outId~P901,color~红色,goodsAnxl~1||2||3||4||5,sell_price~99,goods_version~3.5,goods_tax~0.13,stock~100,tmp_bar_code~131313,image~http://www.cdntaobao.com/1.jpg||http://www.cdntaobao.com/2.jpg,pros~cpjtSpec_property_3=大卡||cpjtSpec_property_2=2*2cm;outId~P902,color~蓝色,goodsAnxl~1||2||3||4||5,sell_price~876,goods_version~2.5,stock~200,tmp_bar_code~231511,image~http://www.cdntaobao.com/3.jpg||http://www.cdntaobao.com/4.jpg,pros~T31_58=8-40个||S8_85=30升及以上。 情况二:如果templateId输入的是4,即销售属性,需要按照下面规范来填写:outId~bht220,goodsProp~c80c62c4448d:H||8ac55c9d2cf8:蓝色,goodsAnxl~1||2||3||4||5,sell_price~100,goods_tax~0.13,stock~100,image~http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg; 其中goodsProp为销售属性标识,c80c62c4448d:H分别为销售属性id和值,对于多个id和值的情况,用||分开,goodsAnxl代表安迅代储需要的长(cm)、高(cm)、宽(cm)、毛重(kg)、保质期天数,用||分开。invoiceType支持的发票类型,支持多种组合非必输 1:电子普票 2:纸质普票 3:增值税专用,默认1,2");
        $request -> setCatalogId("cat18000340");
        $request -> setShopCtgyId("292056;222085;130188");
        $request -> setBrandId("19106");
        $request -> setProductName("");
        $request -> setDescription("这是一件商品");
        $request -> setUnit("件");
        $request -> setPackingList("");
        $request -> setSaleService("");
        $request -> setTemplateId("3");
        $request -> setProps("S1111_11572=其他_,S1111_10238=其他_,T1092_10495=OL通勤_,T1092_10156=其他_,T1092_10664=其他_,T1092_11077=长裙_,T1092_11137=短袖_,T1092_10238=150_");
        $request -> setGift("降 价 促 销");
        $request -> setKeyWord("液晶电视,电视,创维液晶电视");
        $request -> setPropTempletId("fuZhuangSpec");
        $request -> setFreightTempletId("");
        $request -> setMobileDescription("");
        $request -> setProductAnxl("");
    $response = $client -> execute($request);


    Net


    IGmosClient client = new DefaultGmosClient(url, appKey, secret, token);
    GomeGoodsCrossBorderProductAddRequest request = new GomeGoodsCrossBorderProductAddRequest();
    
    request.CbGoodsNo="";
    request.CbBondedWarehouseId="CB0007";
    request.CbBondedWarehouseName="";
    request.CbHsTaxNo="";
    request.CbHsName="";
    request.CbFirstLegalNnit="";
    request.CbFirstLegalNum="";
    request.CbSecLegalNnit="";
    request.CbSecLegalNum="";
    request.CbOriginCountry="美国";
    request.CbOriginCountryCode="US";
    request.CbGoodsSource="";
    request.CbGoodsSourceCode="";
    request.CbBrandLocation="美国";
    request.CbBrandLocationCode="US";
    request.CbTaxpayer="";
    request.CbWeight="";
    request.CbGoodsUse="";
    request.CbSpecifications="";
    request.CbBrand="";
    request.Goods="情况一:如果templateId输入的是0,1,2,3,goods还是按照原来的要求来填写如:outId~P901,color~红色,goodsAnxl~1||2||3||4||5,sell_price~99,goods_version~3.5,goods_tax~0.13,stock~100,tmp_bar_code~131313,image~http://www.cdntaobao.com/1.jpg||http://www.cdntaobao.com/2.jpg,pros~cpjtSpec_property_3=大卡||cpjtSpec_property_2=2*2cm;outId~P902,color~蓝色,goodsAnxl~1||2||3||4||5,sell_price~876,goods_version~2.5,stock~200,tmp_bar_code~231511,image~http://www.cdntaobao.com/3.jpg||http://www.cdntaobao.com/4.jpg,pros~T31_58=8-40个||S8_85=30升及以上。 情况二:如果templateId输入的是4,即销售属性,需要按照下面规范来填写:outId~bht220,goodsProp~c80c62c4448d:H||8ac55c9d2cf8:蓝色,goodsAnxl~1||2||3||4||5,sell_price~100,goods_tax~0.13,stock~100,image~http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg; 其中goodsProp为销售属性标识,c80c62c4448d:H分别为销售属性id和值,对于多个id和值的情况,用||分开,goodsAnxl代表安迅代储需要的长(cm)、高(cm)、宽(cm)、毛重(kg)、保质期天数,用||分开。invoiceType支持的发票类型,支持多种组合非必输 1:电子普票 2:纸质普票 3:增值税专用,默认1,2";
    request.CatalogId="cat18000340";
    request.ShopCtgyId="292056;222085;130188";
    request.BrandId="19106";
    request.ProductName="";
    request.Description="这是一件商品";
    request.Unit="件";
    request.PackingList="";
    request.SaleService="";
    request.TemplateId="3";
    request.Props="S1111_11572=其他_,S1111_10238=其他_,T1092_10495=OL通勤_,T1092_10156=其他_,T1092_10664=其他_,T1092_11077=长裙_,T1092_11137=短袖_,T1092_10238=150_";
    request.Gift="降 价 促 销";
    request.KeyWord="液晶电视,电视,创维液晶电视";
    request.PropTempletId="fuZhuangSpec";
    request.FreightTempletId="";
    request.MobileDescription="";
    request.ProductAnxl="";
    
    GomeGoodsCrossBorderProductAddResponse response = client.Execute(request);
  • 错误码 错误消息
  • 错误码 错误消息
    10001 系统错误
    10002 方法调用次数超限
    10003 当前版本的方法不存在,请检查
    10004 缺少版本参数,请指定服务方法的版本号
    10005 该应用在当前IP下禁止访问
    8224 缺少签名参数,请添加签名请求参数
    8999 存在重复的请求,请在90秒之后再请求第二次
    8225 签名无效,请按正确的算法对请求数据进行签名
    9000 字段%s不能为空
    8249 超过上传限制
    8223 无效的appKey,请使用合法的appKey(由服务提供商授予你)
    8239 需要传递accessToken参数
    8222 缺少appKey,请向服务端获取合法的appKey
    20001 令牌已过期