电子税务局-进项发票勾选
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 配置插件】和【2.3 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
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(微信同号)