1. 简介

2. 商品模块API

2.1. 批量创建或更新商品信息接口

2.1.1. SERVICE_TYPE

GLINK_BATCH_OPERATE_ITEM_NOTIFY

2.1.2. 请求参数

批量创建或更新商品信息请求

参数名 类型 列表 必填 备注
partnerId string N N 合作伙伴ID
itemList object Y Y 商品信息列表；商品不存在则创建，已存在则更新
└ customerCode string N Y 用户编码
└ sku string N Y 商品编码
└ description string N Y 商品名称描述
└ description1 string N N 商品描述1，可用于记录其他语言的描述
└ category string N N 货物分类，WMS系统中维护好该种类才可接收，只支持英文
└ brand string N N 商品品牌
└ countryOfOrigin string N N 商品原产国，国家二字代码，如US、CN
└ shelfLife int N N 商品保质期
└ shelfLifeUnit string N N 保质期单位；业务约定值 DAY：天，MONTH：月，YEAR：年
└ hsCode string N N 海关编码
└ batteryFlag boolean N N 是否含有电池，true/false；不传默认false
└ hazmatFlag boolean N N 是否危险品，true/false；不传默认false
└ liquidFlag boolean N N 是否液体，true/false；不传默认false
└ fragileFlag boolean N N 是否易碎品，true/false；不传默认false
└ careMfgDate boolean N N 是否管生产日期，true/false；不传默认false
└ careExpDate boolean N N 是否管失效日期，true/false；不传默认false
└ careBatch boolean N N 是否管批次，true/false；不传默认false
└ careOriginCountry boolean N N 是否管原产国，true/false；不传默认false
└ requireSerialNumber boolean N N 是否管序列号，true/false；不传默认false
└ packagingList object Y Y 包装节点；至少需提供EA节点的长、宽、高、重量
  └ unit string N Y 包装单位；EA：商品单件包装，CS：商品箱包装，INP：商品内包装
  └ pcsQty int N N 包装数量；仅 INP/CS 包装节点有效
  └ length double N Y 长度；EA节点必须大于0，INP/CS按对应包装写入
  └ width double N Y 宽度；EA节点必须大于0，INP/CS按对应包装写入
  └ height double N Y 高度；EA节点必须大于0，INP/CS按对应包装写入
  └ volume double N N 体积
  └ weight double N Y 重量；EA节点必须大于0，INP/CS按对应包装写入
  └ netWeight double N N 净重
  └ dimensionUnit string N N 尺寸度量单位；不传默认按照仓库所在国家配置；Inch/inch：英寸，cm/centimeter：厘米
  └ weightUnit string N N 重量单位；不传默认按照仓库所在国家配置；KG：千克，LB：磅
  └ overpackRequired boolean N N 是否需要重新包装；true表示商品发运需要重新装箱，false表示商品发运时可原箱发运；不传默认false
└ barcodeList object Y N 商品条码节点；EA最多取前3个条码，INP/CS各取对应包装条码
  └ unit string N N 包装单位；EA：商品单件包装，CS：商品箱包装，INP：商品内包装
  └ barcode string N N 对应包装的商品条码
└ udf1 string N N 自定义字段1
└ udf2 string N N 自定义字段2
└ udf3 string N N 自定义字段3
└ udf4 string N N 自定义字段4
└ udf5 string N N 自定义字段5
└ udf6 string N N 自定义字段6
└ udf7 string N N 自定义字段7
└ udf8 string N N 自定义字段8
└ udf9 string N N 自定义字段9
└ udf10 string N N 自定义字段10
└ udf11 string N N 自定义字段11
└ udf12 string N N 自定义字段12
└ defaultPrice decimal N N 默认售价
└ imageUrl string N N SKU图片地址，存储图片的路径，直接使用GET请求下载即可
└ distributionAttributes boolean N N 是否分销商品
└ ownerShip string N N 货权为其他分销商时，货权归属商家名称

2.1.3. 请求样例

JSON

{
  "partnerId": "GLINK",
  "itemList": [
    {
      "customerCode": "CUSTOMER001",
      "sku": "SKU001",
      "description": "测试商品",
      "description1": "Test Item",
      "category": "GENERAL",
      "brand": "BEST",
      "countryOfOrigin": "CN",
      "shelfLife": 365,
      "shelfLifeUnit": "DAY",
      "hsCode": "1234567890",
      "batteryFlag": false,
      "hazmatFlag": false,
      "liquidFlag": false,
      "fragileFlag": false,
      "careMfgDate": false,
      "careExpDate": false,
      "careBatch": false,
      "careOriginCountry": false,
      "requireSerialNumber": false,
      "packagingList": [
        {
          "unit": "EA",
          "length": 10.00,
          "width": 8.00,
          "height": 5.00,
          "volume": 400.00,
          "weight": 0.50,
          "netWeight": 0.45,
          "dimensionUnit": "cm",
          "weightUnit": "KG",
          "overpackRequired": false
        },
        {
          "unit": "INP",
          "pcsQty": 10,
          "length": 30.00,
          "width": 20.00,
          "height": 15.00,
          "volume": 9000.00,
          "weight": 5.00,
          "netWeight": 4.50,
          "dimensionUnit": "cm",
          "weightUnit": "KG",
          "overpackRequired": false
        },
        {
          "unit": "CS",
          "pcsQty": 20,
          "length": 50.00,
          "width": 40.00,
          "height": 30.00,
          "volume": 60000.00,
          "weight": 10.00,
          "netWeight": 9.00,
          "dimensionUnit": "cm",
          "weightUnit": "KG",
          "overpackRequired": false
        }
      ],
      "barcodeList": [
        {
          "unit": "EA",
          "barcode": "6900000000011"
        },
        {
          "unit": "INP",
          "barcode": "6900000000028"
        },
        {
          "unit": "CS",
          "barcode": "6900000000035"
        }
      ],
      "udf1": "自定义字段1",
      "udf2": "自定义字段2",
      "udf3": "自定义字段3",
      "udf4": "自定义字段4",
      "udf5": "自定义字段5",
      "defaultPrice": 99.99,
      "imageUrl": "https://example.com/sku001.jpg",
      "distributionAttributes": false,
      "ownerShip": "BEST"
    }
  ]
}

2.1.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 操作的处理结果，true表示处理成功，false表示处理失败
code string N N 操作状态码；SUCCESS：成功，INVALID_SIGNATURE：签名非法，INTERNAL_ERROR：内部错误，INVALID_DATA：数据非法，INVALID_OPERATION：非法操作，PARTIAL_SUCCEED：部分成功
message string N N 提示信息
results object Y Y 批量商品处理结果
└ index int N N 商品在请求列表中的序号，从1开始
└ sku string N N 商品编码；如果参数里没有sku，则该字段值为空
└ success boolean N N 操作的处理结果，true表示处理成功，false表示处理失败
└ operation string N N 实际进行的操作；CREATE：创建，UPDATE：更新，NONE：未执行
└ info string N N 提示信息

2.1.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": "",
  "results": [
    {
      "index": 1,
      "sku": "SKU001",
      "success": true,
      "operation": "CREATE",
      "info": ""
    }
  ]
}

2.2. 查询商品信息接口

2.2.1. SERVICE_TYPE

GLINK_QUERY_ITEM_NOTIFY

2.2.2. 请求参数

查询商品信息请求

参数名 类型 列表 必填 备注
customerCode string N Y 用户编码
skus string Y N 商品编码；按商品编码查询时最多100个；为空时必须填写一组完整的创建时间或更新时间，并且page、pageSize必填
createdTimeFrom string N N 创建时间从，格式yyyy-MM-dd HH:mm:ss；商品编码为空时，创建时间和更新时间至少填写一组
createdTimeTo string N N 创建时间到，格式yyyy-MM-dd HH:mm:ss；商品编码为空时，创建时间和更新时间至少填写一组
updatedTimeFrom string N N 更新时间从，格式yyyy-MM-dd HH:mm:ss；商品编码为空时，创建时间和更新时间至少填写一组
updatedTimeTo string N N 更新时间到，格式yyyy-MM-dd HH:mm:ss；商品编码为空时，创建时间和更新时间至少填写一组
status string N N 商品状态；Active：启用，Inactive：停用
page int N N 当前页码；商品编码为空时必填，必须大于0
pageSize int N N 每页记录数；商品编码为空时必填，必须大于0且小于等于200
partnerId string N N 合作伙伴ID

2.2.3. 请求样例

JSON

{
  "customerCode": "CUSTOMER001",
  "skus": [
    "SKU001",
    "SKU002"
  ],
  "status": "Active",
  "partnerId": "GLINK"
}

2.2.4. 响应参数

参数名 类型 列表 必填 备注
success boolean N Y 操作的处理结果，true表示处理成功，false表示处理失败
code string N N 操作状态码；可能值：SUCCESS、INVALID_SIGNATURE、INTERNAL_ERROR、INVALID_DATA、INVALID_OPERATION、PARTIAL_SUCCEED
message string N N 提示信息
total long N N 记录总数
itemList object Y N 商品信息列表；按商品编码查询且未传分页参数时，未查询到的SKU会返回一条失败结果
└ success boolean N N 单个商品查询结果；成功商品为true，未查询到的SKU为false
└ code string N N 单个商品状态码；成功商品为SUCCESS，未查询到的SKU为FAIL
└ message string N N 单个商品提示信息
└ customerCode string N N 用户编码
└ sku string N N 商品编码
└ description string N N 商品描述
└ category string N N 货物分类
└ brand string N N 货物品牌
└ status string N N 商品状态；Active：启用，Inactive：停用
└ countryOfOrigin string N N 商品原产国，国家二字代码，如US、CN
└ shelfLife int N N 商品保质期
└ shelfLifeUnit string N N 保质期单位；业务约定值 DAY：天，MONTH：月，YEAR：年
└ hsCode string N N 海关编码
└ batteryFlag boolean N N 是否含有电池
└ hazmatFlag boolean N N 是否危险品
└ liquidFlag boolean N N 是否液体
└ fragileFlag boolean N N 是否易碎品
└ careMfgDate boolean N N 是否管理生产日期
└ careExpDate boolean N N 是否管理失效日期
└ careBatch boolean N N 是否管理批次
└ careOriginCountry boolean N N 是否管理原产国
└ requireSerialNumber boolean N N 是否管理序列号
└ packagingList object Y N 包装节点；成功商品固定按EA、INP、CS三个包装节点组装
  └ unit string N N 包装单位；EA：商品单件包装，INP：商品内包装，CS：商品箱包装
  └ pcsQty int N N 包装数量；EA 节点通常为空，INP/CS 节点返回包装数量
  └ length double N N 长度
  └ width double N N 宽度
  └ height double N N 高度
  └ weight double N N 重量
  └ dimensionUnit string N N 尺寸度量单位；Inch/inch：英寸，cm/centimeter：厘米
  └ weightUnit string N N 重量单位；KG：千克，LB：磅
  └ overpackRequired boolean N N 是否需要重新包装；true表示商品发运需要重新装箱，false表示商品发运时可原箱发运
  └ imageUrl string N N 图片链接
  └ recommendPackagingMaterial string N N 推荐包材编码
└ barcodeList object Y N 商品条码节点；仅返回条码不为空的节点
  └ unit string N N 包装单位；EA：商品单件包装，INP：商品内包装，CS：商品箱包装
  └ barcode string N N 商品条码
└ udf1 string N N 自定义字段1
└ udf2 string N N 自定义字段2
└ udf3 string N N 自定义字段3
└ udf4 string N N 自定义字段4

2.2.5. 响应样例

JSON

{
  "success": true,
  "code": "SUCCESS",
  "message": "",
  "total": 2,
  "itemList": [
    {
      "success": true,
      "code": "SUCCESS",
      "message": "",
      "customerCode": "CUSTOMER001",
      "sku": "SKU001",
      "description": "测试商品",
      "category": "GENERAL",
      "brand": "BEST",
      "status": "Active",
      "countryOfOrigin": "CN",
      "shelfLife": 365,
      "shelfLifeUnit": "DAY",
      "hsCode": "1234567890",
      "batteryFlag": false,
      "hazmatFlag": false,
      "liquidFlag": false,
      "fragileFlag": false,
      "careMfgDate": false,
      "careExpDate": false,
      "careBatch": false,
      "careOriginCountry": false,
      "requireSerialNumber": false,
      "packagingList": [
        {
          "unit": "EA",
          "length": 10.0,
          "width": 8.0,
          "height": 5.0,
          "weight": 0.5,
          "dimensionUnit": "cm",
          "weightUnit": "KG",
          "overpackRequired": false,
          "imageUrl": "https://example.com/sku001.jpg",
          "recommendPackagingMaterial": "PKG-EA-001"
        },
        {
          "unit": "INP",
          "pcsQty": 10,
          "length": 30.0,
          "width": 20.0,
          "height": 15.0,
          "weight": 3.0,
          "dimensionUnit": "cm",
          "weightUnit": "KG",
          "overpackRequired": false,
          "imageUrl": "https://example.com/sku001.jpg",
          "recommendPackagingMaterial": "PKG-INP-001"
        },
        {
          "unit": "CS",
          "pcsQty": 20,
          "length": 50.0,
          "width": 40.0,
          "height": 30.0,
          "weight": 10.0,
          "dimensionUnit": "cm",
          "weightUnit": "KG",
          "overpackRequired": false,
          "imageUrl": "https://example.com/sku001.jpg",
          "recommendPackagingMaterial": "PKG-CS-001"
        }
      ],
      "barcodeList": [
        {
          "unit": "EA",
          "barcode": "6900000000011"
        },
        {
          "unit": "INP",
          "barcode": "6900000000028"
        },
        {
          "unit": "CS",
          "barcode": "6900000000035"
        }
      ],
      "udf1": "自定义字段1",
      "udf2": "自定义字段2",
      "udf3": "自定义字段3",
      "udf4": "自定义字段4"
    },
    {
      "success": false,
      "code": "FAIL",
      "message": "not found!",
      "sku": "SKU002"
    }
  ]
}
© Copyright QianYi Team 2025 All Rights Reserved            Updated 2026-06-22 11:07:34

results matching ""

    No results matching ""