⑳ 查开票人授权办完没有
企业开通环节的验收点:法人扫码授权、指定开票人之后,到底办成了没有? 本接口把这家企业在乐企上的开票人员名单拉出来,每个人一个状态。名单里至少要有一个人是「1-已确认」,后面才能正常开票; 全是 0(未确认)就说明人还没点同意,别急着下单。数据类:POST 进 / 工行原样 JSON 出。
接口
POST https://openapi.kailingteck.com/api/v1/icbc/invoice/register-confirm
鉴权:请求头 X-App-Key + X-Sign + X-Timestamp(同其它开灵接口)。
请求参数(工行全字段 · 原样传)
| 工行字段 | 必填 | 大白话说明 |
|---|---|---|
appId | 中台填 | 平台编号(开灵自动填,你不用传) |
taxpayerNo | 必填 | 开票企业的税号(统一社会信用代码) |
proTaxAuthCode | 必填 | 省市级税务机关代码(企业开通时税局给的那串码) |
{
"taxpayerNo": "11000000000000003705",
"proTaxAuthCode": "4564646"
}返回(工行原样返回)
| 工行字段 | 大白话说明 |
|---|---|
returnCode | 返回码(0-成功,其它-失败) |
returnMsg | 返回信息 |
taxpayerNo | 使用单位纳税人识别号 / 统一社会信用代码 |
taxpayerName | 使用单位名称(工行回填,可用来核对税号有没有填错) |
proTaxAuthCode | 省市级税务机关代码 |
invoicePersonInfoNum | 开票人员记录数(有几个人) |
invoicePersonInfo | 开票人员名单(数组,字段见下表) |
invoicePersonInfo 开票人员明细
| 工行字段 | 大白话说明 |
|---|---|
invoicePersonName | 开票人员姓名 |
invoicePersonCreditCode | 开票人员证件号码 |
invoicePersonCreditType | 证件类型:201-居民身份证 / 210-港澳居民来往内地通行证 / 213-台湾居民来往大陆通行证 / 227-中国护照 / 237-港澳居民居住证 / 238-台湾居民居住证 |
inviteDate | 邀请时间 yyyy-MM-dd HH:mm:ss(什么时候把这个人拉进来的) |
confirmDate | 确认时间 yyyy-MM-dd HH:mm:ss(这个人什么时候点的同意) |
unbindDate | 解除时间 yyyy-MM-dd HH:mm:ss(什么时候被移出的) |
invoicePersonConfirmStatus | 确认状态:0-未确认 / 1-已确认 / 2-已拒绝 / 3-已解除 |
排障口诀:开票报「未授权 / 无权限」→ 先查这里。状态 2(已拒绝)或 3(已解除)要重新邀请一次; 状态 0 说明短信 / 工行 APP 里那条确认还没点。未配工行凭据时返回 { mock: true }。