达实AIoT
文档中心
快速开始
  • 单点登录对接
  • 开放接口对接
  • 领域模型事件对接
  • 私有部署
  • 应用开发指南
  • DASDesign
IoT平台
应用平台
  • 低代码工具
  • 基础服务
  • 系统运维
  • 场景模型
应用
  • 物业管理
  • 数据中心
  • 智慧园区IPS
  • 园区服务
  • 物业管理
  • 场景模型
  • 会议
  • 门禁
  • 停车场
文档中心
快速开始
  • 单点登录对接
  • 开放接口对接
  • 领域模型事件对接
  • 私有部署
  • 应用开发指南
  • DASDesign
IoT平台
应用平台
  • 低代码工具
  • 基础服务
  • 系统运维
  • 场景模型
应用
  • 物业管理
  • 数据中心
  • 智慧园区IPS
  • 园区服务
  • 物业管理
  • 场景模型
  • 会议
  • 门禁
  • 停车场
期待您的声音
  1. 销售子系统
  • 轻应用
  • 图形引擎
  • 业务编排
  • 数据中台
    • 接口统一认证方式
    • 销售子系统
      • API-body中的columns参数结构
      • 销售子系统API文档
  1. 销售子系统

API-body中的columns参数结构

本接口一共对应6张数据库表,请您传数据时找到对应表进行参数构建#

第一张表 荷-用户分类统计#

1. 表名(tableName):荷-用户分类统计#

适用场景:当 data_name 为以下值时使用该表:
居民用户数
大工业用户数
一般工商业用户数
纺织用户数
农业用户数

2. 请求体(Body)结构说明#

  "tableName": "荷-用户分类统计",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "居民用户数",  // data_name 示例
      12500.0,      // value 示例
      "户",          // unit 示例
      "33333333/22222222",  // measure_point 示例
      "1023/3204",  // id 示例
      "2025-08-15 14:30:00"  // updateTime 示例(需为实时时间)
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
data_namestring必须为以下值之一:
- 居民用户数
- 大工业用户数
- 一般工商业用户数
- 纺织用户数
- 农业用户数
"居民用户数"
valuedouble对应数据的数值(支持小数)12500.0、3680.5
unitstring数据的单位(通常为 “户”)"户"
measure_pointstring计量点标识(可填写设备 ID、区域编码等)"33333333/22222222"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"、"user_20250815"
updateTimetimestamp必须传入调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 14:30:00"

4. 数据推送频率#

一年更新一次即可(1次/年)
📌
注意事项
updateTime 需严格填写调用接口时的实时时间,不可使用历史时间或固定值,否则可能导致数据时效错误。
rows 数组中每个元素的顺序必须与 columns 定义的字段顺序完全一致(例如第一个元素对应 data_name,第二个对应 value 等)。

第二张表 荷-用户用电分析#

1. 表名(tableName):荷-用户用电分析#

适用场景:当 data_name 为以下值时使用该表:
大工业用电量
一般工商业用电量
居民用电量
纺织用电量
农业用电量

2. 请求体(Body)结构说明#

  "tableName": "荷-用户用电分析",
  "columns": [
    {"columnName": "corps", "dataType": "string"},
    {"columnName": "monthYear", "dataType": "string"},
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "第三师",        // corps 示例
      "月",            // monthYear 示例
      "大工业用电量",  // data_name 示例
      56800.5,         // value 示例
      "亿kWh",           // unit 示例
      "33333333/44444444",  // measure_point 示例
      "1023/3204",  // id 示例
      "2025-08-15 15:45:00"  // updateTime 示例(需为实时时间)
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
corpsstring以下值之一:
- 中新建
- 第三师
- 第七师
- 第八师
"第三师"、"中新建"
monthYearstring以下值之一:
- 月(表示月用电量)
- 年(表示年用电量)
"月"、"年"
data_namestring必须为以下值之一:
- 大工业用电量
- 一般工商业用电量
- 居民用电量
- 纺织用电量
- 农业用电量
"居民用电量"
valuedouble对应用电量的数值(支持小数)56800.5、125000.0
unitstring用电量的单位"亿kWh"
measure_pointstring计量点标识(可填写设备 ID、区域编码等)"33333333/44444444"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
updateTimetimestamp必须传入调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 15:45:00"

4. 数据推送频率#

一天更新一次(1次/天)
📌
注意事项
updateTime 需严格填写调用接口时的实时时间,不可使用历史时间或固定值,否则可能导致数据时效错误。
rows 数组中每个元素的顺序必须与 columns 定义的字段顺序完全一致(例如第一个元素对应 data_name,第二个对应 value 等)。

第三张表 集团总览-集团运营服务#

1. 表名(tableName):集团总览-集团运营服务#

适用场景:当 data_name 为以下值时使用该表:
电年度销售额
水年度销售额
热年度销售额
气年度销售额
💡
由于这张表和第一张表”荷-用户分类统计“结构完全一致,因此这里只给出请求体(Body)结构说明,详细信息请参考第一张表
  "tableName": "集团总览-集团运营服务",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "电年度销售额",  // data_name 具体值根据业务场景填写
      1580.0,         // value 示例
      "亿元",      // unit 示例
      "33333333/44444444",    // measure_point 示例
      "1023/3204",  // id 示例(确保唯一)
      "2025-08-15 16:30:00"  // updateTime 需为调用时的实时时间
    ]
  ]
}

2. 数据推送频率#

一天更新一次(1次/天)

第四张表 荷-获得电力统计#

1. 表名(tableName):荷-获得电力统计#

适用场景:当 data_name 为以下值时使用该表:
工单合计
高压新装(增容)
低压新装(增容)
居民新装

2. 请求体(Body)结构说明#

  "tableName": "荷-获得电力统计",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "index", "dataType": "string"},
    {"columnName": "electric_type", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "高压新装(增容)",  // data_name 示例
      "受理工单数",        // index 示例
      "高压",              // electric_type 示例
      120.0,               // value 示例
      "件",                // unit 示例
      "33333333/55555555",  // measure_point 示例
      "1023/3204",  // id 示例
      "2025-08-15 17:20:00"  // updateTime 示例(需为实时时间)
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
data_namestring必须为以下值之一:
- 工单合计
- 高压新装(增容)
- 低压新装(增容)
- 居民新装
"低压新装(增容)"
indexstring必须为以下指标之一:
- 受理工单数
- 新增容量
- 办结工单数
- 在途工作单数
- 超时办理工作单数
"办结工单数"
electric_typestring必须为以下用电类型之一:
- 高压
- 低压
- 居民
"居民"
valuedouble对应指标的数值(支持小数)120.0、35.5
unitstring指标的单位(如 “件”“kVA” 等,根据实际场景填写)"件"、"kVA"
measure_pointstring计量点标识(可填写设备 ID、区域编码等)"33333333/55555555"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
updateTimetimestamp必须传入调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 17:20:00"

4. 数据推送频率#

一年更新一次即可(1次/年)
📌
注意事项
updateTime 需严格填写调用接口时的实时时间,不可使用历史时间或固定值,否则可能导致数据时效错误。
rows 数组中每个元素的顺序必须与 columns 定义的字段顺序完全一致(例如第一个元素对应 data_name,第二个对应 value 等)。

第五张表 荷-大客户每日负荷和用电量#

1. 表名(tableName):荷-大客户每日负荷和用电量#

适用场景:当 data_name 为以下值时使用该表:
天铝用电量
合盛用电量
大全用电量
147 工业园用电量
农站电量

2. 数据推送频率#

一天更新一次(1次/天)
💡
说明
该表的请求体结构、字段详情及注意事项与第一张表”荷-用户分类统计“完全一致,可直接参考其格式规范。

第六张表 水热-水厂总览_热站总览#

1. 表名(tableName):水热-水厂总览_热站总览#

适用场景:当 data_name 为以下值时使用该表:
年度售水量
年度工业蒸汽销售量
月度售水量
月度工业蒸汽销售量
每日售水量
每日工业蒸汽销售量
换热站数量
用水服务客户数
用热服务客户数
用热服务面积

2. 数据推送频率#

数据名称更新频率
年度售水量一天更新一次(1次/天)
年度工业蒸汽销售量一天更新一次(1次/天)
月度售水量一天更新一次(1次/天)
月度工业蒸汽销售量一天更新一次(1次/天)
每日售水量一天更新一次(1次/天)
每日工业蒸汽销售量一天更新一次(1次/天)
换热站数量一年更新一次(1次/年)
用水服务客户数一年更新一次(1次/年)
用热服务客户数一年更新一次(1次/年)
用热服务面积一年更新一次(1次/年)
💡
说明
该表的请求体结构、字段详情及注意事项与第一张表”荷-用户分类统计“完全一致,可直接参考其格式规范。

期待您的宝贵建议

微信扫描二维码,为我们的AIoT产品提出您的宝贵建议,用户体验是我们坚持不懈的追求。

微信扫描二维码
修改于 2025-08-18 06:45:50
上一页
接口统一认证方式
下一页
销售子系统API文档
Built with