互聯互通接口管理系統

合作方、報文和對賬, 在同一套接口台上看完

遇碳雲互聯互通接口管理系統把合作方、協議目錄、聯調、四向報文和對賬差異放在同一本台賬。對方推來的狀態和訂單報文可以檢索,推不出去的進入隊列重試。充電訂單、樁和發票在充電運營,車場訂單在智慧停車,設備物模型在 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 互聯:目錄、簽名、報文和對賬差異。

對賬差異等於已收款嗎?

對賬差異只説明報文和平台訂單對不上。已收款、已退款以充電運營和支付渠道的結果為準。本頁不把差異標成已結清。

監管上報等於主管部門已接收嗎?

本頁留下組包和報送記錄。主管部門是否接收、是否回執,以對方系統為準。沒有回執時不寫成已通過。

簽名工具能代替對方正式環境嗎?

簽名與加解密工具只服務聯調樣例。正式收發走已上線合作方打開的接口,樣例報文不進入正式對賬。

先把一家合作方的收發攤開

告訴我們對方是哪家平台、要打開哪些接口,以及要不要做監管上報。我們按這個範圍演示目錄、聯調、報文和對賬差異。