合作方、报文和对账, 在同一套接口台上看完
遇碳云互联互通接口管理系统把合作方、协议目录、联调、四向报文和对账差异放在同一本台账。对方推来的状态和订单报文可以检索,推不出去的进入队列重试。充电订单、桩和发票在充电运营,车场订单在智慧停车,设备物模型在 IoT。
- 协议目录
- 公共、业务、交易与监管
- 四向报文
- 推我、调我、我调、我推
- 联调调试
- 收包、出包和签名工具
- 对账差异
- 有差异不写成已结清
- 对方推我38%
- 对方调我22%
- 我调对方24%
- 我推对方16%
- 星星充电推送待重试待重试
- 昨日订单报文有差异有差异
从合作方到对账差异
先有合作方和协议目录,再联调收发包,报文进中心,对账只标差异,可观测和场景扩展引用同一本账。
- 01
建合作方
登记运营商或平台,打开要用的接口,并写上限流。
合作方 - 02
对协议目录
按公共信息、业务信息、交易信息、凭证、扩展域和监管上报对照接口。
协议接口目录 - 03
联调收发包
联调向导、收包调试台和出包调试台打通一笔样例。签名工具只用于联调。
接入与联调 - 04
报文进中心
对方推我、对方调我、我调对方、我推对方分开检索。推送失败进入队列。
报文中心 - 05
对账看差异
订单与账单报文和平台订单对照。有差异单独列出,不写成已结清。
交易与对账 - 06
可观测与场景
可用率和告警看接口是否稳定。场站开放、监管上报和二轮协议放在场景扩展。
可观测 · 场景
按接入生命周期逐项看
工作台在页首。下面八项对应协议目录、合作方、字典、联调、报文、可观测、对账和场景扩展。
协议接口目录
目录与合作方按标准分层看接口。目录说明每一层管什么,联调时按层打开开关。
- 六层分开,不把监管上报和交易信息混成一张表
- 出处写在分层说明里
- 开关仍在合作方上配置
示意卡片里的报文量和差异条数用于说明版面,不代表某个合作方的结算结果。
合作方、报文和对账各看各的标记
已停用的合作方不再应答。验签失败和待重试不写成已成功。对账有差异时不写成已结清。
合作方
这家平台现在能不能收发。
- 只用调试台和样例联调中联调中
- 已打开的接口可以收发已上线已上线
- 不再应答,也不再推送已停用已停用
报文
这一笔报文走到哪一步。
- 签名与解密通过后落库验签通过通过
- 不写成已接收验签失败失败
- 推送失败留在队列待重试待重试
对账
报文和平台订单是否对得上。
- 订单与账单报文能对上一致一致
- 列出差额,不标成已结清有差异有差异
8 个状态接口开关、限流和密钥在合作方档案里维护。资金是否到账以充电运营和支付渠道的结果为准。
接入、联调、值班、对账和报送各看不同的页
同一本接口账,有人管合作方,有人打样例,有人看报文,有人核对差异。
现在有几家已上线,还有谁停在联调,哪些接口没打开?
- 工作台上的在网合作方
- 合作方状态
- 接口开关
看工作台、跑联调、再标差异
一次接入从工作台开始,到告警或报送记录结束。中间每一步都能回到合作方和报文。
- 1看工作台
在网合作方和待处理决定要不要下钻。
- 2对目录
确认这一层接口在目录里,并在合作方打开。
- 3跑联调
用调试台打通一笔收包和一笔出包。
- 4收报文
按方向检索,验签失败和待重试分开。
- 5标对账差异
对不上的订单报文单独列出。
- 6告警或报送
可用率告警,或监管上报留下记录。
接口台账留在这里
合作方、目录、联调、报文、对账差异和场景扩展在互联互通接口管理系统。订单、设备和资金各自有产品。
本产品负责
- 协议接口目录和字典规范
- 合作方档案、接口开关与限流
- 联调向导、收包调试台、出包调试台、签名工具
- 四向报文和推送队列
- 订单与账单报文、对账差异
- 可用率、告警、场站开放、监管上报和二轮协议
资金划转、钱包入账和官方监管回执不在本页完成。对账差异只说明报文和平台订单对不上,不代表已收款或已退款。
五步把一家合作方接上
先有档案和开关,再用调试台打通收包和出包,然后报文能检索,对账能看出差异。
- 1合作方名称、地址和密钥
- 2要打开的接口清单
- 3一笔可打样的站点或订单
- 4对账要对照的平台订单范围
联调样例不写入正式对账。验签没通过的报文不写成已接收。
- 1建合作方
录入运营商或平台,状态先放在联调中。
完成标志 · 档案可打开 - 2打开接口开关
按目录勾选接口,并写上限流。
完成标志 · 开关已保存 - 3打通收包和出包
调试台各走一笔样例,签名工具只辅助联调。
完成标志 · 样例可回放 - 4报文可检索
四个方向和推送队列都能按合作方查到。
完成标志 · 中心有记录 - 5对账能看差异
用一笔平台订单对照报文,差异单独列出。
完成标志 · 差异可打开
多合作方、留痕、可导出
同一套接口台按合作方分开。开关、限流、报文和报送都留下记录。部署方式与价格见定价页。
每家运营商或平台单独档案、开关和限流。
调用频率写在合作方上。签名与加解密工具服务联调。
报文、验签结果、重试和报送保留记录。
按合作方和时间导出报文与对账差异。
按项目开通,与遇碳云充电、停车产品同一账号体系。
密钥和报文只能留在内网时,平台可部署在客户侧。
汽车互联、二轮、监管和场站开放都能落在这本账上
主链路是合作方和报文。场景扩展承接场站开放、监管上报和二轮协议。
报文、订单和设备协议
下面五件是开通前最常核对的口径。
和充电运营怎么分工?
充电订单、桩、电价和发票在充电运营。本页保留合作方报文、推送队列和对账差异。两边可以按订单号对照,不合并成一张账单。
和 IoT 怎么分工?
桩和表计的物模型、MQTT 等设备协议在 IoT。本页是与运营商、平台之间的 HTTP 互联:目录、签名、报文和对账差异。
对账差异等于已收款吗?
对账差异只说明报文和平台订单对不上。已收款、已退款以充电运营和支付渠道的结果为准。本页不把差异标成已结清。
监管上报等于主管部门已接收吗?
本页留下组包和报送记录。主管部门是否接收、是否回执,以对方系统为准。没有回执时不写成已通过。
签名工具能代替对方正式环境吗?
签名与加解密工具只服务联调样例。正式收发走已上线合作方打开的接口,样例报文不进入正式对账。