1. Products
GWMS Public API
  • 使用Java SDK快速集成
  • auth
    • 获取访问令牌
      POST
  • Warehouses
    • 列出仓库
      GET
  • Product SPUs
    • 列出产品SPU
      GET
    • 创建一个产品SPU
      POST
    • 通过SPU编码获取产品SPU
      GET
    • 通过SPU编码更新产品SPU(完整)
      PUT
    • 通过SPU编码删除产品SPU
      DELETE
  • Products
    • 列出产品
      GET
    • 创建一个产品
      POST
    • 批量创建产品
      POST
    • 通过SKU编码获取产品
      GET
    • 通过SKU编码更新产品(完整)
      PUT
    • 通过SKU编码删除产品
      DELETE
  • Inbound Orders
    • 列出入库单
      GET
    • 通过入库单号获取入库单
      GET
    • 创建入库单
      POST
    • 打印入库箱唛
      POST
    • 通过入库单号更新入库单
      PUT
    • 通过入库单号取消入库单
      DELETE
    • 更新入库单状态
      PATCH
  • OutboundOrder
    • 创建出库单
      POST
    • 取消出库单
      POST
    • 分页查询出库单
      GET
    • 物流费试算 (按sku)
      POST
    • 物流费试算 (按长宽高)
      POST
  • Stock
    • 查询库存明细(支持分页或全量)
    • 库存日志查询
    • 查询产品库存
    • 分页查询产品库存
  • ExpressChannel
    • 获取所有物流渠道
  • Charge
    • 查询计费流水列表
  • Serial Numbers
    • 查看入库单序列号
    • 写入入库单序列号
    • 查询序列号
  1. Products

创建一个产品

POST
/api/v1/products
Products
在主数据中创建一个新产品。此操作是幂等的,支持上游系统推送产品数据。

请求参数

Authorization
JWT Bearer
在 Header 添加参数
Authorization
示例:
Authorization: ********************
or
Header 参数

Body 参数application/json必填

示例
{
    "params": "{custom_field=some_value, another_field={nested=true}}",
    "skuUnit": "PIECE",
    "spuCode": "SPU-001",
    "upc": "123456789012",
    "sku": "WIDGET-001",
    "skuName": "高品质小部件",
    "skuNameEn": "Premium Quality Widget",
    "amazonFnSku": "FN-SKU-001",
    "serialNumber": "SN-001",
    "dimensions": {
        "lengthCm": 20.5,
        "widthCm": 10.5,
        "heightCm": 5.5,
        "lengthInch": 8.07,
        "widthInch": 4.13,
        "heightInch": 2.17,
        "metricVolume": 1127.5,
        "imperialVolume": 68.83
    },
    "weight": {
        "weightKg": 1.25,
        "weightLb": 2.76
    },
    "packaging": {
        "packageLengthCm": 25.5,
        "packageWidthCm": 15.5,
        "packageHeightCm": 10.5,
        "packageLengthInch": 10.04,
        "packageWidthInch": 6.1,
        "packageHeightInch": 4.13,
        "packageWeightKg": 1.5,
        "packageWeightLb": 3.31,
        "packageMetricVolume": 4144.13,
        "packageImperialVolume": 252.93
    },
    "pricing": {
        "value": 99.99,
        "currency": "USD"
    },
    "attributes": {
        "containingElectric": true,
        "batteryType": 6,
        "batteryVoltage": 3.7,
        "batteryCapacityAh": 2.5,
        "batteryEnergyWh": 9.25,
        "batteryMsds": 1,
        "transportationAppraisalReport": 1,
        "batteryDataValidityPeriod": "2027-12-31",
        "batterySupplier": "string",
        "packSupplier": "string",
        "factoryBatteryPackagePercentage": 30,
        "ulCertification": "string",
        "ulIssuingAuthority": "string",
        "ulNumber": "string",
        "dangerousGoods": true,
        "outboundPackaging": 0,
        "multiItemIndependentPackaging": true,
        "packagingMaterial": true,
        "serialNumberManagement": "0"
    },
    "imageUrl": "https://example.com/product-image.jpg"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://gwms.jmalltech.com/api-gateway/api/v1/products' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "params": "{custom_field=some_value, another_field={nested=true}}",
    "skuUnit": "PIECE",
    "spuCode": "SPU-001",
    "upc": "123456789012",
    "sku": "WIDGET-001",
    "skuName": "高品质小部件",
    "skuNameEn": "Premium Quality Widget",
    "amazonFnSku": "FN-SKU-001",
    "serialNumber": "SN-001",
    "dimensions": {
        "lengthCm": 20.5,
        "widthCm": 10.5,
        "heightCm": 5.5,
        "lengthInch": 8.07,
        "widthInch": 4.13,
        "heightInch": 2.17,
        "metricVolume": 1127.5,
        "imperialVolume": 68.83
    },
    "weight": {
        "weightKg": 1.25,
        "weightLb": 2.76
    },
    "packaging": {
        "packageLengthCm": 25.5,
        "packageWidthCm": 15.5,
        "packageHeightCm": 10.5,
        "packageLengthInch": 10.04,
        "packageWidthInch": 6.1,
        "packageHeightInch": 4.13,
        "packageWeightKg": 1.5,
        "packageWeightLb": 3.31,
        "packageMetricVolume": 4144.13,
        "packageImperialVolume": 252.93
    },
    "pricing": {
        "value": 99.99,
        "currency": "USD"
    },
    "attributes": {
        "containingElectric": true,
        "batteryType": 6,
        "batteryVoltage": 3.7,
        "batteryCapacityAh": 2.5,
        "batteryEnergyWh": 9.25,
        "batteryMsds": 1,
        "transportationAppraisalReport": 1,
        "batteryDataValidityPeriod": "2027-12-31",
        "batterySupplier": "string",
        "packSupplier": "string",
        "factoryBatteryPackagePercentage": 30,
        "ulCertification": "string",
        "ulIssuingAuthority": "string",
        "ulNumber": "string",
        "dangerousGoods": true,
        "outboundPackaging": 0,
        "multiItemIndependentPackaging": true,
        "packagingMaterial": true,
        "serialNumberManagement": "0"
    },
    "imageUrl": "https://example.com/product-image.jpg"
}'

返回响应

🟢201已创建
application/json
产品已成功创建。
Bodyapplication/json

示例
{
    "success": true,
    "message": "操作成功",
    "code": "200",
    "timestamp": "2024-01-01T00:00:00Z",
    "data": {
        "createBy": 1,
        "createTime": "2024-01-01T10:00:00Z",
        "updateBy": 1,
        "updateTime": "2024-01-01T10:30:00Z",
        "params": "{key1=value1, key2=value2}",
        "skuUnit": "PIECE",
        "id": 12345,
        "userId": 1001,
        "spuCode": "SPU-001",
        "upc": "123456789012",
        "sku": "WIDGET-001",
        "skuName": "高品质小部件",
        "skuNameEn": "Premium Quality Widget",
        "skuCode": "EXT-WIDGET-001",
        "gsku": "GSKU-001",
        "amazonFnSku": "FN-SKU-001",
        "serialNumber": "SN-001",
        "dimensions": {
            "lengthCm": 20.5,
            "widthCm": 10.5,
            "heightCm": 5.5,
            "lengthInch": 8.07,
            "widthInch": 4.13,
            "heightInch": 2.17,
            "metricVolume": 1127.5,
            "imperialVolume": 68.83
        },
        "weight": {
            "weightKg": 1.25,
            "weightLb": 2.76
        },
        "packaging": {
            "packageLengthCm": 25.5,
            "packageWidthCm": 15.5,
            "packageHeightCm": 10.5,
            "packageLengthInch": 10.04,
            "packageWidthInch": 6.1,
            "packageHeightInch": 4.13,
            "packageWeightKg": 1.5,
            "packageWeightLb": 3.31,
            "packageMetricVolume": 4144.13,
            "packageImperialVolume": 252.93
        },
        "warehousePackaging": {
            "packageLengthCm": 26,
            "packageWidthCm": 16,
            "packageHeightCm": 11,
            "packageWeightKg": 1.62,
            "packageLengthInch": 10.24,
            "packageWidthInch": 6.3,
            "packageHeightInch": 4.33,
            "packageWeightLb": 3.57
        },
        "pricing": {
            "value": 99.99,
            "currency": "USD"
        },
        "attributes": {
            "containingElectric": true,
            "batteryType": 6,
            "batteryVoltage": 3.7,
            "batteryCapacityAh": 2.5,
            "batteryEnergyWh": 9.25,
            "batteryMsds": 1,
            "transportationAppraisalReport": 1,
            "batteryDataValidityPeriod": "2027-12-31",
            "batterySupplier": "string",
            "packSupplier": "string",
            "factoryBatteryPackagePercentage": 30,
            "ulCertification": "string",
            "ulIssuingAuthority": "string",
            "ulNumber": "string",
            "dangerousGoods": true,
            "outboundPackaging": 0,
            "multiItemIndependentPackaging": true,
            "packagingMaterial": true,
            "serialNumberManagement": "0"
        },
        "imageUrl": "https://example.com/product-image.jpg",
        "status": "ACTIVE"
    }
}
🟠400请求有误
🟠401未认证
🟠409冲突
🔴500服务器内部错误
修改于 2026-08-21 08:14:48
上一页
列出产品
下一页
批量创建产品
Built with