DB50-T 1508-2023 新能源汽车与充电基础设施监测平台 换电设施信息接入技术规范

ICS35.200CCSL65DB50重庆市市场监督管理局发布IDB50/T1508—2023 2规范性引用文件 3术语和定义 4功能描述 5数据接入传输协议过程 6换电设施数据信息 7数据传输接口 8换电设施数据传输体系 9平台认证要求 10密钥的管理和使用 附录A（规范性）平台认证接口规范 附录B（规范性）数据加解密方式 附录C（规范性）HMAC-MD5参数签名方式 28DB50/T1508—2023本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由重庆市经济和信息化委员会提出、归口和组织实施。本文件起草单位：国网重庆市电力公司营销服务中心、重庆市质量和标准化研究院、中国汽车工程研究院股份有限公司、重庆易易新能源科技有限公司、重庆奥动新能源科技有限公司、重庆峘能电动车科技有限公司、重庆市环卫集团有限公司、重庆电子工程职业学院。本文件主要起草人：徐婷婷、吴高林、胡晓锐、龙方家、龙羿、汪会财、朱彬、池磊、鲁波、张程、姚波、刘发超、王涵、陈卫、彭朋梅、徐慧娴、李智、孙正凯、李玉兰、张永瑜、易力峥。DB50/T1508—20231新能源汽车与充电基础设施监测平台换电设施信息接入技术规范本文件规定了新能源汽车与充电基础设施监测平台换电设施信息接入规范，涵盖换电设施数据信息、换电设施数据传输接口、换电设施数据传输体系、平台认证要求、密钥的管理和使用等相关要求。本文件适用于新能源汽车与充电基础设施监测平台换电设施信息接入。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T2260-2007中华人民共和国行政区划代码GB/T7408-2005数据元和交换格式信息交换日期和时间表示法GB/T20271-2006信息安全技术信息系统通用安全技术要求。GB/T22239-2019信息安全技术网络安全等级保护基本要求。GB/T25070-2019信息安全技术网络安全等级保护安全设计技术要求。GB/T29317-2021电动汽车充换电设施术语NB/T33007-2013电动汽车换电站/电池更换站监控系统与充换电设施通信协议3术语和定义下列术语和定义适用于本文件。3.1换电站batteryswapstation为换电型电动汽车的动力电池提供电能的场所。3.2换电站充电设备chargingequipmentforbatteryswapstation换电站中为动力电池充电的设备。3.3新能源汽车与充电基础设施监测平台newenergyvehiclesandcharginginfrastructuremonitoringplatform对电动汽车、充换电设施数据进行采集、存储、处理、分析，实现电动汽车与充换电设施的监测，并提供服务的平台，以下简称平台。DB50/T1508—202324功能描述换电站信息接口应支持以下功能：a)获取换电站信息：支持数据需求方查询换电站运营商的信息，应支持全部查询和增量查询的方b)同步换电站运营状态：支持换电站运行状态同步到数据需求方；c)查询换电站统计信息：支持数据需求方査询换电站运行情况的统计信息；d)推送换电订单信息：同步换电站中订单数据到数据需求方。5数据接入传输协议过程当服务请求方使用http发起一个请求时，应用层、传输层、网络层和链路层的相关协议依次对该请求进行包装，最终在链路层生成以太网数据包，以太网数据包通过物理介质传输给对方主机，服务接受方接收到数据包以后，然后再逐层采用对应的协议进行拆包，最后把应用层数据交给应用程序处理。平台通信协议栈如图2所示。图1平台通信协议栈6换电设施数据信息6.1换电站运营商信息用于描述换电设备运营商的基础信息，定义见表1。DB50/T1508—20233表1换电站运营商信息YYYY换电运营商电话2运营商客服电话2（技术人员或者平台N址YN6.2换电站信息用于描述换电站的信息，包含换电站的基本信息、服务信息、支付信息等，详见表2。表2换电站信息YYYYY—YYNYDB50/T1508—20234表2换电站信息（续））；）；）；）；Y—Y—YYY—N—N营业时间描述格式“HH:mm-HH:mm”NNNNNDB50/T1508—202356.2.1换电站充电架信息用于描述换电站中充电架信息，详见表3。表3换电站充电架信息NNN N NNNNNN6.2.2换电站充电单元信息用于描述换电站中充电单元信息，详见表4。表4换电站充电单元信息YYNY N6.3电池包信息对电池包的描述，包含设备编码、设备类型、设备生产日期等，详见表5。表5电池包信息YYDB50/T1508—20236表5电池包信息（续）Y—Y—Y保留小数点后3位Y保留小数点后3位Y保留小数点后3位Y保留小数点后3位Y保留小数点后3位Y保留小数点后3位Y保留小数点后3位Y保留小数点后3位YYY保留小数点后3位Y保留小数点后3位YY—Y 6.4换电站状态数据用于描述换电站当前状态数据，详细定义见表6。DB50/T1508—20237表6换电站状态数据营商组织机构编码9位+区域编码6YYY—Y—Y Y 和Y—Y—N6.5充电单元状态数据用于描述换电站内充电单元当前状态数据，详细定义见表7。表7充电单元状态数据YY）；）；Y—Y—N6.6电池包状态数据用于描述电池包状态数据，详细定义见表8。DB50/T1508—20238表8电池包状态数据YYY YYNY保留小数点后3位N保留小数点后3位Y保留小数点后3位Y保留小数点后3位Y保留小数点后3位Y保留小数点后3位YYYYY保留小数点后3位Y保留小数点后3位Y保留小数点后3位DB50/T1508—20239表8电池包状态数据（续）Y保留小数点后3位Y保留小数点后3位Y—Y N6.7电池包报警信息用于描述电池包的报警信息，报警开始时上传报警开始信息，结束时上传报警结束信息。详见表9。表9电池包报警信息YYYYpeYYY N6.8电池包统计数据DB50/T1508—2023用于描述电池包统计数据，详细定义见表10。表10电池包统计数据YYNYYN6.9换电订单数据用于描述换电订单数据，详细定义见表11。表11换电订单数据YYYDYUploadSwapConnectorYYYYY保留小数点后3位YY保留小数点后3位Y保留小数点后3位7数据传输接口7.1推送换电站运营商信息接口DB50/T1508—20237.1.1概述用于推送换电站运营商的基础信息。7.1.2接口定义接口定义如下：a)接口名称：operator_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：按需推送。7.1.3输入参数输入参数见表12。表12推送换电站运营商信息的输入参数SwapOperatorInfo7.1.4返回值推送换电站运营商信息的返回值见表13。表13推送换电站运营商信息的返回值7.2推送换电站信息接口7.2.1概述用于推送换电站的信息，包含换电站的基本信息、服务信息、支付信息等。7.2.2接口定义接口定义如下：a)接口名称：swap_station_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：按需推送。7.2.3输入参数输入参数具体内容见表14。DB50/T1508—2023表14推送换电站信息的输入参数是SwapStationInfo是7.2.4返回值返回值见表15。表15推送换电站信息的返回值否机构编码9位+区域编码6位+运营商自定义6是是7.3推送换电站充电架信息接口7.3.1概述用于推送换电站充电架信息。7.3.2接口定义接口定义如下：a)接口名称：swap_system_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：按需推送。7.3.3输入参数输入参数见表16。表16推送换电站充电架信息的输入参数是SwapSystemInfo否7.3.4返回值推送换电站充电架信息接口的主要返回值为操作状态，失败原因。返回值见表17。DB50/T1508—2023表17换电站充电架（系统）信息接口返回值是是是7.4推送换电站最小充电单元信息7.4.1概述此接口用于推送换电站最小充电单元信息。7.4.2接口定义接口定义如下：a)接口名称：swap_connector_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：按需推送。7.4.3输入参数具体内容见表18。表18推送换电站最小充电单元信息的输入参数是SwapConnectorInfo是7.4.4返回值推送换电站信息接口的主要返回值为操作状态，失败原因。返回值见表19。表19推送换电站信息的返回值是是是7.5推送电池包信息7.5.1概述用于对电池包进行描述，包含设备编码、设备型号、设备生产日期、设备类型等详细定义见表20。7.5.2接口定义DB50/T1508—2023接口定义如下：a)接口名称：battery_pack_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：按需推送。7.5.3输入参数输入参数见表20。表20推送电池包信息的输入参数是整型batteryPackInfo是7.5.4返回值推送电池包信息接口的主要返回值有操作结果和失败原因，具体内容见表21。表21推送电池包信息的返回值是是是7.6换电站状态数据7.6.1概述此接口用于推送换电站状态数据。7.6.2接口定义接口定义如下：a)接口名称：swap_station_status_infob)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：30s/次。7.6.3输入参数推送换电站状态数据主要输入参数为换电站ID、可用电池包数量，具体内容见表22。表22推送换电站状态数据的输入参数SwapStationStatusInfo是类型“SwapStationStatusInfo”，见返回值DB50/T1508—2023推送换电站状态数据接口的主要返回值为换电操作结果和失败原因，具体内容见表23。表23推送换电站状态数据的返回值是是是7.7充电单元状态数据7.7.1概述用于推送换电站内充电单元当前状态数据。7.7.2接口定义接口定义如下：a)接口名称：swap_connector_status_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：15min/次。7.7.3输入参数推送换电单元状态数据主要输入参数为换电站ID、充电单元状态，具体内容见表24。表24推送充电单元状态数据的输入参数SwapConnectorStatusInfo是类型“SwapConnectorStatusInfo”，见返回值推送充电单元状态数据接口的主要返回值为操作结果和失败原因，具体内容见表25。表25推送充电单元站状态数据的返回值是是是7.8推送电池包状态数据7.8.1概述接口用于设备归属运营商平台向运营商服务平台推送电池包的状态数据。DB50/T1508—20237.8.2接口定义接口定义如下：a)接口名称：battery_pack_status_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)15min/次。7.8.3输入参数推送电池包状态数据接口的主要输入参数见表26。表26推送电池包状态数据的输入参数BatteryPackStatusInfo是7.8.4返回值推送电池包状态数据接口的主要返回值为电池包编码、操作结果和失败原因，具体内容见表27。表27推送电池包状态数据的返回值是是是7.9推送电池包报警信息7.9.1概述接口用于推送电池包报警信息。7.9.2接口定义接口定义如下：a)接口名称：battery_pack_alarm；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：实时。7.9.3输入参数推送电池包报警信息接口的主要输入参数为电池包编码、报警开始时间、报警结束时间、报警类型、报警等级、备注，具体内容见表28。表28推送电池包报警信息的输入参数BatteryPackAlarmInfo是DB50/T1508—20237.9.4返回值推送电池包报警信息接口的主要返回值为电池包编码、操作结果和失败原因，具体内容见表29。表29推送电池包报警信息的返回值是是是7.10推送电池包统计数据7.10.1概述此接口用于设备归属运营商平台向运营商服务平台推送电池包累计数据。7.10.2接口定义接口定义如下：a)接口名称：battery_pack_cumulative_data_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)频率：天/次。7.10.3输入参数推送电池包累计数据接口的主要输入参数为电池包编码、当前累计总充电量、当前累计总充电电荷量、累计里程、统计时间、备注，具体内容见表30。表30推送电池包累计数据的输入参数iveDataInfo是7.10.4返回值推送电池包累计数据接口的主要返回值为电池包编码、操作结果和失败原因，具体内容见表31。表31推送电池包累计数据的返回值是是是7.11推送换电订单数据7.11.1概述接口用于推送换电订单数据。DB50/T1508—20237.11.2接口定义接口定义如下：a)接口名称：power_exswap_order_info；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；d)频率：实时。7.11.3输入参数推送换电订单数据接口的主要输入参数为换下电池包编码、装载电池包编码、换电站ID、换电时间、申请里程、车牌号、换电费用、本次换电电量，具体内容见表32。表32推送换电订单数据的输入参数fo是7.11.4返回值推送换电订单数据接口的主要返回值为换电订单编号、操作结果和失败原因，具体内容见表33。表33推送换电订单数据的返回值是是是7.12实时负荷调控7.12.1概述用于描述需求响应实时负荷调控指令下发。7.12.2接口定义接口定义如下：a)接口名称：pile_command；b)接口使用方法：换电站运营商服务系统实现此接口，平台调用。7.12.3输入参数实时负荷调控的主要输入参数为控制类型、控制对象类型、范围内编号、目标功率值列表，具体内容见表34。DB50/T1508—2023表34实时负荷调控指令参数是每次调控事件的编号，具体定义：年月日+事件类型《一位，默认0后续扩展)+调度模式+序列(3位，从001开)是是是是是否是是是是表35调度对象信息否否是DB50/T1508—20237.12.4返回值实时负荷调控指令接口的主要返回值为结果、操作结果信息，具体内容见表36。表36实时负荷调控指令返回值是—是7.13需求响应确认信息下发7.13.1概述接口用于向参与需求响应换电站运营商服务系统下发需求响应确认信息。7.13.2接口定义接口定义如下：a)接口名称：confirm_msg；b)接口使用方法：换电站运营商服务系统实现此接口，平台调用；c)调用频率：按实际需求响应调用。7.13.3输入参数输入参数定义见表37。表37需求响应确认信息输入参数YYYY换电站信息表见表38表38需求响应换电站信息表YNNNNNNDB50/T1508—20237.13.4返回值返回值定义见表39。表39需求响应确认信息下发返回值YY7.14需求响应确认信息反馈7.14.1概述接口用于参与需求响应的换电站运营商服务系统向平台反馈响应情况。7.14.2接口定义接口定义如下：a)接口名称：confirm_msg_resp；b)接口使用方法：平台实现此接口，换电站运营商服务系统调用；c)调用频率：按实际需求响应调用。7.14.3输入参数输入参数定义见表40。表40需求响应确认信息输入参数YY7.14.4返回值返回值定义见表41。表41需求响应确认信息返回值YY8换电设施数据传输体系8.1数据传输一般流程DB50/T1508—2023换电设施数据接入应符合GB/T9387.1中关于会话连接的要求，一般需要经过平台认证、请求和应答3个步骤。8.2数据传输接口8.2.1所有数据传输接口均应采用HTTP(S)接口，每个接口的URL均采用http(s)://[域名]/evcs/v[版本号]/[接口名称]格式定义，其中：a)域名：接入运营商域名；b)版本号：代表接口版本号，不同的版本地址对应相应版本代码。系统升级期间，新旧版本可同时存在，待所有接入方都切换到新接口，旧版本接口即可下线。从而达到平滑升级的目的；c)接口名称：所请求/调用接口的名称，具体接口名称见T/CEC102.2-2016和T/CEC102.3-2016。8.2.2为保证各接口的功能明确清晰，每个URL只允许对应一种功能。8.3接口调用方式接口均应使用HTTP(S)/POST方式传输参数，采用JSON的方式，传输过程中应包含消息头和消息主体两部分。8.4消息头规范8.4.1消息头一般需包含内容类型和授权信息（Authorization）。8.4.2内容类型（ContentType）字段用于标识请求中的消息主体的编码方式，信息交换内容均应采用JSON的方式，参数信息采用UTF-8编码，应配置消息头中的ContentType为application/json；charset=UTF-8。8.4.3授权信息（Authorization）字段用于证明客户端有权查看某个资源，授权信息采用令牌（Token）的方式，应配置消息头中的Authorization为BearerToken。8.5消息主体规范8.5.1服务申请一般由运营商标识（OperatorID）、参数内容（Data）、时间戳（REQTimeStamp）、自增序列（Seq）和数字签名（Sig）组成，具体要求见表42。表42消息主体内容表——8.5.2参数返回数据传输接口的返回参数一般由返回值（Ret）、返回信息（Msg）、参数内容（Data）和数字签名（Sig）组成，其中：DB50/T1508—2023a)Ret:必填字段，返回参数编码应符合表43的规定；b)Msg:必填字段，有错误表示具体错误信息，无错误返回成功信息；c)Data:参数内容，返回参数应符合T/CEC102.2-2016和T/CEC102.3-2016的规定，数据应采用UTF-8编码，JSON格式。表43返回参数编码表08.6批量数据传输数据传输接口中的Data字段可为数组型的JSON格式，数据发送方可通过该字段实现批量数据的传输。9平台认证要求9.1基本要求9.1.1换电设施数据接入应符合国家信息安全等级保护要求。9.1.2换电设施数据接入应具备平台认证服务提供平台之间的鉴权认证功能。平台之间在信息交换前，需完成平台认证，获得平台交换能力。9.1.3换电平台运营商应建立严格的系统安全保密机制，保障信息交换接口安全、稳定、可靠地运行。系统安全及保密应满足以下要求：a)采用身份认证、访问控制、数据加密、数字签名等安全措施；b)采用安全可靠并且普遍使用的加密算法；c)密钥的存贮和交易信息的加密／解密在安全的环境中；d)数据安全保密应遵循国家和行业标准；e)能定期或应对突发进行密钥更新和启用；f)具备对报文做来源正确性鉴别的机制（HMAC）。9.2平台认证方法9.2.1平台认证应采取身份认证和访问控制相结合方式，相关流程见图3。身份认证可采取用户名/口令认证、密钥认证或数字证书认证等方式；访问控制可采取IP访问控制、时间访问控制等多种结合手段。DB50/T1508—20239.2.2用户身份认证成功后授予Token，每次向服务端请求资源时应带着服务端签发的Token，服务端验证Token成功后，才返回请求的数据。Token的有效期由服务方确定，最长不应超过7天，Token丢失或失效后应再次发起认证服务。认证接口规范见附录A。图2平台认证方式10密钥的管理和使用10.1基本要求10.1.1运营商应符合GB/T25070-2019、GB/T20271-2006、GB/T22239-2019中关于数据安全传输控制要求。10.1.2运营商应提供严格的系统安全保密机制，保障信息交换接口安全、稳定、可靠地运行，包括信息的存取控制、应用系统操作的安全等。10.1.3密码算法用于密钥的产生、分发、HMAC以及加密等安全功能，相关的算法模块在其生命周期内不应被修改、导出至安全环境外部。10.1.4指定功能的密钥仅能做指定功能使用，不应被其他任何功能使用。10.2密钥的分类每个运营商交互前应分配运营商标识、运营商密钥、消息密钥、消息密钥初始化向量和签名密钥。在每个运营商交互前应分配运营商标识、运营商密钥、消息密钥、消息密钥初始化向量和签名密钥。并应符合下列要求：a)运营商标识（OperatorID）:固定18位，运营商的统一社会信用代码，作为运营商的唯一标b)运营商密钥（OperatorSecret）:可采用16H、32H、48H和64H，由0-F字符组成，为申请认证使用；c)消息密钥（DataSecret）:可采用16H、32H、48H和64H，由0-F字符组成，用于对所有接口中Data信息进行加密；d)消息密钥初始化向量（DataSecretIV）：固定16位，用户AES加密过程的混合加密；DB50/T1508—2023e)签名密钥（SigSecret）:可采用16H、32H、48H和64H，由0-F字符组成，为签名的加密密钥。10.3密钥的管理10.3.1密钥的产生数据密钥应具备随机产生特性，密钥产生后应检查密钥的有效性，弱密钥和半弱密钥应被剔除。主密钥产生的16个子密钥都相同，该密钥就是弱密钥；如果一个主密钥在16轮中只产生两个不同的子密钥，每个被使用8次，这个主密钥就是半弱密钥。运营商加入信息交换时，应申请独立的密钥文件，密钥可由运营商产生。10.3.2密钥的分发密钥的分发应由安全方式进行，可通过线下分发、联机报文或数字信封的方式加密传输。10.3.3密钥的存储密钥宜保存在硬件加密机内。如果出现在硬件加密机外，则密钥应以密文方式出现。密钥注入、密钥管理和密钥档案的保管应由专人负责。使用密钥和销毁密钥应在监督下进行，并有使用、销毁记录。10.3.4密钥的销毁当新密钥产生后，生命期结束的旧密钥应从数据库和内存中清除，防止被替换使用；同时所有可能重新构造此密钥的信息也应清除。10.4密钥的使用10.4.1数据的加解密处理消息发送方应对Data字段中涉及交易及隐私等数据，利用消息密钥（DataSecret）进行加密。消息接收方收到消息之后，根据消息密钥（DataSecret）对消息体中的Data数据进行解密，校验参数合法性等后续业务处理。具体加解密方法和示例见附录B。10.4.2参数签名规范参数签名采用HMAC-MD5算法，采用MD5作为散列函数，通过签名密钥（SigSecret）对整个消息主体进行加密，然后采用MD5信息摘要的方式形成新的密文，参数签名应大写。参数签名顺序按照消息体顺序拼接后执行，入参拼接顺序为运营商标识（OperatorID）、参数内容（Data）、时间戳（REQTimeStamp）、自增序列（Seq），出参拼接顺序为返回值（Ret）、返回信息（Msg）、参数内容（Data）。HMAC-MD5具体参数签名方法和示例见附录CDB50/T1508—2023（规范性）平台认证接口规范A.1概述用于平台之间认证Token的申请，Token作为全局唯一凭证，调用各接口时均需要使用。A.2接口定义接口定义如下：a)接口名称：query_token；b)接口使用方法：由服务端实现此接口，由需求端调用。A.3输入参数输入参数具体如表A.1所示。表A.1平台认证输入参数表A.4返回值返回值如表A.2所示。表A.2平台认证返回值表DB50/T1508—2023（规范性）数据加解密方式B.1数据加解密方法数据传输的加密使用对称加密算法AES128位加密，加密模式采用CBC，填充模式采用PKCS5Padding方式。B.2数据加解密示例数据加解密示例如下：a)示例密钥：1234567890abcdef；b)示例初始向量：1234567890abcdef；c)示例明文信息：{"total":1，"stationStatusInfo":{"operationID":"123456789"，"stationID":"111111111111111"，"connectorStatusInfos":{"connectorID":1，"equipmentID":"10000000000000000000001"，"status":4，"currentA":0，"currentB":0，"currentC":0，"voltageA":0，"voltageB":0，"voltageC":0，"soc":10，}}}；d)示例秘文：il7B0BSEjFdzpyKzfOFpvg/Se1CP802RItKYFPfSLRxJ3jf0bVl9hvYOEktPAYW2nd7S8MBcyHYyacHKbISq5iTmDzG+ivnR+SZJv3USNTYVMz9rCQVSxd0cLlqsJauko79NnwQJbzDTyLooYoIwz75qBOH2/xOMirpeEqRJrF/EQjWekJmGk9RtboXePu2rka+Xm51s