开具数电红票

使用开具数电红票,需先完成【开具数电发票】主文档 中插件配置和企业登录的配置后再进行本文档的功能配置。

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

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