在鸿蒙版企业服务 App 里接入电子营业执照,客户最常问的两句话是"官方到底给不给鸿蒙 SDK"和"联调要排多久"。这两个问题的答案不在技术选型文档里,而在接入资格和链路形态里。所以先给结论,再拆步骤。
截至 2026-10-27,我们在电子营业执照服务专区核对到的公开信息是:门户本身是 Web 形态的服务专区入口,对外呈现的是"官方应用程序出示 + 接入方系统联网验证"的服务形态。至于是否存在面向 HarmonyOS 的独立端侧 SDK、接口文档怎么写,属于取得接入资格后才会下发的材料,本文不对它下结论。
这条边界的含义是:门户页面由脚本渲染,未登录状态只能看到专区入口,任何"有没有端侧 SDK"的判断都要有官方下发的技术文档印证,所以本文不把它当作结论。下面只写不依赖具体版本号、也不会因为文档改版而失效的部分:条文口径、链路形态与分项工期。
为什么鸿蒙端基本只能走"扫码授权 + 服务端换取"
《电子营业执照管理办法(试行)》把系统定位写得很明确:电子营业执照系统是全国统一的市场主体身份验证系统,具备防伪、防篡改、防抵赖特性。这决定了它不是一份可以随便拷贝的文件。
更关键的是第十一条:社会公众、相关单位和机构使用电子营业执照应用程序或接入电子营业执照系统,可实时联网验证市场主体电子营业执照真伪、查询市场主体身份信息及状态,并可同步比对查验持照人相关信息。
这句话直接决定架构。执照文件在总局库里,出示动作发生在官方应用程序里,接入方被允许做的是"联网验证"。所以鸿蒙 App 不该去解析、缓存执照文件本体,而是调起官方应用完成出示与授权,再把一次性凭据交给自己的服务端换取核验结果。
一句话概括:端侧薄,服务端厚。你在鸿蒙端写的主要是调起、回调、展示结果,真正的判定逻辑在服务端。
2026 年的新供给:地方平台开始开放标准化接口
据青岛政务网报道,青岛市行政审批局联合青岛自贸片区管委上线了被当地称为全国首个开放式的电子营业执照赋能平台,面向全市经营主体开放标准化系统开发接口,提供企业端扫码身份认证、照面信息共享等服务。报道日期见文末参考条目。
报道给出的运行口径是:全市电子营业执照系统已接入 105 个政务服务系统,支撑 1055 项涉企政务服务事项,2025 年全市使用量超 260 万次。这些数字只描述青岛一地、政务服务领域的现状,不能外推成全国普遍水平。
但对做鸿蒙开发的人,它给出一个方向性信号:供给正从"只服务政务系统"走向"对社会平台开放标准接口",且平台侧宣称可实现对全国所有经营主体的数字身份核验。端侧复杂度因此可控,真正决定工期的是资格、服务端对接和三方联调。
接入真正要做的三件事
一、企业授权:先把"谁代表企业"锁死
电子营业执照的授权是"法定代表人授权 + 实人认证"的组合,不是给企业开一个账号。办法第十七条明确了实人、实名、实照的使用原则,并规定对于电子营业执照的下载、出示、核验、身份认证、电子签名等基本应用功能,不允许额外收取市场主体使用费用。
工程上的含义是:你的 App 处理的不是用户名密码,而是一次法人扫脸或授权书签署的完整链路,以及授权被撤销、证照管理人员变更后的失效处理。授时过期、拒绝授权、重复授权这三条分支如果没有设计,上线后一定会回来补。
我们交付时的做法是把授权链路单独设成一个可验收里程碑:能稳定拿到授权结果、能处理拒绝、能处理过期,才算这一步走完,才允许多线程推进后面的活。
二、证照数据获取与解析
拿到授权凭据后,服务端向电子营业执照系统换取市场主体身份信息与状态。这里要提前定三件事:换取是"一次一换"还是可复用会话、字段更新时间戳怎么存、企业名称或法定代表人变更后旧数据如何失效。
解析环节别把字段映射写死在鸿蒙端。映射放在服务端,端侧只接收"已核验 + 展示所需字段",这样营业执照信息变更时不用发版,也不用等应用市场审核。
三、展示与校验
展示看似简单,实际要区分三种场景:出示(我有照,给对方看)、核验(我收到一个码,判断真假)、留档(招投标、企业开办、政务办事需要一次性快照)。
留档最容易出事。很多人想"存一张图",但执照文件带水印与数字签名值、状态会变,静态图片无法反映吊销与变更。合规做法是存核验结果与核验时间,而不是存一张可以被当作出示凭证的图。
鸿蒙端的四个适配差异
把 Android 版本平移过来通常能跑通流程,但下面四处会返工,而且都在联调后段才暴露。
| 环节 | 鸿蒙端的实际约束 | 常见返工点 |
|---|---|---|
| 网络与证书 | ArkTS 侧用系统网络能力发请求,政务侧常要求双向证书校验 | 照搬 Android 的证书固定配置,到鸿蒙侧握手直接失败 |
| 凭据存储 | 普通键值存储不加密,密钥与令牌应进系统密钥库(HUKS) | 把 access token 写进普通首选项,安全扫描判高危 |
| 扫码与权限 | 扫码优先走系统扫码能力,相机权限需在配置与运行时双声明 | 只改了权限配置,忘了首次拒绝后的降级路径 |
| H5 承载 | 若授权页由官方 H5 承载,需确认同层渲染 | 浮层被 Web 组件覆盖、输入框调不起键盘 |
还有一条不属于技术但会卡上线:隐私声明与最小必要采集。只取核验必需的字段,授权用途单独说明,别把可选用途混进主流程,否则合规审查会整段打回。
联调节奏:把"等对方排期"写进计划
电子营业执照接入不是甲乙双方的事,至少三方:政务侧或平台侧给测试企业账号与环境,你的团队写端与服务端,客户运维负责网络策略和上线窗口。
最容易失控的是第三方环境排期,不是代码。所以我们排期时固定做两件事:
- 把"环境可用"写成计划第一行的前置条件,而不是假设它天然可用;
- 先用 Mock 在本地把端侧全链路跑完,真实环境一到只做参数替换与回归。
这样即使对方排期延后两周,端侧工作量也不会空转。反过来,如果一开始就等真实环境才动手,同样两周会白白烧掉。
工期拆解:分项区间比一个总数有用
先划清范围:下表只含技术工作,不含应用接入的行政审批时间。表里的工作量是我们内部按分项拆出的排期口径,不是行业统计值,也不是对外承诺。
行政流程本身另有明确口径。按办法第十六条,省级区域内电子营业执照的应用接入,应向省级市场监管部门提出接入申请,由省级市场监管部门批准后报市场监管总局登记注册局备案。跨省级区域的电子营业执照应用接入,由省级市场监管部门向市场监管总局登记注册局提出接入申请,经批准后实施。这段等待取决于主管部门流程,不在开发团队的可控范围内。
| 环节 | 工作区间 | 说明 |
|---|---|---|
| 接入资格材料的技术配合 | 3–5 工作日 | 准备回调地址、安全方案说明、数据处理说明,不含审批等待 |
| 企业授权链路 | 5–8 个工作日 | 含法人授权、授权撤销与过期、异常分支 |
| 服务端核验对接与解析 | 6–10 个工作日 | 签名验签、字段映射、变更失效、审计日志 |
| 鸿蒙端页面与扫码调起 | 5–8 个工作日 | 含同层渲染排查、权限降级路径 |
| 三方联调与回归 | 8–15 自然日 | 其中等待对方环境窗口的时间往往占掉大部分 |
| 合规自查与隐私政策更新 | 2–3 个工作日 | 备案信息一致性、权限清单、最小必要复核 |
把区间加起来,编码类工作合计 16–26 个工作日,加上接入资格的材料技术配合与合规自查,整体落在 21–34 个工作日的量级;联调 8–15 自然日单独计,它不是收尾的零头——起止取决于对方环境窗口,窗口一晚两周,整个日历排期就顺延两周。这是我们按分项拆出的排期口径,不是对外承诺;实际项目要按端形态、是否多端复用、对接政务系统数量重算。
上线前要过的四项合规检查
- App 备案信息一致性:主办单位、应用名称、包名与实际运营主体一致,接入电子营业执照的业务场景要写进备案说明。
- 隐私政策:授权、核验、留档三个场景分别说明,写清收集哪些字段、保存多久、谁能访问。
- 权限清单:相机、网络、存储按实际使用逐条对应,删除未使用权限。
- 数据分类分级:证照信息属敏感个人信息,传输与存储加密、访问留痕、最小权限这三点要有可检查的证据。
备案侧的常见坑我们单独整理过,可以对照 大模型备案流程的分界线 和 鸿蒙应用开发合规指南 一起看,重点是别让备案信息与实际功能对不上。
报价受什么影响
同样叫"接入电子营业执照",报价能差出数倍,通常卡在四件事上:
- 历史证照数据迁移:存量企业信息要重建核验基线,工作量随条数与字段数上升;
- 是否多端复用:鸿蒙、Android、iOS 共用一套服务端最省,各自重写服务端最贵;
- 对接的政务系统数量:接一个办事系统与接五个系统,联调轮次不是线性增加;
- 是否需要留档与审计:招投标类场景对核验快照、审计日志、留存周期有额外要求。
谈报价前先把这四个问题写成一页纸,比让供应商盲报要准得多。技术路线本身也会改变成本结构,ArkTS 原生与跨平台的差异可以对照 鸿蒙应用开发外包:ArkTS 原生与跨平台的成本周期对比 来判断。
如果你正在深圳或粤港澳大湾区推进鸿蒙版政务、企业服务 App 的电子证照接入,可以把端形态、要对接的政务系统数量和授权场景发给我们,我们按上面的分项口径给一份排期估算:联系优码云。鸿蒙端工程的通用交付节奏,也可以参考 软件定制开发 · 鸿蒙端实战指南 和 鸿蒙应用开发外包怎么选:报价、周期与验收清单(2026 版)。
常见问题
鸿蒙版接入一定要依赖官方端侧 SDK 吗?
按条文口径,接入方被允许做的是联网验证,出示动作在官方应用程序内完成,所以工程上通常走"调起官方应用出示 + 服务端核验",不以端侧证照库为前提。至于有没有面向 HarmonyOS 的端侧 SDK、接口怎么调用,以取得接入资格后主管部门下发的技术文档为准,本文不下结论。需要提前设计的是端侧体验:依赖"调起官方应用"的跳转流畅度,返回与中断的处理都要先想好。
能不能把执照图片存在本地,以后离线核验?
不建议,也不合规。执照文件带水印与数字签名值,企业状态会变更,静态图片无法反映吊销、注销与信息变更。离线场景最多做"出示过的历史记录展示",权属判定必须回到联网核验。
为什么联调的时间最难控?
因为测试企业账号与联调环境在对方手上,中间还有客户的网络策略与上线窗口。可控的办法是把端侧链路先在 Mock 环境跑通,把真实环境只留给参数替换与回归,同时把环境可用作为计划前置条件显性列出。
是不是每家企业都能自己申请接入?
接入有明确的管理口径:省级区域内接入向省级市场监管部门申请、批准后报总局备案,跨省接入由省级向总局申请并批准后实施。内部自用与面向社会提供服务的场景,在材料准备上要求也不同,立项时就要把这段行政流程单列进计划。
参考
- 电子营业执照服务专区(市场监管总局,核实日期 2026-10-27)
- 《电子营业执照管理办法(试行)》(中国政府网)
- 青岛上线全国首个开放式电子营业执照赋能平台(青岛政务网,报道日期 2026-05-27)
