互联互通接口管理系统

合作方、报文和对账, 在同一套接口台上看完

遇碳云互联互通接口管理系统把合作方、协议目录、联调、四向报文和对账差异放在同一本台账。对方推来的状态和订单报文可以检索,推不出去的进入队列重试。充电订单、桩和发票在充电运营,车场订单在智慧停车,设备物模型在 IoT。

协议目录
公共、业务、交易与监管
四向报文
推我、调我、我调、我推
联调调试
收包、出包和签名工具
对账差异
有差异不写成已结清
工作台
示意数据
12
在网合作方
家 · 示意
1,860
今日报文
示意数据
4
对账差异
报文方向
  • 对方推我38%
  • 对方调我22%
  • 我调对方24%
  • 我推对方16%
待处理
  • 星星充电推送待重试待重试
  • 昨日订单报文有差异有差异
全链路

从合作方到对账差异

先有合作方和协议目录,再联调收发包,报文进中心,对账只标差异,可观测和场景扩展引用同一本账。

  1. 01

    建合作方

    登记运营商或平台,打开要用的接口,并写上限流。

    合作方
  2. 02

    对协议目录

    按公共信息、业务信息、交易信息、凭证、扩展域和监管上报对照接口。

    协议接口目录
  3. 03

    联调收发包

    联调向导、收包调试台和出包调试台打通一笔样例。签名工具只用于联调。

    接入与联调
  4. 04

    报文进中心

    对方推我、对方调我、我调对方、我推对方分开检索。推送失败进入队列。

    报文中心
  5. 05

    对账看差异

    订单与账单报文和平台订单对照。有差异单独列出,不写成已结清。

    交易与对账
  6. 06

    可观测与场景

    可用率和告警看接口是否稳定。场站开放、监管上报和二轮协议放在场景扩展。

    可观测 · 场景
能力导览

按接入生命周期逐项看

工作台在页首。下面八项对应协议目录、合作方、字典、联调、报文、可观测、对账和场景扩展。

互联互通接口管理系统 / 协议接口目录

协议接口目录

目录与合作方
页内切换
公共信息业务信息交易信息凭证与二维码扩展域监管上报
这一页回答

按标准分层看接口。目录说明每一层管什么,联调时按层打开开关。

  • 六层分开,不把监管上报和交易信息混成一张表
  • 出处写在分层说明里
  • 开关仍在合作方上配置
示意公共信息
公共信息已对照
交易信息已对照
监管上报单独一层

示意卡片里的报文量和差异条数用于说明版面,不代表某个合作方的结算结果。

运行状态

合作方、报文和对账各看各的标记

已停用的合作方不再应答。验签失败和待重试不写成已成功。对账有差异时不写成已结清。

合作方

这家平台现在能不能收发。

  • 联调中
    联调中
    只用调试台和样例
  • 已上线
    已上线
    已打开的接口可以收发
  • 已停用
    已停用
    不再应答,也不再推送

报文

这一笔报文走到哪一步。

  • 验签通过
    通过
    签名与解密通过后落库
  • 验签失败
    失败
    不写成已接收
  • 待重试
    待重试
    推送失败留在队列

对账

报文和平台订单是否对得上。

  • 一致
    一致
    订单与账单报文能对上
  • 有差异
    有差异
    列出差额,不标成已结清

8 个状态接口开关、限流和密钥在合作方档案里维护。资金是否到账以充电运营和支付渠道的结果为准。

谁在用

接入、联调、值班、对账和报送各看不同的页

同一本接口账,有人管合作方,有人打样例,有人看报文,有人核对差异。

要回答的问题

现在有几家已上线,还有谁停在联调,哪些接口没打开?

日常看什么
  • 工作台上的在网合作方
  • 合作方状态
  • 接口开关
常用菜单
工作台合作方协议接口目录
管理闭环

看工作台、跑联调、再标差异

一次接入从工作台开始,到告警或报送记录结束。中间每一步都能回到合作方和报文。

  1. 1
    看工作台

    在网合作方和待处理决定要不要下钻。

  2. 2
    对目录

    确认这一层接口在目录里,并在合作方打开。

  3. 3
    跑联调

    用调试台打通一笔收包和一笔出包。

  4. 4
    收报文

    按方向检索,验签失败和待重试分开。

  5. 5
    标对账差异

    对不上的订单报文单独列出。

  6. 6
    告警或报送

    可用率告警,或监管上报留下记录。

边界

接口台账留在这里

合作方、目录、联调、报文、对账差异和场景扩展在互联互通接口管理系统。订单、设备和资金各自有产品。

本产品负责

  • 协议接口目录和字典规范
  • 合作方档案、接口开关与限流
  • 联调向导、收包调试台、出包调试台、签名工具
  • 四向报文和推送队列
  • 订单与账单报文、对账差异
  • 可用率、告警、场站开放、监管上报和二轮协议

资金划转、钱包入账和官方监管回执不在本页完成。对账差异只说明报文和平台订单对不上,不代表已收款或已退款。

开通

五步把一家合作方接上

先有档案和开关,再用调试台打通收包和出包,然后报文能检索,对账能看出差异。

开工前准备
  • 1合作方名称、地址和密钥
  • 2要打开的接口清单
  • 3一笔可打样的站点或订单
  • 4对账要对照的平台订单范围

联调样例不写入正式对账。验签没通过的报文不写成已接收。

  1. 1
    建合作方

    录入运营商或平台,状态先放在联调中。

    完成标志 · 档案可打开
  2. 2
    打开接口开关

    按目录勾选接口,并写上限流。

    完成标志 · 开关已保存
  3. 3
    打通收包和出包

    调试台各走一笔样例,签名工具只辅助联调。

    完成标志 · 样例可回放
  4. 4
    报文可检索

    四个方向和推送队列都能按合作方查到。

    完成标志 · 中心有记录
  5. 5
    对账能看差异

    用一笔平台订单对照报文,差异单独列出。

    完成标志 · 差异可打开
平台

多合作方、留痕、可导出

同一套接口台按合作方分开。开关、限流、报文和报送都留下记录。部署方式与价格见定价页。

多合作方

每家运营商或平台单独档案、开关和限流。

限流与签名

调用频率写在合作方上。签名与加解密工具服务联调。

调用留痕

报文、验签结果、重试和报送保留记录。

报文可导出

按合作方和时间导出报文与对账差异。

SaaS

按项目开通,与遇碳云充电、停车产品同一账号体系。

私有化

密钥和报文只能留在内网时,平台可部署在客户侧。

常见问题

报文、订单和设备协议

下面五件是开通前最常核对的口径。

和充电运营怎么分工?

充电订单、桩、电价和发票在充电运营。本页保留合作方报文、推送队列和对账差异。两边可以按订单号对照,不合并成一张账单。

和 IoT 怎么分工?

桩和表计的物模型、MQTT 等设备协议在 IoT。本页是与运营商、平台之间的 HTTP 互联:目录、签名、报文和对账差异。

对账差异等于已收款吗?

对账差异只说明报文和平台订单对不上。已收款、已退款以充电运营和支付渠道的结果为准。本页不把差异标成已结清。

监管上报等于主管部门已接收吗?

本页留下组包和报送记录。主管部门是否接收、是否回执,以对方系统为准。没有回执时不写成已通过。

签名工具能代替对方正式环境吗?

签名与加解密工具只服务联调样例。正式收发走已上线合作方打开的接口,样例报文不进入正式对账。

先把一家合作方的收发摊开

告诉我们对方是哪家平台、要打开哪些接口,以及要不要做监管上报。我们按这个范围演示目录、联调、报文和对账差异。