添加订单

1. 接口描述

接口名称:

/eventopenapi/gnet/customer/order/add

发送方式:

POST

参数格式:

accept: application/json;content-type: application/json

2. 输入参数

Http Headers

参数 类型 必须 说明
Nonce String 随机数(随机数,最大长度128个字符)
CurTime String 当前UTC时间戳,从1970年1月1日0点0分0秒开始到现在的毫秒数
CheckSum String 服务器认证需要,16进制字符小写SHA1(AppSecret+Nonce+CurTime), AppSecret由全时分配, 如果CheckSum值不一致, 不允许请求接口

Http Body

参数 类型 必须 说明
customerInfo Object 客户基本信息
salesInfo Object 销售品信息
orderId String 第三方订单ID
orderType Int 订单类型 1:新购 2:增购 3延期 4:增购+续期
callbackUrl String 第三方回调地址
meetingCallbackUrl String 会议应用回调地址

customerInfo 参数说明

参数 类型 必须 说明
customerName String 客户名称,customerCode,customerName 二选一,当全时不存在该企业时, 必须提供客户名称
thirdPartnerId Long 第三方客户ID
thirdPartnerEncryptId String 第三方客户ID(加密后)
customerCode String 全时客户ID,如果是全时已存在客户,请通过销售获得全时客户ID

salesInfo 参数说明

参数 类型 必须 说明
prodId Int 全时产品 1:WPS365全时会议版, 不传默认为1
packageType Int 套餐人数规模 1:100人 2:200人 3:300人, 测试时可以为空
isTest Int 1:测试 0:非测试, 默认0
totalCount Int 开通的总数量
telephoneCount Int 电话语音包购买数量,每个语音包1200分钟时长
beginTime 时间戳 订单生效时间,精确到秒
buyYears Int 购买时长, 单位年
paidMoney Double 实收金额
saleName String 销售人员名称
saleId Int 销售人员WPSId

输入示例

{
  "orderId": "10390333",
  "orderType": 2,
  "customerInfo": {
    "customerName": "",
    "customerCode": "01231",
    "thirdPartnerId": 23023,
    "thirdPartnerEncryptId": "23023",
  },
  "salesInfo": {
    "prodId": 1,
    "package": 1,
    "isTest": 0,
    "totalCount": 120,
    "telponeCount":5,
    "mcuCount":3
    "beginTime": 1709789004,
    "buyYears": 1,
    "saleName":"张立",
    "salesId": 109333
  },
  "callbackUrl": "https://wwww.quanshi.com",
  "meetingCallbackUrl": "https://wwww.quanshi.com"
}

3. 输出参数

参数 类型 说明
timeStamp Long 返回时间(时间戳,单位毫秒)
requestId String 请求ID(在接口异常时, 需提供请求ID)
code Int 返回的状态码
msg String 当返回结果的状态码不为200时,包含的错误信息
data Json -

data 参数说明

参数 类型 说明
orderId String 订单ID
orderType String 订单类型
status Int 订单处理结果, 1:订单处理中 2:订单处理成功 3:订单处理失败
  • 接口调用成功,返回状态1
  • 接口调用如果有参数错误,或其他错误, 返回 3
  • 回调中返回2和3两种状态

示例

输出示例

{
  "orderId": "10390333",
  "orderType": 2,
  "status":1  
}

4. 回调

全时执行完业务逻辑后, 通过回调接口, 通知金山结果

参数 类型 说明
orderId String 订单ID
orderStatus boolean 订单处理结果, true:成功, false:失败
appId String 全时开发者秘钥
appSecret String 全时开发者秘钥
customerCode String 全时客户编码
failedReason String 消息
companyId Long 金山客户ID

输出示例

{
  "companyId": 683098735,
  "orderId": "asdasdasdas24234",
  "appId": "b70847a3d2b78ff4b4b7ed1ab487fbfd",
  "orderStatus": true,
  "customerCode": "0012345",
  "appSecret": "69be63149dbf6e98cc933dcd8895f273"
}