蔬东坡开放平台V2版本
  1. 商品
蔬东坡开放平台V2版本
  • 蔬东坡开发平台V2版本文档
    • 什么是蔬东坡开放平台
    • 开发指南
      • 接入说明
      • API调用协议
    • API列表
      • 鉴权
        • 获取access_token
      • 商品
        • 新增分类
          POST
        • 编辑分类
          POST
        • 删除分类
          POST
        • 获取分类
          GET
        • 获取商品单位
          GET
        • 新增商品
          POST
        • 获取商品SPU
          GET
        • 编辑商品
          POST
        • 获取商品客户类型价
          GET
      • 客户
        • 新增客户
        • 获取客户列表
        • 获取客户类型列表
        • 集团列表
      • 采购员
        • 获取采购员
        • 新增采购员
      • 供应商
        • 新增供应商
        • 获取供应商
      • 库房
        • 现有库存查询
        • 入库列表
        • 出库详情
        • 出库列表
        • 入库详情
      • 订单
        • 创建订单
        • 获取订单列表
        • 获取订单详情
        • 获取订单标签
        • 完成订单
        • 关闭订单
        • 实收变更列表
        • 批量创建订单
        • 创建实收变更
        • 实收变更详情
      • 配送
        • 获取区域列表
        • 获取线路列表
        • 获取区域线路关系列表
        • 获取送货时间段
      • 采购
        • 采购列表
      • 系统
      • 基础数据接口
        • 获得全部站点
        • 业务员列表
        • 获取所有仓库
      • 订单-退货单
        • 创建退货单
        • 退货单列表
        • 退货单详情
        • 编辑退货单
      • 财务
        • 客户对账列表
        • 采购对账列表
        • 客户对账详情
        • 采购对账详情
        • 支付列表
        • 客户结算
        • 采购结算
      • 客户商品
        • 获取客户商品价格
      • 采购-退货单
        • 采购退货单列表
      • 协议价
        • 客户协议价
        • 客户协议价详情
        • 采购协议价
        • 采购协议价详情
      • 异步通知
        • 通知参数说明
    • API主要场景
      • 如何创建一个商品
      • 如何创建订单
      • 创建商城订单
    • 常见问题
  • 数据模型
    • 11
  1. 商品

新增商品

POST
/openApiV2/Commodity/add
该接口用于创建商品
接口最大支持qps5
错误码释义
错误码错误内容解决方法
100200业务异常,具体以message内容为准---

请求参数

Header 参数

Body 参数application/json

示例
{
    "name": "小小西瓜",
    "commodity_code": "xxxg0001",
    "category_id1": 1,
    "category_id2": 2,
    "purchase_type": 1,
    "agent_id": 61,
    "is_base_unit_sort": 0,
    "is_batch": 1,
    "shelf_life": 78,
    "unit_list": [
        {
            "unit": "斤",
            "unit_num": 1,
            "summary": "很甜的哦",
            "is_base_unit": 1,
            "order_quantity": 1,
            "price": 9.8,
            "barcode_list": [
                {
                    "barcode": "JH999999",
                    "remark": ""
                },
                {
                    "barcode": "JH0000001",
                    "remark": "2323"
                }
            ]
        }
    ]
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://scm.sdongpo.com/cc_thirdparty/openApiV2/Commodity/add' \
--header 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJpc3MiOiJvcGVuQXBpVjIiLCJpYXQiOjE3NTYwOTIzNjEsImV4cCI6MTc1NjE3ODc2MSwiY2xhaW0iOnsiYXV0aF9hY2NvdW50X2lkIjoiMSIsImNsaWVudF9pZCI6IjNmMTM0MmZlMTUzOWRmYmYiLCJjbGllbnRfdHlwZSI6IjEiLCJhdXRoX3R5cGUiOjAsInNpdGVfaWQiOiI2Iiwic2luZ2xlX2lkIjoiM2YxMzQyZmUxNTM5ZGZiZjYifX0.ITJr90Hh8gGpUxDRfuYBFAf-eKSDeyQ4jJ5xAum5x-YuSLZm-SiGTU9JYFORDupq6BW1p0u88QvFBKlHrFhulmiORhGiPqapjPozRlgz3rDAkjume9y4MgSD8dmPYAzuVX0HgFt-huJYcUBVAfAhQsyclv9gjlQ08W0Rq2hPRu1HyVQU6E03btJBceOnAg60a-xp00hlPPtsKJhubU3HUxCaimSD1wzc3IwJPEBQF2br7NP2rtrWlmQ1vOQnTXnwdy6PRHHyJccbgcDmbP2PPmAJlRIBYILLGD1KdcKC7B1_jADQ5fTybnnDQcgRLKop84ksPNrbyKHVLExGzel9vMBIeibGZgA8yLnaCNgcLAkjt-tUpP8C06Vb8_sgNNA2R6HqYLBICzbxeB-iDnNHcdiE63ERtaC1lkq800w13XKbsFeAojXbczLEPAZ0sD3E-_7dK1rs2uOr5H7g-OuDCD2W5DXOdIQ4vDC5v5A-87VgCxkwaEnt3EGiv8A7Wb4-0eZrDx1h9Z4wH92-BHmFr1aICBXyMYzvaOBTzE6uYHfh8HCfDjKb-HVDNS47QrubhGJAVAm_S9JmFt0sPONQpmaGeGa-1gmsnxlBr6F8ooGbMNbeXbpzLMvyCiUbwdZzhytRxI_UqIehBX0Op0-vbZarUrAwfliLQdUKOvAZtfw' \
--header 'X-Request-Id: 921e69818917335cebcd1da7ecb8d863' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "小小西瓜",
    "commodity_code": "xxxg0001",
    "category_id1": 1,
    "category_id2": 2,
    "purchase_type": 1,
    "agent_id": 61,
    "is_base_unit_sort": 0,
    "is_batch": 1,
    "shelf_life": 78,
    "unit_list": [
        {
            "unit": "斤",
            "unit_num": 1,
            "summary": "很甜的哦",
            "is_base_unit": 1,
            "order_quantity": 1,
            "price": 9.8,
            "barcode_list": [
                {
                    "barcode": "JH999999",
                    "remark": ""
                },
                {
                    "barcode": "JH0000001",
                    "remark": "2323"
                }
            ]
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "status": 1,
    "data": {
        "id": 69336
    },
    "errCode":0,
    "message": null
}
修改于 2025-11-05 09:41:12
上一页
获取商品单位
下一页
获取商品SPU
Built with