零售进销存开发：商品条码查询 API 方案实践

做零售收银 / 进销存 SaaS、跨境食品商贸的开发者想必对商品条码接口很熟悉，扫描条码就能知道商品信息。但是还是会存在一些疑惑，这个接口查询速度快不快？能查到多少产品信息？覆盖的商品多吗？进口商品能查吗？

应用场景

✅超市收银 / PDA 入库：扫条码，自动带出商品名、品牌、规格、图片，不用手动建商品。
✅仓储系统：扫码录入，自动获取尺寸、重量，辅助计算库位、物流体积。
✅食品溯源小程序：展示厂家信息、原产国、备案信息。
✅电商 SaaS 批量建档：批量查条码，自动填充商品基础资料，提升上新效率。
✅商品分类管理：自动按 UNSPSC 编码归类商品，统一分类体系。

接口介绍

• 输入13位或14位条码，获取条码对应商品的名称、品牌、规格、价格、等信息，海量条码信息储备。

• 本地库千万级别数据支撑，本地无数据实时查询中国编码中心。

• 支持国内69开头条码和国外进口条码查询，条码数据定期更新，可配合条码识别接口实现扫码识别条码数据。

请求参数

返回参数

部分参数功能详解

• goods_type / category_code / category_name：商品分类 + UNSPSC 编码，自动给商品归类、做分类树、ERP 分类同步。

• width/height/depth ：外包装尺寸，用于仓储体积计算、快递装箱预估。

• gross_weight/net_weight：毛重 / 净重，仓库称重核对、物流运费估算。

• origin_country：原产国，区分国产 / 进口商品，跨境、商超系统展示。

• shelf_life：保质期，食品系统做临期预警。

• image ：商品图片，商品档案配图、小程序 / 收银界面展示。（有效期24小时，建议自行下载保存，避免丢失）

产品优势

1. 核心优势：千万条码本地缓存，查不到时自动调取编码中心数据。
2. 条码覆盖全：69 国产条码 + 国外进口条码都支持，跨境零售、进口超市很合适。
3. 字段丰富度高：除基础名称 / 品牌 / 厂商 / 规格 / 图片，部分商品可返回尺寸、重量、保质期、食品认证等信息。
4. 一站式配套：同平台自带条码图片 OCR 识别接口，一套 key 完成「拍照识别条码号 + 查询商品信息」整套扫码业务。
5. 接入简单：GET/POST 都支持，传入条码就能返回信息。

python接入教程

import urllib, urllib3, sys, uuid
import ssl


host = 'https://market.aliyun.com/detail/cmapi00065867'#接口地址
path = '/barcode/index'
method = 'GET'
appcode = '你自己的AppCode'
querys = 'barcode=692183……6820'
bodys = {
   }
url = host + path + '?' + querys

http = urllib3.PoolManager()
headers = {
   
    'Authorization': 'APPCODE ' + appcode
}
response = http.request('GET', url, headers=headers)
content = response.data.decode('utf-8')
if (content):
    print(content)

返回示例

{
   
    "code": 1,
    "msg": "操作成功",
    "data": {
   
        "barcode": "6921……20",
        "brand": "老厨", //品牌名称
        "goods_name": "老厨香辣牛肉干", //商品名称
        "company": "温州老厨食品有限公司", //公司名称
        "keyword": "牛肉干", //    关键词
        "goods_type": "食品、饮料和烟草>>预制食品和罐头>>小吃>>肉干和处理过的肉", //商品分类
        "category_code": "10005767", //分类编码-unspsc
        "category_name": "预制/加工牛肉", //分类名称
        "first_ship_date": "", //上市日期
        "spec": "52g", //产品规格
        "width": "", //宽
        "height": "", //高
        "depth": "", //深
        "gross_weight": "", //毛重
        "net_weight": "", //净重
        "price": "6.00", //价格
        "origin_country": "中国", //原产国
        "company_address": "", //
        "packaging_type": "", //包装类型
        "shelf_life": "", //保质期
        "min_sales_unit": "", //最小销售单位
        "certification_standard": "", //    国家认证标准
        "certificate_license": "", //    生产许可证
        "image": "", //图片,（有效期24小时，建议自行下载保存，避免丢失）
        "remark": "checkResult：1；备注：经查，该商品条码已在中国物品编码中心注册；logout_flag：0；login_date：Sep  3 1997 12:00:00:000AM；valid_date：Sep  3 2023 12:00:00:000AM；宽：6.2；单位：CM；高：9.5；深：2；关键字：老厨牌 牛肉干；上市时间：2014-01-01；英文名称：xianglaniurougan；产地：杭州；gpc2020：10005767；" //备注信息
    }
}