开具数电红票
使用开具数电红票,需先完成【开具数电发票】主文档 中插件配置和企业登录的配置后再进行本文档的功能配置。
1. 简介
1.1 场景简介
开具数电发票插件支持连接电子税务局,自动开具数电红冲发票,并自动返回红票日期,红票号码、红票文件、红票地址等红票信息。
1.2 应用场景
常用于开票有误、销货退回、服务中止和销售折让等需要开具红冲发票的场景。
1.3 预期效果
开票申请人在「红冲发票」 表单提交红冲发票申请后,财务审批人员进行审批,待开票数据审核通过后,在「数据管理」处自动新增开具的红冲发票。效果如下所示:
1.4 使用说明
1)该插件有无 API 权限均可使用,「API 版」可返回红票文件和红票下载地址,「无 API 版」仅能返回红票下载地址。
2)其他配置请参考:
- 插件安装和配置请参考【开具数电发票 >> 2. 插件安装及配置】。
- 本场景需登录税局,企业登录配置请参考【开具数电发票 >> 3. 表单搭建】。
4)开具红冲发票为开具数电发票插件的一个函数,函数使用您可先点击下方链接安装插件及插件模板,安装后参考使用指南使用。
- 插件安装:开具数电发票插件安装链接;
- 插件应用模板:开具数电发票应用模板。
2. 表单搭建
1)新建「红冲发票」流程表单,字段设置如下所示:
字段说明 | 字段名称 | 是否必填 | 字段类型 |
蓝票信息 | 销方税号 | 是 | 单行文本 |
购方税号 | |||
蓝票号码 | |||
蓝票日期 | 日期时间 | ||
发票类型 | 下拉框,设置下拉框选项为:
| ||
红冲信息 | 红冲原因 | 是 | 下拉框,设置下拉框选项为:
|
返回信息 | 红票号码 | 返回值 | 单行文本 |
红票日期 | 日期时间 | ||
红票地址 | 单行文本 | ||
红票请求ID | |||
红冲结果 | |||
红票文件 | 附件 |
2)进入「扩展功能 >> 数据推送」中,点击设置字段别名,依次将字段别名设置为下方别名,设置完成后,点击「保存」按钮。设置如下所示:
- 红票文件:files
注:此项仅需 API 版用户配置,无 API 版无需配置。
3. 红冲发票流程节点设置
因开具红冲发票涉及请求参数和返回参数,故需要使用流程中的插件节点来实现。
红冲发票需对应原蓝票信息进行红冲,红冲时为全额红冲,每张蓝票可以红冲一次。
3.1 流程发起节点
点击流程发起节点,在「节点属性 >> 节点名称」处,修改节点名称为「发起红票申请」;在「节点属性 >> 字段权限」处,勾选部分字段的「可见」、「可编辑」权限:
3.2 财务登录&刷脸节点
在「流程设定」中,从工具栏中选择「流程节点」,将其拖动至流程图中,通过流程连接线将全部流程节点串联起来,并在「节点属性>>字段权限」处,勾选部分字段的「可见」、「可编辑」权限。如下所示:
3.3 配置开具红冲发票节点
3.3.1 添加插件节点
在「流程设定」中,从工具栏中选择「插件节点」,将其拖动至流程图中,在「节点属性 >> 节点名称」处设置节点名称为「开具数电发票」,然后点击「插件配置」,如下所示:
3.3.2 配置插件节点
进入插件配置页面,插件配置如下所示:
- 插件选择:选择「开具数电发票 >> 7.红冲发票-」;
- 数据 ID:设置为「字段值」,即「数据 ID」字段。
- 销方税号:设置为「字段值」,即「销方税号」字段;
- 购方税号:设置为「字段值」,即「购方税号」字段;
- 蓝票号码:设置为「字段值」,即「蓝票号码」字段;
- 蓝票日期:设置为「字段值」,即「蓝票日期」字段;
- 发票类型:设置为「字段值」,即「发票类型」字段;
- 红冲原因:设置为「字段值」,即「红冲原因」字段;
- 字段存储关系:点击「添加」按钮,设置字段存储关系如下所示:
- 将「红票号码」的值存储到「红票号码」中;
- 将「红票地址」的值存储到「红票地址」中;
- 将「红票请求 ID」的值存储到「红票请求 ID」中;
- 将「红冲结果」的值存储到「红冲结果」中;
全部设置完成后,点击「确定」按钮。
注:
1)「*」号为必填项,需勾选对应字段。
2)字段和存储关系,有无API版都需配置。
3.4 配置重新获取发票节点
3.4.1 添加插件节点
在「流程设定」中,从工具栏中选择「插件节点」,将其拖动至流程图中,通过流程连接线将全部流程节点串联起来。
3.4.2 配置插件节点
选中插件节点,在「节点属性 >> 节点名称」处设置节点名称为「重新获取红票」,然后点击「插件配置」,进入插件配置页面,插件配置如下所示:
- 插件选择:选择「开具数电发票 >> 8.重新获取红票」;
- 数据 ID:设置为「字段值」,即「数据 ID」字段;
- 销方税号:设置为「字段值」,即「销方税号」字段;
- 红票请求ID:设置为「字段值」,即「红票请求 ID」字段;
- 数据ID:设置为「字段值」,即「数据 ID」字段;
- 字段存储关系:点击「添加」按钮,设置字段存储关系如下所示:
- 将「红票号码」的值存储到「红票号码」中;
- 将「红票地址」的值存储到「红票地址」中;
- 将「红票请求 ID」的值存储到「红票请求 ID」中;
- 将「红冲日期」的值存储到「红冲日期」中;
- 将「红冲结果」的值存储到「红冲结果」中;
全部设置完成后,点击「确定」按钮。
注:重新获取红票流程和重新获取发票配置相似,可参考本文档【5.4 配置重新获取发票节点】和【5.6.2 重新获取发票节点连接线】进行配置。
3.5 配置节点连接线
1)点击「开具数电发票」和「重新获取发票」之间的节点连接线,在右侧「节点连接线 >> 数据流转条件」处,选择「使用自定义流转条件」,设置流转条件如下所示:
- 设置「开票请求 ID」 不为空;
- 设置「红票地址」不为空。
2)点击「开具数电发票」和「流程结束」之间的节点连接线,在右侧「节点连接线 >> 数据流转条件」处,选择「使用 Else 条件」,如下所示:
注:如红冲也需预留手动开具入口,可参考【开具数电蓝票 >> 3. 流程节点配置】进行配置。
4. 报错对照表
错误代码 | 错误信息 | 说明 |
2000 | 登录成功/发送短信成功 | 业务正常返回无错误 |
2001 | 任务成功 | 发票请求超时,针对同步转异步的情况 |
4001 | 用户名或密码错误 | 具体错误信息参考报错中message的提示信息 |
4002 | 企业未注册、停用、注销 | |
4003 | 企业信息或身份不符 | |
4004 | 风险纳税人 | |
4005 | 手机号不是办税号 | |
4006 | 登录信息不全 | |
4010 | 税务登记信息不全 | |
8000 | 短信发送频繁/税号访问频繁 | |
9999 | 系统级异常(异常信息不固定) | |
720000 | 常规错误 | |
720002 | 参数错误 | 传入的参数不符合要求 |
720004 | 数据已存在 | 开具发票时,相同的订单只能调用一次 |
720005 | 局端返回未知错误 | 通常是局端500错误等 |
720006 | 开票员不在线或登录失效 | 未成功登录平台 |
720016 | 登录失败 | 未成功登录平台 |
720007 | 开票员须扫脸认证 | —— |
710001 | 与局端HTTP通讯异常 | |
710002 | 局端返回已知错误 | 具体错误信息参考报错中message的提示信息 |
710003 | 开具金额较大,请确认是否开具 | |
710004 | 当前未查询到购买方纳税人信息,请确认是否继续开具 | |
710021 | 红字申请时原蓝票不存在或没有可红冲的金额 | —— |
710024 | 该发票存在进行中的红字确认单 | |
710022 | 红字发票开具失败 | |
730001 | 内部调用失败 | 服务异常 |
700000 | 异步请求已发起不可重复发起 | 重复发起 |
700001 | 异步请求失败 | 请求失败,重新发起 |
700002 | 异步请求超时 | 请求超时,晚点重试 |
700003 | 业务异步请求时回写结果失败 | 结果失败,重新发起 |
700009 | 业务异步请求时系统正忙 | 系统正忙,晚点重试 |
720010 | 开票调用电子税局超时 | 请求超时,晚点重试 |
其他代码 | 网关接入错误,请参考message返回信息 | —— |
5. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)