1. API升级公告
蔬东坡开放平台V2版本
  • 蔬东坡开发平台V2版本文档
    • 什么是蔬东坡开放平台
    • 开发指南
      • 接入说明
      • API调用协议
    • API列表
      • 鉴权
        • 获取access_token
      • 商品
        • 新增分类
        • 编辑分类
        • 删除分类
        • 获取分类
        • 获取商品单位
        • 新增商品
        • 获取商品SPU
        • 编辑商品
        • 获取商品客户类型价
        • 获取商品SKU
      • 客户
        • 新增客户
        • 获取客户列表
        • 获取客户类型列表
        • 集团列表
      • 采购员
        • 获取采购员
        • 新增采购员
      • 供应商
        • 新增供应商
        • 获取供应商
      • 库房
        • 现有库存查询
        • 入库列表
        • 出库详情
        • 出库列表
        • 入库详情
      • 订单
        • 创建订单
        • 获取订单列表
        • 获取订单详情
        • 获取订单标签
        • 完成订单
        • 关闭订单
        • 实收变更列表
        • 批量创建订单
        • 创建实收变更
        • 实收变更详情
        • 获取配送信息
        • 编辑订单(不支持重复商品)
        • 第三方单号查询
        • 创建实收变更(不支持重复商品)
      • 配送
        • 获取区域列表
        • 获取线路列表
        • 获取区域线路关系列表
        • 获取送货时间段
      • 采购
        • 采购列表
        • 采购单详情
        • 采购单创建
        • 采购收货保存
        • 采购单确认收货
      • 系统
      • 基础数据接口
        • 获得全部站点
        • 业务员列表
        • 获取所有仓库
      • 订单-退货单
        • 创建退货单
        • 退货单列表
        • 退货单详情
        • 编辑退货单
      • 财务
        • 客户对账列表
        • 采购对账列表
        • 客户对账详情
        • 采购对账详情
        • 支付列表
        • 客户结算
        • 采购结算
      • 客户商品
        • 获取客户商品价格
      • 采购-退货单
        • 采购退货单列表
      • 协议价
        • 客户协议价
        • 客户协议价详情
        • 采购协议价
        • 采购协议价详情
      • 异步通知
        • 通知参数说明
      • 溯源
        • 获取溯源信息
    • API主要场景
      • 如何创建一个商品
      • 如何创建订单
      • 创建商城订单
    • 常见问题
      • 蔬东坡开放平台 V2 常见问题知识库
    • API升级公告
      • 16.8.0版本更新
      • 16.9.0版本更新
      • 17.0.0版本更新
      • 17.1.0版本更新
      • 17.2.0版本更新
      • 17.3.0版本更新
  • 数据模型
    • PurchaseReceiptRequest
    • PurchaseReceiptCommodity
    • PurchaseReceiptCost
    • PurchaseReceiptSuccessResponse
    • ErrorResponse
  1. API升级公告

17.3.0版本更新

蔬东坡开放平台 V2 版本更新通知#

版本信息#

版本号:17.3.0
整理时间:2026-07-23
整理来源:https://openapi.sdongpo.com
整理口径:仅整理在线文档中明确标注了版本支持范围的入参或返回字段

本版本变更概览#

17.3.0 版本主要新增了商品排序接口,并为商品、客户、采购员、供应商、区域线路、协议价、入库、出库、订单改价、退货单等多个列表查询接口补充了创建时间、更新时间或时间格式增强能力,便于团餐和开放平台对接方做增量同步与精细筛选。

接口变更明细#

1. POST /openApiV2/commodity/sort#

接口名称:商品排序
变更类型:新增接口
新增入参:
commodity_list
说明:商品排序列表,最大支持 100 条
版本说明:17.3.0 新增
commodity_list[].sup_id
说明:SPU 商品 ID;与 commodity_code 不能同时为空
版本说明:与 commodity_list 同版本说明
commodity_list[].commodity_code
说明:SPU 商品编码;与 sup_id 不能同时为空
版本说明:与 commodity_list 同版本说明
commodity_list[].sequence
说明:SPU 排序值,必须为大于等于 0 的数值
版本说明:与 commodity_list 同版本说明
commodity_list[].sku_list[].sku_id
说明:SKU 商品 ID;与 commodity_code + unit 组合不能同时为空
版本说明:与 commodity_list 同版本说明
commodity_list[].sku_list[].commodity_code
说明:SKU 商品编码
版本说明:与 commodity_list 同版本说明
commodity_list[].sku_list[].unit
说明:SKU 单位;使用 commodity_code 定位 SKU 时必传
版本说明:与 commodity_list 同版本说明
commodity_list[].sku_list[].sequence
说明:SKU 排序值,必须为大于等于 0 的数值
版本说明:与 commodity_list 同版本说明

2. GET /openApiV2/common/getUserWarehouse#

接口名称:获取所有仓库
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明

3. GET /openApiV2/in/list#

接口名称:入库列表
变更类型:查询能力增强
新增入参:
start_date
说明:开始时间支持 Y-m-d 和 Y-m-d H:i:s 两种格式
版本说明:17.3.0 起增强时间精度
end_date
说明:结束时间支持 Y-m-d 和 Y-m-d H:i:s 两种格式
版本说明:与 start_date 同版本说明

4. GET /openApiV2/PurchaseBill/pageList#

接口名称:采购对账列表
变更类型:查询能力增强
新增入参:
start_date
说明:当按创建日期查询时,开始时间支持 Y-m-d 和 Y-m-d H:i:s 两种格式
版本说明:17.3.0 起增强时间精度
end_date
说明:当按创建日期查询时,结束时间支持 Y-m-d 和 Y-m-d H:i:s 两种格式
版本说明:与 start_date 同版本说明

5. GET /openApiV2/Commodity/pageSkuList#

接口名称:获取商品 SKU
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

6. GET /openApiV2/Commodity/categoryList#

接口名称:获取商品分类列表
变更类型:新增入参
新增入参:
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_update_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

7. GET /openApiV2/User/pageList#

接口名称:获取客户列表
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

8. GET /openApiV2/User/groupList#

接口名称:获取集团列表
变更类型:查询能力增强
新增入参:
search_value
说明:集团搜索关键字
版本说明:17.3.0 起支持通过开放平台请求对象透传
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:与 search_value 同版本说明
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 search_value 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 search_value 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 search_value 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

9. GET /openApiV2/common/saleList#

接口名称:业务员列表
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

10. GET /openApiV2/provider/pageList#

接口名称:获取供应商列表
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

11. GET /openApiV2/agent/pageList#

接口名称:获取采购员列表
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

12. GET /openApiV2/distribution/lineList#

接口名称:线路列表
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

13. GET /openApiV2/distribution/areaList#

接口名称:区域列表
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

14. GET /openApiV2/PurchaseAgreementPrice/pageList#

接口名称:采购协议价列表
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

15. GET /openApiV2/UserProtocolPrice/pageList#

接口名称:客户协议价列表
变更类型:新增入参
新增入参:
start_create_time
说明:创建时间开始,格式 Y-m-d H:i:s
版本说明:17.3.0 新增
end_create_time
说明:创建时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
start_update_time
说明:更新时间开始,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
end_update_time
说明:更新时间结束,格式 Y-m-d H:i:s
版本说明:与 start_create_time 同版本说明
返回字段检查结果:当前在线文档中未发现 17.3.0 专属的返回字段版本说明

对接方建议#

1.
如需通过开放平台做主数据增量同步,建议优先接入本次新增的创建时间、更新时间筛选参数,并按接口各自的最大查询时间范围控制拉取窗口。
2.
如需从开放平台维护商品排序,可直接接入 POST /openApiV2/commodity/sort,并按文档要求传入 SPU、SKU 排序数据。
3.
对仅使用旧查询条件的调用方,本次大部分变更为兼容性增强,原有参数和返回字段解析逻辑通常可以保持不变。
4.
涉及时间筛选的接口对时间格式和时间跨度有校验限制,上线前建议按接口规则补充联调用例,避免因时间格式不符被接口拒绝。

来源页面#

商品排序(17.3.0 版本更新)
获取所有仓库
入库列表
采购对账列表
获取商品 SKU
获取商品分类列表
获取客户列表
获取集团列表
业务员列表
获取供应商列表
获取采购员列表
线路列表
区域列表
采购协议价列表
客户协议价列表
修改于 2026-07-23 09:44:55
上一页
17.2.0版本更新
下一页
PurchaseReceiptRequest
Built with