㉒ 授权续期(免得再找老板扫码)
企业开通时法人扫码授权,拿到的是一个有有效期的授权令牌。到期就开不了票, 重新走一遍扫码要再麻烦一次法人。本接口就是在到期前静默续期,不用惊动任何人。 数据类:POST 进 / 工行原样 JSON 出。
接口
POST https://openapi.kailingteck.com/api/v1/icbc/enterprise/refresh-auth
鉴权:请求头 X-App-Key + X-Sign + X-Timestamp(同其它开灵接口)。
请求参数(工行全字段 · 原样传)
| 工行字段 | 必填 | 大白话说明 |
|---|---|---|
appId | 中台填 | 平台编号(开灵自动填,你不用传) |
archiveType | 必填 | 开票档案类型:00-平台档案 / 01-子商户档案 / 02-反向开票助手 / 03-合作机构开票企业 / 04-合作机构平台子商户 |
outVendorId | archiveType≠00 时必填 | 子商户编号(即回收企业编号)。archiveType=03 时要和真实商户 appId 一致 |
partnerMerTrueAppId | archiveType=03/04 时必填 | 开票企业外部编号(合作机构模式专用) |
{
"archiveType": "01",
"outVendorId": "562526"
}返回(工行原样返回)
| 工行字段 | 大白话说明 |
|---|---|
returnCode | 返回码(0-成功,其它-失败) |
returnMsg | 返回信息 |
只回一个成败,没有业务数据。刷完想确认效果,配 ⑳ 查开票人授权状态 一起看。 未配工行凭据时返回 { mock: true }。
怎么用最省事
- 挂定时任务:每家已开通企业每天(或每周)跑一次,一次一个
outVendorId,失败重试即可。 - 开票前兜底:发现开票报授权类错误,先调一次本接口再重试,大概率就过了。
- 档案类型别填错:平台自营模式一般是
01(子商户档案),合作机构模式才用03/04并补partnerMerTrueAppId。