新增客户订单

POST

https://w.xiaoliebian.com/api/demo-wechat-work/open/api/customer/order/add

开放平台:客户信息

相同店铺id与orderId不会执行两次新增操作，后续新增相同的店铺id，orderId，会执行修改操作

请求参数

Header 参数

Authorization

string <string>

认证令牌

必需

示例值:

Bearer 64FMJbvkyQC2EHY8G9

Body 参数application/json

shopId

string

必需

店铺ID，长度128以内，必填
Validate[max: 128; ]

orderId

string

必需

主订单编号，长度128以内，必填
Validate[max: 128; ]

transactionId

string

可选

微信支付ID，长度128以内，非必填
Validate[max: 128; ]

state

enum<integer>

必需

订单状态，必填
(See: 订单状态)

枚举值:

12345

示例值:

finalePrice

integer

必需

最终成交金额（分）+ 运费，必填

staffId

string

必需

成员id，，长度64以内，非必填
Validate[max: 64; ]

originalPrice

integer

必需

商品总原价(分)，必填

orderItemList

array [object {14}]

必需

子订单，必填一个，必填

orderId

string <string>

必需

主订单编号，长度128以内
Validate[max: 128; ]

string <string>

必需

子订单id，长度128以内
Validate[max: 128; ]

productId

string <string>

必需

商品id，长度128以内
Validate[max: 128; ]

skuId

string <string>

必需

skuId
Validate[max: 128; ]

banner

string <string>

必需

banner，需能在浏览器中能访问

name

string <string>

必需

商品标题
Validate[max: 128; ]

num

integer <int32>

购买数量

必需

示例值:

originalUnitPrice

integer <int32>

必需

购买时的原单价，单位/分

示例值:

freight

integer <int32>

必需

总运费，没有可传0，单位/分

示例值:

discountPrice

integer <int32>

必需

总优惠金额，没有可传0，单位/分

示例值:

finalePrice

integer <int32>

必需

最终成交价（包含运费），单位/分

示例值:

value

array[string]

规格值，非必填

可选

示例值:

state

enum<integer>

必需

子订单状态，必填
(See: 订单状态)

枚举值:

12345

xlbAfterSaleStatus

integer

可选

售后状态：1.售后处理中 2.售后成功 3.售后关闭，非必填

externalUserId

string

必需

企微用户id，长度64以内，必填
Validate[max: 64; ]

createTime

string

必需

下单时间，必填
示例：2023-12-01 12:12:12

shipReceiver

string

可选

收件人姓名，长度64以内，非必填

shipPhone

string

可选

收件人电话，长度64以内，非必填

shipAddress

string

可选

收件人地址，长度128以内，非必填

示例

{
    "shopId": "58",
    "orderId": "94",
    "transactionId": "47",
    "state": 1,
    "finalePrice": 24,
    "staffId": "9",
    "originalPrice": 98,
    "orderItemList": [
        {
            "orderId": "4",
            "id": "47",
            "productId": "53",
            "skuId": "2",
            "banner": "ipsum commodo amet ut velit",
            "name": "只各备对",
            "num": 0,
            "originalUnitPrice": 0,
            "freight": 0,
            "discountPrice": 0,
            "finalePrice": 0,
            "value": ",",
            "state": 1,
            "xlbAfterSaleStatus": 1
        }
    ],
    "externalUserId": "84",
    "createTime": "2004-04-09 04:30:03",
    "shipReceiver": "",
    "shipPhone": "",
    "shipAddress": ""
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://w.xiaoliebian.com/api/demo-wechat-work/open/api/customer/order/add' \
--header 'Authorization: Bearer 64FMJbvkyQC2EHY8G9' \
--header 'Content-Type: application/json' \
--data-raw '{
    "shopId": "58",
    "orderId": "94",
    "transactionId": "47",
    "state": 1,
    "finalePrice": 24,
    "staffId": "9",
    "originalPrice": 98,
    "orderItemList": [
        {
            "orderId": "4",
            "id": "47",
            "productId": "53",
            "skuId": "2",
            "banner": "ipsum commodo amet ut velit",
            "name": "只各备对",
            "num": 0,
            "originalUnitPrice": 0,
            "freight": 0,
            "discountPrice": 0,
            "finalePrice": 0,
            "value": ",",
            "state": 1,
            "xlbAfterSaleStatus": 1
        }
    ],
    "externalUserId": "84",
    "createTime": "2004-04-09 04:30:03",
    "shipReceiver": "",
    "shipPhone": "",
    "shipAddress": ""
}'

返回响应

🟢200OK

application/json

Body

success

boolean

成功标识

可选

示例值:

true

code

integer <int32>

错误编码

可选

示例值:

msg

string <string>

错误信息

可选

示例值:

value

null

必需

返回对象(object)

traceId

string <string>

链路ID

可选

示例值:

示例

{
  "success": true,
  "code": 0,
  "msg": "",
  "value": "",
  "traceId": ""
}

修改于 2024-09-11 08:46:51

手机号查询客户信息

新增客户动态