(值); 1/0 上报数据响应格式详解: 1表示成功; 0表示失败; 注:错误信息不予返回,请自行查找! 具体对应字段见附录一 日最小值表 响应格式 备注 3.2.2、上报数据请求格式 3.4 数据报文加密方式采用AES加密,java实例见附件二
四、 附录一
1.1电力实时表(编号: 01)
序号 字段名 类型 Varchar(30) Varchar(14) Decimal(8,3) decimal(8,3) decimal(8,3) decimal(8,3) decimal(8,3) 13 / 25
空值 N N 编号 备注 terminalId getTime yyyyMMddHHmmss 01 02 03 04 05 1. 监测仪编号 2. 得到数据时间 3. 总负荷 4. A相负荷 5. B相负荷 6. C相负荷 7. 总无功 宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
8. A相无功 9. B相无功 10. C相无功 11. 总功率因数 12. A相功率因数 13. B相功率因数 14. C相功率因数 15. A相电流 16. B相电流 17. C相电流 18. 零线电流 19. A相电压 20. B相电压 21. C相电压 22. Uab线电压 23. Ubc线电压 24. Uca线电压 25. 负荷率 26. 频率 27. 三相电流不平衡度 28. 三相电压不平衡度 29. A相电压偏差 30. B相电压偏差 31. C相电压偏差 32. Uab线电压偏差 33. Ubc线电压偏差 34. Uca线电压偏差 35. 频率偏差 36. 温度一 37. 温度二 38. 温度三 39. 温度四 40. 温度五 41. 温度六 42. 温度七 43. 温度八 decimal(8,3) decimal(8,3) decimal(8,3) decimal(5,3) decimal(5,3) decimal(5,3) decimal(5,3) decimal(8,3) decimal(8,3) decimal(8,3) decimal(8,3) decimal(8,2) decimal(8,2) decimal(8,2) decimal(8,2) decimal(8,2) decimal(8,2) decimal(8,4) decimal(5,3) decimal(6,3) decimal(6,3) decimal(5,2) decimal(5,2) decimal(5,2) decimal(5,2) decimal(5,2) decimal(5,2) decimal(5,2) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 14 / 25
宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
1.2电量实时表(编号: 02)
序号 字段名 类型 Varchar(30) varChar(14) decimal(10,3) decimal(10,3) decimal(10,3) decimal(10,3) decimal(10,3) decimal(10,3) decimal(10,3) decimal(10,3) 空值 N N 编号 备注 1. 监测仪编号 2. 得到数据时间 3. 正相有功电量 4. 正相无功电量 5. 反相有功电量 6. 反相无功电量 7. 正相有功电度示值 8. 正相无功电度示值 9. 反相有功电度示值 10. 反相无功电度示值 terminalId getTime yyyyMMddHHmmss 01 02 03 04 05 06 07 08 1.3谐波电压实时表(编号: 03)
序号 字段名 类型 Varchar(30) DateTime Varchar(2) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) 空值 N N N 15 / 25
编号 备注 1. 监测仪编号 2. 得到数据时间 3. 谐波电压类型(UA/UB/UC) terminalId getTime harmonicType yyyyMMddHHmmss 4. 3次谐波电压 5. 5次谐波电压 6. 7次谐波电压 7. 9次谐波电压 8. 11次谐波电压 9. 13次谐波电压 10. 15次谐波电压 11. 17次谐波电压 12. 19次谐波电压 13. 21次谐波电压 14. 23次谐波电压 15. 25次谐波电压 16. 27次谐波电压 17. 29次谐波电压 18. 31次谐波电压 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
19. 总谐波电压畸变率 decimal(6,3) decimal(10,3) 16 20. 基波 17 1.4谐波电流实时表(编号: 04)
序号 字段名 类型 Varchar(30) Varchar(14) Varchar(2) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(6,3) decimal(10,3) 空值 N N N 编号 terminalId 备注 1. 监测仪编号 2. 得到数据时间 3. 谐波电流类型 (IA/IB/IC) getTime yyyyMMddHHmmss harmonicType 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 4. 3次谐波电压 5. 5次谐波电压 6. 7次谐波电压 7. 9次谐波电压 8. 11次谐波电压 9. 13次谐波电压 10. 15次谐波电压 11. 17次谐波电压 12. 19次谐波电压 13. 21次谐波电压 14. 23次谐波电压 15. 25次谐波电压 16. 27次谐波电压 17. 29次谐波电压 18. 31次谐波电压 19. 总谐波电流畸变率 20. 基波 1.5电量整点表(编号: 05)
序号 字段名 类型 Varchar(30) varChart(8) Int(2) decimal(10,3) decimal(10,3) decimal(10,3) 16 / 25
空值 N N N 编号 备注 terminalId getDate yyyyMMdd hour 01 02 03 1. 监测仪编号 2. 得到数据日期 3. 小时数 4. 正相有功电量 5. 正相无功电量 6. 反相有功电量 宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
7. 反相无功电量 8. 正相有功电度示值 9. 正相无功电度示值 10. 反相有功电度示值 11. 反相无功电度示值 decimal(10,3) decimal(10,3) decimal(10,3) decimal(10,3) decimal(10,3) 04 05 06 07 08 1.6日峰谷平电量表(编号: 06)
序号 字段名 类型 Varchar(30) Varchar(8) Number(8,3) Number(8,3) Number(8,3) Number(8,3) Number(8,4) Number(8,4) Number(8,4) Number(8,4) 空值 N N 编号 备注 terminalId getDate yyyyMMdd 01 02 03 04 05 06 07 08 1. 监测仪编号 2. 得到数据日期 3. 峰电量 4. 谷电量 5. 平电量 6. 尖峰电量 7. 峰单价 8. 谷单价 9. 平单价 10. 尖峰单价 1.7日平均值表(编号:07)
序号 字段名 类型 Varchar2(30) Varchar2(8) Number(9,3) Number (9,3) Number (9,3) Number (9,3) Number (8,3) Number (8,3) Number (8,3) Number (8,3) Number (5,3) Number (5,3) Number (5,3) Number (5,3) Number (8,3) Number (8,3) 空值 N N 编号 备注 terminalId getDate yyyyMMdd 01 02 03 04 05 06 07 08 09 10 11 12 13 14 1. 监测仪编号 2. 得到数据日期 3. 总负荷 4. A相负荷 5. B相负荷 6. C相负荷 7. 总无功 8. A相无功 9. B相无功 10. C相无功 11. 总功率因数 12. A相功率因数 13. B相功率因数 14. C相功率因数 15. A相电流 16. B相电流
17 / 25
宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
17. C相电流 18. 零线电流 19. A相电压 20. B相电压 21. C相电压 22. Uab线电压 23. Ubc线电压 24. Uca线电压 25. 负荷率 26. 频率 27. 三相电流不平衡度 28. 三相电压不平衡度 29. A相电压偏差 30. B相电压偏差 31. C相电压偏差 32. Uab线电压偏差 33. Ubc线电压偏差 34. Uca线电压偏差 35. 频率偏差 36. 温度一 37. 温度二 38. 温度三 39. 温度四 40. 温度五 41. 温度六 42. 温度七 43. 温度八 44. A相电流谐波畸变率 45. B相电流谐波畸变率 46. C相电流谐波畸变率 47. A相电压谐波畸变率 48. B相电流谐波畸变率 49. C相电流谐波畸变率 Number (8,3) Number (8,3) Number (8,2) Number (8,2) Number (8,2) Number (8,2) Number (8,2) Number (8,2) Number (8,4) Number (5,3) Number (6,3) Number (6,3) Number (5,2) Number (5,2) Number (5,2) Number (5,2) Number (5,2) Number (5,2) Number (5,2) Number (6,3) Number (6,3) Number (6,3) Number (6,3) Number (6,3) Number (6,3) Number (6,3) Number (6,3) Number(5,2) Number(5,2) Number(5,2) Number(5,2) Number(5,2) Number(5,2) 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 1.8日最大值表(编号:08)
序号 1. 2.
字段名 监测仪编号 得到时间 类型 Varchar2 (30) Varchar2(8) 18 / 25
空值 N N 编号 备注 terminalId getDate yyyyMMdd 宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19. 20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. A相电流 A相电流时间 B相电流 B相电流时间 C相电流 C相电流时间 零序电流 零序电流时间 A相负荷 A相负荷时间 B相负荷 B相负荷时间 C相负荷 C相负荷时间 总负荷 总负荷时间 A相无功功率 A相无功功率时间 B相无功功率 B相无功功率时间 C相无功功率 C相无功功率时间 总无功功率 总无功功率时间 A相功率因数 A相功率因数时间 B相功率因数 B相功率因数时间 C相功率因数 C相功率因数时间 总功率因数 总功率因数时间 A相电压 A相电压时间 B相电压 B相电压时间 C相电压 C相电压时间 Ab线电压 Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (6,3) Varchar2(14) Number (6,3) Varchar2(14) Number (6,2) Varchar2(14) Number (6,3) Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) 19 / 25
01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39
宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 56. 57. 58. 59. 60. 61. 62. 63. 64. 65. 66. 67. 68. 69. 70. 71. 72. 73. 74. 75. 76. 77. 78. 79. 80. Ab线电压时间 BC线电压 BC线电压时间 CA电压 CA电压时间 负荷率 负荷率时间 频率 频率时间 A相谐波电流畸变率 A相谐波电流畸变率时间 A相谐波电压畸变率 A相谐波电压畸变率时间 B相谐波电流畸变率 B相谐波电流畸变率时间 B相谐波电压畸变率 B相谐波电压畸变率时间 C相谐波电流畸变率 C相谐波电流畸变率时间 C相谐波电压畸变率 C相谐波电压畸变率时间 三相电流不平衡度 三相电流不平衡度时间 三相电压不平衡度 三相电压不平衡度时间 频率偏差 频率偏差时间 A相电压偏差 A相电压偏差时间 B相电压偏差 B相电压偏差时间 C相电压偏差 C相电压偏差时间 ab线电压偏差 ab线电压偏差时间 bc线电压偏差 bc线电压偏差时间 ca线电压偏差 ca线电压偏差时间 Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,3) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) 20 / 25
40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78
宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
81. 82. 83. 84. 85. 86. 87. 88. 89. 90. 91. 92. 93. 94. 95. 96. 温度一 温度一时间 温度二 温度二时间 温度三 温度三时间 温度四 温度四时间 温度五 温度五时间 温度六 温度六时间 温度七 温度七时间 温度八 温度八时间 Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 1.9日最小值表(编号:09)
序号 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19.
字段名 监测仪编号 得到时间 A相电流 A相电流时间 B相电流 B相电流时间 C相电流 C相电流时间 零序电流 零序电流时间 A相负荷 A相负荷时间 B相负荷 B相负荷时间 C相负荷 C相负荷时间 总负荷 总负荷时间 A相无功功率 类型 Varchar2 (30) Varchar2(8) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) 21 / 25
空值 N N 编号 备注 terminalId getDate yyyyMMdd 01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
20. 21. 22. 23. 24. 25. 26. 27. 28. 29. 30. 31. 32. 33. 34. 35. 36. 37. 38. 39. 40. 41. 42. 43. 44. 45. 46. 47. 48. 49. 50. 51. 52. 53. 54. 55. 56. 57. 58. A相无功功率时间 B相无功功率 B相无功功率时间 C相无功功率 C相无功功率时间 总无功功率 总无功功率时间 A相功率因数 A相功率因数时间 B相功率因数 B相功率因数时间 C相功率因数 C相功率因数时间 总功率因数 总功率因数时间 A相电压 A相电压时间 B相电压 B相电压时间 C相电压 C相电压时间 Ab线电压 Ab线电压时间 BC线电压 BC线电压时间 CA线电压 CA线电压时间 负荷率 负荷率时间 频率 频率时间 A相谐波电流畸变率 A相谐波电流畸变率时间 A相谐波电压畸变率 A相谐波电压畸变率时间 B相谐波电流畸变率 B相谐波电流畸变率时间 B相谐波电压畸变率 B相谐波电压畸变率时间 Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (8,3) Varchar2(14) Number (6,3) Varchar2(14) Number (6,3) Varchar2(14) Number (6,3) Varchar2(14) Number (6,3) Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) Varchar2(14) Number (8,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,3) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) 22 / 25
18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56
宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
59. 60. 61. 62. 63. 64. 65. 66. 67. 68. 69. 70. 71. 72. 73. 74. 75. 76. 77. 78. 79. 80. 81. 82. 83. 84. 85. 86. 87. 88. 89. 90. 91. 92. 93. 94. 95. 96.
C相谐波电流畸变率 C相谐波电流畸变率时间 C相谐波电压畸变率 C相谐波电压畸变率时间 三相电流不平衡度 三相电流不平衡度时间 三相电压不平衡度 三相电压不平衡度时间 频率偏差 频率偏差时间 A相电压偏差 A相电压偏差时间 B相电压偏差 B相电压偏差时间 C线电压偏差 C线电压偏差时间 ab线电压偏差 ab线电压偏差时间 bc线电压偏差 bc线电压偏差时间 ca线电压偏差 ca线电压偏差时间 温度一 温度一时间 温度二 温度二时间 温度三 温度三时间 温度四 温度四时间 温度五 温度五时间 温度六 温度六时间 温度七 温度七时间 温度八 温度八时间 Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) Number (6,2) Varchar2(14) 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 23 / 25
宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
五、 附录二
2.1、AES java 加密代码
import javax.crypto.Cipher;
import javax.crypto.spec.SecretKeySpec; public class AESUtil {
/*** * 加密 */
public static String Encrypt(String sSrc, String key) throws Exception { } }
String hs = \"\"; String stmp = \"\";
for (int n = 0; n < b.length; n++) { }
return hs;
stmp = (java.lang.Integer.toHexString(b[n] & 0XFF)); if (stmp.length() == 1) { }
hs = hs + \"0\" + stmp; hs = hs + stmp; } else {
public static String byte2hex(byte[] b) {
if(checkKey(key)) { }
return null;
byte[] raw = key.getBytes(\"ASCII\");
SecretKeySpec skeySpec = new SecretKeySpec(raw, \"AES\"); Cipher cipher = Cipher.getInstance(\"AES\"); cipher.init(Cipher.ENCRYPT_MODE, skeySpec);
byte[] encrypted = cipher.doFinal(sSrc.getBytes()); return byte2hex(encrypted).toLowerCase();
public static boolean checkKey(String key) throws Exception {
24 / 25
宁夏电力需求侧管理公共服务平台数据接口规范V2.0 www.nxdsm.com
}
}
if (key == null) {
/*\"密码为空!\"错误处理代码*/ }else if (key.length() != 16) { /*\"Key长度不是16位!\"错误处理代码*/ }
return true;
25 / 25