文档中心 > API类目 > 用户API

taobao.item.barcode.gs.get (gs1数据获取接口)

向大润发提供cgf数据查询服务

公共参数

请求地址：

环境	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。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
gtin_code	String	可选	6923644287627		条码值

响应参数

名称	类型	示例值	描述
result	ResultDo	demo	返回结果
└ error_map String demo 错误信息 module CgfDataDto demo 数据模型 cgf_outer_info CgfOuterInfoDto demo 外箱包装、储运、层级、测量信息 └ stacking_factor String 1 可堆叠层数 └ count_of_each_specific_products String [] 1 内装中包数量 └ gtin_of_the_contained_products String [] 06970999038114 内装中包GTIN └ total_count_of_all_products String 9 内装中包总数 └ number_of_different_products String 3 内装中包种数 └ gtin String 06970999038114 外箱条码 └ packaging_type String 箱包装类型 └ product_packaging_level String 单品包装层级 └ height String 210 高度 └ height_unit_of_measure String 毫米高度-度量单位 └ width String 210 宽度 └ width_unit_of_measure String 毫米宽度-度量单位 └ deep String 210 深度 └ deep_unit_of_measure String 毫米深度-度量单位 └ gross_weight String 13574 毛重 └ gross_weight_unit_of_measure String 克毛重-度量单位 cgf_middle_info CgfMiddleInfoDto demo 中包包装、储运、层级、测量信息 └ count_of_each_specific_products String [] 3 内装单品数量 └ gtin_of_the_contained_products String [] demo 内装单品GTIN └ total_count_of_all_products String 9 内装单品总数 └ number_of_different_products String 3 内装单品种数 └ gtin String demo 数据模型 └ packaging_type String 箱包装类型 └ product_packaging_level String 中包或内包装包装层级 └ height String 210 高度 └ height_unit_of_measure String 毫米高度-度量单位 └ width String 210 宽度 └ width_unit_of_measure String 毫米宽度-度量单位 └ deep String 210 深度 └ deep_unit_of_measure String 毫米深度-度量单位 └ gross_weight String 13574 毛重 └ gross_weight_unit_of_measure String 克毛重-度量单位 handling_info CgfHandlingInfoDto demo 装卸储运信息 └ handling_instructions String 有毒有害装卸储运说明 └ stacking_factor String 3 可堆叠层数 cgf_tax_info CgfTaxInfoDto demo 税费信息 └ tax_percentage String 0 进项税率 └ tax_type_code String demo 税务编码 regulatory_info CgfRegulatoryInfoDto demo 监管认证信息 third_party_accreditation_symbols ThirdPartyAccreditationSymbol [] demo 认证标志/合格标识信息 └ markings_description String 保健食品蓝帽子标志认证标志/合格标识说明 └ third_party_accreditation_symbol_on_product_package String 保健食品蓝帽子标志认证标志/合格标识 └ regulation_type_code String REGULATED_BY_AGENCY 监管类型代码 └ regulatory_permit_identification String SC10661102601128 批准文号 └ regulatory_act String GB/T 20977-2007 执行标准 product_spec CgfProductSpecDto demo 规格型号 └ model_number String E27 型号 └ size_dimension String 容量：120升尺寸规格 └ net_content_statement String 20克*10袋净含量规格 product_info CgfProductInfoDto demo 生产信息、联系信息、商品说明 └ product_variant String 燕麦拿铁商品特征 └ product_variant_type_code String FLAVOUR 商品特征类型 └ product_range String 产品系列产品系列 └ sub_brand_name String 经典子品牌名称 └ minimum_daysof_shelf_life_from_production String 90 保质期（如有多个，填写最短保质期） └ consumer_storage_instructions String 开封后冷藏，避免阳光直射贮藏/储存方法 └ warning_copy_description String 危险注意事项/警示语 └ trade_item_feature_benefit String demo 主宣传语 └ consumer_usage_instructions String 开袋即食食用方法/使用方法 nutriens Nutriens [] demo 营养素信息 nutrient_base_lists NutrientBaseList [] demo 营养成分子模板列表 nutrient_values NutrientValue [] demo 营养素列表 └ daily_nutrient_value_percentage String 10 NRV% └ daily_nutrient_value_percentage_precision_code String 大于或等于 NRV%计算精度 └ nutrient_quantity_unit String 克营养素度量单位 └ nutrient_quantity String 脂肪营养素含量 └ nutrient_value_precision_code String 大于或等于营养素计算精度 └ nutrient_code String 蛋白质营养素名称 └ nutritional_preparation_code String 未制备的营养素含量基于的商品制备状态 └ nutrient_basis_type_code String 每100克营养素计算基准类型 └ unit_of_measure String 克营养素计算基准-度量单位 └ serving_size String 55毫克每份含量 └ nutrient_basis_unit String 克营养素计算基准度量单位 └ nutrient_basis String 每100克营养素计算基准 └ nutrient_basis_quantity_description String 营养成分表营养成分表名称 └ non_food_ingredient_statement String demo 成分（非食） └ ingredient_statement String demo 配料（食品） communication_channel CommunicationChannel demo 联系信息 └ contact_type_code String DSU 联系人类型 └ contact_method_code String TELEPHONE 联系方式 └ contact_details String 100100100 联系电话 └ provenance_statement String 长白山配料原产地（矿泉水类） └ ingredient_name String 水，奶一组配料 └ manufacturer_address String [] xx省xx市生产厂家地址 └ manufacturer_names String [] xx厂生产厂家名称 └ origin_declarations String [] 浙江省杭州市二级产地 └ country_subdivisionof_origin_codes String [] 浙江省一级产地 └ country_of_origins String [] 中国大陆原产国（地区） └ brand_owner_name String demo 品牌商名称 base_info CgfBaseInfoDto demo 数据模型 └ product_type_description String 洗衣液品类通用名称 └ update_time String demo 更新时间 └ brand_owner_name String demo 品牌商名称 └ net_content_unit_of_measure String 100 净含量-度量单位 └ net_content String 克净含量 └ gpc_description String demo 产品类目编码对应的描述 └ product_category String demo 产品类目编码 └ country_of_sale String demo 销售国（地区） product_images ProductImage [] demo 产品图片URL └ digital_asset_type_code String demo 数字资产类型 └ digital_asset_file_name String demo 数字资产文件名 └ product_image_url String demo 图片URL └ product_title String demo 标题（产品名称） └ brand_name String demo 品牌名 └ effective_date_time String demo 商品信息生效时间 └ gtin String 06970999038114 GTIN 条码 └ packaging_type String 箱包装类型 └ product_packaging_level String 外箱包装层级 └ height String 210 高度 └ height_unit_of_measure String 毫米高度-度量单位 └ width String 210 宽度 └ width_unit_of_measure String 毫米宽度-度量单位 └ deep_unit_of_measure String 毫米深度-度量单位 └ deep String 210 深度 └ gross_weight String 13574 毛重 └ gross_weight_unit_of_measure String 克毛重-度量单位 └ success Boolean true 调用结果标志

请求示例

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
ItemBarcodeGsGetRequest req = new ItemBarcodeGsGetRequest();
req.setGtinCode("6923644287627");
ItemBarcodeGsGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

XML示例
JSON示例

<item_barcode_gs_get_response>
    <result>
        <error_map>demo</error_map>
        <module>
            <cgf_outer_info>
                <stacking_factor>1</stacking_factor>
                <count_of_each_specific_products>
                    <string>1</string>
                </count_of_each_specific_products>
                <gtin_of_the_contained_products>
                    <string>06970999038114</string>
                </gtin_of_the_contained_products>
                <total_count_of_all_products>9</total_count_of_all_products>
                <number_of_different_products>3</number_of_different_products>
                <gtin>06970999038114</gtin>
                <packaging_type>箱</packaging_type>
                <product_packaging_level>单品</product_packaging_level>
                <height>210</height>
                <height_unit_of_measure>毫米</height_unit_of_measure>
                <width>210</width>
                <width_unit_of_measure>毫米</width_unit_of_measure>
                <deep>210</deep>
                <deep_unit_of_measure>毫米</deep_unit_of_measure>
                <gross_weight>13574</gross_weight>
                <gross_weight_unit_of_measure>克</gross_weight_unit_of_measure>
            </cgf_outer_info>
            <cgf_middle_info>
                <count_of_each_specific_products>
                    <string>3</string>
                </count_of_each_specific_products>
                <gtin_of_the_contained_products>
                    <string>demo</string>
                </gtin_of_the_contained_products>
                <total_count_of_all_products>9</total_count_of_all_products>
                <number_of_different_products>3</number_of_different_products>
                <gtin>demo</gtin>
                <packaging_type>箱</packaging_type>
                <product_packaging_level>中包或内包装</product_packaging_level>
                <height>210</height>
                <height_unit_of_measure>毫米</height_unit_of_measure>
                <width>210</width>
                <width_unit_of_measure>毫米</width_unit_of_measure>
                <deep>210</deep>
                <deep_unit_of_measure>毫米</deep_unit_of_measure>
                <gross_weight>13574</gross_weight>
                <gross_weight_unit_of_measure>克</gross_weight_unit_of_measure>
            </cgf_middle_info>
            <handling_info>
                <handling_instructions>有毒有害</handling_instructions>
                <stacking_factor>3</stacking_factor>
            </handling_info>
            <cgf_tax_info>
                <tax_percentage>0</tax_percentage>
                <tax_type_code>demo</tax_type_code>
            </cgf_tax_info>
            <regulatory_info>
                <third_party_accreditation_symbols>
                    <third_party_accreditation_symbol>
                        <markings_description>保健食品蓝帽子标志</markings_description>
                        <third_party_accreditation_symbol_on_product_package>保健食品蓝帽子标志</third_party_accreditation_symbol_on_product_package>
                    </third_party_accreditation_symbol>
                </third_party_accreditation_symbols>
                <regulation_type_code>REGULATED_BY_AGENCY</regulation_type_code>
                <regulatory_permit_identification>SC10661102601128</regulatory_permit_identification>
                <regulatory_act>GB/T 20977-2007</regulatory_act>
            </regulatory_info>
            <product_spec>
                <model_number>E27</model_number>
                <size_dimension>容量：120升</size_dimension>
                <net_content_statement>20克*10袋</net_content_statement>
            </product_spec>
            <product_info>
                <product_variant>燕麦拿铁</product_variant>
                <product_variant_type_code>FLAVOUR</product_variant_type_code>
                <product_range>产品系列</product_range>
                <sub_brand_name>经典</sub_brand_name>
                <minimum_daysof_shelf_life_from_production>90</minimum_daysof_shelf_life_from_production>
                <consumer_storage_instructions>开封后冷藏，避免阳光直射</consumer_storage_instructions>
                <warning_copy_description>危险</warning_copy_description>
                <trade_item_feature_benefit>demo</trade_item_feature_benefit>
                <consumer_usage_instructions>开袋即食</consumer_usage_instructions>
                <nutriens>
                    <nutriens>
                        <nutrient_base_lists>
                            <nutrient_base_list>
                                <nutrient_values>
                                    <nutrient_value>
                                        <daily_nutrient_value_percentage>10</daily_nutrient_value_percentage>
                                        <daily_nutrient_value_percentage_precision_code>大于或等于</daily_nutrient_value_percentage_precision_code>
                                        <nutrient_quantity_unit>克</nutrient_quantity_unit>
                                        <nutrient_quantity>脂肪</nutrient_quantity>
                                        <nutrient_value_precision_code>大于或等于</nutrient_value_precision_code>
                                        <nutrient_code>蛋白质</nutrient_code>
                                    </nutrient_value>
                                </nutrient_values>
                                <nutritional_preparation_code>未制备的</nutritional_preparation_code>
                                <nutrient_basis_type_code>每100克</nutrient_basis_type_code>
                                <unit_of_measure>克</unit_of_measure>
                                <serving_size>55毫克</serving_size>
                                <nutrient_basis_unit>克</nutrient_basis_unit>
                                <nutrient_basis>每100克</nutrient_basis>
                            </nutrient_base_list>
                        </nutrient_base_lists>
                        <nutrient_basis_quantity_description>营养成分表</nutrient_basis_quantity_description>
                    </nutriens>
                </nutriens>
                <non_food_ingredient_statement>demo</non_food_ingredient_statement>
                <ingredient_statement>demo</ingredient_statement>
                <communication_channel>
                    <contact_type_code>DSU</contact_type_code>
                    <contact_method_code>TELEPHONE</contact_method_code>
                    <contact_details>100100100</contact_details>
                </communication_channel>
                <provenance_statement>长白山</provenance_statement>
                <ingredient_name>水，奶</ingredient_name>
                <manufacturer_address>
                    <string>xx省xx市</string>
                </manufacturer_address>
                <manufacturer_names>
                    <string>xx厂</string>
                </manufacturer_names>
                <origin_declarations>
                    <string>浙江省杭州市</string>
                </origin_declarations>
                <country_subdivisionof_origin_codes>
                    <string>浙江省</string>
                </country_subdivisionof_origin_codes>
                <country_of_origins>
                    <string>中国大陆</string>
                </country_of_origins>
                <brand_owner_name>demo</brand_owner_name>
            </product_info>
            <base_info>
                <product_type_description>洗衣液</product_type_description>
                <update_time>demo</update_time>
                <brand_owner_name>demo</brand_owner_name>
                <net_content_unit_of_measure>100</net_content_unit_of_measure>
                <net_content>克</net_content>
                <gpc_description>demo</gpc_description>
                <product_category>demo</product_category>
                <country_of_sale>demo</country_of_sale>
                <product_images>
                    <product_image>
                        <digital_asset_type_code>demo</digital_asset_type_code>
                        <digital_asset_file_name>demo</digital_asset_file_name>
                        <product_image_url>demo</product_image_url>
                    </product_image>
                </product_images>
                <product_title>demo</product_title>
                <brand_name>demo</brand_name>
                <effective_date_time>demo</effective_date_time>
                <gtin>06970999038114</gtin>
                <packaging_type>箱</packaging_type>
                <product_packaging_level>外箱</product_packaging_level>
                <height>210</height>
                <height_unit_of_measure>毫米</height_unit_of_measure>
                <width>210</width>
                <width_unit_of_measure>毫米</width_unit_of_measure>
                <deep_unit_of_measure>毫米</deep_unit_of_measure>
                <deep>210</deep>
                <gross_weight>13574</gross_weight>
                <gross_weight_unit_of_measure>克</gross_weight_unit_of_measure>
            </base_info>
        </module>
        <success>true</success>
    </result>
</item_barcode_gs_get_response>

{
    "item_barcode_gs_get_response":{
        "result":{
            "error_map":"demo",
            "module":{
                "cgf_outer_info":{
                    "stacking_factor":"1",
                    "count_of_each_specific_products":{
                        "string":[
                            "1"
                        ]
                    },
                    "gtin_of_the_contained_products":{
                        "string":[
                            "06970999038114"
                        ]
                    },
                    "total_count_of_all_products":"9",
                    "number_of_different_products":"3",
                    "gtin":"06970999038114",
                    "packaging_type":"箱",
                    "product_packaging_level":"单品",
                    "height":"210",
                    "height_unit_of_measure":"毫米",
                    "width":"210",
                    "width_unit_of_measure":"毫米",
                    "deep":"210",
                    "deep_unit_of_measure":"毫米",
                    "gross_weight":"13574",
                    "gross_weight_unit_of_measure":"克"
                },
                "cgf_middle_info":{
                    "count_of_each_specific_products":{
                        "string":[
                            "3"
                        ]
                    },
                    "gtin_of_the_contained_products":{
                        "string":[
                            "demo"
                        ]
                    },
                    "total_count_of_all_products":"9",
                    "number_of_different_products":"3",
                    "gtin":"demo",
                    "packaging_type":"箱",
                    "product_packaging_level":"中包或内包装",
                    "height":"210",
                    "height_unit_of_measure":"毫米",
                    "width":"210",
                    "width_unit_of_measure":"毫米",
                    "deep":"210",
                    "deep_unit_of_measure":"毫米",
                    "gross_weight":"13574",
                    "gross_weight_unit_of_measure":"克"
                },
                "handling_info":{
                    "handling_instructions":"有毒有害",
                    "stacking_factor":"3"
                },
                "cgf_tax_info":{
                    "tax_percentage":"0",
                    "tax_type_code":"demo"
                },
                "regulatory_info":{
                    "third_party_accreditation_symbols":{
                        "third_party_accreditation_symbol":[
                            {
                                "markings_description":"保健食品蓝帽子标志",
                                "third_party_accreditation_symbol_on_product_package":"保健食品蓝帽子标志"
                            }
                        ]
                    },
                    "regulation_type_code":"REGULATED_BY_AGENCY",
                    "regulatory_permit_identification":"SC10661102601128",
                    "regulatory_act":"GB\/T 20977-2007"
                },
                "product_spec":{
                    "model_number":"E27",
                    "size_dimension":"容量：120升",
                    "net_content_statement":"20克*10袋"
                },
                "product_info":{
                    "product_variant":"燕麦拿铁",
                    "product_variant_type_code":"FLAVOUR",
                    "product_range":"产品系列",
                    "sub_brand_name":"经典",
                    "minimum_daysof_shelf_life_from_production":"90",
                    "consumer_storage_instructions":"开封后冷藏，避免阳光直射",
                    "warning_copy_description":"危险",
                    "trade_item_feature_benefit":"demo",
                    "consumer_usage_instructions":"开袋即食",
                    "nutriens":{
                        "nutriens":[
                            {
                                "nutrient_base_lists":{
                                    "nutrient_base_list":[
                                        {
                                            "nutrient_values":{
                                                "nutrient_value":[
                                                    {
                                                        "daily_nutrient_value_percentage":"10",
                                                        "daily_nutrient_value_percentage_precision_code":"大于或等于",
                                                        "nutrient_quantity_unit":"克",
                                                        "nutrient_quantity":"脂肪",
                                                        "nutrient_value_precision_code":"大于或等于",
                                                        "nutrient_code":"蛋白质"
                                                    }
                                                ]
                                            },
                                            "nutritional_preparation_code":"未制备的",
                                            "nutrient_basis_type_code":"每100克",
                                            "unit_of_measure":"克",
                                            "serving_size":"55毫克",
                                            "nutrient_basis_unit":"克",
                                            "nutrient_basis":"每100克"
                                        }
                                    ]
                                },
                                "nutrient_basis_quantity_description":"营养成分表"
                            }
                        ]
                    },
                    "non_food_ingredient_statement":"demo",
                    "ingredient_statement":"demo",
                    "communication_channel":{
                        "contact_type_code":"DSU",
                        "contact_method_code":"TELEPHONE",
                        "contact_details":"100100100"
                    },
                    "provenance_statement":"长白山",
                    "ingredient_name":"水，奶",
                    "manufacturer_address":{
                        "string":[
                            "xx省xx市"
                        ]
                    },
                    "manufacturer_names":{
                        "string":[
                            "xx厂"
                        ]
                    },
                    "origin_declarations":{
                        "string":[
                            "浙江省杭州市"
                        ]
                    },
                    "country_subdivisionof_origin_codes":{
                        "string":[
                            "浙江省"
                        ]
                    },
                    "country_of_origins":{
                        "string":[
                            "中国大陆"
                        ]
                    },
                    "brand_owner_name":"demo"
                },
                "base_info":{
                    "product_type_description":"洗衣液",
                    "update_time":"demo",
                    "brand_owner_name":"demo",
                    "net_content_unit_of_measure":"100",
                    "net_content":"克",
                    "gpc_description":"demo",
                    "product_category":"demo",
                    "country_of_sale":"demo",
                    "product_images":{
                        "product_image":[
                            {
                                "digital_asset_type_code":"demo",
                                "digital_asset_file_name":"demo",
                                "product_image_url":"demo"
                            }
                        ]
                    },
                    "product_title":"demo",
                    "brand_name":"demo",
                    "effective_date_time":"demo",
                    "gtin":"06970999038114",
                    "packaging_type":"箱",
                    "product_packaging_level":"外箱",
                    "height":"210",
                    "height_unit_of_measure":"毫米",
                    "width":"210",
                    "width_unit_of_measure":"毫米",
                    "deep_unit_of_measure":"毫米",
                    "deep":"210",
                    "gross_weight":"13574",
                    "gross_weight_unit_of_measure":"克"
                }
            },
            "success":true
        }
    }
}

异常示例

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>

错误码解释

错误码	错误描述	解决方案

API工具

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

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

用户API

taobao.item.barcode.gs.get (gs1数据获取接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ