① 企业授权
回收企业开票前的第一步:调本接口拿到工行的税务授权二维码页。页面类:POST 进 → 拿 pageUrl → 跳过去。下面是工行全部字段,原样传;标「中台填」的开灵自动补。
老板端操作流程(业务步骤 · 不在接口内)
- 你们页面点「企业授权」→ 调本接口 → 拿
pageUrl→ 跳工行二维码页。 - 企业法定代表人或财务负责人用「电子税务局 App」登录本企业。
- 扫码 → 刷脸实名 → 录入授权有效期。
- 首次还需手动下载一次发票,自动开票额度才生效。
必须法人 / 财务本人、且已登录电子税务局;换别人扫无效。
接口
POST https://openapi.kailingteck.com/api/v1/icbc/enterprise/auth
鉴权:X-App-Key + X-Sign + X-Timestamp。
请求参数(工行全字段 · 原样传)
| 工行字段 | 必填 | 大白话说明 |
|---|---|---|
appId | 中台填 | 平台编号(开灵自动填,你不用传) |
outVendorId | 看档案类型 | 子商户编号(开票档案类型为 01/02/03/04 时必填) |
archiveType | 必填 | 开票档案类型:00-平台档案 / 01-子商户 / 02-反向开票助手 / 03-合作机构开票企业 / 04-合作机构平台子商户 |
partnerMerTrueAppId | 看档案类型 | 真实商户 appId(合作机构模式;档案类型 03 或 04 时必填) |
accessMethod | 选填 | 接入方式:00-PC / 01-H5(默认 00) |
jumpUrl | 选填 | 授权完成后跳回你们页面的地址 |
unitNumber | 选填 | 乐企 ID |
humanType | 选填 | 授权人身份:01-法定代表人 / 02-财务负责人 |
authHumanType | 选填 | 授权人证件类型:201-身份证 / 227-中国护照 / 208-外国护照 …(具体见工行字典) |
authPersonNumber | 选填 | 授权人证件号码 |
返回
{ "code": "CYT_00000", "data": { "pageUrl": "https://…/redirect/rxxx", "mock": false } }页面类接口:返回一个 pageUrl,前端 location.href = pageUrl 跳工行页即可。不用单独做 H5。