账号与采购渠道
「账号管理」统一维护系统对接外部平台时用到的所有账号。业务服务从这里读取凭证,不需要在代码或配置文件里写死。
账号类型
| 页面 | 用途 |
|---|---|
| OTA 账号 | 各平台店铺账号,用于进单、回填、退改 |
| 登录账号 | 平台后台登录账号 |
| 航司 | 航司基础资料 |
| 采购渠道 | 出票采购渠道及路由配置 |
| 外部采购渠道 / 外采开放平台 | 外部 HTTP 供应商渠道与开放平台供应商 |
| 外采账号 | 外采渠道凭证,例如易旅行、航班管家、IBE |
| 外采任务 / 外采流水日志 | 外采任务与资金流水查询 |
| IBE 账号 / Office / SGUI | 中航信相关账号 |
| 支付方式 / 支付账号 | 采购支付使用的方式与账号 |
| 承运人回填配置 | 按承运人配置回填行为 |
采购渠道调用链
订单服务(业务编排)
→ 外采服务 ruoyi-external-procurement(调度)
→ 独立采购渠道服务(供应商实现)- 外采服务负责渠道选择、标准订单快照、幂等任务、按乘客拆单、延时查单、重试与超时;同时聚合供应商子订单状态,统一回填采购信息、票号、订单状态,以及 OTA 侧数据。
- 渠道服务只负责和供应商通信,把供应商状态统一映射为
PROCESSING、ISSUED、FAILED、CANCELLED。渠道服务不查询订单库,也不回填 OTA。 - 外采服务按采购渠道上配置的服务地址路由请求,不按供应商名称硬编码。是否按乘客拆单由采购渠道配置决定。
已接入的采购渠道
| 渠道 | 能力 |
|---|---|
| IBE | 国内查价、订座、PNR 修改 / 提取、国内出票;国际查价、最优运价、行李、规则、出票;结算报表 |
| 易旅行(国内) | 查价、生单、支付校验、支付;出票结果以回调或查单为准 |
| 航班管家 | 航班政策、验舱验价、提交订单、出票前确认、提交出票、取消、订单详情 |
| HKG | 政策查询、创单、订单详情与 VCC 支付 |
| 标准外采开放接口 | 供应商主动拉单、接单、回传结果,见标准外采开放接口 |
| 第三方 HTTP 供应商 | 平台主动调用供应商的标准协议,见第三方自动出票供应商协议 |
新增供应商时,优先使用「标准外采开放接口」或「第三方自动出票供应商协议」接入。这样只需要在后台配置渠道,不用开发新的渠道服务。
凭证安全
- 供应商密钥只通过环境变量或后台账号配置注入,不写入仓库和前端代码;
- 同一渠道有多个账号时,按渠道配置中的优先级选用;
- 查看乘客证件等敏感信息时会记录查看日志。