采购单创建

开发中

POST

https://open.yibaitao.cn/api/order/create

order/create

请求参数

Query 参数

access_token

string

授权token

可选

默认值:

Header 参数

version

string

版本号

可选

默认值:

Body 参数application/json

trace_no

string

交易流水号

必需

35位不定长(需要保证唯一)

>= 1 字符<= 35 字符

address

object

收货信息

必需

name

string

收货人姓名

必需

>= 1 字符<= 30 字符

phone

string

收货人手机

必需

>= 1 字符<= 18 字符

province

string

省份

必需

>= 1 字符<= 50 字符

city

string

城市

必需

>= 1 字符<= 50 字符

area

string

地区

必需

>= 1 字符<= 50 字符

address

string

街道地址

必需

>= 1 字符<= 200 字符

cargo

array [object {2}]

商品信息

必需

unique

string

商品sku唯一值

必需

number

integer

采购数量

必需

>= 1<= 1000

mark

string

买家留言

可选

<= 500 字符

示例

{
  "address": {
    "name": "袁刚",
    "phone": "18177285814",
    "province": "浙江省",
    "city": "上海市",
    "area": "钢城区",
    "address": "网商路699号"
  },
  "cargo": [
    {
      "unique": "1234324",
      "number": 1
    },
    {
      "unique": "123dsad24",
      "number": 2
    }
  ],
  "mark": "aliquip esse magna",
  "trace_no": "1234"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location -g --request POST 'https://open.yibaitao.cn/api/order/create?access_token={{token}}' \
--header 'version: v1' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address": {
        "name": "袁刚",
        "phone": "18177285814",
        "province": "浙江省",
        "city": "上海市",
        "area": "钢城区",
        "address": "网商路699号"
    },
    "cargo": [
        {
            "unique": "1234324",
            "number": 1
        },
         {
            "unique": "123dsad24",
            "number": 2
        }
    ],
    "mark": "aliquip esse magna",
    "trace_no": "1234"
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

info

string

说明

必需

data

object

必需

order_sn

string

订单编号

必需

total_num

integer

合计数量

必需

total_price

number

合计金额

必需

示例

{
  "code": 200,
  "info": "成功",
  "data": {
    "order_sn": "Y172897350531514497",
    "total_num": 1,
    "total_price": 17.22
  }
}

修改于 2024-10-17 10:02:43

交易相关

采购单详情