开具数电发票插件
1. 简介
1.1 插件简介
开具数电发票插件支持连接电子税务局,自动开具数电发票(专票/普票、蓝票/红票),同时支持货物运输服务、建筑服务和不动产经营租赁服务这 3 种特定业务下的数电发票开具,并返回开票日期、发票号码、发票文件、发票地址,且可设置邮箱进行发票的对外交付。
1.2 应用场景
常用于根据销售订单、开票申请等进行自动开具发票,并通过邮件进行发票的对外交付。
1.3 预期效果
1)开票申请人在「开票申请」提交开票申请信息后,财务审批人员进行审批,待开票数据审核通过后,在「数据管理」处自动新增开具的数电发票。效果如下所示:
注:财务审批节点有「发送登录验证码」、「上传登录验证码」、「发起刷脸认证&检测登录刷脸状态」、「获取刷脸结果」这 4 个步骤,无需每日执行。后续开票时仅需执行第三步「发起刷脸认证&检测登录刷脸状态」,确认登录和刷脸状态是有效的即可,直到提示登录或者刷脸失效时,再去执行上述动作。
2)若需要对发票进行对外交付,根据表单内填写的邮箱地址自动发送邮件。效果如下所示:
1.4 使用说明
1)该插件包含 8 种事件,如下所示:
- 1.发送登录验证码
- 2.上传登录验证码(广东、天津、浙江、湖北四个地区无需上传验证码,可跳过此步骤)
- 3.发起刷脸认证&检测登录刷脸状态
- 4.获取刷脸结果
- 5.开具数据发票-API 版/5.开具数据发票-无 API 版
- 6.重新获取发票-API 版 / 6.开具数据发票-无 API 版
- 7.红冲发票
- 8.重新获取红票
注:该插件有无 API 权限均可使用,「API版」可返回发票文件和发票下载地址,「无API版」仅能返回发票下载地址。
2)开具数电发票插件可直接下载使用,但插件配置时的销方授权码需联系开发者购买。
- 一个税号对应一个销方授权码;
- 销方授权码为 1000 元/个/年。
注:开发者联系方式详见本文:【6. 联系方式】。
3)插件使用可安装 开具数电发票应用模板,安装后即可使用。
2. 插件安装及配置
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:开具数电发票插件安装。
- 安装成功后,可参考本文【2.2 配置插件】和【2.3 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「开具数电发票」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.2 配置插件
在插件管理中,点击插件右侧「设置」按钮,将「简道云API Key」「销方授权码」配置进去,配置完成后点击「保存」。
注:
1)无 API 权限的用户,可不填写「简道云API Key」,使用无 API 版函数开票即可。
2)通过【7. 联系方式】联系开发者获取销方授权码。
3)若有多个销方时,每个授权码分别换行配置到销方授权码中即可。
2.3 启用插件
在插件管理中,打开「开具数电发票」插件右侧开关,启用插件。
3. 表单搭建
插件使用体验可先安装:开具数电发票插件模板表单。本文将按照示例表单进行讲解。
- 该插件函数较多,配置较为复杂,文档分为主文档、蓝票开具和红票开具进行展开说明,企业登录部分在蓝票和红票开具中均会涉及,在主文档中一并示范,可新建表单在独立页签中进行配置后,再结合蓝票开具和红冲发票开具文档进行后续配置。
以开票申请为例,新建「开票申请」或「红冲发票」流程表单,字段设置如下所示:
字段说明 | 字段名称 | 是否必填 | 字段类型 |
企业登录-发送登录验证码 | 销方地区 | 是 | 下拉框,下拉框内容设置详见【4.1 关于销方地区的说明】 |
用户名 | 单行文本 注:此处填写为登录电子税务局的用户名和密码。 | ||
用户密码 | |||
身份类型 | 下拉框,设置下拉框选项为:
| ||
税局手机号 | 单行文本 | ||
发送验证码 | 按钮 | ||
企业登录-上传登录验证码 | 登录任务ID | 是 | 单行文本 |
短信验证码 | |||
上传验证码 | 按钮 | ||
登录结果 | 单行文本 | ||
企业登录-发起刷脸认证&检测登录刷脸状态 | 发起刷脸认证 | 是 | 按钮 |
刷脸认证ID | 单行文本 | ||
刷脸认证二维码 | |||
发起刷脸结果 | |||
发起刷脸时间 | 日期时间,设置类型为【年-月-日 时:分:秒】 | ||
企业登录-获取刷脸结果 | 获取刷脸结果 | 是 | 按钮 |
刷脸认证结果 | 单行文本 | ||
刷脸认证时间 | 日期时间,设置类型为【年-月-日 时:分:秒】 |
4. 设置前端事件
登录刷脸部分分为「1.发送登录验证码」、「2.上传登录验证码」、「3.发起刷脸认证&检测登录刷脸状态」、「4.获取刷脸结果」,这 4 个执行动作均为按钮触发,配置方式相同。本章节以「发送登录验证码」为例,具体配置步骤如下所示:
4.1 添加按钮执行动作
点击「发送验证码」按钮,进入「字段属性」,点击执行动作下的设置,添加执行动作:
4.2 设置事件名称和说明
添加好执行动作后,首先设置前端事件的基础信息,即事件名称和事件说明,用于区分执行动作:
4.3 设置执行动作
1)设置执行动作如下:
- 选择插件:选择「开具数电发票」插件;
- 选择执行动作:1.发送登录验证码
- 配置参数:分别以「字段值」方式配置销方税号、销方地区、用户名、用户密码、身份类型、税局手机号;
2)设置执行返回信息回填至哪些字段中,设置完成点击「保存」。
注:
1)「3.发起刷脸认证&检测登录刷脸状态」和「4.获取刷脸结果」都有认证结果、认证时间两个返回值,「3.发起刷脸认证&检测登录刷脸状态」返回到发起刷脸结果和发起刷脸时间字段中,「4.获取刷脸结果」返回到刷脸认证结果和刷脸认证时间中。
2)当前税局已延长登录有效时长,无需每次开票都登录和刷脸,财务审核时点击「3.发起刷脸认证&检测登陆刷脸状态」,若发起刷脸结果返回 success,代表当前登录和刷脸处在「有效」中,则可以直接提交开票。
3)为避免因其他工作影响,忘记刷脸是否有效的情况,可在流程「财务审核节点>>节点属性>>流转规则」中增加一个提交校验的条件:
- 人工点击&提交校验:每次审核时点击「3.发起刷脸认证&检测登录刷脸状态」,若登录和刷脸都是有效的,会返回一个状态和时间,用刷脸认证时间和当前时间(now)做一个小于1分钟的提交校验;
- 参考校验公式:OR(DATEDIF(发起刷脸时间,NOW(),"m")<1,DATEDIF(发起刷脸时间,NOW(),"m")<1)
5. 注意事项
5.1 关于销方地区的说明
请根据销方所在地区,填写以下标准名称:
北京市、天津市、河北省、山西省、内蒙古、辽宁省、大连市、吉林省、黑龙江省、上海市、江苏省、浙江省、宁波市、安徽省、福建省、厦门市、江西省、山东省、青岛市、河南省、湖北省、湖南省、广东省、深圳市、广西、海南省、重庆市、四川省、贵州省、云南省、西藏、陕西省、甘肃省、青海省、宁夏、新疆。
注:以上名称中某些城市是独立的税局,因此销方所在地区需要传具体的城市,不能再传省。
5.2 关于登录时税局手机号的说明
除广东、浙江、湖北外,其他地区税局手机号都是必传。
且广东、浙江、湖北四个地区,仅需要做登录,不需要发送验证码,可直接进入刷脸认证环节。
5.3 关于登录扫脸状态控制的说明
如需调整扫脸认证时长,可用企业法人或财务管理员账号登录税局,在「蓝字发票开具 >> 发票填开」右侧设置扫脸认证时长。
6. 插件使用
开具数电蓝票和开具数电红冲发票。您可通过阅读以下文档,来完成插件的配置及使用:
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)