开具数电发票插件

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(微信同号)

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验