茂阳
  1. 商品
茂阳
  • 蔬东坡开放平台API文档
    • 什么是蔬东坡开放平台
    • 开发入门
      • API调用协议
      • 签名生成规则
    • 基础数据接口
      • 获得全部站点
      • 发货时间段列表
      • 用户类型列表
      • 商品分类列表
      • 获得全部仓库
      • 业务员新增
      • 获取采购员、供应商数据
      • 区域列表
      • 供应商新增
      • 商品单位列表
      • 业务员列表
    • 库房
      • 订单发货出库
      • 批次库存列表
    • 商品
      • 商品标签
        GET
      • 编辑商品分类
        POST
      • 新增商品分类
        POST
      • 删除商品分类
        POST
      • 新建商品
        POST
      • 搜索商品
        GET
      • 更新商品
        POST
    • 订单
      • 新增实收变更
      • 订单标签
      • 查询实收变更详情
      • 订单商品标签查询
      • 搜索订单
      • 批量创建订单
      • 新建订单
      • 完成订单
      • 订单关闭
      • 获取配送信息
    • 采购单
      • 新增采购单
      • 采购单收货
      • 采购单查询
      • 编辑采购单
    • 客户协议价
      • 客户类型列表
      • 协议价详情
      • 客户协议价列表
    • 客户
      • 获取下单商品信息
      • 获取线路列表
      • 新增客户
      • 获取集团列表
      • 搜索客户
    • 异步通知
      • 通知参数说明
    • 订单-退货单
      • 退货单列表
      • 退货单详情
      • 创建退货单
      • 审核拒绝退货单
    • 商品-溯源
      • 查询商品溯源
    • 出、入库单查询
      • 入库单查询
      • 出库单查询
    • 客户类型
      • 获得可下单商品列表
    • 现有库存查询
      • 现有库存查询
    • 库房-分拣
      • 分拣条形码获取订单明细
    • 采购-退货单
      • 搜索采购退货单
      • 保存采购退货单
    • 财务
      • 采购结算单列表
      • 客户结算单列表
  1. 商品

搜索商品

GET
/openApi/commodity/query

请求参数

Query 参数
appid
string 
必需
由服务端分配唯一标示appid
示例值:
0bdb1d24951f3f13
timestamp
integer 
当前时间戳
必需
示例值:
{{timestamp}}
sign
string 
签名参数(32位)
必需
示例值:
{{sign}}
notice
string 
可选
site_id
string 
站点
可选
category_id1
integer 
一级分类ID
可选
category_id2
integer 
二级分类ID
可选
page
integer 
页码
必需
page_size
integer 
每页大小
必需
示例值:
10
commodity_ids
string 
可选
商品id,多个以逗号分隔,最多50个
category1_name
string 
一级分类名称
可选
category2_name
string 
二级分类名称
可选
create_start_time
string 
创建开始时间
可选
create_end_time
string 
创建结束时间
可选
is_online
string 
是否上架, Y/N
可选
purchase_type
integer 
可选
采购方式,1:采购员采购,2:供应商采购
provider_id
integer 
可选
供应商id,供应商采购时必填
agent_id
integer 
可选
采购员id,采购员采购时必填
exclude_commodity_ids
string 
可选
排除的商品ids 用逗号分隔
is_process
integer 
可选
0=>非加工商品 1=>加工商品
is_sell
integer 
可选
是否可售卖 1是 0否
search_value
string 
可选
商品编码、名称、别名模糊搜索
status
string 
可选
商品状态,Y:正常,N:删除,D:彻底删除
start_update_time
string 
更新时间-开始
可选
end_update_time
string 
更新时间-结束
可选
user_style
string 
可选
tag
string 
可选
商品标签名称, 多个标签半角逗号分隔

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://basesfpstest.sdongpo.com/openApi/commodity/query?appid=0bdb1d24951f3f13&timestamp={{timestamp}}&sign={{sign}}&notice&site_id&category_id1&category_id2&page&page_size=10&commodity_ids&category1_name&category2_name&create_start_time&create_end_time&is_online&purchase_type&provider_id&agent_id&exclude_commodity_ids&is_process&is_sell&search_value&status&start_update_time&end_update_time&user_style&tag'

返回响应

🟢200成功
application/json
Body
status
integer 
必需
data
object 
必需
list
array [object {41}] 
必需
pageParams
object 
必需
message
string  | null 
必需
示例
{
    "status": 1,
    "data": {
        "list": [
            {
                "id": "2",
                "name": "零/云南直发一级生菜(大利)。9",
                "alias": "拆零生菜/",
                "pinyin": "LINGYUNNANZHIFAYIJISHENGCAIDALI,LYNZFYJSCDL",
                "logo": "http://base-image.sdongpo.com/sdpcloud/upload_pic/com_thumb_2018061216191887528dbd5b1f820664fb8.jpg",
                "create_time": "2024-09-01 17:19:55",
                "update_time": "2024-10-09 08:54:16",
                "notice": "外包装:塑料薄膜\n商品规格:长度12-25cm,重量:150-300g\n定量允许误差:±0.2斤\n储存条件:冷藏\n产地:云南\n品级:一级",
                "category_id1": "1",
                "category_id2": "129",
                "commodity_code": "YNZFYJSCGJDL1612",
                "unit_convert": "N",
                "durability_period": "",
                "brand": "",
                "product_place": "云南",
                "loss_rate": "0.00",
                "purchase_type": "2",
                "provider_id": "1",
                "provider_code": "2X001",
                "agent_id": "0",
                "agent_code": "",
                "provider_supervisor": "0",
                "provider_supervisor_code": "",
                "provider_supervisor_name": "",
                "is_active": "N",
                "is_online": "Y",
                "is_rough": "N",
                "is_process": "N",
                "allow_change_channel": "Y",
                "is_time_price": "N",
                "unit_list": [
                    {
                        "id": "2",
                        "unit": "斤",
                        "unit_id": "2",
                        "price": "2.00",
                        "in_price": "5.00",
                        "summary": "拆零商品 16:00后不可下单",
                        "is_sell": "Y",
                        "is_sell_stock": "N",
                        "sell_stock": "0.00",
                        "status": "Y",
                        "unit_num": "1.00",
                        "receivable_style_list": [
                            {
                                "receivable_style": "0",
                                "name": "默认客户类型*(市场价)",
                                "price": "2.00",
                                "sequence": "0"
                            },
                            {
                                "receivable_style": "4",
                                "name": "自提一批客户",
                                "price": "3.08",
                                "sequence": "4"
                            },
                            {
                                "receivable_style": "5",
                                "name": "自提二批客户",
                                "price": "3.15",
                                "sequence": "5"
                            },
                            {
                                "receivable_style": "6",
                                "name": "自提零售a客户",
                                "price": "3.21",
                                "sequence": "6"
                            },
                            {
                                "receivable_style": "7",
                                "name": "自提零售b客户",
                                "price": "3.28",
                                "sequence": "7"
                            },
                            {
                                "receivable_style": "8",
                                "name": "100km一批客户",
                                "price": "3.17",
                                "sequence": "8"
                            },
                            {
                                "receivable_style": "9",
                                "name": "100km二批客户",
                                "price": "3.24",
                                "sequence": "9"
                            },
                            {
                                "receivable_style": "10",
                                "name": "100km零售a客户",
                                "price": "3.30",
                                "sequence": "10"
                            },
                            {
                                "receivable_style": "11",
                                "name": "100km零售b客户",
                                "price": "3.37",
                                "sequence": "11"
                            },
                            {
                                "receivable_style": "12",
                                "name": "200km一批客户",
                                "price": "3.20",
                                "sequence": "12"
                            },
                            {
                                "receivable_style": "13",
                                "name": "200km二批客户",
                                "price": "3.26",
                                "sequence": "13"
                            },
                            {
             
上一页
新建商品
下一页
更新商品
Built with