汇
⛽ 加油站数据分发平台
汇悦客
HUI YUE KE · DATA HUB
汇聚多源数据 · 悦享智能分发
采集器、税控、第三方接口多源汇聚,统一字段窄腰,按授权实时分发至收银、对账等多个业务端 —— 一个平台,打通加油站每一笔数据。
🛢️
多源汇聚
采集器 / 税控 / 接口统一接入
⚡
实时查单
加油数据秒级可查 · 自动出价
🔗
智能分发
按授权分发多消费端
🛡️
安全合规
数据脱敏 · 密钥隔离 · 全链可溯
© 汇悦客 · 加油站数据分发平台
汇
汇悦客HUI YUE KE

欢迎登录

管控台 · 请输入管理密码

仅限授权管理员访问 · 汇悦客数据分发平台

数据驾驶舱

实时刷新中 退出
在线站点 / 总站点
0 / 0
心跳 90 秒内视为在线
今日采集订单
0
笔
今日加油金额
¥0
元
累计订单 / 金额
0
¥0

近 7 天采集趋势订单笔数

最新加油最近 8 笔

站点管理

一个物理站可有多个数据源:🔌采集器(装机自注册上报)、🏛️税控(税务局 MQ 推来只带 stationId)、⛽聊城(成品油外接口 REST 拉取,只带 credit_code)、🧾税控直连06(另一家税控公司直接推给我们,按信用代码认站)、☁️云端零管(零管在厂商云上,中台登录对方云台去拉),后几者在这对到我方油超门店。 同一油超门店的多个数据源共用同一站号,不撞号。
清空

数据源现在能采到数据的只有这两个

① 采集器 —— 站上装我们的程序直接读加油机。② 通联透传 —— 通联替我们对接好各地税控平台,一个口把济南 / 聊城 / 高密…全都推过来。
这页配整个源一份的连接/密钥;哪个站走哪个源到「站点管理 → 添加站点」按站录(通联的站就填个信用代码)。

🔌 采集器 数据源01—

现场装机的采集器自注册上报,无需在此配置连接。装机人在采集器登录后,到「装机绑定」发一次令牌即接入;之后该站自动出现在「站点管理」列表。
🗄️ 已退役的数据源(济南税控 02 / 聊城 03)—— 点开查阅
2026-07-31 起这两条自建线停用,所有地市的数据统一走「通联透传」一个口。 配置留在这里只为查阅/万一要回退,不必再维护。 ⚠ 这两个源的站点映射表绝不能删 —— 通联现在就是靠它们按信用代码认站的,删了整片站收不到数据。

🏛️ 济南报税口 已退役—  

税务局税控口(0x0D),经 RocketMQ 推送到我方。此处填整源一份的接入参数(授权站共用):NameServer=RocketMQ 接入地址、AccessKey / SecretKey=MQ ACL 账密、SM4 密钥=消息体解密密钥(Base64,须解出 16 字节)、spid=我方服务商统一社会信用代码(据此推 Topic/消费组)——均由税局给。加密算法固定 SM4/CBC/PKCS7(已实现)。SecretKey / SM4 密钥只你在此填、读回打码不回显;留空保存=只改其余字段、密钥不动。填齐并勾「启用消费」后重启服务生效(真正连 RocketMQ 的客户端待确认版本后接上,当前先把参数就位)。站映射(stationId → 我方门店)到「站点管理」按站录。
用已填 SM4 密钥把一条样例报文在服务端加密后干跑一遍解密→解析→归一,验证密钥与链路自洽。不入库、不查授权、不推下游(纯自检),不影响生产。链路通≠密钥与税局一致(那要等真机推送)。

⛽ 聊城报税口 数据源03—  

聊城成品油外接口的拉取凭证(整个账号一份,授权站共用)。base_url + 账号名 source 由对方给;username / password 是 SM2 预加密密文(对方直接给密文串,你原样粘进来即可,系统当不透明凭证存/转发,不碰明文)。填好并勾「启用」后,拉取服务下一轮(≤5分钟)自动生效,免重启。账密只你在此填、读回打码不回显;留空保存=只改域名/账号/开关,密文不动。填完到「站点管理」加聊城站,点该站「测试拉取」当场验通。

⛽ 聊城推送接入 数据源03·新对接

聊城正式接口:平台改主动推送(≠上面的拉取账号)。我方当接收方——聊城把已解析的油品业务字段直接 POST 给我方。spId / accessSecret 由聊城线下分配(accessSecret 只你在此填、读回不回显,系统当不透明串存,不碰明文);getToken 地址填聊城给的取 token 接口(用于校验推来的 Bearer,可留空先只凭 spId 收)。填好勾「启用接收」后立即生效。把下方"接收端点 URL"发给聊城当推送地址。「严格 token」联调确认聊城推的 token 与我方取回一致后再开(默认关:token 对不上记告警仍收,防误拒真实数据)。
📮 接收端点 URL(交给聊城):—

🔁 通联透传 数据源04—  

通联已经替我们对接好各地税控平台(济南 / 聊城 / 高密 …),把解析好的加油业务字段统一透传过来 —— 一个口顶多个地市,以后新增地市他那边接完直接推,我方零改动。配置、联调自测、原始数据存档都在专页。

🆕 税控公司直连推送 数据源06

某税控公司直连推给我方(不经通联,所以不能共用源04 那个口 —— 源04 全局只有一份 spId + 一把密钥,两个发送方共用我方分不出身份)。把下面这条"接收地址"整条发给对方当推送地址。
鉴权就是地址本身:对方首版接口完全没有鉴权手段(无 token、无签名、无密钥),裸地址等于谁都能灌假单,所以地址里带了一段随机串。别公开贴;泄露了点「换地址」重签发一条即可(旧地址立刻失效,对方要换)。
⚠ 切「正式」之前,先确认对方报文里已经带上这两个字段。我方的归一和入账已经就绪(与通用接入口同一份口径), 闸门在对方那边 —— 这两样是编不出来的,少任何一样都会出事:
① 唯一流水号 tradeNo —— 幂等键。没有它,他们超时重推我方就重复入账;只能拿「信用代码+时间+枪+金额」拼键,而同枪同额同秒的两笔分不开(上月「一单两票」就是这么来的)。
② 加油机号 machineNo(只给 gunName 不够)—— 我方油品和查单都认「机-枪」复合键,单枪号在多台加油机的站必然撞号,撞号不是查不到,是查到别人那张单。
切成「正式」后这两样就是硬要求:缺了那一笔不入账、回 1008 留档(不会丢,对方补齐后拿同一个 tradeNo 重推即可入账); tradeType 是退款/冲正/作废的回 1010 留档待人工(我方尚未实现冲销)。
切档只影响往后的新数据 —— 已经存档的历史不会自动回灌。
📮 接收地址(交给对方):—
已存档 — 条
这条口收到的数据(含以前存的)已并入下面的「数据源接入」面板统一查看 —— 两处各看一半才是真会误事的做法。

☁️ 云端零管 数据源07—  

这类站的零管跑在厂商云上,站里只有集线器和网关 —— 装不了采集器、也没有本地库,所以由中台登录对方云台去拉。 实时性由收银查单时当场现拉保证(百毫秒级),后台还有 120 秒一轮的轮询兜底。
这里只配账号(凭据)。站点在【站点管理】→ +添加站点 里加。一份账号可以管多个站。
账号(凭据) — 一份凭据可以管多个站;站点在【站点管理】按站挂到某个账号上
账号id石油公司名登录账号备注密码挂几个站启用操作
还没配过账号
账号配好后到「站点管理 → + 添加站点 → ☁️ 云端零管」加站:那里能用这份账号直接拉出对方的站列表,选一个就行,不用手抄站编号。

🎫 数据源接入 通用·范本

这是「我方定接口、对方来对接」那条线,和上面几个源相反 —— 上面每一家都是对方给协议、我方写一套适配。 这条线只有一份接口文档、一个地址、一套代码:来第 7 家、第 8 家时不用改代码,在这里签一把新凭据、把同一份文档发过去就行(对方只需回填文档第 9 节那张字段确认表)。
📮 正式上报地址(所有接入方共用,写在文档里):—
正式地址走 HMAC 签名(五个请求头),凭据是下表的 app_key / app_secret。app_secret 只在签发那一刻显示一次,之后谁也看不到 —— 丢了只能「换密钥」重发。
⚠ 新签的凭据一律是「试运行」档 —— 收下来只留档,不进台账、不参与查单对账。 这是刻意的:加油机号和枪号的确切含义、油品编码表必须拿真数据核对过才能进账,没核就切档一定串单(把钱记到别的油上,金额还对得上,查不出来)。 核对完在这里改成「正式」。
共收到 — 条
接入方app_key档位状态已收最后收到授权站过渡地址操作
还没签发过接入凭据

🔁 通联透传接入 数据源04

通联已经对接好各地税控平台(济南 / 聊城 / 高密 …),把解析好的加油业务字段统一透传给我方 —— 一个口顶多个地市,以后新增地市他那边接完直接推,我方零改动。AES 密钥双方线下约定(只你在此填、读回不回显,系统不碰明文);spId 留空=不校验来件 X-SP-ID。把下方"接收端点 URL"发给通联当推送地址。
2026-07-31 起这就是唯一的税控数据来源 —— 济南(源02)/ 聊城(源03)两条自建线已退役,能采数据的只剩采集器和通联两个源。
站点靠信用代码认:在「站点管理 → 添加站点 → 通联透传」填上信用代码就收这个站的单;没配过的站一律不落库,只在下面「推过来但不是我们的站」里记个数,你从那份名单认出自己的站点一下就能配。
📮 接收端点 URL(交给通联):—
🩺 体检 = 不靠猜定口径:拿通联存档去撞旧线(源02/源03)已入库的同一笔油 —— 两条线并跑过的那段时间同一笔油两边都有。按「同门店 + 时间相差 ≤3 分钟 + 金额相等」配对,看旧线那条的 nozzle_no 到底等于 tankerCode 还是 gunNo,按地市分别给结论。只读、不改数据;配不上对只会说「样本不足」,不硬给建议。

🏷️ 推过来但不是我们的站认出自己的站,点一下就收 ·

通联一个口把整片地市的站都推过来,没在「站点管理」配过信用代码的一律不落库 —— 只在这里记一笔「谁推的、推了多少」,不存金额/时间/枪号任何内容。
这张表是用来认站的:哪一行是你自己的站,点「配成我方站点」填门店号,以后它的单就自动进台账。只从这一刻起的新单 —— 之前的没存下来,拿不回来。
清理 = 把改成「只计数」之前已经存下的那批未授权单据删掉(先折进上面的计数再删,不会丢「谁在推」这个信息)。

🔬 联调自测 不落库 · 不看启用开关

把通联发来的 encryptData 贴进来,当场看解得开解不开、验签过不过、归到哪个站、落库枪号是哪个 —— 不用等真流水,也不会写进任何表。
只填明文 JSON = 用当前密钥自加自解,顺带把 encryptData 和签名算给你,可以直接发给通联核对拼法。

📥 通联透传原始数据存档字段语义看这里定 ·

通联每推一条都存这里(不管入没入台账、认没认领),字段是报文原值。source 列看这条来自哪个地市 —— 各地市字段语义不一样,别混着看:
· 济南:tankerCode=加油机号、pumpNo=该机第几把枪(2026-08-13 起才推)、gunNo 恒 01 无信息、oilType 有油品。⚠ 济南缺省口径落库枪号取的是 tankerCode,所以台账里「油枪」和「加油机(位置)」两列同值 —— 要看真枪号得按站切 pump 口径(数据源页「落库枪号」那栏);
· 聊城:tankerCode=加油机号、gunNo=枪号、oilType 一律为空(聊城平台从来不给油品,不是丢了)——聊城的油品靠站点里那张「加油机+枪号 → 油品」映射反推,配了才显示,改映射自动回溯历史单。
两个按钮:补发=把「未认领」的存档回灌台账(配站晚了用);重算=按当前枪号口径/油品映射把已入库的单就地修正(改过口径用)。
状态: 信用代码:
站点筛选:
站点: 起: 止: 油枪: 油品:

税控原始数据(源02·神思推送存档)一条不丢 · 和实际加油对比

神思每推一条都存这里(不管认没认领),字段是报文原值(端口/枪号带前导零)。字段语义(2026-07-25 用 260 条真实存档定案):tankerCode=加油机号、PortNo=该机上的第几把枪、NozzleNo 恒 01 无信息;油品映射请按 「机-枪」复合键配(如 5-2→95#),没配就用报文 oilType。未认领=配站前 / 没配的站存下的,配好站会自动补进台账,也可下方按信用代码手动补发;改过油品映射后点重算可把存量订单一并对齐。
状态: 信用代码:

装机绑定 · 待发令牌 / 已发

装机人在采集器输账号密码点【登录】后,这里出现手机号 → 点【发令牌】选这次绑哪套收银端 → 把令牌发给装机人填入采集器即可绑定。令牌一次性、30 分钟有效、绑定那台电脑。

🔑 优油前端直连 · 换票密钥

优油商家后台的前端直接调我方数据接口那条路(页面是他们写的,我方只出数据)。老板的浏览器拿一个优油短 token 到我方换一张访问票,票里钉死「这个手机号名下有哪些门店」——「一个手机号只能看到自己的门店」就落在这儿。换票那一次的上游调用完整发生在我方服务端,两把钥匙一个字节都不进浏览器。两把钥匙齐 + 勾了启用才发票,缺一样换票口一律 503(绝不退化成"不验签也照发票")。改完下一次换票即生效、免重启。
⚠ 换的是公钥,不是私钥。我方私钥在这台服务器上生成、永不出服务器(这个页面也看不到它,只看得到指纹)—— 所以别去别的地方生成密钥对再贴进来。你要做的是两件事:① 点「生成我方密钥对」,把回显的我方公钥复制发给优油; ② 把优油给你的他们的公钥粘进下面那个框。两件都做完,状态才会变成「已启用」。
📮 我方公钥(交给优油):
—
⛔ 这次对接是单向的。优油前端调我方接口(可读、可写我方的数据); 我方只允许换票这一次只读的 getUserInfo,绝不主动去调优油接口取数据,更不改写对方任何数据。 下面那个路径框只认末段是 getUserInfo 的地址(前缀可换,对方换版本号时不必发版)—— 填成对方别的接口会被直接拒绝保存,硬限制不能靠配置绕开。
跨域白名单另配(优油页面的准确域名,Central__PortalAllowedOrigins)——没加白名单,浏览器在预检那一步就拦了,请求根本到不了我方。前端怎么接见 docs/优油前端对接-前端接入说明v1.md。

🎫 优油前端直连 · 临时票换票卡住时的旁路

正路是优油前端拿短 token 到我方换票。那一步卡住的时候(对方那边短 token 换不出人来),在这儿手签一张票交给对方前端,数据接口就能先跑起来 —— 不用等换票通了才开始验数据,两件事分开查。
前端拿到票只要一件事:每个请求带 Authorization: Bearer <票>,其余接口用法和正路一字不差(正路也是换出这么一张票)。
⚠ 手签绕过的是「他是谁」,不是「他能看见多少」。 正路的门店范围由优油返回的 room[] 钉死;手签这条路没有 room[],所以门店只能你一个一个勾。 不勾站签不出票 —— 这里刻意没有「全部站」这个选项:票一旦交出去就看不见了,圈多大只有签的时候能定。
勾出这张票能看见的门店
还没列 —— 点上面那个按钮。
(默认 2 小时,最多 24 小时;没有"永不过期"——联调票最后总会被忘在某个前端配置里)

回调推送 Webhook开关变更·实时推给收银后端

给每套收银端配一个接收地址 + 密钥。你在「站点管理」拨某站的回调推送开关时,中台会立刻按开票系统同款 webhook 把变更推给对应收银端(同样的 X-Webhook-Signature 验签:HMAC-SHA256(secret, body)),对方据此开始 / 停止给该站推支付回调。纯推 + 重试(0/1/3/9 秒),收银后端复用其现成的开票 webhook 接收端即可。

对账同步 Webhook(shoukuan)加油单变化·推对账工作台

给对账工作台 shoukuan 配接收地址(如 https://yy.jiayouzhan.top/api/webhook/reconcile)+ 密钥。中台每有新单 / 支付 / 退款 / 人工写回就推一条 merchant.reconcile_record 完整快照(带连续 sync_seq 防漏单),验签同款 HMAC-SHA256(secret, body)。这是给 shoukuan 的(≠ 上面收银后端),故单独配。shoukuan 另用不绑 ev 的一把验签密钥(下方「收银验签密钥」新建时 ev 留空)拉 feed / 回写 resolve。

POS 主动查询接口我方出站·拉支付状态(防错账兜底)

配收银端发给我方的一把客户端密钥(base_url + apiKey(pk_…) + apiSecret),用于我方主动调他们的 /client/gather/query_pay_status 查某单真实支付状态(推丢 / 对不上时兜底)。这是我方当签名方的 API 签名(HMAC-SHA256(apiSecret, apiKey\\n时间戳\\nnonce\\nPOST\\n/路径)),与回调 webhook 验签是两套。注意:这把密钥与「收银验签密钥」(我方发给他们的)是反方向的另一把。

收银验签密钥

每套收银端发一把:把 app_key + app_secret 交给他们后端,后端用它对查单请求做 HMAC 签名(请求头 X-App-Key / X-Timestamp / X-Nonce / X-Signature)。app_secret 只在新建时显示一次,请当场复制、走安全渠道交给对方。
💳 支付回调
↩️ 退款订单
⚠️ 异常订单
🧾 对账(未收支付)
🔔 收银通知(交班)

支付回调流水收银推过来的支付回调 · 原样落台账

每条支付回调进来就原样落台账(含原始报文)。这里按时间列全部支付回调(对上的、对不上的都在),点【原文/拉真相】看原始报文、主动查对方真实状态。只看不改 —— 要处理异常去「异常订单」。
四个金额分清楚:应收=我方油枪跳的钱(元);应付/实付/优惠=收银端回调里的三个数。「对平」列直接给结论 —— 应收 = 应付,或 = 实付+优惠,任一成立即算平(打折单实付本就少于油枪金额);都解释不通才标差额,那才是要追的。这四个数会原样同步给收款平台去推开票,对不上开票就会错。
站点: 起: 止:

退款订单流水收银推过来的退款回调 · 原样落台账

按时间列全部退款回调。点【原文/拉真相】看原始报文。只看不改 —— 异常(退款无前置等)去「异常订单」处理。
站点: 起: 止:

收银通知(交班)收银端推过来的非支付通知 · 原样存档

收银端走同一条支付回调链路推过来的通知类报文(目前是交班,以后可能还有日结、盘点等),这里按时间原样列出。
这类包没有我方订单号,以前会被当成「回调缺单号」直接拒掉(HTTP 400)——对方反复重推、异常页被塞满,而交班是一次性推送,拒掉就永远没了。现在一律收下存档,点【原文】看完整报文。
⚠ 收到交班不会自动动任何订单:交班后那些待处理单是转给收款平台、还是我方自己处置,口径未定 —— 定下来之前只存不动,错一次就是把钱记到别处。
站点: 起: 止:

异常订单对不上的支付/退款 · 需要人工处理

只列对不上的回调:查无加油单、金额不符、退款无前置支付。点【原文/拉真相】看报文/查真相;查无此单的支付可【强制关联】到某加油单;重复/测试回调点【忽略】。
站点: 异常: 起: 止:

对账 · 未收到支付的加油单有加油单·没收到支付(现金/挂单候选)

这些加油单到现在没收到任何支付回调:多半是现金或线下挂单,但也可能是回调丢了。核实后点【现金已收】/【挂单已处理】写回为已付,即不再被查单当未付、可进开票。刚加完油的单支付回调可能还在路上,看「距今」别急着处理。
看「兜底」列先分清是哪一类:排队中=还在自动问收银端,先别动;收银端说没付=对方查到这单确认没线上支付,基本就是现金/挂单;⚠ 对方不认单号=对方连这个单号都查不到,不等于没付,得找收银厂商对;超时归档=超过 48 小时不再自动问了。
站点: 起: 止: 🔄 重新兜底查询

① 选加油流水表 —— 点【查看数据】看真实记录,跟零管界面对上了再选⚠️ 选错就采错

辖区划分
税局账户
访问审计

油站 → 税务局辖区

没划辖区的站,任何税局都看不见(宁可看不到,也不能把这个市的纳税人数据露给另一个市)。辖区码至少选到区/县(6 位),乡镇街道不是必填;税局能看到哪些站,只看前 4 位地市码,所以乡镇填错也不会串市。新站装机时由装机人现场选,存量站在这里补。
批量划分选中站 →

税局账户一个账户 = 一个税务局

选到哪一级,就只能看到哪一级:选到地市 = 看全市;选到区县 = 只看本县,连同市隔壁县的站都看不见。登录后页面上没有切换辖区的入口,税局侧全是只读(只有 GET),改不了任何数据。口令用 PBKDF2 存,存完就再也看不到了,请当场交给对方。
辖区

访问审计税局账户查了什么

谁、什么时候、从哪个 IP、查了哪个接口。审计写失败绝不阻断查询,所以这里偶有缺行属正常。

边缘盒子

我方自己装在站里的 4G 串口网关(数据源 08),直接挂加油机总线 —— 不再依赖别人的零管。 盒子是哑的:只按下面配的「问帧」发字节、按偏移抹掉卡号、把原始字节原样传上来,解析全在中台。 装机流程(r9 起的通用固件):所有盒子刷同一个固件 → 盒子一上电按硬件号来敲门、出现在下面「待认领」列表 → 对一眼硬件号/指纹是你手里那台 → 点「认领 · 绑站」→ 盒子 ≤60 秒自动拿到凭据。盒子上什么都不用填,不用重编译。
老路(r8 及以前的固件,码烤在固件里):「新建设备」出 8 位配对码(24 小时有效、用掉即废)→ 填进固件源码编译刷机 → 盒子拿码换凭据。两条路并存,r8 的盒子照旧。

原始帧存档

解不出来的帧就是下一个协议族的分析材料 —— 这张表默认只留这些。要看全部,把那台设备的留档策略调成「全量」,看完记得调回来(空闲轮询每 110ms 一帧,全量是每站每天几十万行)。
落库的字节里卡号已经在盒子里按偏移抹掉了,中台不做二次脱敏 —— 这里要是还看得见卡号,说明配置漏了抹码段,该去改配置。

站长怎么登不用我们开账号

站里自己看的那个界面在 /zlg —— 每把枪的实时状态、逐笔流水、当日汇总。
⭐ 站长直接用他自己的油超 / 优油收银账号登,我们这边不开、也开不了账号: 登录时中台把账号口令转发给收银端验一次,对方返回的门店列表就是他能看见的范围。 他名下有几个门店,顶栏就能切几个。
这样做的原因:① 站长不用多记一套口令;② 我们一个口令都不存(手机号也只存脱敏的); ③ 门店归属油超自己就是权威,不需要我们再手工绑一次 site_id —— 手工绑填错一个字就把别人家的站给他看了。
站长侧全是只读,改不了任何数据 —— 而且改了也下不到加油机,我们只采集不控制。
登不进去先查这三样:收银端选对没(优油/油超别选反)、这个账号在油超那边名下有没有门店、这个门店有没有装采集。

访问审计站长账号查了什么

谁、什么时候、从哪个 IP、查了哪个接口。审计写失败绝不阻断查询,所以这里偶有缺行属正常。
🎛️

远程管控

远程启停采集器、批量下发配置、自动更新 —— 二期开放。
🔀

商户路由

站点 → 收银商户号 的归属路由与白名单 —— 二期开放。

🔔 告警中心 · 边缘盒子

读取中…
只报已配对且未停用的盒子。掉线=心跳断超 90 秒(断电 / 断网 / 拔网线,4G 也没顶上); 某口无数据=盒子在线、但某个本来在收数的口 rx 卡住超 3 分钟(U 口拔线 / 串口松动 / 加油机没答; 被动只听口和从没收过数的口不参与)。采集器等其它源随后并入。
⚙️

系统设置

账号、密钥、零管档案管理 —— 二期开放。