乐企-开具数电发票
- 开具数电发票插件，支持电子税务局开票（文档简称电局开票）和税局总局乐企平台开票（文档简称乐企开票）。
- 税局总局乐企平台：乐企平台是国家税务总局打造的与企业信息系统直接连接的官方数字化平台，乐企平台开票有着无需短信验证码、无需扫脸认证等特点。
- 在开始使用插件前，您可先点击下方图片安装应用模板，快速完成测试。
1. 简介
1.1 场景简介
乐企开具数电发票，支持连接税局总局乐企平台，自动开具数电发票(专票/普票、蓝票/红票），同时可以开具部分特定业务下的数电发票，支持自动返回开票日期、发票号码、发票文件、发票地址等，可设置邮箱进行发票的对外交付。
1.2 应用场景
常用于根据销售订单、开票申请等进行自动开具发票，并通过邮件进行发票的对外交付。
1.3 预期效果
1）乐企-开具数电蓝票效果预览如下所示：
2）乐企-开具数电红票效果预览如下所示：
1.4 使用说明
1）使用乐企开票将调用插件以下2种事件：
- 乐企-1.开具数电发票
- 乐企-2.开票账号验证
注：插件有无 API 权限均可使用，「API 版」返回发票文件和发票下载地址，「无 API 版」仅返回发票下载地址。
2）开具数电发票插件可直接下载使用，但插件配置时的销方授权码需联系开发者购买。
- 一个税号对应一个乐企开具数电发票销方授权码；
- 乐企授权码和电局授权码不同，不可通用；
- 销方授权码分别为 1000 元/个税号/年。
注：开发者联系方式详见本文：【7. 联系方式】。
2. 电子税务局操作
2.1 使用单位接入条件：
使用单位接入乐企平台，需符合税务部门规定的基本条件：
1）纳税信用级别为 A 级、B 级或 M 级；
2）接入时未被税务机关认定为风险纳税人，且近三年无重大税收违法行为；
3）企业正常经营、有实际参保（社保缴纳）人员；
4）有实际经营场所，注册地址真实有效。
注：
1）接入申请前，先提供企业营业执照进行评估；
2）符合条件的企业，直连单位会发出邀请，使用单位完成接入即可。
2.2 电子税务局操作确认
2.2.1 登录乐企
- 登入电子税务局后，选择【我要办税】，点击【乐企数字开放平台】进入，仅单位法定代表人、财务负责人有执行乐企接入的权限。
2.2.2 使用单位接入确认
1）使用单位接收到乐企接入邀请后，可登录乐企在【接入管理】->【响应邀请】中确认邀请信息。
2）确认邀请时，需完成开票人员的添加和开票安全验证时间的配置。建议将时间设置为2099年（逾期将影响企业开票业务，建议直接设置为99年）。
3. 表单搭建
插件使用体验可先安装：开具数电发票插件模板表单。本文将按照示例表单进行讲解。
3.1 开具数电发票
乐企开具数电蓝票和红票配置方式类似，此处以开具数电蓝票为例，表单搭建如下所示：
字段说明 | 字段名称 | 是否必填 | 字段类型 |
开票信息 | 购方类型 | 是 | 下拉框，设置下拉框选项为：
|
购方名称 | 单行文本 | ||
购方税号 | |||
发票类型 | 下拉框，设置下拉框选项为：
| ||
含税标识 | 下拉框选项为：
| ||
文件类型 | 否 | 下拉复选框，选项为：
文件格式可以多选，该项有API权限必填。 | |
发票明细 | 是 | 子表单 | |
发票明细.发票行性质 | 否 | 选填，子表单-下拉框，设置下拉框选项为：
发票行性质：一般都使用正常行，涉及折扣时，折扣行需要填写为负数，被折扣行和折扣行需同时存在，原正常行应变为被折扣行。 | |
发票明细.税收分类编码 | 是 | 子表单-单行文本 | |
发票明细.税收分类名称 | |||
发票明细.产品名称 | |||
发票明细.规格型号 | 否 | ||
发票明细.单位 | |||
发票明细.数量 | 子表单-数字 | ||
发票明细.单价 | |||
发票明细.金额 | 是 | 子表单-数字，在「字段属性 >> 默认值」处设置为公式计算，编辑公式如下所示： ROUND(发票明细.单价*发票明细.数量,2) | |
发票明细.税率 | 子表单-数字，设置为百分比 | ||
发票明细.税额 | 子表单-数字，在「字段属性 >> 默认值」处设置为公式计算，如下所示：
| ||
发票明细.聚合字段 | 子表单-单行文本 在「字段属性 >> 默认值」处设置为公式计算，编辑公式如下所示： CONCATENATE('{','"product_code":发票明细.税收分类编码,"good_name":发票明细.税收分类名称,"define_name":发票明细.产品名称,"specification":发票明细.规格型号,"unit":发票明细.单位,"unit_price":发票明细.单价,"quantity":发票明细.数量,"detail_amount":'+TEXT(发票明细.总价)+',"tax_rate":发票明细.税率,"tax_amount":'+TEXT(发票明细.税额)+',"discount_type":发票明细.发票行性质','}') 注：有无API都需配置该字段。 | ||
发票明细 | 多行文本。 在「字段属性 >> 默认值」处设置为公式计算，编辑公式如下所示： JOIN(发票明细.聚合字段,CHAR(10)) 注：有无API都需配置该字段 | ||
发票备注 | 多行文本 注：备注有字符数限制（需在 200 字符以内）。 | ||
购方收票邮箱 | 否 | 单行文本，填写购方交付邮箱地址。 | |
销方信息 | 销方开票人账号 | 是 | 单行文本，填写销方信息 |
销方名称 | |||
销方税号 | |||
销方地址 | |||
销方电话 | |||
销方开户银行 | |||
销方银行账号 | |||
开票返回信息 | 开票日期 | 是 | 日期时间，设置类型为【年-月-日 时:分:秒】 |
发票号码 | 单行文本 | ||
发票文件 | 附件（仅有简道云 API 权限的用户需要设置该字段） 返回的发票文件命名如下：
示例：
| ||
XML地址 | 三种格式的发票文件下载地址，自动回写。 | ||
OFD地址 | |||
PDF地址 | |||
请求ID | 自动回写 | ||
3.2 开票账号验证
首次使用乐企开具数电发票和新增开票账号时，需要先进行开票账号验证，表单搭建如下：
字段说明 | 字段名称 | 是否必填 | 字段类型 |
开票人账号登录 | 销方地区 | 是 | 下拉框，下拉框内容设置详见【6.2 关于销方地区的说明】 |
销方税号 | 单行文本 注：填写开票账号对应销方税号。 | ||
开票人登录账号 | 单行文本 注：此处填写为登录电子税务局的用户名和密码。 | ||
开票人登录密码 | |||
身份类型 | 下拉框，设置下拉框选项为：
| ||
业务类型 | 开票 | ||
账号登录 | 按钮，参考下方4.1设置前端事件。 | ||
上传验证码 | 验证码 | 否 | 单行文本 除部分不发送验证码地区外，其他必填。 |
上传验证码 | 按钮，参考下方4.1设置前端事件。 | ||
登录结果 | 单行文本 触发按钮自动返回，无需填写操作。 | ||
登录描述 |
4. 设置前端事件
开票账号验证分为「1 账号登录」、「2 上传验证码」2个步骤，均为按钮触发，配置完全相同。本章节以「发送登录验证码」为例，具体配置步骤如下所示：
4.1 添加按钮执行动作
点击「1 账号登录」按钮，进入「字段属性」，点击执行动作下的设置，添加执行动作：
4.2 设置事件名称和说明
添加好执行动作后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分执行动作：
4.3 设置执行动作
1）设置执行动作如下：
- 选择插件：选择「开具数电发票」插件；
- 选择执行动作：乐企-2.开票账号验证
- 配置参数：分别以「字段值」方式配置销方税号、销方地区、开票人登录账号、开票人登录密码、身份类型、业务类型、验证码等字段；
2）设置执行返回信息回填：
- 登录结果：的值存储到「登录结果」中；
- 登录描述：的值存储到「登录描述」中。
设置完成点击「保存」。
注：部分不需要发送验证码的销方地区，操作账号登录即可，此时验证码可不填。
5.流程节点设置
5.1 流程发起节点
点击流程发起节点，在「节点属性 >> 节点名称」处，在「节点属性 >> 字段权限」处，勾选除开票返回信息和公式编辑外其他字段的「可见」、「可编辑」权限：
5.2 配置发票开具节点
1）选中并添加插件节点，在「节点属性 >> 节点名称」处设置节点名称为「发票配置」，然后点击「插件配置」：
2）进入插件配置页面，插件配置如下所示：
- 插件选择：选择「开具数电发票 >> 乐企1.开具数电发票」；
- 数据链接：设置为「字段值」，即「数据链接」字段；
- 开票方向：设置为「自定义」，勾选为「蓝票」；
- 发票类型：设置为「字段值」，即「发票类型」字段；
- 含税标识：设置为「字段值」，即「含税标识」字段；
- 销方名称：设置为「字段值」，即「销方名称」字段；
- 销方税号：设置为「字段值」，即「销方税号」字段；
- 销方地址：设置为「字段值」，即「销方地址」字段；
- 销方电话：设置为「字段值」，即「销方电话」字段；
- 销方开户银行：设置为「字段值」，即「销方开户银行」字段；
- 销方银行账号：设置为「字段值」，即「销方银行账号」字段；
- 销方开票人账号：设置为「字段值」，即「销方开票人账号」字段；
- 购方类型：设置为「字段值」，即「购方类型」字段；
- 购方名称：设置为「字段值」，即「购方名称」字段；
- 购方税号：设置为「字段值」，即「购方税号」字段；
- 购方收票邮箱：设置为「字段值」，即「购方收票邮箱」字段；
- 发票明细：设置为「字段值」，即「发票明细」字段；
- 发票备注：设置为「字段值」，即「发票备注」字段；
- 发票文件格式-有API必填：设置为「字段值」，即「发票文件格式-有API必填」字段；
- 发票文件字段ID-有API必填：设置为「组合」，在旁边“+”号中，勾选「发票文件（ID）」字段；
- 扩展参数：设置为「字段值」，即「扩展参数」字段，若有需求则填写，如无，则不填；
- 蓝票号码-红票必填：开具数电红票时设置为「字段值」勾选「蓝票号码」对应字段，开具蓝票时不用设置；
- 蓝票日期-红票必填：开具数电红票时设置为「字段值」勾选「蓝票日期」对应字段，开具蓝票时不用设置；
- 红冲原因-红票必填：开具数电红票时设置为「字段值」勾选「红冲原因」对应字段，开具蓝票时不用设置；
3）设置字段存储关系如下：
字段存储关系：点击「添加」按钮，设置字段存储关系如下所示：
- 将「开票请求 ID」的值存储到「开票请求 ID」中；
- 将「发票号码」的值存储到「发票号码」中；
- 将「发票日期」的值存储到「发票日期」中；
- 将「XML地址」的值存储到「XML地址」中；
- 将「OFD地址」的值存储到「OFD地址」中；
- 将「PDF地址」的值存储到「PDF地址」中；
- 将「报错消息」的值存储到「报错信息」字段中，该项选填，设置不报错模式时填写。
全部设置完成后，点击「确定」按钮。
注：
1）乐企-开具数电发票，有无 API 版均需设置，其中发票文件格式和发票文件字段ID，有API必填。
2）扩展字段：表单需新增一个字段「扩展字段」进行勾选，如无，则不填，不能勾选为「发票备注」等其他字段。
5.3 启用流程
全部设置完成后，点击右上方「启用流程」，启用流程节点。
6. 注意事项
6.1 关于税收分类编码和名称基础表
开票时需要传 19 位的税收分类编码和名称，可参考右表，选择自己公司所需的编码和名称：
1）字段中的「税收分类编码」对应表格中的「税收分类编码」，需填写对应的末级税收分类编码；
2）字段中的「产品名称」对应表单中的 「货物和劳务名称 」，字段中的「税收分类名称」对应表单中的「商品和服务分类简称」（简称可能为税局自定义的内容，如表中无参考，登录税局进行查看）。
6.2 关于销方地区的说明
请根据销方所在地区，填写以下标准名称：
北京、天津、河北、山西、内蒙古、辽宁、大连、吉林、黑龙江、上海、江苏、浙江、宁波、安徽、福建、厦门、江西、山东、青岛、河南、湖北、湖南、广东、深圳、广西、海南、重庆、四川、贵州、云南、西藏、陕西、甘肃、青海、宁夏、新疆。
注：以上名称中某些城市是独立的税局，因此销方所在地区需要传具体的城市，不能再传省级名称。
6.3 关于开具数电红票设置的说明
开具数 电红票和蓝票设置类似，只需在插件节点多传下方三个参数，其他复用蓝票开具设置参数即可：
- 开票方向：设置为「自定义」，勾选为「红票」；
- 蓝票号码-红票必填：开具数电红票时设置为「字段值」勾选「蓝票号码-红票必填」字段；
- 蓝票日期-红票必填：开具数电红票时设置为「字段值」勾选「蓝票日期-红票必填」字段；
- 红冲原因-红票必填：开具数电红票时设置为「字段值」勾选「红冲原因-红票必填」字段。
6.4 关于特定业务发票的配置说明
如需开具特定业务发票可下载开具数电发票应用模板，参考「开具数电蓝票-乐企」表单中的示例进行设置。此处以建筑服务特定业务发票开具为例，设置如下所示：
6.4.1 新增建筑服务相关字段
字段说明 | 字段名称 | 字段代码 | 设置说明 |
特定业务发票-建筑服务 | 特定业务类型 | business_type | 下拉框/单行文本。
|
详细地址 | detail_address | 单行文本 | |
跨区域涉税事项报验管理编号 | cross_city_tax_verify_no | 单行文本，当跨地市标识为“1”，时必填，填写需要按照税局规则，填写示例如下：
| |
建筑服务发生地 | construction_service_location | 单行文本 | |
建筑项目名称 | construction_project_name | ||
跨地市标识 | cross_city_flag | 下拉框，设置下拉框选项为：
| |
土地增值税项目编号 | land_value_tax_project_no | 单行文本 | |
扩展参数 | 扩展参数 | 添加公式 | 单行文本，在「字段属性 >> 默认值」处设置为公式计算，编辑公式如下所示： CONCATENATE('{','"business_type":特定业务类型,"build_info":{"construction_service_location":建筑服务发生地,"detail_address":详细地址,"construction_project_name":建筑服务发生地,"cross_city_flag":跨地市标识,"land_value_tax_project_no":土地增值税项目编号,"cross_city_tax_verify_no":跨区域涉税事项报验管理编号}','}') |
6.4.2 流程插件节点配置
- 流程设定-插件配置中，将扩展参数：设置为字段值，即「扩展参数」。
注：扩展参数中，还可添加是否展示销方购方信息/复核人/收款人等信息
- 新增复核人/收款人：在扩展字段的公式中，新增："reviewer":复核人,"payee":收款人
- 是否展示销方和购方信息，参考下方【6.5】的设置说明。
6.5 关于展示销方和购方信息的说明
若需备注中展示销方和购方详细信息，可在备注中直接填写，也可在【扩展参数】中配置是否展示。在表单中新增购方信息，并设置字段如下所示：
字段名称 | 是否必填 | 字段类型 | 字段设置 |
购买方地址 | 否 | 单行文本 | —— |
购买方电话 | |||
购买方开户银行 | |||
购买方银行账号 | |||
是否展示销方银行/账号 | 下拉框 | 下拉框选项如下：
| |
是否展示购方银行/账号 | |||
是否展示销方地址/电话 | |||
是否展示销方地址/电话 | |||
扩展参数 | 单行文本 | 在「字段属性 >> 默认值」处选择「公式编辑」，公式设置如下所示： CONCATENATE('{','"show_seller_card":是否展示销方银行/账号,"show_seller_address_tel":是否展示销方地址/电话,"show_buyer_card":是否展示购方银行/账号,"show_buyer_address_tel":是否展示购方地址/电话,"buyer_address":购买方地址,"buyer_fixed_telephone":购买方电话,"buyer_card_name":购买方银行,"buyer_card_number":购买方银行账号','}') |
注：
1）备注有字符数要求（需在 200 字符以内），直接填写若超字符限制会提示报错。如上述信息均需展示，可选择使用【扩展参数】配置传值，插件节点配置参考【6.4.2 流程插件节点配置】。
2）使用插件配置【扩展参数】函数时，内容依旧展示于备注字段中，但不占用备注字符数。
3）若只需销方信息展示，公式里可只保留销方部分的参数，购方同理。
6.6 报错模式的配置说明
插件支持不报错模式，默认为报错，可在【扩展参数】中设置不报错，设置参考如下：
功能场景 | 字段名称 | 参数代码 | 字段格式 | 字段说明 |
报错模式 | 报错模式 | debug | 下拉框 | 下拉框选项为：
默认为 false，表示插件节点正常报错。填写 true时，插件节点不会报错，报错信息返回报错信息字段，并且请求 ID 返回为 999999。 |
报错信息 | —— | 单行文本 | ||
扩展参数公式新增 | 下方为扩展功能公式参考： CONCATENATE('{','"debug":报错模式','}') | |||
注：
1）使用流程插件节点时，可以用不抛错模式，即报错模式选择为：“true”，这时可通过请求ID做流程条件分支，走人工修改节点，回到流程待办里面去修改信息后再提交即可重新开票。
2）智能助手Pro 使用插件节点开具发票时，不建议使用不抛错模式。
6.7 关于特定征税方式和税收优惠政策的配置说明
参考下方表单，在发票明细子表单的聚合公式中添加对应字段名和字段：
简道云字段名称 | 公式对应字段名 | 字段说明 |
是否使用优惠政策 | preferential_policy | 填写参考如下：
|
优惠政策类型 | vat_exception | 填写参考如下：
|
即征即退类型 | tax_free_type | 填写参考如下：
|
7. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
- 电子税务局发票业务交流群，二维码如下：
400-111-0890
在线咨询