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

API-body中的columns参数结构

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

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

1. 表名(tableName):sale_he_clientClassify#

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

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

  "tableName": "sale_he_clientClassify",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point_name", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "recordTime_year", "dataType": "int"},
    {"columnName": "recordTime_month", "dataType": "int"},
    {"columnName": "recordTime_day", "dataType": "int"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "居民用户数",
      1250,
      "户",
      "33333333/22222222",
      "1023/3204",
      2025,
      8,
      15,
      "2025-08-15 14:30:00"
    ],
    [
      "大工业用户数",             
      3680,                       
      "户",                       
      "33333333/22222222",
      "1023/3204",
      2024,
      8,
      15,
      "2025-08-15 14:30:00"
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
data_namestring必须为以下值之一:
- 居民用户数
- 大工业用户数
- 一般工商业用户数
- 纺织用户数
- 农业用户数
"居民用户数"
valuedouble对应数据的数值(支持小数)12500.0、3680.5
unitstring数据的单位"户"
measure_point_namestring测点名"33333333/22222222"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
recordTime_yearint数据被记录的时间年份2025
recordTime_monthint数据被记录的时间月份8
recordTime_dayint数据被记录的时间日期18
updateTimetimestamp调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 14:30:00"

4. 数据推送频率#

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

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

1. 表名(tableName):sale_he_electricityUsage#

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

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

  "tableName": "sale_he_electricityUsage",
  "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_name", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "recordTime_year", "dataType": "int"},
    {"columnName": "recordTime_month", "dataType": "int"},
    {"columnName": "recordTime_day", "dataType": "int"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "第三师",     
      "月",            
      "大工业用电量",  
      56800.5,        
      "亿kWh",           
      "33333333/44444444",  
      "1023/3204",  
      2025,
      8,
      15,
      "2025-08-15 15:45:00"  
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
corpsstring以下值之一:
- 中新建
- 第三师
- 第七师
- 第八师
"第三师"、"中新建"
monthYearstring以下值之一:
- 月(表示月用电量)
- 年(表示年用电量)
"月"、"年"
data_namestring必须为以下值之一:
- 大工业用电量
- 一般工商业用电量
- 居民用电量
- 纺织用电量
- 农业用电量
"居民用电量"
valuedouble对应用电量的数值(支持小数)56800.5、125000.0
unitstring用电量的单位"亿kWh"
measure_point_namestring测点名"33333333/44444444"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
recordTime_yearint数据被记录的时间年份2025
recordTime_monthint数据被记录的时间月份8
recordTime_dayint数据被记录的时间日期18
updateTimetimestamp调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 15:45:00"

4. 数据推送频率#

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

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

1. 表名(tableName):sale_group_groupOperation#

适用场景:当 data_name 为以下值时使用该表:
电年度销售额
水年度销售额
热年度销售额
气年度销售额

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

  "tableName": "sale_group_groupOperation",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point_name", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "recordTime_year", "dataType": "int"},
    {"columnName": "recordTime_month", "dataType": "int"},
    {"columnName": "recordTime_day", "dataType": "int"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "电年度销售额",  
      1580.0,        
      "亿元",      
      "33333333/44444444",    
      "1023/3204",
      2025,
      8,
      15,
      "2025-08-15 16:30:00" 
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
data_namestring必须为以下值之一:
- 电年度销售额
- 水年度销售额
- 热年度销售额
- 气年度销售额
"电年度销售额"
valuedouble对应数据的数值(支持小数)12500.0、3680.5
unitstring数据的单位"亿元"
measure_point_namestring测点名"33333333/22222222"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
recordTime_yearint数据被记录的时间年份2025
recordTime_monthint数据被记录的时间月份8
recordTime_dayint数据被记录的时间日期18
updateTimetimestamp调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 14:30:00"

4. 数据推送频率#

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

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

1. 表名(tableName):sale_he_electricityAccessStatistics#

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

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

  "tableName": "sale_he_electricityAccessStatistics",
  "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_name", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "recordTime_year", "dataType": "int"},
    {"columnName": "recordTime_month", "dataType": "int"},
    {"columnName": "recordTime_day", "dataType": "int"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "高压新装(增容)",  
      "受理工单数",        
      "高压",              
      120.0,               
      "件",                
      "33333333/55555555",  
      "1023/3204",  
      2025,
      8,
      15,
      "2025-08-15 17:20:00"  
    ]
  ]
}

3. columns 字段详情#

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

4. 数据推送频率#

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

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

1. 表名(tableName):sale_he_clientEleDailyUsage#

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

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

  "tableName": "sale_he_clientEleDailyUsage",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point_name", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "recordTime_year", "dataType": "int"},
    {"columnName": "recordTime_month", "dataType": "int"},
    {"columnName": "recordTime_day", "dataType": "int"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "天铝用电量",  
      1580.0,        
      "万kWh",      
      "33333333/44444444",    
      "1023/3204",
      2025,
      8,
      15,
      "2025-08-15 16:30:00" 
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
data_namestring必须为以下值之一:
- 天铝用电量
- 合盛用电量
- 大全用电量
- 147 工业园用电量
- 农站电量
"天铝用电量"
valuedouble对应数据的数值(支持小数)12500.0、3680.5
unitstring数据的单位"万kWh"
measure_point_namestring测点名"33333333/22222222"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
recordTime_yearint数据被记录的时间年份2025
recordTime_monthint数据被记录的时间月份8
recordTime_dayint数据被记录的时间日期18
updateTimetimestamp调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 14:30:00"

4. 数据推送频率#

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

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

1. 表名(tableName):sale_shuire_IndustryOverview#

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

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

  "tableName": "sale_shuire_IndustryOverview",
  "columns": [
    {"columnName": "data_name", "dataType": "string"},
    {"columnName": "value", "dataType": "double"},
    {"columnName": "unit", "dataType": "string"},
    {"columnName": "measure_point_name", "dataType": "string"},
    {"columnName": "id", "dataType": "string"},
    {"columnName": "recordTime_year", "dataType": "int"},
    {"columnName": "recordTime_month", "dataType": "int"},
    {"columnName": "recordTime_day", "dataType": "int"},
    {"columnName": "updateTime", "dataType": "timestamp"}
  ],
  "rows": [
    [
      "年度售水量",  
      1580.0,        
      "万吨",      
      "33333333/44444444",    
      "1023/3204",
      2025,
      8,
      15,
      "2025-08-15 16:30:00" 
    ]
  ]
}

3. columns 字段详情#

字段名数据类型说明示例值
data_namestring必须为以下值之一:
- 年度售水量
- 年度工业蒸汽销售量
- 月度售水量
- 月度工业蒸汽销售量
- 每日售水量
- 每日工业蒸汽销售量
- 换热站数量
- 自来水厂数量
- 用水服务客户数
- 用热服务客户数
- 用热服务面积
"年度售水量"
valuedouble对应数据的数值(支持小数)12500.0、3680.5
unitstring数据的单位"万吨"或""
measure_point_namestring测点名"33333333/22222222"
idstring数据唯一标识(可自定义格式,确保唯一)"1023/3204"
recordTime_yearint数据被记录的时间年份2025
recordTime_monthint数据被记录的时间月份8
recordTime_dayint数据被记录的时间日期18
updateTimetimestamp调用接口时的实时时间,格式为 yyyy-MM-dd HH:mm:ss"2025-08-15 14:30:00"

4. 数据推送频率#

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

期待您的宝贵建议

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

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