开具数电蓝票
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"','}') 注:上述公式中
|
注:
1)因税局要求,备注有字符数限制,直接填写若超字符限制会提示报错。如上述信息均需展示,可选择使用【扩展字段】函数配置传值。
2)使用插件配置【扩展字段】函数时,内容依旧展示于备注字段中,但不占用备注字符数。
3)若只需销方信息展示,公式里可只保留:sfzsxsfyhzh、 sfzsxsfdzdh 参数和值。
4.5.2 配置插件
在插件配置页面,设置插件配置项如下所示:
- 插件:选择「开具数电发票 >> 5.开具数电发票-API 版」插件;
- 扩展字段:设置为字段值,即「扩展字段」。
注:此处不能勾选「备注」字段。
4.6 关于特定征税方式和税收优惠政策的配置说明
参考下方表单,填写对应的征税方式,并在聚合公式中添加公式对应字段名即可。
简道云字段名称 | 公式对应字段名 | 字段说明 |
特定征税方式 | tdzsfsdm | 填写参考如下:
|
税收优惠政策类型 | ssyhzclx | 填写参考如下:
|
即征即退类型代码 | jzjtlxDm | 填写参考如下:
|
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(微信同号)