新建订单 - 蔬东坡开放平台API

请求参数

Body 参数multipart/form-data

appid

string

可选

由服务端分配唯一标示appid

timestamp

integer

当前时间戳

可选

示例值:

sign

string

签名参数(32位)

可选

示例值:

notice

string

可选

site_id

string

站点

可选

user_id

integer

用户ID

必需

delivery_date

string

必需

发货日期，如:"2019-05-01"

delivery_time

integer

发货时间段ID

可选

pay_way

integer

必需

目前只支持0货到付款

tag_ids

string

可选

订单标签id,多个以逗号分隔

remark

string

备注

可选

notify_url

string

可选

异步通知地址,如:https://api.xx.com/receive_notify.htm

commodity_list

string

必需

订单商品列表， JSON字符串，如：[{"commodity_id":10117,"num":1,"price":1,"remark":"","order_commodity_tag":"1"}] commodity_id 商品ID，num 下单数量，price 商品单价，remark 备注，order_commodity_tag 订单商品标签ID（12.8.1 及以上版本支持）

idempotent_key

string

可选

系统版本>=15.7.0支持，传随机数，用于做幂等校验。如果不传此字段或为空则不校验

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://scm.sdongpo.com/cc_thirdparty/openApi/order/create' \
--form 'appid=""' \
--form 'timestamp=""' \
--form 'sign=""' \
--form 'notice=""' \
--form 'site_id=""' \
--form 'user_id=""' \
--form 'delivery_date=""' \
--form 'delivery_time=""' \
--form 'pay_way=""' \
--form 'tag_ids=""' \
--form 'remark=""' \
--form 'notify_url=""' \
--form 'commodity_list=""' \
--form 'idempotent_key=""'

返回响应

🟢200成功

application/json

Body

status

integer

必需

data

object

必需

order_no

string

订单编号

必需

order_id

string

订单ID

必需

total

integer

订单小计

必需

message

string | null

必需

示例

{
  "status": 1,
  "data": {
    "order_no": "DD19030500001",
    "order_id": "23123",
    "total": 1
  },
  "message": ""
}