开具数电蓝票

1. 简介

1.1 场景简介

开具数电发票插件支持连接电子税务局,自动开具数电蓝票(专票/普票),并返回发票日期、发票号码、发票文件、发票地址等信息,且可设置邮箱进行发票的对外交付。

1.2 应用场景

常用于根据销售订单、开票申请等进行自动开具发票,并通过邮件进行发票的对外交付。

1.3 预期效果

开票申请人在「开票申请」提交开票申请信息后,财务审批人员进行审批,待开票数据审核通过后,在数据管理」处自动新增开具的数电发票。效果如下所示:

1.4 使用说明

1)该插件有无 API 权限均可使用「API 版」可返回发票文件和发票下载地址,「无 API 版」仅能返回发票下载地址。

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

3)其他配置请参考:

  • 插件安装和配置请参考【开具数电发票>>2. 插件安装及配置】。
  • 本场景需登录税局,企业登录配置请参考【开具数电发票>>3. 表单搭建】。

4)开始使用插件前,可点击下方链接安装插件及插件模板:

安装后参考使用指南使用。插件配置时的销方授权码需联系开发者购买。

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

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

2. 表单搭建

2.1 开票申请表单创建

1)在「开票申请」流程表单中,新增「开票申请」页签,用于填写蓝字发票开具开具信息。字段设置如下所示:

字段说明

字段名称

是否必填

字段类型

开票申请-开票信息

购方类型

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

  • 企业
  • 个人
  • 事业单位

购方名称

单行文本

购方税号

发票类型

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

  • 数电专票
  • 数电普票

邮箱地址

单行文本

发票明细

子表单

发票明细.发票行性质

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

  • 正常行
  • 被折扣行
  • 折扣行

发票行性质:一般都使用正常行,涉及折扣时,折扣行需要填写为负数,被折扣行和折扣行需同时存在,原正常行应变为被折扣行。

发票明细.税收分类编码

单行文本

发票明细.税收分类名称

发票明细.产品名称

发票明细.规格型号

发票明细.单位

发票明细.数量

数字

发票明细.单价(含税)

发票明细.金额(含税)

发票明细.税率

数字,设置为百分比

发票明细.单行发票明细拼接字段

单行文本

在「字段属性 >> 默认值」处设置为公式计算,编辑公式如下所示:

CONCATENATE('{','"fphxz":发票明细.发票性质',',"spbm":发票明细.税收商品编码',',"spmc":发票明细.税收商品名称',',"xmmc":发票明细.自定义的商品名称',',"ggxh":发票明细.规格型号',',"dw":发票明细.单位',',"spsl":发票明细.数量',',"dj":发票明细.单价(含税)',',"je":发票明细.金额(含税)',',"sl":发票明细.税率','}')

注:仅无 API 版需要该字段,有 API 版本的无需该字段。

多行发票明细拼接字段

多行文本。

在「字段属性 >> 默认值」处设置为公式计算,编辑公式如下所示:

JOIN(发票明细.单行数据拼接字段,CHAR(10))

注:仅无 API 版需要该字段,有 API 版本的无需该字段。

备注

多行文本

开票申请-销方信息

销方名称

单行文本

销方税号

销方地址

销方电话

销方开户银行

销方银行账号

开票申请-返回信息

开票日期

日期时间,设置类型为【年-月-日】

发票号码

单行文本

发票文件

附件(仅 API 版需要该字段

发票地址

单行文本

开票请求ID

邮件发送结果

是否手动开票

2)点击开票金额.金额」,在「字段属性 >> 默认值」处,选择「公式编辑」,编辑公式为:

发票明细.数量*发票金额.单价(含税)

2.2 开票申请字段别名

进入扩展功能 >> 数据推送中,点击设置字段别名,依次将字段别名设置为下方别名,设置完成后,点击「保存」按钮。设置如下所示:

字段名称

字段别名

购方类型

gmf_lx

购方名称

gmf_nsrmc

购方税号

gmf_nsrsbh

发票类型

fplxdm

发票明细

xmmx

发票明细.发票行性质

fphxz

发票明细.税收分类编码

spbm

发票明细.税收分类名称

spmc

发票明细.产品名称

xmmc

发票明细.规格型号

ggxh

发票明细.单位

dw

发票明细.数量

spsl

发票明细.单价(含税)

dj

发票明细.金额(含税)

je

发票明细.税率

sl

备注

bz

销方名称

xsf_nsrmc

销方税号

nsrsbh

销方地址

xsf_dz

销方电话

xsf_dh

销方开户银行

xsf_yhmc

销方银行账号

xsf_yhzh

开票日期

kprq

发票号码

serial_no

发票文件

files

发票地址

url

开票请求ID

request_id

注:此项仅需 API 版用户配置,无 API 版无需配置。

3. 流程节点配置

「API 版」「无 API 版」流程节点配置相似,此处以「API 版」做示范进行展示,「无API 版」配置时插件选择「开具数电发票 >> 5.开具数电发票-API 版」即可。

3.1 流程发起节点

点击流程发起节点,在「节点属性 >> 节点名称」处,在「节点属性 >> 字段权限」处,勾选如下部分字段的「可见」、「可编辑」权限:

3.2 配置财务登录&刷脸节点

1)点击流程审批节点,在「节点属性 >> 节点名称」处,修改节点名称为「财务登录&刷脸」,并根据业务需求选择节点负责人,如下所示:

2)在字段权限处,勾选部分字段的可见可编辑」权限。如下所示:

3.3 配置开具数电发票节点

3.3.1 添加插件节点

在「流程设定」中,从工具栏中选择「插件节点」,将其拖动至流程图中,通过流程连接线将全部流程节点串联起来。

3.3.2 配置插件节点

1)选中插件节点,在「节点属性 >> 节点名称」处设置节点名称为「开具数电发票」,然后点击「插件配置」:

2)进入插件配置页面,插件配置如下所示:

  • 插件选择:选择「开具数电发票 >> 5.开具数电发票- API 版」;
  • 应用 ID:设置为「字段值」,即「应用 ID」字段;
  • 表单 ID:设置为「字段值」,即「表单 ID」字段;
  • 数据 ID:设置为「字段值」,即「数据 ID」字段;
  • 销方税号:设置为「字段值」,即「销方税号」字段;
  • 文件格式:设置为「自定义」,支持同时返回单个/多个文件格式和发票地址;
  • 是否触发智能助手:设置为「自定义」,如设置为「否」;
  • 邮箱地址:设置为「自定义」,企业可根据业务需求自定义邮箱地址;
  • 邮件文件格式:设置为「自定义」,支持从下拉框中选择不同的邮件格式;
  • 特定业务类型:设置为「字段值」,即「特定业务类型」字段,若需开具特定业务类型发票则填写,如无,可不填。
  • 特定业务明细:设置为「字段值」,如「特定业务开票明细聚合-建筑服务」字段,若需开具特定业务类型发票则填写,如无,可不填。
  • 差额开票代码:设置为「字段值」,即「差额开票代码」字段,若需开具差额发票则填写,如无,可不填。
  • 差额明细:设置为「字段值」,即「差额明细聚合」字段,若需开具差额发票则填写,如无,可不填。
  • 扩展字段:设置为「字段值」,即「扩展字段」字段,若有需求则填写,如无,可不填。
  • 字段存储关系:点击「添加」按钮,设置字段存储关系如下所示:
    • 将「发票号码」的值存储到「发票号码」中;
    • 将「发票地址」的值存储到「发票地址」中;
    • 将「开票请求 ID」的值存储到「开票请求 ID」中;
    • 将「发票日期」的值存储到「发票日期」中;
    • 将「邮件发送结果」的值存储到「邮件发送结果」字段中。

全部设置完成后,点击「确定」按钮。

注:

1)邮件交付需先在电子税务局进行「发件邮箱设置」,详细设置步骤可参见右侧附件:邮箱设置指引.pdf

2)有无 API 版均需填写字段存储关系

3)若用扩展功能配置插件节点,建议使用智能助手pro,老智能助手不支持填写返回值。

4)扩展字段:表单需新增一个字段「扩展字段」进行勾选,如无,则不填,不能勾选为「备注」字段

3.4 配置重新获取发票节点

3.4.1 添加插件节点

在「流程设定」中,从工具栏中选择「插件节点」,将其拖动至流程图中,通过流程连接线将全部流程节点串联起来。

3.4.2 配置插件节点

1)选中插件节点,在「节点属性 >> 节点名称」处设置节点名称为「重新获取发票」,然后点击「插件配置」:

2)进入插件配置页面,插件配置如下所示:

  • 插件选择:选择「开具数电发票 >> 6.重新获取发票- API 版」;
  • 应用 ID:设置为「字段值」,即「应用 ID」字段;
  • 表单 ID:设置为「字段值」,即「表单 ID」字段;
  • 数据 ID:设置为「字段值」,即「数据 ID」字段;
  • 销方税号:设置为「字段值」,即「销方税号」字段;
  • 开票请求 ID:设置为「字段值」,即「开票请求 ID」字段;
  • 文件格式:设置为「自定义」,支持同时返回单个/多个文件格式和发票地址;
  • 邮箱地址:设置为「自定义」,企业可根据业务需求自定义邮箱地址;
  • 邮件文件格式:设置为「自定义」,支持从下拉框中选择不同的邮件格式;
  • 字段存储关系:点击「添加」按钮,设置字段存储关系如下所示:
    • 将「发票号码」的值存储到「发票号码」中;
    • 将「发票地址」的值存储到「发票地址」中;
    • 将「开票请求 ID」的值存储到「开票请求 ID」中;
    • 将「发票日期」的值存储到「发票日期」中;
    • 将「邮件发送结果」的值存储到「邮件发送结果」中;

全部设置完成后,点击「确定」按钮。

注:

1)非 API 版用户使用重新获取发票时,配置方式与上文类似,函数选择为「 6.重新获取发票-非API 版 >> 重新获取为发票文件下载地址」即可,为重新获取文件下载地址。

2)有无 API 版用户均建议配置重新获取发票节点,且字段的存储关系都需配置。

3.5 配置手动回填发票信息节点

如需预留手动开具发票节点,可参照本节点配置:

点击「手动回填发票信息」流程节点,在「节点属性 >> 节点名称」处,修改节点名称为「手动回填发票信息」,并根据业务需求选择节点负责人,字段权限处,勾选部分字段的可见可编辑」权限。如下所示:

注:此节点预留一个手动开票入口,如偶遇税局不稳定等异常情况,发票未能即时传回的,可以手动开票并手动归档发票信息,不影响流程正常流转。

3.6 配置节点连线

3.6.1 手动开票配置节点连线

1)点击「财务登录&刷脸」节点和「手动回填发票信息」之间的节点连接线,在右侧「节点连接线 >> 数据流转条件」处,选择「使用自定义流转条件」,设置流转条件如下所示:

  • 设置「是否手动开票」 等于「是」;

2)点击「财务登录&刷脸」节点和「开具数电发票」之间的节点连接线,在右侧「节点连接线 >> 数据流转条件」处,选择「使用 Else 条件」,如下所示:

3.6.2 重新获取发票节点连线

1)点击「开具数电发票」和「重新获取发票」之间的节点连接线,在右侧「节点连接线 >> 数据流转条件」处,选择「使用自定义流转条件」,设置流转条件如下所示:

  • 设置「开票请求 ID」 不为空;
  • 设置「发票地址」为空。

2)点击「开具数电发票」和「流程结束」之间的节点连接线,在右侧「节点连接线 >> 数据流转条件」处,选择「使用 Else 条件」,如下所示:

4. 注意事项

4.1 关于税收分类编码和名称基础表

开票时需要传19位的税收分类编码和名称,可参考右表,选择自己公司所需的编码和名称:税收分类编码和名称表.xls

注:

1)字段中的「税收分类编码」对应表格中的「合并编码」,需填写对应的末级税收分类编码;

2)字段中的「产品名称」对应表单中的 「货物和劳务名称 」,字段中的「税收分类名称」对应表单中的「商品和服务分类简称」(简称可能为税局自定义的内容,如表中无参考,自行登录税局查看)。

4.2 关于购方名称/税号的说明

请在开具发票前确保购方名称、购方税号的信息一致性,避免开具的发票购方名称不对,建议在建立客户档案的校验一下购方名称,或者在开票申请时校验一下购方名称、购方税号的信息一致性。

4.3 关于价税分离的说明

本插件统一采用含税金额进行开票,若企业需要分别统计不含税金额和税额、可在表单中预先计算好该金额。

  • 不含税单价=含税单价/(1+税率); 
  • 不含税金额=round(含税金额/(1+税率),2);
  • 税额=含税金额-不含税金额;

注:本插件统一采用含税金额进行开具发票,系统会自动在开票时反算对应的不含税单价、不含税金额。

4.4 关于特定业务发票和差额发票开具的配置说明

如需开具特定业务发票和差额发票可下载表单应用模板,直接使用或参考模板表单中的配置。

4.5 关于展示销方和购方信息的说明

若需备注中展示销方和购方详细信息,可在备注中直接填写。也可在插件中配置【扩展字段】函数,如需在插件中配置【扩展字段】,函数配置方法如下。

4.5.1 新增表单字段

在表单中新增销方/购方信息,以新增购方信息为例,字段设置如下所示:

字段名称

是否必填

字段类型

字段设置

购买方地址

单行文本

——

购买方电话

购买方开户银行

扩展字段

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

CONCATENATE('{','"sfzsgmfdzdh":"1","gmf_dz":购买方地址,"gmf_dh":购买方电话,"sfzsgmfyhzh":"1","gmf_yhmc":购买方开户银行,"gmf_yhzh":购买方银行账号,"sfzsxsfdzdh":"1","sfzsxsfyhzh":"1"','}')

注:上述公式中

  • sfzsgmfyhzh 表示展示购买方银行账号 ,1为是,0为否。
  • sfzsxsfyhzh 表示展示销售方银行账号, 1为是,0为否。
  • sfzsgmfdzdh 表示展示购买方地址电话 ,1为是,0为否。
  • sfzsxsfdzdh表示 展示销售方地址电话, 1为是,0为否。

注:

1)因税局要求,备注有字符数限制,直接填写若超字符限制会提示报错。如上述信息均需展示,可选择使用【扩展字段】函数配置传值。

2)使用插件配置【扩展字段】函数时,内容依旧展示于备注字段中,但不占用备注字符数。

3)若只需销方信息展示,公式里可只保留:sfzsxsfyhzh、 sfzsxsfdzdh 参数和值。

4.5.2 配置插件

在插件配置页面,设置插件配置项如下所示:

  • 插件:选择「开具数电发票 >> 5.开具数电发票-API 版」插件;
  • 扩展字段:设置为字段值,即「扩展字段」。

注:此处不能勾选「备注」字段。

4.6 关于特定征税方式和税收优惠政策的配置说明

参考下方表单,填写对应的征税方式,并在聚合公式中添加公式对应字段名即可。

简道云字段名称

公式对应字段名

字段说明

特定征税方式

tdzsfsdm

填写参考如下:

  • 填写:01 表示 "不征税“;
  • 填写:02 表示"零税率";
  • 填写:03 表示"差额征税";
  • 填写:02 表示"免税"
  • 填写:05 表示"简易征税";
  • 填写:06 表示"减按征税"

税收优惠政策类型

ssyhzclx

填写参考如下:

  • 填写:01 表示"简易征收";
  • 填写:02 表示 "稀土产品“;
  • 填写:03 表示"免税"
  • 填写:04: 表示"不征税"
  • 填写:05 表示 "先征后退"
  • 填写:06 表示 "100%先征后退"
  • 填写:07 表示"50%先征后退"
  • 填写:08 表示"按3%简易征收"
  • 填写:09 表示"按5%简易征收"
  • 填写:10 表示"按5%简易征收减按1.5%计征"
  • 填写:11 表示"即征即退30%"
  • 填写:12 表示 "即征即退50%"
  • 填写:13 表示"即征即退70%"
  • 填写:14 表示 "即征即退100%"
  • 填写:15 表示"超税负3%即征即退"
  • 填写:16 表示"超税负8%即征即退"
  • 填写:17 表示"超税负12%即征即退"
  • 填写:18 表示"超税负6%即征即退”

即征即退类型代码

jzjtlxDm

填写参考如下:

  • 01 软件产品发票
  • 02 资源综合利用产品发票
  • 03 管道运输服务发票
  • 04 有形动产融资租赁服务
  • 05 有形动产融资性售后回租服务发票
  • 06 新型墙体材料发票
  • 07 风力发电产品发票
  • 08 光伏发电产品发票
  • 09 动漫软件产品发票
  • 10 飞机维修劳务发票
  • 11 黄金发票
  • 12 铂金发票

5. 报错对照表

报错场景

错误代码

错误信息

说明

企业登录

2001

任务成功

发票请求超时,针对同步转异步的情况

4001

用户名或密码错误

具体错误信息,参考报错中 message 的提示信息

4002

企业未注册、停用、注销

企业信息填写异常

4003

企业信息或身份不符

企业信息或身份类型填写不符

4004

风险纳税人

——

4005

手机号不是办税号

4006

登录信息不全

登录信息填写不全

4010

税务登记信息不全

——

8000

短信发送频繁/税号访问频繁

短信验证码发送太频繁

720006

开票员不在线或登录失效

未成功登录平台

720016

登录失败

未成功登录平台

720007

开票员须扫脸认证

未扫脸认证

开具数电蓝票

720002

参数错误

传入的参数不符合要求

720004

数据已存在

开具发票时,相同的发票只能开具一次

720005

局端返回未知错误

通常是税局异常

710002

局端返回已知错误

具体错误信息,参考报错中 message 的提示信息

710003

开具金额较大,请确认是否开具

710004

当前未查询到购买方纳税人信息,请确认是否继续开具

700001

异步请求失败

请求失败,重新发起

700002

异步请求超时

请求超时,晚点重试

700003

业务异步请求时回写结果失败

结果失败,重新发起

700009

业务异步请求时系统正忙

系统正忙,晚点重试

720010

开票调用电子税局超时

请求超时,晚点重试

730001

内部调用失败

通常为服务异常

700000

异步请求已发起不可重复发起

重复发起

开具数电红票

710021

红字申请时原蓝票不存在或没有可红冲的金额

具体错误信息,参考报错中 message 的提示信息

710024

该发票存在进行中的红字确认单

710022

红字发票开具失败

6. 联系方式

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

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

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