小裂变-开放平台
  1. 开放平台:客户信息
小裂变-开放平台
  • 接口注意事项
  • 开放平台:接口调用凭证
    • 获取应用access_token
      POST
  • 开放平台:客户信息
    • 单个unionId，openId转换客户externalUserId
      POST
    • 批量unionId，openId转换客户externalUserId，
      POST
    • 批量externalUserId查询unionId
      POST
    • 查询客户信息
      GET
    • 批量查询客户信息
      POST
    • 手机号查询客户信息
      GET
    • 新增客户订单
      POST
    • 新增客户动态
      POST
  • 开放平台:企业会员
    • 新增会员信息
      POST
  • 开放平台:商品
    • 商品列表
      POST
    • 商品详情
      GET
    • 新增商品
      POST
    • 编辑商品
      POST
    • 删除商品
      POST
    • 删除商品与分组的绑定
      POST
    • 编辑商品上下架状态
      POST
  • 开放平台:商品分组
    • 分组列表
      POST
    • 分组详情
      GET
    • 新增分组
      POST
    • 编辑分组
      POST
    • 删除分组
      POST
  • 开放平台:管理企业标签
    • 获取企业标签
      GET
    • 添加企业标签
      POST
    • 编辑企业标签
      POST
    • 删除企业标签
      POST
    • 删除企业标签分组
      POST
  • 开放平台:编辑客户企业标签
    • 编辑客户企业标签
  • 开放平台:事件通知
    • 客户画像变更事件通知
    • 客户关系变更事件通知
    • 客户标签变更事件通知
  • 开放平台:获客活动
    • 查询单个用户活动完成记录
    • 查询活动奖品信息
  • 开放平台:成员信息
    • 成员明文id转换密文id
  • 开放平台:推客
    • 推客信息
      • 获取推客信息
      • 获取推客注册参数
    • 短视频信息
      • 获取短视频分页
      • 获取短视频推广信息
    • 直播信息
      • 获取直播列表
      • 获取直播推广二维码
      • 获取预约直播列表
      • 获取预约直播推广二维码
    • 佣金单信息
      • 获取佣金单详情
    • 商品信息
      • 获取商品分页
      • 获取商品推广二维码
  1. 开放平台:客户信息

新增客户订单

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
示例值:
1
finalePrice
integer 
必需
最终成交金额（分）+ 运费，必填
staffId
string 
必需
成员id，，长度64以内，非必填
Validate[max: 64; ]
originalPrice
integer 
必需
商品总原价(分)，必填
orderItemList
array [object {14}] 
必需
子订单，必填一个，必填
orderId
string <string>
必需
主订单编号，长度128以内
Validate[max: 128; ]
id
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>
购买数量
必需
示例值:
0
originalUnitPrice
integer <int32>
必需
购买时的原单价，单位/分
示例值:
0
freight
integer <int32>
必需
总运费，没有可传0，单位/分
示例值:
0
discountPrice
integer <int32>
必需
总优惠金额，没有可传0，单位/分
示例值:
0
finalePrice
integer <int32>
必需
最终成交价（包含运费），单位/分
示例值:
0
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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>
错误编码
可选
示例值:
0
msg
string <string>
错误信息
可选
示例值:
value
null 
必需
返回对象(object)
traceId
string <string>
链路ID
可选
示例值:
示例
{
  "success": true,
  "code": 0,
  "msg": "",
  "value": "",
  "traceId": ""
}
修改于 2024-09-11 08:46:51
上一页
手机号查询客户信息
下一页
新增客户动态
Built with