应用场景
商户在其前端页面输入对应的电费号和查询日期,由商户网页或者商户后台调用该接口发起电费欠费查询。
接口地址
219.136.207.190:9991
输入参数
采用SOCKET协议通信,报文格式采用拼接字符串的形式,具体格式如下:
客户号 # 查询方式
查询 | ||||
---|---|---|---|---|
含义 | 功能说明 | 长度 | 说明 | |
客户号 | 用户id | 16 | 电费号 | |
查询方式 | 标识查询的方式 | 6 | 查询所有月份(999999)或输入单月份(YYYYMM) |
举例如下:
0800140016751430#201703
返回结果
数据按拼接字符串格式实时返回:
状态标识$查询内容1 $查询内容2 $……
查询内容 : 客户号#客户名称#账单日期#欠费月数#单月总金额#电费#滞纳金#用量#记录状态
查询 | ||||
---|---|---|---|---|
含义 | 功能说明 | 长度 | 说明 | |
状态标识 | 标识操作结果状态 | 2 | OK为成功 | |
查询内容 | 客户号 | 16 | 用户id | |
客户名称 | 64 | |||
账单日期 | 6 | 单月,如201005;多月,999999 | ||
欠费月数 | 1 | 默认返回值:1 | ||
单月总金额 | 16 | 单位:分,保留两位小数 | ||
本月费用金额 | 16 | 单位:分,保留两位小数 | ||
滞纳金 | 16 | 单位:分,保留两位小数 | ||
用量 | 3 | 默认返回值:999 | ||
记录状态 | 1 | 3冻结,其他为正常,如果为冻结状态,此时不能进行正常缴费操作 |
举例如下:
OK$0800140016751430#黄晓明#201703#1#34300#34300#0#999#1
响应码
返回类别 | 返回编码 | 说明 |
---|---|---|
成功 | 0 | 成功 |
参数错误 | 1001 | 参数错误 |
非本系统终端 | 1002 | 非本系统终端 |
签名不正确 | 1003 | 此终端已列入黑名单 |
报文发送电力失败 | 1004 | 报文发送电力失败 |
电力返回空 | 1005 | 电力返回空 |
供电返回不完整 | 1006 | 供电返回不完整 |
供电返回错误信息 | 1007 | 供电返回错误信息 + 数据 |
流水号不一致 | 1008 | 流水号不一致 |
系统故障 | 1582 | 系统故障 |
签名不正确 | 1009 | 签名不正确 |
金额不符 | 1010 | 金额不符 |
余额不足 | 1011 | 余额不足 |
系统生成订单失败 | 1012 | 系统生成订单失败 |
扣费失败 | 1013 | 扣费失败 |
连接供电局失败 | A1 | 连接供电局失败 |
发送电力失败 | A2 | 发送电力失败 |
其他错误 | ER | 错误信息 |