蔬东坡开放平台V2版本
  1. API主要场景
蔬东坡开放平台V2版本
  • 蔬东坡开发平台V2版本文档
    • 什么是蔬东坡开放平台
    • 开发指南
      • 接入说明
      • API调用协议
    • API列表
      • 鉴权
        • 获取access_token
      • 商品
        • 新增分类
        • 编辑分类
        • 删除分类
        • 获取分类
        • 获取商品单位
        • 新增商品
        • 获取商品SPU
        • 编辑商品
        • 获取商品客户类型价
      • 客户
        • 新增客户
        • 获取客户列表
        • 获取客户类型列表
        • 集团列表
      • 采购员
        • 获取采购员
        • 新增采购员
      • 供应商
        • 新增供应商
        • 获取供应商
      • 库房
        • 现有库存查询
        • 入库列表
        • 出库详情
        • 出库列表
        • 入库详情
      • 订单
        • 创建订单
        • 获取订单列表
        • 获取订单详情
        • 获取订单标签
        • 完成订单
        • 关闭订单
        • 实收变更列表
        • 批量创建订单
        • 创建实收变更
        • 实收变更详情
      • 配送
        • 获取区域列表
        • 获取线路列表
        • 获取区域线路关系列表
        • 获取送货时间段
      • 采购
        • 采购列表
      • 系统
      • 基础数据接口
        • 获得全部站点
        • 业务员列表
        • 获取所有仓库
      • 订单-退货单
        • 创建退货单
        • 退货单列表
        • 退货单详情
        • 编辑退货单
      • 财务
        • 客户对账列表
        • 采购对账列表
        • 客户对账详情
        • 采购对账详情
        • 支付列表
        • 客户结算
        • 采购结算
      • 客户商品
        • 获取客户商品价格
      • 采购-退货单
        • 采购退货单列表
      • 协议价
        • 客户协议价
        • 客户协议价详情
        • 采购协议价
        • 采购协议价详情
      • 异步通知
        • 通知参数说明
    • API主要场景
      • 如何创建一个商品
      • 如何创建订单
      • 创建商城订单
    • 常见问题
  • 数据模型
    • 11
  1. 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、接口时序图
deepseek_mermaid_20250711_4d47f3 (1).png
时序图说明:
所有前置数据获取完成后,才发起最终的订单创建请求
6、最佳实践建议
考虑实现异步创建流程,提高高并发下的系统稳定性
修改于 2025-07-14 09:01:33
上一页
如何创建一个商品
下一页
创建商城订单
Built with