蔬东坡开放平台V2版本
API主要场景
复制页面
蔬东坡开放平台V2版本
蔬东坡开发平台V2版本文档
什么是蔬东坡开放平台
开发指南
接入说明
API调用协议
API列表
鉴权
获取access_token
商品
新增分类
编辑分类
删除分类
获取分类
获取商品单位
新增商品
获取商品SPU
编辑商品
获取商品客户类型价
客户
新增客户
获取客户列表
获取客户类型列表
集团列表
采购员
获取采购员
新增采购员
供应商
新增供应商
获取供应商
库房
现有库存查询
入库列表
出库详情
出库列表
入库详情
订单
创建订单
获取订单列表
获取订单详情
获取订单标签
完成订单
关闭订单
实收变更列表
批量创建订单
创建实收变更
实收变更详情
配送
获取区域列表
获取线路列表
获取区域线路关系列表
获取送货时间段
采购
采购列表
系统
基础数据接口
获得全部站点
业务员列表
获取所有仓库
订单-退货单
创建退货单
退货单列表
退货单详情
编辑退货单
财务
客户对账列表
采购对账列表
客户对账详情
采购对账详情
支付列表
客户结算
采购结算
客户商品
获取客户商品价格
采购-退货单
采购退货单列表
协议价
客户协议价
客户协议价详情
采购协议价
采购协议价详情
异步通知
通知参数说明
API主要场景
如何创建一个商品
如何创建订单
创建商城订单
常见问题
数据模型
11
API主要场景
复制页面
如何创建订单
1、使用场景
创建订单接口用于在ERP系统、或其他业务系统中生成新的客户订单
#
2、前置依赖接口
创建订单前需要调用以下接口获取必要信息:
#
2.1 商品基础档案接口(
获取商品
)
用途:获取商品ID、编码、单位、价格、备注状态等基础信息
必填字段:无
调用时机:创建订单前获取下单商品
说明:如果没有商品信息需,先调用接口(
新增商品
)来创建商品。创建商品说明可以参考(
如何创建一个商品
)
2.2 客户档案接口(
获取客户列表
)
用途:获取客户ID、编码、类型等基础信息
必填字段:无
调用时机:创建订单前下单客户
说明:如果没有客户信息,需先调用接口(
新增客户
)创建客户
2.3 送货时间段接口(
获取送货时间段
)
用途:获取订单可配送的时间段
必填字段:无
调用时机:创建订单前送货时间段
2.4 订单标签接口(
获取送货时间段
)
用途:获取订单可选标签
必填字段:无
调用时机:创建订单前下单标签
3、创建订单完整流程
3.1 前置数据准备阶段
调用商品基础档案接口,组装参数commodity_list商品信息
调用客户档案接口,组装参数user_id或user_code用户信息
调用送货时间段接口(可选),组装参数delivery_time_id送货时间段
调用订单标签接口(可选),组装参数tag_ids订单标签
3.2 订单创建阶段(
创建订单
)
前端/客户端收集用户选择的商品、数量、配送时间、订单标签等信息
调用创建订单接口,提交以下核心信息:
客户信息
商品信息
发货时间
4、异常处理流程
5、接口时序图
时序图说明:
所有前置数据获取完成后,才发起最终的订单创建请求
6、最佳实践建议
考虑实现异步创建流程,提高高并发下的系统稳定性
修改于
2025-07-14 09:01:33
上一页
如何创建一个商品
下一页
创建商城订单