open-api
首页
首页
  1. 产品
  • 快速开始
  • 授权登录
    • 授权登录流程
    • 鉴权接口
      POST
    • 刷新令牌接口
      POST
  • 客户
    • 客户
    • 跟进动态查询接口
      GET
    • 提交跟进动态
      POST
    • 客户分组新增/编辑
      POST
    • 删除客户分组
      POST
    • 客户阶段新增/编辑
      POST
    • 删除客户阶段
      POST
    • 客户标签新增/编辑
      POST
    • 删除客户标签
      POST
    • 客户枚举:客户类型,客户标签,时区,规模,星级,采购意向,采购额度,职级
      GET
    • 移入公海
      POST
    • 客户数据字典
      GET
    • 客户(含联系人)新增/编辑
      POST
    • 删除客户(仅支持公海客户)
      POST
    • 客户详情
      GET
    • 查询客户的阶段、分组、状态、地区、主营产品、来源
      GET
  • 销售订单
    • 销售订单
    • 销售订单枚举:货币,付款方式,国家/地区,订单类型,订单状态,订单创建方式
    • 销售订单字段
    • 销售订单删除
    • 销售订单新建/编辑
    • 销售订单列表
    • 销售订单详情
  • 采购订单
    • 采购订单
    • 采购订单列表
    • 采购订单字段
    • 采购订单状态
    • 采购订单新增/编辑
    • 采购订单详情
  • 产品
    • 产品
    • 产品枚举:产品类型,离岸价设置类型,创建方式,产品计量单位
      GET
    • 产品分组删除
      POST
    • 查询产品库列表
      GET
    • 产品新建/编辑
      POST
    • 产品库的数据字典
      GET
    • 产品详情
      GET
    • 产品分组新增/编辑
      POST
    • 删除产品规格
      POST
    • 查询产品分组
      GET
    • 新增/编辑规格
      POST
    • 查询产品规格列表
      GET
    • 增量更新产品规格值
      POST
  • 回款登记
    • 回款登记
    • 回款登记详情
    • 回款登记字段
    • 回款登记新建/编辑
    • 回款登记列表
    • 回款登记核销
  • 回款单
    • 回款单
    • 回款方式枚举
    • 回款单列表
    • 回款单字段
    • 回款单新建/编辑
    • 回款单详情
  • 付款单
    • 付款单
    • 付款单详情
    • 付款单字段
    • 付款单列表
  • 费用单
    • 费用单
    • 费用单-详情
    • 费用单字段
    • 费用项目列表
    • 费用单列表
  • 报价单
    • 报价单
    • 报价单列表
    • 报价单状态、币种查询
    • 报价单删除
    • 报价单数据字典
    • 报价单新建/编辑
    • 查询报价单详情
  • 供应商
    • 供应商
    • 供应商列表
    • 供应商字段
    • 供应商删除
    • 供应商详情
    • 供应商新增/编辑
  • 商机
    • 商机
    • 查询商机的销售流程 商机阶段 输单原因
    • 商机删除接口
    • 商机列表
    • 商机数据查询
    • 商机数据字典
    • 商机新建/编辑接口
  • 用户
    • 用户
    • 用户部门列表
    • 用户部门详情
    • 用户列表
    • 用户详情
  • 销售出库单
    • 销售出库单
    • 销售出库单列表
    • 销售出库单详情
    • 销售出库单字段
    • 销售出库单删除
    • 新增/编辑销售出库单
  • 库存
    • 库存
    • 库存写入
    • 仓库查询
  • 线索
    • 线索
    • 线索|联系人的数据字典
    • 线索列表
    • 线索数据查询
    • 线索(含联系人)创建/编辑接口
  • 资金
    • 资金
    • 资金账户列表
  • 采购入库单
    • 采购入库单
    • 采购入库单-列表
    • 采购入库单-详情
    • 采购入库单字段
    • 采购入库单-删除
    • 采购入库单-新建/编辑
  • 采购退货单
    • 采购退货单
    • 采购退货单-列表
    • 采购退货单-详情
    • 采购退货单字段
    • 采购退货单-新建/编辑
    • 采购退货单-删除
  • 统计分析
    • 统计报告-统计详细
  • 示例接口(勿用)
    • 示例说明
    • 例子列表
    • 例子枚举值查询
  • devops相关
    • 钉钉回调
    • tapd回调接口
    • 获取智齿token
    • 智齿刷新接口
    • app版本发布
    • 钉钉管理-删除账号
  • 动态
  • 阿里账号信息
    GET
  • 阿里资金账户信息
    GET
  • ACP网关接口
    POST
  1. 产品

产品新建/编辑

POST
/v1/product/push
如何创建一个无规格产品
新建无规格产品
{
  "images": [],
  "name": "testname",
  "product_no": "testno",
  "product_type": 1,
  "package_remark": "remark"
  }
参数列表中有罗列可传入参数以及数据类型
如何编辑一个无规格产品
编辑无规格产品
{
  "product_id":xxxxxx,
  "images": [],
  "name": "testname",
  "product_no": "test",
  "product_type": 1,
  "package_remark": "remark"
  }
编辑无规格产品,需要获取info接口中的product_id传入,参数列表中有罗列可传入参数以及数据类型。
===========================================================================================
如何创建一个多规格产品
新建多规格产品
{
	"images": [],
	"name": "测试23",
	"product_no": "编号12",
	"product_type": 2,
	"sku_items": [{
		"sku_code": "测试11",
		"attributes": [{
			"item_id": 2056386462650, --规格类型id
			"value": {
				"item_id": 2268631617468  --规格值id
			}
		}],
		"fob_price": 123,
		"disable_flag": 0
	}, {
		"sku_code": "测试21",
		"attributes": [{
			"item_id": 2056386462650, --规格类型id
			"value": {
				"item_id": 2268631617469 --规格值id
			}
		}],
		"fob_price": 123,
		"disable_flag": 0
	}],
	"package_remark": "备注",
	"sku_attributes": [{
    --需要包含sku_items使用的规格值与类型,如item_id规格类型 2056386462650有使用规格值2268631617469/2268631617468,则都需要填写进来
		"item_id": 2056386462650,
		"value": [{
			"item_id": 2268631617469
		}, {
			"item_id": 2268631617468
		}]
	}]
}
    
创建多规格需要通过https://api-sandbox.xiaoman.cn/v1/product/push-sku-attribute ,创建规格后,item_id是由https://api-sandbox.xiaoman.cn/v1/product/sku-attribute-list 获得,用于创建多规格产品。多规格sku_attributes与sku_items必填,
参数列表中有罗列可传入参数以及数据类型。
如何编辑一个多规格产品
编辑多规格产品
    {
  "images": [],
  "name": "测试2",
  "product_no": "编号1",
  "product_type": 2,
    "product_id":xxxxxx,
  "sku_items": [
    {
      "sku_id":xxxxxx,
      "sku_code": "测试1",
      "attributes": [
        {
          "item_id": 2056386462650, --规格类型id
          "value": {
            "item_id": 2268631617468 --规格值id
          }
        }
      ],
      "fob_price": 123,
      "disable_flag": 0
    }
  ],
  "package_remark": "备注",
  "sku_attributes": [
    {
      "item_id": 2056386462650,   --规格类型id
      "value": [
        {
          "item_id": 2268631617468 --规格值id
        }
      ]
    }
  ]
}
    
编辑多规格产品,需要获取info接口中的product_id与sku_id传入,参数列表中有罗列可传入参数以及数据类型。

请求参数

Header 参数

Body 参数application/json

示例
{
  "product_id": 0,
  "product_no": "string",
  "name": "string",
  "cn_name": "string",
  "create_user": 0,
  "product_type": 1,
  "model": "string",
  "description": "string",
  "intro": "string",
  "product_remark": "string",
  "images": "string",
  "from_url": "string",
  "hs_code": "string",
  "place": "string",
  "info_json": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "quantity": "string",
  "quantity_unit": "string",
  "price_currency": "string",
  "price_min": 0,
  "price_max": 0,
  "price_unit": "string",
  "package_gross_weight": "string",
  "package_unit": "string",
  "package_size_length": 0,
  "package_size_weight": 0,
  "package_size_height": 0,
  "package_volume": 0,
  "product_size_length": 0,
  "product_size_weight": 0,
  "product_size_height": 0,
  "product_volume": 0,
  "product_net_weight": 0,
  "customs_name": 0,
  "customs_cn_name": 0,
  "package_remark": "string",
  "count_per_package": "string",
  "cost_currency": "string",
  "cost": 0,
  "cost_unit": "string",
  "unit": "string",
  "group_id": 0,
  "disable_flag": 0,
  "fob_type": 1,
  "gradient_price": [
    {
      "quantity": 0,
      "price": 0
    }
  ],
  "category_ids": null,
  "sku_attributes": [
    {
      "item_id": 0,
      "value": [
        {
          "item_id": 0
        }
      ]
    }
  ],
  "sku_items": [
    {
      "sku_id": 0,
      "sku_code": "string",
      "sku_image_url": "string",
      "fob_price": 0,
      "disable_flag": 0,
      "attributes": [
        {
          "item_id": 0,
          "value": {
            "item_id": 0
          }
        }
      ]
    }
  ],
  "sub_product_sku_items": [
    {
      "sub_sku_id": 0,
      "sub_product_id": 0,
      "count": 0
    }
  ],
  "images_base64": [
    {
      "file_name": "string",
      "data": "string"
    }
  ]
}

示例代码

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://api-sandbox.xiaoman.cn/v1/product/push' \
--header 'Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiI2MzlhYTA1MmZlMGNkMzJhYmQyMWJlNWZjOGU2NWQ2ZDg5OGRhMmQxN2MwODI1NTgwZjA4M2M5MGU4MGU0MTZmZjI2YTQyNmYwYjVjOWQ1YSIsImp0aSI6IjI2ODMyNThlMDMyOTNjZDQ1ZWZiZGVkODQyZThjM2E0YmY1NDYyYTJjZDQ4NWEzMzlmN2ExMjE2YjQ3ZGZjMTZhMGUzMzdlMWU0NjA4YWNlIiwiaWF0IjoxNzQ3NjQ2NzIyLjgxMjg3OCwibmJmIjoxNzQ3NjQ2NzIyLjgxMjg4MSwiZXhwIjoxNzQ3Njc1NTIyLjgwMjc1NSwic3ViIjoiIiwic2NvcGVzIjpbXX0.VoNtwQCrv8w1DoittcOEfXCbV0kMpmizJQn9YLB934KRslg0SSX4ws8HA0kJir9PPzLVQirSaiGzJCUfN8KSh6w3fctZJ1Kwe7HZlVgZ13FqFWYX6RQ7FKNjT4-mimoAkXeyDcpZxxnIBJcURqeftcF0gfp_eWFr9Qm3Fj1k0ZSZKqpWuw45R-S9H8tZUHk0ArZz7uROhkJdu_ghTAmAENdpl_ndhihX_L2jDkLaFiPcviRAw6ouBevct7Cex_e1mLRJqQiFakgrHdyDOdT78X8HjBIKRWjTZLIQeh3GJnUxHZ3uxPNKmgV5gCBUJ-IK4457PkhFTABOv1LbHHif0w' \
--header 'Content-Type: application/json' \
--data-raw '{
  "product_id": 0,
  "product_no": "string",
  "name": "string",
  "cn_name": "string",
  "create_user": 0,
  "product_type": 1,
  "model": "string",
  "description": "string",
  "intro": "string",
  "product_remark": "string",
  "images": "string",
  "from_url": "string",
  "hs_code": "string",
  "place": "string",
  "info_json": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "quantity": "string",
  "quantity_unit": "string",
  "price_currency": "string",
  "price_min": 0,
  "price_max": 0,
  "price_unit": "string",
  "package_gross_weight": "string",
  "package_unit": "string",
  "package_size_length": 0,
  "package_size_weight": 0,
  "package_size_height": 0,
  "package_volume": 0,
  "product_size_length": 0,
  "product_size_weight": 0,
  "product_size_height": 0,
  "product_volume": 0,
  "product_net_weight": 0,
  "customs_name": 0,
  "customs_cn_name": 0,
  "package_remark": "string",
  "count_per_package": "string",
  "cost_currency": "string",
  "cost": 0,
  "cost_unit": "string",
  "unit": "string",
  "group_id": 0,
  "disable_flag": 0,
  "fob_type": 1,
  "gradient_price": [
    {
      "quantity": 0,
      "price": 0
    }
  ],
  "category_ids": null,
  "sku_attributes": [
    {
      "item_id": 0,
      "value": [
        {
          "item_id": 0
        }
      ]
    }
  ],
  "sku_items": [
    {
      "sku_id": 0,
      "sku_code": "string",
      "sku_image_url": "string",
      "fob_price": 0,
      "disable_flag": 0,
      "attributes": [
        {
          "item_id": 0,
          "value": {
            "item_id": 0
          }
        }
      ]
    }
  ],
  "sub_product_sku_items": [
    {
      "sub_sku_id": 0,
      "sub_product_id": 0,
      "count": 0
    }
  ],
  "images_base64": [
    {
      "file_name": "string",
      "data": "string"
    }
  ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 200,
    "message": "success",
    "now": "2025-03-05 20:01:36",
    "data": {
        "product_id": 5203231500,
        "product_no": "2",
        "sku_items": [
            {
                "sku_id": 5203231501,
                "sku_code": "2"
            }
        ]
    }
}
修改于 2025-07-04 07:38:32
上一页
查询产品库列表
下一页
产品库的数据字典