电子税务局-进项发票勾选

1. 简介

1.1 插件简介

电子税务局-进项发票勾选插件支持在简道云中,对电子税务局 发票勾选确认中的发票,进行抵扣、退税、不抵扣、撤销抵扣、撤销不抵扣和撤销退税等抵扣类勾选类型的操作,并且将更新后的数据同步至电子税务局。

1.2 应用场景

常用于在简道云中需进行发票勾选确认等相关业务时,用该插件直接在简道云表单中对需勾选确认的发票,进行抵扣、退税、不抵扣、撤销抵扣、撤销不抵扣和撤销退税等勾选类型的操作,发票勾选状态同步更新至电子税务局,方便财务人员在简道云中统一管理发票业务。

1.3 预期效果

开启电子税务局-进项发票勾选插件,在「电子税务局-进项发票勾选」表单中填写相关信息后效果如下所示:

1.4 使用说明

1)该插件包含 6 种事件,如下所示:

  • 1.发送登录验证码
  • 2.上传登录验证码
  • 3.获取最新税款所属期
  • 4.进项发票采集
  • 5.进项发票勾选
  • 6.获取勾选结果

2)该插件可直接插件市场安装使用,但插件配置时的销方授权码需联系开发者购买。

  • 一个税号对应一个销方授权码;
  • 销方授权码为 1000 元/个/年。

注:开发者联系方式详见本文:【7. 联系方式】。

2. 插件安装及配置

2.1 安装插件

1)直接安装

2)在简道云「插件市场」处,安装「电子税务局-进项发票勾选」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】

2.2 配置插件

在插件管理中,点击插件右侧「设置」按钮,将「销方授权码」配置进去,配置完成后点击「确定」。

注:销方授权码需联系开发者获取。

2.3 启用插件

在插件管理中,打开「电子税务局-进项发票勾选」插件右侧开关,启用插件。

3. 表单搭建

插件使用体验可先安装:电子税务局-进项发票勾选模板表单。本文将按照示例表单进行讲解。

3.1 企业登录表单

1)新建「企业登录」表单,字段设置如下所示:

字段说明

字段名称

是否必填

字段类型

企业登录-发送登录验证码

销方地区

下拉框,下拉框内容设置详见【6.1 关于销方地区的说明】

销方税号

新增一个销方税号字段,用于前端事件配置。

用户名

单行文本

注:此处填写为登录电子税务局的用户名和密码

用户密码

身份类型

下拉框,设置下拉框选项为:

  • 法定代表人
  • 财务负责人
  • 开票员
  • 办税员
  • 领票人
  • 涉税服务人员
  • 管理员
  • 社保经办人
  • 出口退税人员
  • 销售人员
  • 行政办事员
  • 其他人员

税局手机号

单行文本

发送验证码

按钮

企业登录-上传登录验证码

登录任务ID

单行文本

短信验证码

上传验证码

按钮

登录结果

单行文本

获取当前税期

获取当前税期

按钮

纳税人识别号

单行文本,在「字段属性 >> 默认值」处选择公式编辑,设置公式如下:

销方税号

税期所属期

单行文本,为返回内容

税期所属任务

注:税期所属期可配置到任意表单中获取,本表仅做配置示范。当期税期为固定值,税期更换时,需执行一次获取,但无需每次发票勾选都获取,只需把获取到当期税期传递到发票勾选插件中即可。

注:

1)表单中的按钮字段,需购买销方授权码,配置插件后再进行按钮配置。

2)本插件中的企业登录和【开具数电发票插件】均为电子税局登录接口:

  • 可参考本文档搭建企业登录表单使用,只需确保数据同步执行时,税局登录在有效时长内即可。
  • 如已使用【开具数电发票插件】,也可直接使用【开具数电发票插件】表单中的企业登录检验登录是否有效。

3)首次登录可按1-2 步骤进行,后续使用可直接点击【发送验证码】按钮,在【2.登录任务 ID】中返回succese,则证明登录在时效内。

4)部分地区不用上传验证码,但也需点击发送验证码校验下是否有效。

5)税期所属期只需获取一次当期税期即可,无需每次发票勾选都获取。

3.2 发票勾选表单

1)新建发票勾选表单,将发票勾选的信息,以字段形式添加至本表单:

字段说明

字段名称

字段类型

备注

填写字段

企业纳税人识别号

单行文本

必填。

数电发票号码

数电发票时必填(号码为:20 位)

发票代码

无数电发票号码时填写此项

发票号码

无数电发票号码时填写此项

勾选类型

下拉框

必填,下拉框选项为:

  • 抵扣
  • 退税
  • 不抵扣
  • 撤销抵扣
  • 撤销不抵扣
  • 撤销退税

不抵扣原因

下拉框

勾选不抵扣时为必填:

  • 用于非应税项目
  • 用于免税项目
  • 用于集体福利或者个人消费
  • 非正常损失的
  • 其他

不抵扣原因描述

单行文本

勾选不抵扣且不抵扣原因为其他时必填

税期所属期

在此字段中填写/关联/写入当期税期时,此项必填。也可直接在插件配置参数中填写默认值,此时无需表单填写此字段。

发票采集信息

采集日期

下拉框

非必填,下拉框选项为:

  • 昨天
  • 今天
  • 上周
  • 本周
  • 上月
  • 本月
  • 去年
  • 今年

注:发票采集可配置在前端事件中,也可配置在智能助手Pro定时任务中,表单搭建以前端事件为例,如使用前端事件进行发票采集,此项为必填

采集总数

单行文本

选择采集日期后,所采集的发票数量。

开始采集

按钮

——

回填字段

发票类型

下拉框

返回内容

开票日期

日期时间

年-月-日 时分秒

金额

数字

返回内容

税额

有效税额

勾选状态

单行文本

勾选时间

日期时间

年-月-日 时分秒

处理结果

单行文本

返回内容

错误码

错误信息

辅助字段

勾选任务状态

单行文本

返回内容

发票明细

在「字段属性 >> 默认值」处选择公式编辑,公式如下:

CONCATENATE('{','"qdfphm":数电发票号码,"fpdm":发票代码,"fphm":发票号码','}')

4. 按钮配置

4.1 企业登录按钮

企业税局登录中,「1.发送登录验证码」、「2.上传登录验证码」这 2个执行动作均为按钮触发,配置方式相同。本章节以「发送登录验证码」为例,具体配置步骤如下所示:

4.1.1 添加按钮执行动作

点击「发送验证码」按钮,进入「字段属性 >> 执行动作」处,点击「设置」添加执行动作:

4.1.2 设置事件名称和说明

添加好执行动作后,首先设置前端事件的基础信息,即事件名称和事件说明,用于区分执行动作:

4.1.3 设置执行动作

设置执行动作如下:

  • 选择插件:选择「电子税务局-进项发票勾选」插件;
  • 选择执行动作:1.发送登录验证码
  • 配置参数:分别以「字段值」方式配置销方税号、销方地区、用户名、用户密码、身份类型、税局手机号;
  • 字段存储关系:将「登录任务 ID」的值存储到「登录任务 ID」字段中。

设置完成点击「保存」。

注:

1)「1.发送验证码」中点击发送验证码按钮,在「2.上传登录验证码」的【登录任务ID】重返回「succese」,即表示登录状态目前为有效。

2)此项配置在企业登录表单中。

4.2 获取税期按钮

4.2.1 添加按钮执行动作

点击「获取当期税期」按钮,进入「字段属性 >> 执行动作」处,点击「设置」添加执行动作:

4.2.2 设置事件名称和说明

添加好执行动作后,首先设置前端事件的基础信息,即事件名称和事件说明,用于区分执行动作:

4.2.3 设置执行动作

执行动作如下:

  • 选择插件:选择「电子税务局-进项发票勾选 >> 3.获取最新税款所属期」插件;
  • 配置参数:分别以「字段值」方式配置纳税人识别号;
  • 字段存储关系:
    • 将「税期所属期」的值存储到「税期所属期」字段中;
    • 将「税期任务状态」的值存储到「税期任务状态」字段中。

设置完成点击「保存」。

注:此项可根据实际业务,配置到方便获取税期的表单中,当期只需获取一次即可。

4.3 发票采集按钮

4.3.1 添加按钮执行动作

点击「发票采集」按钮,在「字段属性 >> 执行动作」处,点击「设置」添加执行动作:

4.3.2 设置事件名称和说明

添加好执行动作后,首先设置前端事件的基础信息,即事件名称和事件说明,用于区分执行动作:

4.3.3 设置执行动作

设置执行动作如下:

  • 选择插件:选择「电子税务局-进项发票勾选 >> 4.进项发票采集」插件;
  • 配置参数:分别以「字段值」方式配置「纳税人识别号」、「采集日期」。
  • 字段存储关系:
    • 将「采集总数」的值存储到「采集总数」字段中。

设置完成点击「保存」。

5. 智能助手Pro配置

5.1 新建智能助手Pro

进入「发票勾选」表单中,在「扩展功能 >> 智能助手」处,点击「新建智能助手」,修改智能助手Pro 的名称为「发票勾选」,并选择触发方式为表单触发:

5.2 配置表单触发动作

触发动作进行如下设置:

  • 触发动作:
    • 选择新增数据」时;
    • 或「修改数据勾选任意指定字段>>勾选类型

注:勾选类型状态改变时可继续触发智能助手pro 修改当前数据状态。

5.3 配置发票勾选插件节点

点击节点连接线上的加号按钮,添加插件节点,进行如下设置:

  • 执行插件:选择「电子税务局-进项发票勾选 >> 5.进项发票勾选」;
  • 纳税人识别号:选择字段值,勾选「触发数据--企业纳税人识别号」;
  • 发票明细:选择字段值,勾选「发票明细」;
  • 勾选类型:选择字段值,勾选「触发数据--勾选类型」;
  • 税款所属期:选择自定义,填写「202506」(填写当期税期或勾选对应字段值);
  • 不抵扣原因:选择字段值,勾选「触发数据--不抵扣原因」;
  • 不抵扣原因描述:选择字段值,勾选「触发数据--不抵扣原因描述」。
  • 添加执行结果如下:
    • 任务编号,勾选为文本类型;

注:税款所属期可自定义填写,勾选字段值或不填,不填默认取上月税期。

  • 如今天是 7 月1 日则税期为 202506,如今天是 6 月 30 日则税期默认为 202505。

5.4 勾选结果获取配置

5.4.1 循环容器配置

点击节点连接线上的加号按钮,添加循环容器,进行如下设置:

  • 节点名称:填写「循环容器」;
  • 循环方式:勾选:不指定循环数据,在循环中设置「结束循环」;
  • 最大循环次数:填写为 200;
  • 循环过程中执行失败时:跳过失败的轮次进入下一次循环。

5.4.2 勾选结果获取配置

在循环容器节点连接线上的加号按钮,添加插件节点,进行如下设置:

  • 执行插件:选择「电子税务局-进项发票勾选 >> 6.获取勾选结果」;
  • 纳税人识别号:选择字段值,勾选「触发数据--企业纳税人识别号」;
  • 任务编号:选择字段值,勾选「发票勾选--任务编号」;
  • 添加执行结果如下:
    • 任务状态,勾选为文本类型;
    • 发票列表.发票类型,勾选为文本类型;
    • 发票列表.开票日期,勾选为日期时间类型;
    • 发票列表.金额,勾选为数字类型;
    • 发票列表.税额,勾选为数字类型;
    • 发票列表.有效税额,勾选为数字类型;
    • 发票列表.勾选任务状态,勾选为文本类型;
    • 发票列表.处理结果,勾选为文本类型;
    • 发票列表.错误信息,勾选为文本类型;
    • 发票列表.错误码,勾选为文本类型;
    • 发票列表.发票风险等级,勾选为文本类型;
    • 发票列表.勾选状态,勾选为文本类型;
    • 发票列表.勾选时间,勾选为日期时间类型;
    • 发票列表.勾选类型,勾选为文本类型;
    • 发票列表.全电票号码,勾选为文本类型;
    • 发票列表.发票号码,勾选为文本类型;
    • 发票列表.发票代码,勾选为文本类型。

注:示范按全部字段勾选,返回字段可根据实际业务选择勾选。

5.4.3 分支节点条件设置

在勾选结果获取插件节点后的连接线上点击加号按钮,添加「逻辑节点>>条件分支」,三个分支设置条件如下:

  • 分支条件1:设置条件节点为:勾选结果获取>>勾选任务状态等于 申请处理完成;
  • 分支条件2:设置条件节点为:勾选结果获取>>勾选任务状态等于 申请处理失败;
  • 其他条件:无需手动设置即所有条件都不满足时执行本分支。

5.4.4 分支节点修改数据设置

1)在三个分支条件后,点击链接线,分别添加修改数据节点,修改数据筛选条件配置均一样,设置如下:

  • 修改对象:选择「发票勾选」表单;
  • 筛选出要修改的数据:满足所有条件的数据:
    • 数电发票号码:等于任意一个 「勾选结果获取--数电发票号码」;
    • 发票号码:等于任意一个 「勾选结果获取--发票号码」;
    • 发票代码:等于任意一个 「勾选结果获取--发票代码」。

2)分支条件1 >>申请处理完成,设置字段值如下:

  • 添加「勾选时间」,勾选「勾选结果获取--勾选时间」;
  • 添加「处理结果」,勾选「勾选结果获取--处理结果」;
  • 添加「勾选状态」,勾选「勾选结果获取--勾选状态」;
  • 添加「勾选类型」,勾选「勾选结果获取--勾选类型」。
  • 设置待修改数据和「勾选结果获取」的匹配关系如下:
    • 添加「数电票号码」,勾选「勾选结果获取--发票列表.全电票号码」;
    • 添加「发票号码」,勾选「勾选结果获取--发票列表.发票号码」;
    • 添加「发票号码代码」,勾选「勾选结果获取--发票列表.发票代码」。

注:其他返回字段,可根据实际使用自行添加。

3)分支条件2 >> 申请处理失败,设置字段值如下:

  • 添加「处理结果」,勾选「勾选结果获取--处理结果」;
  • 添加「错误信息」,勾选「勾选结果获取--错误信息」;
  • 添加「错误码」,勾选「勾选结果获取--错误码」。
  • 设置待修改数据和「勾选结果获取」的匹配关系如下:
    • 添加「数电票号码」,勾选「勾选结果获取--发票列表.全电票号码」;
    • 添加「发票号码」,勾选「勾选结果获取--发票列表.发票号码」;
    • 添加「发票号码代码」,勾选「勾选结果获取--发票列表.发票代码」。

3)其他条件分支,设置字段值如下:

  • 添加「处理结果」,勾选「勾选结果获取--处理结果」;
  • 添加「勾选状态」,勾选「勾选结果获取--勾选状态」。
  • 设置待修改数据和「勾选结果获取」的匹配关系如下:
    • 添加「数电票号码」,勾选「勾选结果获取--发票列表.全电票号码」;
    • 添加「发票号码」,勾选「勾选结果获取--发票列表.发票号码」;
    • 添加「发票号码代码」,勾选「勾选结果获取--发票列表.发票代码」。

5.5.4 分支节点结束循环设置

在分支条件 1 和分支条件 2 的修改数据节点之后,需要分别添加结束循环节点,点击链接线的加号按钮,在逻辑节点中,添加「结束循环」即可。

5.6 保存并启用

全部设置完成后,点击右上方「保存并启用」,启用智能助手。

6. 注意事项

6.1 关于登录时填写销方地区的说明

请根据销方所在地区,填写以下标准名称:

北京市、天津市、河北省、山西省、内蒙古、辽宁省、大连市、吉林省、黑龙江省、上海市、江苏省、浙江省、宁波市、安徽省、福建省、厦门市、江西省、山东省、青岛市、河南省、湖北省、湖南省、广东省、深圳市、广西、海南省、重庆市、四川省、贵州省、云南省、西藏、陕西省、甘肃省、青海省、宁夏、新疆。

注:以上名称中某些城市是独立的税局,因此销方所在地区需要传具体的城市,不能再传省。

6.2 关于登录时税局手机号的说明

除部分地区外,其他地区税局手机号都是必传。建议首次登录使用时,「1.发送验证码」中点击发送验证码按钮,在「2.上传登录验证码」的【登录任务ID】重返回「succese」,即表示登录状态目前为有效,可以直接同步数据。

部分地区虽不用验证码登录,但也需在「1.发送验证码」中点击发送验证码按钮,校验是否在登录状态。

6.3 关于获取税期的配置说明

本文档示范配置于「企业登录」表单中,可结合实际业务配置到任意表单中进行当期税期获取。获取当期税期为勾选必要动作,当期税期通常为固定值,税期更换时,需执行一次获取动作,不用每次勾选都执行,只需把获取到当期税期传值到发票勾选插件相关参数中。

税款所属期参数可自定义填写,勾选字段值或不填,不填默认取上月税期。税款所属期无论自定义填写、不填还是勾选字段值,均需执行一次当期税期的获取。

  • 如今天是 7 月 1 日则税期为 202506,如今天是 6 月 30 日则税期默认为 202505。

6.4 关于采集发票的配置说明

发票采集为必须动作,可配置在前端事件中,也可配置在智能助手Pro 定时任务中,表单搭建以前端事件为例。

6.5 关于批量勾选的说明

如有批量发票勾选提交需求,插件配置可下载本文档中的应用模板,参考模板配置,批量勾选动作可尝试使用简道云表单和智能助手pro 功能。

6.6 其他说明

1)插件执行需要一定时间,参考上述配置后插件会自动在循环容器中慢慢执行,请耐心等待。

2)任务处理结果会返回表单当中,不会阻断智能助手Pro 执行。

7. 联系方式

该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:

  • 公司:成都轻如燕企业服务有限公司
  • 联系人:赵鹏
  • 联系电话:18583980516(微信同号)

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