1、ICS 35.200 CCS L 65 DB50重庆市地方标准 DB50/T 15082023 新能源汽车与充电基础设施监测平台 换电设施信息接入技术规范 2023-11-10 发布2024-02-10 实施重庆市市场监督管理局 发 布 DB50/T 15082023 目 次 前言.II1 范围.12 规范性引用文件.13 术语和定义.14 功能描述.15 数据接入传输协议过程.26 换电设施数据信息.27 数据传输接口.108 换电设施数据传输体系.219 平台认证要求.2310 密钥的管理和使用.24附录 A（规范性）平台认证接口规范.26附录 B（规范性）数据加解密方式.27附录 C（规
2、范性）HMAC-MD5 参数签名方式.28 DB50/T 15082023 前言 本文件按照 GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由重庆市经济和信息化委员会提出、归口和组织实施。本文件起草单位：国网重庆市电力公司营销服务中心、重庆市质量和标准化研究院、中国汽车工程研究院股份有限公司、重庆易易新能源科技有限公司、重庆奥动新能源科技有限公司、重庆峘能电动车科技有限公司、重庆市环卫集团有限公司、重庆电子工程职业学院。本文件主要起草人：徐婷婷、吴高林、胡晓锐、龙方家、龙羿
3、、汪会财、朱彬、池磊、鲁波、张程、姚波、刘发超、王涵、陈卫、彭朋梅、徐慧娴、李智、孙正凯、李玉兰、张永瑜、易力峥。1DB50/T 15082023 新能源汽车与充电基础设施监测平台 换电设施信息接入技术规范 1 范围 本文件规定了新能源汽车与充电基础设施监测平台换电设施信息接入规范，涵盖换电设施数据信息、换电设施数据传输接口、换电设施数据传输体系、平台认证要求、密钥的管理和使用等相关要求。本文件适用于新能源汽车与充电基础设施监测平台换电设施信息接入。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日
4、期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 22602007 中华人民共和国行政区划代码GB/T 74082005 数据元和交换格式信息交换日期和时间表示法GB/T 202712006 信息安全技术 信息系统通用安全技术要求。GB/T 222392019 信息安全技术 网络安全等级保护基本要求。GB/T 250702019 信息安全技术 网络安全等级保护安全设计技术要求。GB/T 293172021 电动汽车充换电设施术语 NB/T 330072013 电动汽车换电站/电池更换站监控系统与充换电设施通信协议 3 术语和定义下列术语和定义适用于本文件。3.1 换电站 ba
5、ttery swap station为换电型电动汽车的动力电池提供电能的场所。3.2 换电站充电设备 charging equipment for battery swap station换电站中为动力电池充电的设备。3.3 新能源汽车与充电基础设施监测平台 new energy vehicles and charging infrastructure monitoring platform 对电动汽车、充换电设施数据进行采集、存储、处理、分析，实现电动汽车与充换电设施的监测，并提供服务的平台，以下简称平台。4 功能描述换电站信息接口应支持以下功能：DB50/T 15082023 2 a)获取
6、换电站信息：支持数据需求方查询换电站运营商的信息，应支持全部查询和增量查询的方式；b)同步换电站运营状态：支持换电站运行状态同步到数据需求方；c)查询换电站统计信息：支持数据需求方査询换电站运行情况的统计信息；d)推送换电订单信息：同步换电站中订单数据到数据需求方。5 数据接入传输协议过程当服务请求方使用http发起一个请求时，应用层、传输层、网络层和链路层的相关协议依次对该请求进行包装，最终在链路层生成以太网数据包，以太网数据包通过物理介质传输给对方主机，服务接受方接收到数据包以后，然后再逐层采用对应的协议进行拆包，最后把应用层数据交给应用程序处理。平台通信协议栈如图 2 所示。图1 平台通
7、信协议栈6 换电设施数据信息6.1 换电站运营商信息用于描述换电设备运营商的基础信息，定义见表 1。3DB50/T 15082023 表1 换电站运营商信息名称字段描述必填类型长度/范围换电运营商 IDSwapOperatorID使用统一社会信用代码Y字符串18 字符换电运营商名称SwapOperatorName换电运营商名称Y字符串64 字符换电运营商联系人SwapOperatorConn运营商客服联系人Y字符串32 字符换电运营商电话 1SwapOperatorTell运营商客服电话 1（技术人员或者平台对接员）Y字符串32 字符换电运营商电话 2SwapOperatorTel2运营商客服
8、电话 2（技术人员或者平台对接员）N字符串32 字符换电运营商注册地址OperatorRegAddress运营商注册地址Y字符串255 字符其他信息OperatorNote其他信息N字符串255 字符6.2 换电站信息用于描述换电站的信息，包含换电站的基本信息、服务信息、支付信息等，详见表 2。表2 换电站信息名称字段描述必填类型长度/范围换电站 IDSwapStationID运营商自定义的换电站唯一编码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6 位）Y字符串21 字符换电运营商IDSwapOperatorID使用统一社会信用代码Y字符串18 字符换电站设备所属方 IDS
9、wapEquipmentOwnerID使用统一社会信用代码Y字符串18 字符换电站名称SwapStationName换电站名称的描述Y字符串50 字符换电站最大电池包组数量BatMaxNumber换电站内最大电池包组数量Y整型换电站省市辖区编码SwapStationAreaCode按照 GB/T 2260Y字符串6 字符详细地址SwapStationAddress详细地址Y字符串64 字符站点电话SwapStationStationTel站点电话N字符串30 字符服务电话SwapStationServiceTel服务电话Y字符串30 字符DB50/T 15082023 4 表 2 换电站信息（
10、续）名称字段描述必填类型长度/范围站点服务对象SwapStationType1：公共；50：个人；100：公交（专用）；101：环卫（专用）；102：物流（专用）；103：出租车（专用）；255：其他Y整型站点状态SwapStationStatus0：未知；1：建设中；5：关闭下线；6：维护中；50：正常使用Y整型经度SwapStationLngGCJ-02 坐标系，是由中国国家测绘局制订的地理信息系统的坐标系统，又称火星坐标系Y浮点型保留小数点后 6 位纬度SwapStationLatGCJ-02 坐标系，是由中国国家测绘局制订的地理信息系统的坐标系统，又称火星坐标系Y浮点型保留小数点后 6
11、 位建设场所SwapStationConstruction1：居民区；2：公共机构；3：企事业单位；4：写字楼；5：工业园区；6：交通枢纽；7：大型文体设施；8：城市绿地；9：大型建筑配建停车场；10：路边停车位；11：城际高速服务区；12：风景区；13：公交场站；14：加油加气站；15：出租车运营点；255：其他Y整型站点照片SwapStationPictures站点照片N字符串数组服务车型描述MatchCars车系车型（厂牌型号）N字符串100 字符营业时间SwapStationBusineHours营业时间描述格式“HH:mm-HH:mm”N字符串100 字符供电类型SwapElectr
12、icityFee01：直供电；02：转供电N字符串256 字符用电户号SwapElectricityNumber供电类型位直供电必填，转供电可不填N字符串32 字符用电表号MeterNumber供电类型位直供电必填，转供电可不填N字符串32 字符其他信息Remark其他信息N字符串100 字符5DB50/T 15082023 6.2.1 换电站充电架信息用于描述换电站中充电架信息，详见表 3。表3 换电站充电架信息名称字段描述必填类型长度/范围充电架 IDSwapSystemID换电站 ID+运营商自定义 2 位N字符串24 字符换电站 IDSwapStationID运营商自定义的换电站唯一编
13、码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6 位）N字符串21 字符充电架总功率SwapSystemPower换电架充电额定功率N整型充电单元数SwapConnectPower换电站内充电架的充电单元总数N整型设备生产商统一信用代码ManufacturerID设备生产商统一信用代码N字符串18 字符设备生产商名称ManufacturerName设备生产商的名称N字符串30 字符设备型号EquipmentModel由设备生产商定义的设备型号N字符串20 字符设备生产日期ProductionDate格式：yyyy-MM-ddN字符串10 字符投运时间OperationDate
14、换电站充电架投入运营时间，格式：yyyy-MM-ddN字符串10 字符其他信息Remark其他信息N字符串100 字符6.2.2 换电站充电单元信息用于描述换电站中充电单元信息，详见表 4。表4 换电站充电单元信息名称字段描述必填类型长度充电单元 IDSwapConnectorID换电站内最小充电单元唯一识别编码(换电站 ID+自定义 7 位)Y字符串28 字符换电站 IDSwapStationID运营商自定义的换电站唯一编码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6 位）Y字符串21 字符充电架 IDSwapSystemID换电站 ID+运营商自定义 2 位N字符串24
15、 字符充电单元额定功率SwapConnectPower换电站内充电单元额定功率Y整型其他信息Remark其他信息N字符串100 字符6.3 电池包信息对电池包的描述，包含设备编码、设备类型、设备生产日期等，详见表 5。表5 电池包信息名称字段描述必填类型长度/范围电池包编码PackVin电池系统唯一识别号Y字符串32 字符电池包生产时间BattProductionTime电池包的生产（下线）时间，格式：yyyy-MM-ddY字符串10 字符DB50/T 15082023 6 表 5 电池包信息（续）名称字段描述必填类型长度/范围电池单体总数BatteryCount电池单体总数Y整型温度探针个数
16、TemperatureProbeCount温度探针个数Y整型最大充电电流CurrentSwapThreshold最大充电电流Y浮点型保留小数点后 3 位最大放电电流CurrentDisSwapThreshold最大放电电流Y浮点型保留小数点后 3 位最大充电 SOCSOCSwapThreshold最大充电 SOCY浮点型保留小数点后 3 位最低放电 SOCSOCDisSwapThreshold最低放电 SOCY浮点型保留小数点后 3 位最大放电温度阈值TempMaxDisThreshold最大放电温度阈值Y浮点型保留小数点后 3 位最低放电温度阈值TempMinDisThreshold最低放电
17、温度阈值Y浮点型保留小数点后 3 位最大充电温度阈值TempMaxSwapThreshold最大充电温度阈值Y浮点型保留小数点后 3 位最低充电温度阈值TempMinSwapThreshold最低充电温度阈值Y浮点型保留小数点后 3 位BMS 软件版本BMSSwVersBMS 软件版本Y字符串32 字符BMS 硬件版本BMSHwVersBMS 硬件版本Y字符串32 字符标称电量RatingPower标称电量（kWh）Y浮点型保留小数点后 3 位标称容量RatingCapacity标称容量(Ah)Y浮点型保留小数点后 3 位电池系统生产厂家BattManufacturer电池系统生产厂家Y字符串
18、32 字符电池包电池类型CellType1：三元锂离子电池；2：磷酸铁锂离子电池；3：磷酸铁锂电池；4：锂离子动力电池；5：三元系动力电池；6：锰酸锂动力电池；7：镍钴锰酸锂；8：钛酸锂电池；9：镍氢电池；10：钴酸锂电池；11：超级电容器；255：其他Y整型电池包状态BatteryPackStatus0：未知；1：正常使用；2：维护中；3：报废Y整型6.4 换电站状态数据用于描述换电站当前状态数据，详细定义见表 6。7DB50/T 15082023 表6 换电站状态数据名称字段描述必填类型长度/范围换电站 IDSwapStationID运营商自定义的换电站唯一编码（运营商组织机构编码 9 位
19、+区域编码 6位+运营商自定义 6 位）Y字符串21 字符状态上送时间SwapLoadTime格式：yyyy-MM-dd HH:mm:ssY字符串24 字符电池包数量CurrentBatNumber当前换电站内电池包的数量Y整型电池包列表CurrentBatList当前换电站内所有电池包的电池包编码集合Y字符串数组可用电池包数量EnableBatNumber当前换电站内电池包可用（可直接给车辆换电的电池包）的数量Y整型可用电池包列表EnableBatList当前换电站内电池包可用的电池包编码列表Y字符串数组实时功率TotalRealPower换电站内正在充电的充电单元功率之和Y整型充电中充电单
20、元数量RealChargeUnitNumber当前换电站内充电单元数量Y整型其他信息Mark其他信息N字符串64 字符6.5 充电单元状态数据用于描述换电站内充电单元当前状态数据，详细定义见表 7。表7 充电单元状态数据名称字段描 述必填类型长度/范围换电站 IDSwapStationID运营商自定义的换电站唯一编码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6 位）Y字符串21 字符充电单元 IDSwapConnectorID换电站内最小充电单元唯一识别编码(换电站 ID+自定义 7 位)Y字符串28 字符充电单元状态SwapConnectStatus0：离线；1：空闲；2
21、：占用（未充电）；3：占用（充电中）；255：故障Y整型充电单元实时功率RealPower充电单元实时充电功率Y整型其他信息Mark其他信息N字符串64 字符6.6 电池包状态数据用于描述电池包状态数据，详细定义见表 8。DB50/T 15082023 8 表8 电池包状态数据名称字段描述必填类型长度/范围电池包编码PackVin电池系统唯一识别号Y字符串32 字符换电站 IDSwapStationID运营商自定义的换电站唯一编码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6 位）Y字符串21 字符充电单元连接状态SwapConnectState0：空闲；1：充电中；2：充满
22、；3：人工中止；4：故障中止；5：出仓中止充电；6：未充电；7：结束充电Y整型充电单元 IDSwapConnectorID换电站内最小充电单元唯一识别编码(换电站 ID+自定义 7 位)Y字符串24 字符充电开始时间SwapStartTime格式：yyyy-MM-dd HH:mm:ssY字符串24 字符充电结束时间SwapEndTime格式：yyyy-MM-dd HH:mm:ss，充电未结束时为空。充电结束时，此字段为必填项N字符串24 字符充电开始 SOCStartSOC电池包充电开始 SOCY浮点型保留小数点后 3 位预计充满时间EstimatedFillingTime预计电池包充电充满状
23、态时长（min）N浮点型保留小数点后 3 位充电结束 SOCEndSOC电池包结束开始 SOC；充电结束时，此字段为必填项Y浮点型保留小数点后 3 位电池包当前SOCSOC电池包当前 SOCY浮点型保留小数点后 3 位电池系统当前电量CurrentPower电池系统当前电量Y浮点型保留小数点后 3 位电池包当前健康度SOH电池系统当前健康度（0-100%）Y浮点型保留小数点后 3 位最低温度探针编号MinTempNum最低温度探针编号Y字符串24 字符最高温度探针编号MaxTempNum最高温度探针编号Y字符串24 字符最低电压电池单体代号MinVoltageBattNum最低电压电池单体代号
24、Y字符串24 字符最高电压电池单体代号MaxVoltageBattNum最高电压电池单体代号Y字符串24 字符最大温差TempMaxGap最大温差Y浮点型保留小数点后 3 位最大压差VolMaxGap最大压差Y浮点型保留小数点后 3 位总电压BusVoltage总电压Y浮点型保留小数点后 3 位9DB50/T 15082023 表 8 电池包状态数据（续）名称字段描述必填类型长度/范围总电流BusCurrent总电流Y浮点型保留小数点后 3 位当前容量RemainCapacity当前容量Y浮点型保留小数点后 3 位单体电压CellVoltage电池包各单体电池电压Y字符串数组单体温度CellT
25、emperature电池包各单体电池温度Y字符串数组备注Remark其他备注信息N字符串100 字符6.7 电池包报警信息用于描述电池包的报警信息，报警开始时上传报警开始信息，结束时上传报警结束信息。详见表 9。表9 电池包报警信息名称字段描述必填类型长度/范围电池报警编码BatteryPackAlarmID一次报警的唯一识别编码（用户自定义）Y字符串32 字符换电站 IDSwapStationID运营商自定义的换电站唯一编码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6 位）Y字符串21 字符电池包编码PackVin电池系统唯一识别号Y字符串32 字符报警开始时间Alarm
26、StartTime格式：yyyy-MM-dd HH:mm:ssY字符串24 字符报警类型BatteryPackAlarmTypeA1：电池单体一致性差报警；A2：单体电池过压报警；A3：电池系统过压报警；A4：电池系统欠压报警；A5：单体电池欠压报警；C1：电池高温报警；C2：绝缘报警；B1：SOC 跳变报警；B2：SOC 低报警；00：无报警Y字符串4 字符报警结束时间AlarmEndTime格式：yyyy-MM-dd HH:mm:ssY字符串24 字符报警等级AlarmLevel1 级：轻微，指不影响车辆行驶的故障；2 级：严重，指影响车辆性能，需驾驶员限制行驶的故障；3 级：紧急，此时驾
27、驶员应立即停车或请求援助Y整型其他信息Remark其他信息N字符串100 字符6.8 电池包统计数据DB50/T 15082023 10 用于描述电池包统计数据，详细定义见表 10。表10 电池包统计数据名称字段描述必填类型长度/范围电池包编码PackVin电池系统唯一识别号Y字符串32 字符当前累计充电量PowerCumsum当前累计充电量，单位：kWhY浮点型保留小数点后 3 位当前累计充电电荷量AHCumsum当前累计充电电荷量，单位：AhN浮点型保留小数点后 3 位累计里程TotalMile累计里程Y浮点型保留小数点后 3 位统计时间SwapStartTime格式：yyyy-MM-dd
28、 HH:mm:ssY字符串24 字符备注Remark其他备注信息N字符串100 字符6.9 换电订单数据用于描述换电订单数据，详细定义见表 11。表11 换电订单数据名称字段描述必填类型长度/范围换电订单编号OrderID订单唯一标识Y字符串32 字符换下电池包编码LoadPackVin电池系统唯一识别号，车辆换下电池包编码Y字符串32 字符装载电池包编码UploadPackVin电池系统唯一识别号，装载到车辆电池包编码Y字符串32 字符充电单元 IDLoadSwapConnectorID换下电池包的充电单元编码Y字符串28 字符充电单元 IDUploadSwapConnectorID装载电池
29、包的充电单元编码Y字符串28 字符换电站 IDSwapStationID运营商自定义的换电站唯一编码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6 位）Y字符串21 字符换电开始时间SwapStartTime格式：yyyy-MM-dd HH:mm:ssY字符串24 字符换电结束时间SwapEndTime格式：yyyy-MM-dd HH:mm:ssY字符串24 字符订单里程ApplyMileage订单里程Y浮点型保留小数点后 3 位车牌号LicensePlateNumber换电车辆车牌号Y字符串12 字符换电费用SwapSwap换电单笔订单总费用Y浮点型保留小数点后 3 位本次
30、换电电量SwapPower换电电量Y浮点型保留小数点后 3 位7 数据传输接口7.1 推送换电站运营商信息接口11DB50/T 15082023 7.1.1 概述用于推送换电站运营商的基础信息。7.1.2 接口定义接口定义如下：a)接口名称：operator_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：按需推送。7.1.3 输入参数输入参数见表 12。表12 推送换电站运营商信息的输入参数参数名称字段参数类型描述接口标志InterfaceFlag整型接口标志，此标志标记接口类型1：新增；2：修改；3：删除换电站运营商信息SwapOperatorInfo字符串
31、类型“SwapOperatorInfo”，见 7.17.1.4 返回值推送换电站运营商信息的返回值见表 13。表13 推送换电站运营商信息的返回值参数名称字段参数类型描述运营商 IDSwapOperatorID字符串换电设备运营商 ID 使用统一社会信用代码操作结果Status整型0：成功；1：失败失败原因FailReason字符串失败原因7.2 推送换电站信息接口7.2.1 概述用于推送换电站的信息，包含换电站的基本信息、服务信息、支付信息等。7.2.2 接口定义接口定义如下：a)接口名称：swap_station_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频
32、率：按需推送。7.2.3 输入参数输入参数具体内容见表 14。DB50/T 15082023 12 表14 推送换电站信息的输入参数参数名称字段必填参数类型描述接口标志InterfaceFlag是整型接口标志，此标志标记接口类型1：新增；2：修改；3：删除换电站信息SwapStationInfo是字符串类型“SwapStationInfo”，见 7.27.2.4 返回值返回值见表 15。表15 推送换电站信息的返回值参数名称字段必填参数类型描 述换电站 IDSwapStationID否字符串运营商自定义的换电站唯一编码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6位）操作结果
33、Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.3 推送换电站充电架信息接口7.3.1 概述用于推送换电站充电架信息。7.3.2 接口定义接口定义如下：a)接口名称：swap_system_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：按需推送。7.3.3 输入参数输入参数见表 16。表16 推送换电站充电架信息的输入参数参数名称字段必填参数类型描述接口标志InterfaceFlag是整型接口标志，此标志标记接口类型 1：新增；2：修改；3：删除充电架信息SwapSystemInfo否字符串类型“SwapSystemInf
34、o”，见 7.2.17.3.4 返回值推送换电站充电架信息接口的主要返回值为操作状态，失败原因。返回值见表 17。13DB50/T 15082023 表17 换电站充电架（系统）信息接口返回值参数名称字段必填参数类型描述充电架 IDSwapSystemID是字符串换电站 ID+运营商自定义 2 位操作结果Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.4 推送换电站最小充电单元信息7.4.1 概述此接口用于推送换电站最小充电单元信息。7.4.2 接口定义接口定义如下：a)接口名称：swap_connector_info；b)接口使用方法：平台实现此接口，换
35、电站运营商服务系统调用；c)频率：按需推送。7.4.3 输入参数具体内容见表 18。表18 推送换电站最小充电单元信息的输入参数参数名称字段必填参数类型描述接口标志InterfaceFlag是整型接口标志，此标志标记接口类型1：新增；2：修改；3：删除充电单元信息SwapConnectorInfo是字符串类型“SwapConnectorInfo”，见 7.2.27.4.4 返回值推送换电站信息接口的主要返回值为操作状态，失败原因。返回值见表 19。表19 推送换电站信息的返回值参数名称字段必填参数类型描述充电单元 IDSwapConnectorID是字符串换电站内最小充电单元唯一识别编码(换电
36、站 ID+自定义 7 位)操作结果Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.5 推送电池包信息7.5.1 概述用于对电池包进行描述，包含设备编码、设备型号、设备生产日期、设备类型等详细定义见表 20。7.5.2 接口定义DB50/T 15082023 14 接口定义如下：a)接口名称：battery_pack_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：按需推送。7.5.3 输入参数输入参数见表 20。表20 推送电池包信息的输入参数参数名称字段必填参数类型描述接口标志InterfaceFlag是整型接口标志，此标
37、志标记接口类型1：新增；2：修改；3：删除电池包信息batteryPackInfo是字符串类型“batteryPackInfo”，见 7.37.5.4 返回值推送电池包信息接口的主要返回值有操作结果和失败原因，具体内容见表 21。表21 推送电池包信息的返回值参数名称字段必填参数类型描述电池包编码PackVin是字符串电池系统唯一识别号操作结果Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.6 换电站状态数据7.6.1 概述此接口用于推送换电站状态数据。7.6.2 接口定义接口定义如下：a)接口名称：swap_station_status_infob)接口
38、使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：30s/次。7.6.3 输入参数推送换电站状态数据主要输入参数为换电站 ID、可用电池包数量，具体内容见表 22。表22 推送换电站状态数据的输入参数参数名称字段必填参数类型描述换电站状态信息SwapStationStatusInfo是字符串类型“SwapStationStatusInfo”，见 7.47.6.4 返回值15DB50/T 15082023 推送换电站状态数据接口的主要返回值为换电操作结果和失败原因，具体内容见表 23。表23 推送换电站状态数据的返回值参数名称字段必填参数类型描述换电站 IDSwapStationID
39、是字符串运营商自定义的换电站唯一编码（运营商组织机构编码 9 位+区域编码 6 位+运营商自定义 6 位）操作结果Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.7 充电单元状态数据7.7.1 概述用于推送换电站内充电单元当前状态数据。7.7.2 接口定义接口定义如下：a)接口名称：swap_connector_status_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：15min/次。7.7.3 输入参数推送换电单元状态数据主要输入参数为换电站 ID、充电单元状态，具体内容见表 24。表24 推送充电单元状态数据的输入参
40、数参数名称定义必填参数类型描述充电单元状态信息SwapConnectorStatusInfo是字符串类型“SwapConnectorStatusInfo”，见 7.57.7.4 返回值推送充电单元状态数据接口的主要返回值为操作结果和失败原因，具体内容见表 25。表25 推送充电单元站状态数据的返回值参数名称定义必填参数类型描述充电单元 IDSwapConnectorID是字符串换电站内充电单元唯一识别编码(换电站 ID+自定义 7位)操作结果Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.8 推送电池包状态数据7.8.1 概述接口用于设备归属运营商平台向运
41、营商服务平台推送电池包的状态数据。DB50/T 15082023 16 7.8.2 接口定义接口定义如下：a)接口名称：battery_pack_status_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)15min/次。7.8.3 输入参数推送电池包状态数据接口的主要输入参数见表 26。表26 推送电池包状态数据的输入参数参数名称字段必填参数类型描述电池包状态信息BatteryPackStatusInfo是字符串类型“BatteryPackStatusInfo”，见 7.67.8.4 返回值推送电池包状态数据接口的主要返回值为电池包编码、操作结果和失败原因，具体内
42、容见表 27。表27 推送电池包状态数据的返回值参数名称字段必填参数类型描 述电池包编码PackVin是字符串电池系统唯一识别号操作结果Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.9 推送电池包报警信息7.9.1 概述接口用于推送电池包报警信息。7.9.2 接口定义接口定义如下：a)接口名称：battery_pack_alarm；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：实时。7.9.3 输入参数推送电池包报警信息接口的主要输入参数为电池包编码、报警开始时间、报警结束时间、报警类型、报警等级、备注，具体内容见表 28。表28
43、 推送电池包报警信息的输入参数参数名称字段必填参数类型描述电池报警编码BatteryPackAlarmInfo是字符串类型“BatteryPackAlarmInfo”，见 7.717DB50/T 15082023 7.9.4 返回值推送电池包报警信息接口的主要返回值为电池包编码、操作结果和失败原因，具体内容见表 29。表29 推送电池包报警信息的返回值参数名称字段必填参数类型描 述电池包编码PackVin是字符串电池系统唯一识别号操作结果Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.10 推送电池包统计数据7.10.1 概述此接口用于设备归属运营商平台向
44、运营商服务平台推送电池包累计数据。7.10.2 接口定义接口定义如下：a)接口名称：battery_pack_cumulative_data_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：天/次。7.10.3 输入参数推送电池包累计数据接口的主要输入参数为电池包编码、当前累计总充电量、当前累计总充电电荷量、累计里程、统计时间、备注，具体内容见表 30。表30 推送电池包累计数据的输入参数参数名称字段必填参数类型描述电池包统计数据batteryPackCumulativeDataInfo是字符串类型“batteryPackCumulativeDataInfo”，
45、见 7.87.10.4 返回值推送电池包累计数据接口的主要返回值为电池包编码、操作结果和失败原因，具体内容见表 31。表31 推送电池包累计数据的返回值参数名称字段必填参数类型描述电池包编码PackVin是字符串电池系统唯一识别号操作结果Status是字符串0：成功；1：失败失败原因FailReason是字符串失败原因7.11 推送换电订单数据7.11.1 概述接口用于推送换电订单数据。DB50/T 15082023 18 7.11.2 接口定义接口定义如下：a)接口名称：power_exswap_order_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；d)频率：实时
46、。7.11.3 输入参数推送换电订单数据接口的主要输入参数为换下电池包编码、装载电池包编码、换电站 ID、换电时间、申请里程、车牌号、换电费用、本次换电电量，具体内容见表 32。表32 推送换电订单数据的输入参数参数名称字段必填参数类型描述换电订单信息PowerExswapOrderInfo是字符串类型“PowerExswapOrderInfo”，见 7.97.11.4 返回值推送换电订单数据接口的主要返回值为换电订单编号、操作结果和失败原因，具体内容见表 33。表33 推送换电订单数据的返回值参数名称字段必填参数类型描述换电订单编号OrderID是字符串订单唯一标识操作结果Status是字符
47、串0：成功；1：失败失败原因FailReason是字符串失败原因7.12 实时负荷调控7.12.1 概述用于描述需求响应实时负荷调控指令下发。7.12.2 接口定义接口定义如下：a)接口名称：pile_command；b)接口使用方法：换电站运营商服务系统实现此接口，平台调用。7.12.3 输入参数实时负荷调控的主要输入参数为控制类型、控制对象类型、范围内编号、目标功率值列表，具体内容见表34。19DB50/T 15082023 表34 实时负荷调控指令参数参数名称字段必填参数类型描述调度编号DispatchSeq 是字符串每次调控事件的编号，具体定义：年月日+事件类型一位，默认 0 后续扩展
48、)+调度模式+序列(3 位，从 001 开)如:2022051100001 代表事件时间:2022 年 5 月 11 日事件类型:0 需求响应，调度模式:0 立即调控，序列:001。调度模式DispatchModel 是整型0：立即调控；1：预约调控调度类型DispatchType 是整型0：调控开始；1：调控结束；2：取消预约发送时间DateTime是字符串举例：2020-04-09 12:29:30事件类型EventType是整型0：需求响应1：辅助调峰当前调控只支持推送：0-需求响应控制对象类型TargetType是整型1：站；9：平台范围内编号TargetID否字符串控制对象唯一识别编
49、码，如果控制对象类型为平台时，此字段为运营商平台组织机构编码。如果控制对象类型为站时，此字段为换电站站点编码调控开始时间DispatchStartTime是字符串格式：yyyy-MM-dd HH:mm:ss调控结束时间DispatchEndTime是字符串格式：yyyy-MM-dd HH:mm:ss时段数 N SumPeriod 是整型范围：1-96，至少为 1 个，等于调度具体对象的数量调度具体对象OperDates 是OperDates数据如果调度模式为预约调控，则分段时间必须是【调控开始时间，调控结束时间】的范围分割，前序调控结束时间等于后续的调控开始时间；调控结束时间与开始时间间隔至少
50、需要 15 分钟，同时，每个时间段的间隔需要相同表35 调度对象信息参数名称字段必填参数类型描述开始时间DetailStartTime 否字符串格式：yyyy-MM-dd HH:mm:ss 结束时间DetailEndTime 否字符串格式：yyyy-MM-dd HH:mm:ss 功率OperPower 是浮点型需要调整执行压降的功率值，单位 kW，小数点后三位DB50/T 15082023 20 7.12.4 返回值实时负荷调控指令接口的主要返回值为结果、操作结果信息，具体内容见表 36。表36 实时负荷调控指令返回值参数名称字段必填参数类型描述操作结果OperResult是布尔值操作结果信息
