现状
每月开票高峰期，财务部是不是都像"战场"？手动录入客户税号、商品明细反复核对怕出错，开票后还要把数据手动录入财务系统做台账，一张发票耗时几分钟不说，月均还得处理因录各种原因的红冲重开。
那么有没有办法解决如上现状呢？答案是自动开票API。随着数电发票的普及，自动开票API已成为企业财税数字化必不可少的工具。
优势
系统集成：企业的业务系统（如ERP、电商平台、收银系统）通过集成自动开票API，可以与税务服务平台或发票服务商直接进行数据交换 。通过这种直连，系统可以在触发特定条件（如订单支付完成、货物签收）时，自动完成发票的开具、填写、校验和推送，无需人工登录税务网站或手动录入数据。
极致效率与成本优化：将人工从重复劳动中解放出来。例如，通过财务凭证接口平台，企业原本需要3-5天的手工录入工作可缩短至1小时内自动完成。
数据准确与合规管理：接口直连确保了业务数据与开票数据的一致性，避免了手工录入导致的错填、漏填。
提升用户体验：对于终端消费者而言，自动开票接口意味着“支付即开票”或“扫码即开票”，极大地提升了开票体验。
功能
自动开票API支持：增值税专用发票，普通发票。功能包括：登录税局、实名认证、发票开具、发票交付、冲红等API。
详见这里
登录税局
发票开具需先调用登录接口去登录税局
登录之后，如果登录未过期，可一直发起开票任务，如果过期则再次调用登录接口
每次发起开票任务，需要判断登录是否过期（调用判断登录状态接口）
- 请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| nsrsbh | String | 是 | 纳税人识别号 |
| dq | String | 是 | 地区编码 |
| sflx | String | 是 | 身份类型 |
| gryhm | String | 是 | 登录账号，该值可为：居民身份证/手机号/用户名 |
| gryhmm | String | 是 | 登录密码 |
| sjhm | String | 否 | 手机号码，除浙江外，该值必填 |
- 登录成功返回样例
{
"code": 200,
"msg": "成功",
"taskNo": "526782409178028989145499",
"charge": false
}
- 发送验证码返回样例
{
"code": 202,
"msg": "已发送验证码，请再调用校验验证码接口完成登录",
"taskNo": "526782409178028989145499",
"charge": false,
"data": {
"validateCodeSmsTaskId": "12121321323123123323" // 短信验证码taskId，校验验证码时需要传入该参数
}
}
实名认证
登录之后还需要实名认证，步骤如下：
调用获取人脸识别认证二维码接口获取二维码
用税务App扫码进行人脸识别
再调用获取人脸识别认证结果接口获取认证结果
获取人脸识别认证二维码
- 请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| nsrsbh | String | 是 | 纳税人识别号 |
| type | String | 是 | 扫码方式，1-税务app，2-个税app |
- 返回样例
{
"code": 200, // 详见code返回码说明
"msg": "成功",
"taskNo": "69564903663951243279",
"data": {
"qrcodeContent":"", // 二维码内容
"qrcodeImageUrl":"", // 二维码图片地址，有效期30分钟
"authenticationId":"" // 认证ID，通过该ID可查询是否已刷脸状态
}
}
获取人脸识别认证结果
- 请求参数
| 名称 | 类型 | 必须 | 说明 |
|---|---|---|---|
| nsrsbh | String | 是 | 纳税人识别号 |
| authenticationId | String | 是 | 获取人脸识别认证二维码返回的认证ID |
| type | String | 是 | 扫码方式，1-税务app，2-个税app |
- 返回样例
认证成功
{
"code": 200,
"msg": "成功",
"taskNo": "69564903663951243279"
}
已生成二维码未扫脸
{
"code": 211,
"msg": "已生成二维码未扫脸",
"taskNo": "69564903663951243279"
}
二维码已过期
{
"code": 212,
"msg": "二维码已过期",
"taskNo": "69564903663951243279"
}
开票
发票开具为异步方式，步骤如下：
调用发起开票任务接口，返回任务id。
用返回的任务id，调用发票开具结果查询接口，即可查询开票结果，结果主要包括：发票号码和开票日期。
再用返回的发票号码和开票日期，调用发票下载接口，即可获取发票文件，支持（PDF, OFD, XML）。
详见
冲红
当发票需要作废时，可调用红字发票开具接口来冲红，冲红支持全额冲红和部分冲红。
