互联互通入口方配置指南

功能概述

入口方案是指通过互联互通机制接入其他平台的充电站点。通过配置入口方案，您可以将其他平台的充电站点接入到本平台，使本平台用户可以使用其他平台的充电桩，从而扩大平台服务范围，提升用户体验。

前置配置：互联互通秘钥

在创建入口方案之前，需要先配置互联互通秘钥。秘钥用于确保与其他平台进行安全的数据交互。

配置步骤

1. 进入互联互通秘钥管理页面

   • 在导航栏中选择"互联互通秘钥"标签页

2. 新增秘钥配置

   • 点击"新增"按钮，填写以下信息：
     • 类型：选择"入口方"
     • 运营商：选择或输入运营商名称
     • 组织机构代码：输入合作方的组织机构代码
     • 秘钥：配置用于数据交互的秘钥
     • 签名秘钥：配置用于数据签名的秘钥
     • 数据加密秘钥：配置用于数据加密的秘钥
     • 初始化向量：配置加密算法的初始化向量
     • UAT互联互通测试url地址：配置测试环境的接口地址
     • 我们的组织机构代码（可选）：输入本平台的组织机构代码
     • 我们的秘钥（可选）：输入本平台的秘钥
     • 我们的签名秘钥（可选）：输入本平台的签名秘钥
     • 我们的数据加密秘钥（可选）：输入本平台的数据加密秘钥
     • 我们的初始化向量（可选）：输入本平台的初始化向量
     • 我们的UAT互联互通测试url地址（可选）：输入本平台的测试环境接口地址

3. 保存配置

   • 点击"确定"保存配置
   • 配置完成后，可以在列表中查看、编辑或删除秘钥信息

入口方案管理

创建入口方案

1. 进入入口方案管理页面

   • 在导航栏中选择"入口方案"标签页

2. 点击新增按钮

   • 点击页面上的"新增"按钮，打开入口方案编辑对话框

3. 填写方案信息

   • 运营商（必填）：选择已配置的运营商
   • 关联秘钥（必填）：选择已配置的互联互通秘钥
   • 方案名称（必填）：输入方案的名称，用于标识该入口方案
   • 定价类型（必填）：选择定价类型
     • 折扣：在运营商推送价格基础上进行打折
     • 固定差额：在运营商推送价格基础上，每度上调或下调固定金额
   • 电费折扣(%)（定价类型为"折扣"时必填）：输入电费折扣百分比，例如：80 表示80%折扣
   • 服务折扣(%)（定价类型为"折扣"时必填）：输入服务费折扣百分比，例如：80 表示80%折扣
   • 电费调价(度/元)（定价类型为"固定差额"时必填）：输入电费每度的调价金额，例如：+0.01 表示每度上调0.01元
   • 服务费调价(度/元)（定价类型为"固定差额"时必填）：输入服务费每度的调价金额，例如：+0.01 表示每度上调0.01元
   • 开始时间（必填）：选择方案生效的开始日期
   • 结束时间（必填）：选择方案失效的结束日期

4. 保存方案

   • 点击"确定"按钮保存配置
   • 点击"取消"按钮放弃保存

编辑入口方案

1. 查找方案

   • 在搜索区域可以通过"方案名称"、"运营商"和"状态"筛选入口方案
   • 点击"搜索"按钮执行查询
   • 点击"重置"按钮清空筛选条件

2. 编辑方案

   • 在操作列点击"编辑"按钮
   • 在编辑对话框中修改方案信息
   • 点击"确定"保存修改

方案状态管理

入口方案支持以下状态操作：

• 启用：激活入口方案，使方案生效
• 停止：手动停止入口方案，方案将不再生效
• 删除：删除入口方案（请谨慎操作）

同步操作

入口方案支持以下同步操作（在操作列的"更多"下拉菜单中）：

• 同步站点：同步其他平台的充电站点信息到本平台
• 同步计费：同步其他平台的计费信息到本平台
• 同步状态：同步其他平台的设备实时状态到本平台

定价类型说明

折扣类型

• 在运营商推送价格基础上进行打折
• 折扣价格设置，即在运营商推送价格基础上进行打折，仅保留4位小数，其他舍弃
• 示例：电站推送价格为1.1291元/度，折扣为80%，计算后价格为0.90328元/度，该电站在平台的基础价格为0.9032元/度

固定差额类型

• 在运营商推送价格基础上，每度上调或下调固定金额
• 固定差额设置，即在运营商推送价格基础上，每度上调、下调固定金额，精确到2位小数
• 示例：电站推送电费价格为1.1291元/度，设置调价+0.01每度，该电站在平台的基础电价为1.1391元/度

注意事项

1. 创建入口方案前，请确保已正确配置互联互通秘钥（类型选择"入口方"）
2. 方案的有效期由开始时间和结束时间决定，超出有效期后方案将自动失效
3. 定价类型选择后，需要填写对应的价格参数（折扣类型填写折扣百分比，固定差额类型填写调价金额）
4. 同步操作需要确保网络连接正常，且其他平台接口可正常访问
5. 删除操作不可恢复，请谨慎操作
6. 关联秘钥必须选择类型为"入口方"的秘钥配置

路径配置

通知路径格式

https://域名/interflow/notification/{platform}/{id}

路径参数说明

{platform}

平台类型，可选值如下：

• SUPERVISE - 监管平台
• CONNECTIVITY - 互联互通运营商
• ENTRANCE - 入口方

{id}

对应数据库入口表(interflow_entrance)的 id 字段值