# 后付费接口v1-曹
**Repository Path**: vs_aliTalk/post_pay_interface_v1_cao
## Basic Information
- **Project Name**: 后付费接口v1-曹
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-11-02
- **Last Updated**: 2020-12-19
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# 后付费接口v1-曹
[toc]
# 1 购卡查询
## 1.1 购卡查询
---
请求地址：/iot_service/purchase/queryOrderList.do
请求方式：
---
请求参数
------
参数|备注|类型|是否必填|示例
--|--|--|--|--|--
orderNo|订单编号| String| 否|temp|
createTimeStart|下单时间开始|String|否|temp|
createTimeEnd|下单时间结束|String|否|temp|
currentPage|当前页码|int|是|1|
pageSize|单页条数|int|是|10|
status|购卡状态|int|否|0|
返回结果说明
------
参数|说明|类型|示例
--|--|--|--
errno| 返回码|int|0=成功,其他值表示失败
info|说明|String|成功
data|返回结果|Json| 示例
返回示例：
{
"data": {
"totalFees": 204,
"totalPage": 108,
"pageSize": 10,
"currentPage": 1,
"list": [
{
"assignFlag": "",
"cardCount": 1,
"cardType": "",
"createId": 0,
"createTimeStr": "2018-03-30 14:18:27",
"dataPlanId": 0,
"dataPlanName": "",
"deliveryTime": null,
"expressCompany": "",
"expressFee": 0,
"expressNo": "",
"id": 161,
"isValid": 0,
"modifiedId": 0,
"modifiedTime": null,
"operator": "中国联通",
"orderNo": "1522390707637",
"payTime": null,
"receiverAddress": "",
"receiverId": 0,
"receiverName": "",
"receiverPhone": "",
"status": "2",
"statusName": "已付款",
"totalFee": 0,
"userId": 0
}
]
"totalCount": 4
},
"errno": 0,
"info": "成功"
}
data说明：
参数 | 说明
---|---
payTime | 付款时间
orderNo | 订单编号
cardType |卡片类型
operator |运营商
dataPlanName|套餐名称
cardCount|卡片数量
totalFee |总金额
statusName|状态
totalCount|总订单数
totalCountFees|总金额
status|状态1，未付款；2，已付款；3，已分配
## 1.2 订购卡查询详细
---
请求地址：/iot_service/purchase/orderDetail.do
---
请求参数：
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
orderId|订单id| int| 否|temp
返回结果
---
参数|说明|类型|示例
--|--|--|--
errno|返回码|int|0=成功,其他值表示失败
info|说明|String|成功
data|返回结果|Json| 示例
返回示例
{
"data": {
"order":{
"orderNo": "1514425069115",
"expressNo": "123",
"payTime": "Thu Dec 28 18:44:02 CST 2017",
"cardCount": "2",
"isValid": "1",
"userId": "7",
"receiverAddress": "上海市普陀区",
"receiverId": null,
"receiverPhone": "13122222222",
"createTime": "Wed Dec 28 13:22:20 CST 2016",
"totalFee": "0.0",
"createId": "7",
"expressCompany": null,
"statusName": null,
"id": "4",
"modifiedId": "7",
"status": "3"
},
"flowList":[
{
"dataPlanName":"套餐名称",
"dataPlanFlow":"套餐流量",
"id":"套餐id",
"orderNo":"订单明细编号"
}
]
},
"errno": 0,
"info": "成功"
}
data说明：
------
参数 | 说明
---|---
iccid|
statusName| 状态
totalFee| 金额
dataPlanName| 套餐名称
operator|运营商
expressNo|快递单号
cardCount|订购卡数
statusName|支付状态
flowList|订单购买套餐流量
## 1.3 订单套餐卡明细接口
---
请求地址：/iot_service/purchase/orderDataPlanCard.do
---
请求参数：
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
orderId|订单明id| String| 否|123
dataPlanId|套餐id| int|否|1
currentPage|当前页码|int|是|1
pageSize|单页条数|int|是|10
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例
{
"data": {
"totalPage": 108,
"pageSize": 10,
"currentPage": 1,
"list": [
{"iccid":"iccid",
"cardType":"卡片类型",
"dataPlanName":"套餐名称",
"dataPlanFlow":"套餐流量",
"mnoAccountId":"账号名称"
}
]
},
"errno": 0,
"info": "成功"
}
# 2 卡库
## 2.1 卡片列表
---
请求地址：/iot_service/sell/card/queryCardList.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
currentPage|页码| int| 是|1
pageSize|每页条数| int| 是|10
iccidStart|开始iccid| String| 否|
iccidEnd|结束iccid| String| 否|
simStatus|卡状态| String| 否|1
dataPlanName|套餐名称| String| 否|联通3g
dataPlanExpire|套餐期限| String| 否|360
dataPlanType|套餐类型|String|是|1
hasDataPlanId|含有或购买套餐|int|否|1=查看赠或购买套餐
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
{
"data": {
"totalPage": 5,
"pageSize": 1,
"currentPage": 1,
"list": [
{
"allotName": "",
"cardBean": {
"bCompanyName": "cao",
"bDataPlanName": "",
"bExceedDataPlanFlow": "",
"bRemainDataPlanFlow": "",
"bTotalDataPlanFlow": "",
"bUsedDataPlanFlow": "",
"cId": 122092,
"comment": "AGK TEST：Lau（vv)",
"createId": 0,
"createTime": null,
"dataPlanId": "",
"iccid": "8986061501000343577",
"id": 0,
"isValid": 0,
"modifiedId": 0,
"modifiedTime": null,
"msisdn": "861064612047577",
"operatorTypeName": "",
"platformFlagName": "",
"poolDataPlanFlow": "",
"poolDataPlanId": 0,
"poolDataPlanName": "",
"poolDataPlanExpire":"",
"renewNum": "0",
"status": "3",
"statusName": "未使用",
"userType": "",
"userTypeName": ""
},
"createId": 0,
"createTime": null,
"dataPlanExpire": "",
"dataPlanFlow": 0,
"dealerFlag": 1,
"iccid": "8986061501000343577",
"id": 0,
"initId": 0,
"isAllot": "",
"isValid": 0,
"modifiedId": 0,
"modifiedTime": null,
"nextCompany": "cao",
"nextUserId": 25,
"orderNo": "",
"realAuthBean": null,
"setUserLevel": 1,
"simStatus": "1",
"simStatusName": "",
"tOrderId": "",
"userId": 25
}
]
},
"errno": 0,
"info": "成功"
}
data说明：
参数 | 说明
---|---
iccid | 卡片iccid
msisdn | 卡片msisdn号
bDataPlanName | 套餐名称
cardBean.userTypeName | 账户类别
cardBean.bCompanyName | 账户名称
cardBean.bTotalDataPlanFlow | 总流量
cardBean.bUsedDataPlanFlow|使用流量
cardBean.bExceedDataPlanFlow|超出流量
cardBean.poolDataPlanFlow |流量池流量
cardBean.poolDataPlanName |流量池名称
cardBean.poolDataPlanExpire|流量池期限
simStatus | 卡状态
simStatusName | 卡状态名称(1未使用 2已使用 3使用完)
dealerFlag | 客户分配标记 1=可以分配，0=不可分配
----
逻辑说明：
dealerFlag 是计算出来的，根据卡状态、与userId计算出来的结果，dealerFlag，取值说明：
1、当卡状态是未使用，所有者是自己，可以分配
2、当卡状态是未使用，所有者是直接客户，可以重新分配
3、其他情况，都不能分配
## 2.2 开通卡片
---
请求地址：/iot_service/sell/card/openCard.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
iccids|iccid,多个以","分割| String| 是|"123,456"
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"result": "ok"
}
}
----
逻辑说明：
1、只有未使用的卡，才能开通
2、向 t_order_flex [流量池订单表],新增一条订单记录
3、调用jasper，开通卡片接口
4、批量开通的时候，只有所有选中的卡是未使用的，才允许批量开通。
## 2.3 停卡
---
请求地址：/iot_service/sell/card/stopCard.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
iccids|iccid,多个以","分割| String| 是|"123,456"
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"result": "ok"
}
}
----
停卡逻辑说明：
1、只有已经使用的，才允许停卡
2、调用jasper,停卡
3、批量停卡时，所选的状态都应该是已使用,才允许停卡
## 2.4 分配
---
请求地址：/iot_service/sell/card/updateCardUserIdStr.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
iccidStr|iccid,多个以","分割| String| 是|"123,456"
cardUserId|被分配用户Id|Int|是|11
dataPlanId|自定义套餐Id|Int|是|11
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
-----
逻辑说明：
1、能不能分配，是根据dealerFlag决定的
2、修改b_sim_lib中,user_id
3、修改 t_card_storage,将dataPlanId应用到b_user_data_plan_id中
4、如果是将分配出去的卡回收，那么应该将t_card_storage.b_user_data_plan_id 修改为该卡对应agk的流量池来源id
## 2.5 用户套餐级联
---
请求地址：/iot_service/sell/card/userDataPlan.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
userId|用户id| int| 是|12
dataPlanType|套餐类型|int|否|1
dataPlanType说明：2=流量池,32=自定义流量池,默认值为32,
1=固定不共享,31=自定义固定不共享
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"list":[
"id"："套餐id",
"dataPlanName":"套餐名称",
"dataPlanFlow":"套餐流量"
]
}
}
## 2.6 卡片明细
---
请求地址：/iot_service/sell/card/queryCardDetails.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
iccid|iccid| String| 是|"8986061501000190802"
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"simLibBean": {
"iccid": "8986061501000343577",
"userId": 25,
"orderNo": "1234567890",
"setUserLevel": 1,
"simStatus": "1",
"simStatusName": "未使用",
"cardBean": null,
"isAllot": null,
"allotName": null,
"tOrderId": null,
"dataPlanFlow": null,
"realAuthBean": null,
"dataPlanExpire": null,
"dealerFlag": null,
"initId": null,
"nextUserId": 25,
"nextCompany": "cao",
"id": null,
"isValid": null,
"createTime": null,
"createId": null,
"modifiedTime": null,
"modifiedId": null
},
"dataPlanBean": [{
"id": 84,
"dataPlanFlow": 100,
"dataPlanName": "100M",
"dataPlanExpire": "360",
"rebate": null,
"dataPlanPrice": "15",
"dataPlanRemark": null,
"dataPlanEnable": "1",
"isValid": 1,
"createTime": "2018-08-16 02:04:09",
"createId": null,
"modifiedTime": null,
"modifiedId": null,
"createTimeStr": null,
"dataPlanFlowFmt": null,
"userId": 25,
"flowType": null,
"planAppends": null,
"unicomDataplanName": null,
"thirdPartyFees": "0",
"operatorType": null,
"dataPlanTypeName": null,
"dataPlanFlowStr": null,
"dataPlanType": 32,
"flowDataPlanId": null,
"deposit": 1,
"minCount": 1,
"minExpire": 1,
"planExpireType": "t",
"dataPlanCost": "10",
"dataPlanExpireName": null,
"iccid": null,
"uId": null
}],
"mapFlowInfo": {
"totalFlow": "100",
"remainFlow": "100",
"usedFlow": "0",
"exceedDataPlanFlow": "0"
}
}
}
data说明
参数|说明
--- |---
mapFlowInfo|流量使用信息
mapFlowInfo.totalFlow|总流量
mapFlowInfo.remainFlow|剩余流量
mapFlowInfo.usedFlow|使用流量
mapFlowInfo.exceedDataPlanFlow|超出流量
dataPlanBean|套餐基本信息
simLibBean|卡片信息
simLibBean.nextCompany|客户名称
## 2.7 agk流量池套餐查询
---
请求地址：/iot_service/sell/card/getFlowPoolDataPlan
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"list":[
"id"："套餐id",
"dataPlanName":"套餐名称",
"dataPlanFlow":"套餐流量"
]
}
}
逻辑说明：
1、查询b_data_plan，userId=0,data_plan_type=2 的套餐信息
## 2.8 账户类别，经销商用户列表
---
请求地址：/iot_service/sell/card/queryDealerUserList.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
businessType|业务类型|int|是|1
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
"data":[{"text":"59595959","id":38,"nodes":
[{"text":"380","id":40},{"text":"大股东身份的","id":101}]}
]
## 2.9 卡片数量统计
---
请求地址：/iot_service/sell/card/queryCardDataPlanCount.do
请求方式：post
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"shareCard": 0,
"cardCount": 0,
"initCard": 1
}
}
data说明
参数|说明
--- |---
initCard|初始卡库数
shareCard|共享卡数
cardCount|卡片总数
## 2.10 查找直属客户
---
请求地址：/iot_service/sell/card/queryDirectlyUser.do
请求方式：post
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
businessType|业务类型|String|否|
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": [
{
"id": 25,
"accountId": "18512105675",
"password": null,
"level": null,
"company": "cao1",
"contacts": null,
"mobile": null,
"email": null,
"facePicture": null,
"address": null,
"lastLoginTime": null,
"loginCnt": null,
"accountEnable": null,
"parentId": null,
"isValid": null,
"createTime": null,
"createId": null,
"modifiedTime": null,
"modifiedId": null,
"roleId": null,
"userType": null,
"remark": null,
"realAuthStatus": null,
"realAuthStatusName": null,
"userTypeName": null,
"businessType": 0,
"accountType": 0
},
{
"id": 35,
"accountId": "1212",
"password": null,
"level": null,
"company": "a流量池代理商",
"contacts": null,
"mobile": null,
"email": null,
"facePicture": null,
"address": null,
"lastLoginTime": null,
"loginCnt": null,
"accountEnable": null,
"parentId": null,
"isValid": null,
"createTime": null,
"createId": null,
"modifiedTime": null,
"modifiedId": null,
"roleId": null,
"userType": null,
"remark": null,
"realAuthStatus": null,
"realAuthStatusName": null,
"userTypeName": null,
"businessType": 0,
"accountType": 0
},
{
"id": 36,
"accountId": "b11",
"password": null,
"level": null,
"company": "b流量池cc",
"contacts": null,
"mobile": null,
"email": null,
"facePicture": null,
"address": null,
"lastLoginTime": null,
"loginCnt": null,
"accountEnable": null,
"parentId": null,
"isValid": null,
"createTime": null,
"createId": null,
"modifiedTime": null,
"modifiedId": null,
"roleId": null,
"userType": null,
"remark": null,
"realAuthStatus": null,
"realAuthStatusName": null,
"userTypeName": null,
"businessType": 0,
"accountType": 0
}
]
}
## 2.11 出库
---
请求地址：/iot_service/sell/card/cardCheckOut.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
iccids|iccid,多个以","分割| String| 是|"123,456"
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"result": "ok"
}
}
# 3、客户管理
## 3.1 客户账户列表 条件搜索
---
请求地址：/iot_service/group/getGroupList.do
请求方式：
---
请求参数
参数 | 说明 | 类型 |必填|实例
---|---|--|--|--
groupName|账户名称|String|否|temp1
pageSize|分页大小|int|必填|10
currentPage|当前页|int|必填|1
userType|业务类型|int|否|1
realAuthStatus|实名认证|String|0
createTimeStart|开始创建时间|String|
createTimeEnd|结束创建时间|String|
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回数据|json|
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"totalPage": 14,
"pageSize": 1,
"currentPage": 1,
"list": [
{
"id": 36,
"accountId": "b11",
"level": null,
"company": "b流量池代理商",
"contacts": null,
"mobile": "13122699567",
"email": null,
"facePicture": null,
"userType": 2,
"realAuthStatus": null,
"realAuthStatusName": "未验证",
"userTypeName": null,
"cardCount": 0,
"billAmount": null,
"createTime": "2018-08-16 11:03:02",
"remark": null,
"businessType": "1",
"businessTypeName": "预付费",
"accountType": "1",
"accountTypeName": "自用"
}
]
}
}
data说明
参数|说明
--- |---
company|公司名称
cardCount|卡片数量
billAmount|账单金额
realAuthStatus|实名认证
realAuthStatusName|实名认证名称
userTypeName|用户类别
accountId|账号
mobile|手机号
createTime|创建时间
remark|备注
businessType|业务类型
accountType|账户类型
## 3.3 新建账户提交
---
请求地址：/iot_service/group/createNewGroup.do
请求方式：
---
请求参数
参数 | 说明 | 类型 |必填|实例
---|---|--|--|--
accountId|用户名|String|必填|temp
company|企业名称|String|是|temp1
password|密码|String|必填|temp
mobile|手机|String|必填|temp
dataPlanInfo|套餐数组|Array|必填|
businessType|业务类型|int|必填|
accountType|账户类型|int|必填|
remark|备注|String|否|
请求参数示例
{
"company":"测试",
"accountId":"1212",
"password":"123123",
"mobile":"13122699556",
"businessType":1,
"accountType":1,
"dataPlanInfo":
[
{"id":1,"planPrice":"20"},
{"id":1,"planPrice":"30"}
]
}
请求参数说明
参数|说明
--|--
id|套餐id
dataPlanInfo|套餐数组
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
## 3.4 修改子账户预载入
---
请求地址：/iot_service/group/getGroup.do
请求方式：
---
请求参数
参数 | 说明 | 类型 |必填|实例
---|---|--|--|--
id|子账户id|int|必填|2
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回数据|json|
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"dataPlanInfo": [
{
"id": 1,
"dataPlanFlow": 1000,
"dataPlanName": "全国流量1000MB360天（MIFI测试）",
"dataPlanExpire": "360",
"rebate": null,
"dataPlanPrice": "20",
"dataPlanRemark": null,
"dataPlanEnable": null,
"isValid": null,
"createTime": null,
"createId": null,
"modifiedTime": null,
"modifiedId": null,
"createTimeStr": null,
"dataPlanFlowFmt": null,
"userId": null,
"flowType": null,
"planAppends": null,
"unicomDataplanName": null,
"thirdPartyFees": null,
"operatorType": null,
"dataPlanTypeName": null,
"dataPlanFlowStr": null,
"dataPlanType": null,
"flowDataPlanId": null,
"deposit": null,
"minCount": null,
"minExpire": null,
"planExpireType": null,
"dataPlanCost": "1",
"iccid": null,
"uId": null
}
],
"group": {
"id": 35,
"accountId": "1212",
"password": "",
"level": 2,
"company": "a流量池代理商",
"contacts": null,
"mobile": "13122699556",
"email": null,
"facePicture": null,
"address": null,
"lastLoginTime": null,
"loginCnt": null,
"accountEnable": "1",
"parentId": 25,
"isValid": 1,
"createTime": "2018-08-15 02:28:34",
"createId": 25,
"modifiedTime": null,
"modifiedId": null,
"roleId": null,
"userType": 11,
"remark": null,
"realAuthStatus": "0",
"realAuthStatusName": "未认证",
"userTypeName": null
}
}
}
data说明
参数|说明
--- |---
bDataPlanBeans|套餐列表（回显套餐信息）
dataPlanName|套餐名称
dataPlanFlow|流量
dataPlanExpire|服务期
dataPlanPrice|套餐价格
id|套餐id
group|子账户信息
accountId|用户名
company|企业名称
password|密码
mobile|手机号
## 3.5 修改账户提交
---
请求地址：/iot_service/group/editGroupSubmit.do
请求方式：
---
请求参数
参数 | 说明 | 类型 |必填|实例
---|---|--|--|--
id|账户id|int|必填|1
accountId|用户名|String|必填|temp
company|企业名称|String|是|temp1
password|密码|String|必填|temp
mobile|手机|String|必填|temp
dataPlanInfo|套餐数组|必填|
请求参数示例
{
"id":1,
"company":"测试",
"accountId":"1212",
"password":"123123",
"mobile":"13122699556"
"dataPlanInfo":
[
{"id":1,"planPrice":"20"},
{"id":1,"planPrice":"30"}
]
}
请求参数说明
参数|说明
--|--
id|套餐id
dataPlanInfo|套餐数组
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
## 3.6 删除账户
---
请求地址：/iot_service/group/deleteChildUser.do
请求方式：
---
请求参数
参数 | 说明 | 类型 |必填|实例
---|---|--|--|--
id|账户id|int|必填|temp
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
## 3.7 查看
---
请求地址：/iot_service/group/loginGroup.do
请求方式：
---
请求参数
参数 | 说明 | 类型 |必填|实例
---|---|--|--|--
id|账户id|int|是|1
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回数据|json|
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"regist": "a97da629b098b75c294dffdc3e463904"
}
}
data说明
参数|说明
--- |---
regist|客户登录标记
# 4 发票管理
## 4.1、发票列表，条件搜索
---
请求地址：/iot_service/accountInquiry/getInvoiceList.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
invoiceType|类型| String| 是|普通发票
status|状态| String| 是|审核通过
startTime|开始时间| datetime| 否|2018-04-21
endTime|结束时间| datetime| 否|2018-04-26
currentPage|当前页| int| 是|1
pageSize|每页行数| int| 是否|10
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
"data": {
"list": [
{
"id": 1,
"createTime": "2018-04-25 15:30:23",
"invoiceTypeName": "普通发票",
"invoiceAmount": "金额",
"statusName": "审核通过",
"expressNo": "x123"
}
]}
data说明：
参数 | 说明
---|---
createTime | 申请时间
invoiceTypeName | 发票类型
invoiceAmount|金额
statusName|状态
expressNo|快递单号
## 4.2、提交发票申请
---
请求地址：/iot_service/invoicev1/addInvoice.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
idstr|充值的id字符串|Sting | 是 | 1a,2a,1b
invoiceType|发票类型| String| 是|1：普通发票；2：增值税发票
invoiceTitle|公司名称 |String|是|
taxNumber|纳税人识别号 |String|是|
comment|发票内容 |String|是|
invoiceAmount|开票金额 |float|是|1000.50
receiverAddress|寄送地址 |String|是|
bankAccount|开户银行 |String|否|
publicAccount|对公账号 |String|否|
businessLicensePic|营业执照图片 |String|否|
accountProofPic|开户证明图片 |String|否|
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
## 4.3、选择开票金额列表，条件搜索
---
请求地址：/iot_service/invoicev1/getRechargeList.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
startTime|开始时间| datetime| 否|2018-04-21
endTime|结束时间| datetime| 否|2018-04-26
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
"data": {
"list": [
{
"createTime": "2018-04-25 15:30:23",
"orderNo": "2017122821001004800261681796",
"type": "充值",
"account": "2000",
"idAccount":"6b-300.00"
}
]}
data说明：
参数 | 说明
---|---
createTime | 付款时间
orderNo | 订单编号
type|类型
account|金额
idAccount | id+标识+金额
前台逻辑：
将idAccount作为checkbox的value值，当勾选后，
1）从idAccount中截取-后面的金额，多个的相加，返回开票金额到发票申请页面
2）从idAccount中截取-前面的id+标识，多个的拼接，返回idstr字符串到发票申请页面
# 5 常量查询
## 5.1 常量表查询接口
---
请求地址：/iot_service/constant/bCodeSelect.do
请求方式：post
---
请求参数
参数 | 说明 | 类型 |实例
---|---|--|--
typeId|类型|String|"1"
typeId 说明：
typeId| 说明
---|---
COMPANY_CERTIFY_AUTH_STATUS |实名制审批
USER_TYPE|用户类型
BUY_CARD_STATUS|购卡状态
BUSINESS_TYPE|业务类型
SUB_DATA_PLAN_TYPE|套餐细分类型
DATA_PLAN_EXPIRE_FIXED|月固定
DATA_PLAN_EXPIRE_SUBSCRIBER|单个订户
DATA_PLAN_EXPIRE|灵活共享套餐期限
ACCOUNT_TYPE_2|灵活共享账户类别
ACCOUNT_TYPE_3|单个链接、代理-代收专用
ADMIN_TYPE|管理员属性
---
返回结果：
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"list": [{
"id": 51,
"typeId": "TALK_USER_STATUS",
"typeName": "对讲卡片状态",
"itemValue": "0",
"itemName": "未使用",
"orderValue": 1,
"isValid": 1,
"createTime": "2018-03-20 10:51:09",
"createId": 0,
"remark": "10"
}, {
"id": 52,
"typeId": "TALK_USER_STATUS",
"typeName": "对讲卡片状态",
"itemValue": "1",
"itemName": "已使用",
"orderValue": 2,
"isValid": 1,
"createTime": "2018-03-20 10:51:09",
"createId": 0,
"remark": "10"
}
]
}
}
# 6 预付订单
## 6.1 预付订单查询
---
请求地址：/iot_service/dataPlanOrder/queryDataPlanOrderList.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
orderNo|订单编号| String| 否|temp
startDate|下单时间开始|String|否|temp
endDate|下单时间结束|String|否|temp
currentPage|当前页码|int|是|1
pageSize|单页条数|int|是|10
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"totalPage": 3,
"pageSize": 1,
"currentPage": 1,
"list": [
{
"id": 54117,
"orderNo": "1510996097144",
"iccid": "89860616010044998660",
"dataPlanId": 1,
"dataPlanFlow": 100,
"dataPlanName": "100M/月",
"dataPlanExpire": "12个月",
"dataPlanPrice": null,
"createTime": "2018-09-13 09:43:17",
"orderPrice": "0",
"tradeNo": null,
"simStatus": "1",
"simStatusName": "未使用",
"userId": 64,
"company": "duan"
}
]
}
}
data说明：
参数 | 说明
---|---
createTime | 订单创建时间
orderNo | 订单编号
iccid | iccid
dataPlanId|套餐id
dataPlanName|套餐名称
dataPlanFlow|套餐流量
dataPlanExpire|套餐期限
orderPrice|订单金额
company|客户名称
simStatusName|卡片状态名称
## 6.2 预付订单明细
---
请求地址：/iot_service/dataPlanOrder/orderDetail.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
id|订单id| int| 否|1
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json| 示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"realAuth": {
"photo_status": 2,
"create_time": "2018-03-01 04:24:17",
"modified_id": 88,
"negative_photo": "f52d7f9337ec43e79ac57d05aed55531.png",
"id_card": "32**************73",
"mobile": "15306265201",
"confirm_id": 88,
"postive_photo": "3bbf7c0dbc774150a131946a0d934a91.png",
"hand_photo": "2751ff5c850b4036a66143fa82880a2f.png",
"confirm_time": "2018-03-08 02:27:52",
"iccid": "8986061501000343590",
"modified_time": "2018-03-08 02:27:52",
"create_id": 0,
"is_valid": "1",
"name": "葛*",
"id": 37085,
"reject_id": "1"
},
"order": {
"id": 75078,
"orderNo": "1519892581645",
"iccid": "8986061501000343590",
"dataPlanId": 56,
"dataPlanFlow": null,
"dataPlanName": null,
"dataPlanExpire": null,
"dataPlanPrice": null,
"createTime": "2018-03-01 04:23:01",
"orderPrice": "0.01",
"tradeNo": "4200000060201803010586925605",
"simStatus": "2",
"simStatusName": "已使用",
"userId": 66,
"company": "duan"
}
}
}
data说明：
参数 | 说明
---|---
realAuth.name | 姓名
realAuth.id_card | 身份证
realAuth.mobile|手机号
--|--
order|订单信息
tradeNo|流水号
orderNo|订单编号
createTime|下单时间
dataPlanName|套餐名称
company|客户名称
# 7 固定不共享套餐
## 7.1 是否启用
---
请求地址：/iot_service/dataPlan/setDataPlanEnable.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
id|套餐id| int| 是|1
dataPlanEnable|是否启用|int|1=启用,0=不启用
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"result": "ok"
}
}
## 7.2 修改套餐售价
---
请求地址：/iot_service/dataPlan/setDataPlanPrice.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
id|套餐id| int| 是|1
dataPlanPrice|套餐售价|String|12
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"result": "ok"
}
}
# 8 首页返利
## 8.1 返利统计
---
请求地址：/iot_service/sell/index/rebateStatistics.do
请求方式：
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
返回结果
参数 | 说明|类型| 示例
---|---|--|--
errno | 返回码|int|0=成功,其他值表示失败
info |说明|String|成功
data|返回结果|Json|示例
返回示例：
{
"errno": 0,
"info": "成功",
"data": {
"payRebate": 0.0,
"incomeRebate": 0.0,
"totalRebate": 0.0
}
}
data说明：
参数 | 说明
---|--
payRebate|支出返利
incomeRebate| 收入返利
totalRebate | 总返利收入
# 9 导出
## 9.1 灵活共享账单导出
---
请求地址：/iot_service/sell/financial/billExport.do
请求方式：post
---
请求参数
参数 |备注 |类型 | 是否必填 | 示例
---|--|---|-- |--|--
id|账单id| int| 是|1
-----
返回说明：
返回excel文件流