以下为该插件在简道云帮助中心的原始文档，含完整配置说明与表单搭建步骤。
这是一个运行在简道云开放平台上的插件，把企业开票动作从电子税务局搬进简道云。开票申请人在简道云提交申请，财务审批通过后自动开具发票，发票号码、发票文件、发票地址与邮件发送结果自动回写到表单。成都及周边的企业无需再切换到税局系统重复登录、逐条录入。
这个插件的四个特点Why it matters
有无API 权限都能开票
有API 权限可返回发票文件与下载地址，无API 权限仅返回下载地址。0 门槛，所有付费用户都能用。
全程自动
自动开票、自动回填发票信息与发票文件、自动邮件交付。审批完就不用管。
场景更全
红冲、特定业务、差额发票、批量发票都能开，不是只能处理最简单的蓝票。
登录刷脸有效期延长
首次开票需逐一登录刷脸，后续检测刷脸状态有效即可直接开票，不必每次操作。
能开哪些发票
| 发票类型 | 支持范围 | 说明 |
|---|---|---|
| 数电蓝票 | 增值税专用发票、增值税普通发票 | 常规开票场景，从销售订单或开票申请自动开具 |
| 特定业务发票 | 货物运输服务、建筑服务、不动产经营租赁服务、成品油 | 成品油特定业务发票勾选即开；建筑服务支持跨地市与非跨地市开票 |
| 差额数电发票 | 按差额开票代码开具 | 部分类型需额外申报项目代码 |
| 机动车销售统一发票 | 机动车 | 需在发票类型中勾选「机动车发票」，特定业务类型选「机动车」，购买方电话为必传 |
| 红冲发票 | 全额红冲 | 需对应原蓝票信息，每张蓝票可红冲一次 |
电子器件与零部件企业的月度销项明细动辄上百行，常见做法是导出明细后粘贴进税局客户端逐条录入。开票申请人在简道云提交、财务审批、开具完成、结果回写订单表、发票邮件送达客户——整条链路不需要人再碰税局系统。
怎么工作
蓝票开具流程
流程中预留了两个容错节点
这两个设计很实用，实际运行中能避免流程卡死：
重新获取发票
当「开票请求ID」不为空但「发票地址」为空时触发，节点条件为自定义条件加Else 分支。用于处理税局响应慢、发票信息未即时传回的情况。
手动回填发票信息
通过「是否手动开票 = 是」的条件分支进入。偶遇税局不稳定等异常时，财务可以手动开票并手动归档，不影响整体流程正常流转。
表单字段配置
开票申请核心字段
| 字段 | 必填 | 选项与说明 |
|---|---|---|
| 购方类型 | 是 | 下拉框：企业 / 个人 / 事业单位 |
| 购方名称 | — | 开票前务必校验名称与税号的一致性 |
| 购方税号 | — | 与名称一致性直接影响发票正确性 |
| 发票类型 | — | 下拉框：数电专票 / 数电普票（机动车发票需额外新增此选项） |
| 邮箱地址 | — | 用于发票对外邮件交付 |
| 发票明细 | 子表 | 税收分类编码、税收分类名称、产品名称、规格型号、单位、数量、单价（含税）、金额（含税）、税率 |
| 发票行性质 | — | 正常行 / 被折扣行 / 折扣行 |
| 备注 | — | 税局要求 200 字符以内，超出会报错 |
| 销方名称 / 销方税号 | 是 | 多主体企业需按开票主体区分 |
| 开票日期 | 是 | 日期时间，格式「年-月-日 时:分:秒」 |
| 发票号码 | 回填 | 开票成功后自动写入 |
| 发票文件 | 回填 | 附件类型，仅有API 权限的用户需设置此字段 |
| 发票地址 | 回填 | 发票下载地址 |
| 开票请求 ID | 回填 | 用于重新获取发票 |
发票行性质一般都用「正常行」。涉及折扣时：折扣行需要填写为负数，被折扣行和折扣行需同时存在，原来的正常行应改为被折扣行。这个规则配错会导致开票失败。
价税分离的处理方式
插件统一采用含税金额开具，系统在开票时自动反算不含税单价与不含税金额。企业如需分别统计，可在表单中预先计算：
不含税单价
= 含税单价 ÷ (1 + 税率)
不含税金额
= round(含税金额 ÷ (1 + 税率), 2)
税额
= 含税金额 − 不含税金额
无API 版的拼接公式
仅无API 版用户需要配置发票明细的拼接字段，有API 版无需此步。单行明细拼接公式：
多行明细拼接公式：
API 版的字段别名配置
仅 API 版用户需要，在「扩展功能 → 数据推送」中设置字段别名：
| 字段名称 | 别名 | 字段名称 |
|---|---|---|
| 购方类型 | gmf_lx | gmf_nsrmc 购方名称 |
| 购方税号 | gmf_nsrsbh | fplxdm 发票类型 |
| 发票明细 | xmmx | fphxz 发票行性质 |
| 税收分类编码 | spbm | spmc 税收分类名称 |
| 产品名称 | xmmc | ggxh 规格型号 |
| 单位 | dw | spsl 数量 |
| 单价（含税） | dj | je 金额（含税） |
| 税率 | sl | bz 备注 |
| 销方名称 | xsf_nsrmc | nsrsbh 销方税号 |
| 开票日期 | kprq | serial_no 发票号码 |
| 发票文件 | files | url 发票地址 |
| 开票请求 ID | request_id | — |
红冲发票
红冲需对应原蓝票信息，红冲时为全额红冲，每张蓝票可以红冲一次。同样需要登录和刷脸认证。
| 请求参数 | 说明 |
|---|---|
| 销方税号 | 开票方税号 |
| 购方税号 | 受票方税号 |
| 蓝票号码 | 需红冲的原蓝票发票号码 |
| 蓝票日期 | 需红冲的原蓝票开票日期 |
| 发票类型 | 与原蓝票一致 |
| 红冲原因 | 红冲原因说明 |
返回参数存储关系：红票号码、红票地址、红票日期、红票请求 ID、红冲结果。这几项有无 API 版都需配置。
注意事项
税收分类编码
开票时需传 19 位的税收分类编码和名称，须填写对应的末级税收分类编码。字段中的「税收分类编码」对应编码表中的「合并编码」；「产品名称」对应编码表中的「货物和劳务名称」，「税收分类名称」对应「商品和服务分类简称」。
销方地区必须填到市
销方地区需按标准名称填写。部分城市是独立税局（如辽宁省需填大连市、浙江省需填宁波市、广东省需填深圳市、山东省需填青岛市、厦门市），这种情况下不能只传省，必须传具体城市。四川地区适用成都市。
税局手机号
除广东、天津、浙江、湖北外，其他地区税局手机号均为必传。这四个地区仅需要做登录，不需要发送验证码，可直接进入刷脸认证环节。成都企业需提供手机号。
购方名称与税号的一致性
开票前务必确保购方名称、税号信息一致，否则会出现购方名称不对的发票。建议在建立客户档案时就做一次校验，或在开票申请环节校验。
扩展字段不能勾选备注
如需在备注中展示销方购方的详细信息（地址电话、银行账号），或设置复核人、收款人信息，需通过扩展字段函数传值，不能把扩展字段勾选为「备注」字段。使用扩展字段时，内容仍展示在备注中，但不占用备注 200 字符的限制。
扩展字段为通配参数，可设置的展示开关：sfzsgmfdzdh 展示购买方地址电话、sfzsxsfdzdh 展示销售方地址电话、sfzsgmfyhzh 展示购买方银行账号、sfzsxsfyhzh 展示销售方银行账号，值为 1 表示是、0 表示否。
复核人与收款人可在扩展字段公式中新增："fhr":复核人、"skr":收款人。
避免智能助手重复触发
若设置「是否触发智能助手」为「是」，在配置数电发票的智能助手执行动作时，需增加「开票请求ID」并设置其值为空，以避免返回数据触发智能助手时再次触发开票。
安装与配置
本插件如为付费插件，在简道云插件市场直接下单购买即可使用，购买后在「开放平台 >> 插件管理」中安装启用；开票过程中若调用按次计费的函数，在简道云充值云币后即可使用，按实际调用次数扣除。此外本插件需单独配置销方授权码，一个税号对应一个授权码，价格详见插件市场与开发者说明。
| 配置项 | 是否必填 | 说明 |
|---|---|---|
| 简道云 API Key | 非必填 | 无 API 权限的用户可不填写，直接使用无 API 版函数开票。填写后可返回发票文件与下载地址 |
| 销方授权码 | 必填 | 需联系开发者获取。一个税号对应一个销方授权码，价格详见插件市场与开发者说明。多个销方时，每个授权码分别换行配置 |
| 发件邮箱设置 | 条件必填 | 需先在电子税务局进行「发件邮箱设置」，才能使用邮件交付功能 |
- 在简道云
开放平台 >> 插件市场安装「开具数电发票」插件 - 在
插件管理中点击「设置」，填入 API Key（按需）与销方授权码，保存 - 打开插件右侧开关启用
- 按上述字段结构创建「开票申请」流程表单，API 版用户另需配置字段别名
- 配置「企业登录」表单与按钮，配置财务登录刷脸节点
- 在流程中添加插件节点，配置开具数电发票、重新获取发票、手动回填三个节点
- 设置节点连线条件：用「是否手动开票」区分手动分支，用「开票请求ID 不为空且发票地址为空」触发重新获取
- 测试一个完整业务流（含一次异常分支）后再正式启用
边界说明
- 本插件对接的是企业已完成税务实名认证的电子税务局账号，账号权限与登录方式由企业自行提供
- 涉及增值税申报、纳税申报表编制的环节不在本插件范围内，仍由企业财务人员在税务局系统内完成
- 红冲为全额红冲，每张蓝票只能红冲一次，不支持部分红冲
- 所有发票数据与法律效力以税务局系统回执为准，插件不改变任何税务口径
- 销方授权码按税号购买，一个税号对应一个授权码；多主体企业需按税号数量分别购买
- 税局系统稳定性由税务部门决定，插件已预留重新获取与手动回填两个容错节点，但不能完全消除外部系统不可用的情况
本页常见问题
没有简道云 API 权限能开票吗？
能。API 版可返回发票文件和发票下载地址，无 API 版仅能返回发票下载地址。两种版本的所有付费用户都能使用，0 门槛。无 API 版需要多配置一步发票明细的拼接公式。
每次开票都要刷脸吗？
首次开票需逐一登录、刷脸，之后会检测刷脸状态是否有效，有效即可直接开票，无需每次操作。插件一周年时官方专门做过登录刷脸环节的稳定性优化，有效期已延长。
支持开具的发票类型有哪些？
数电蓝票（专票、普票）、货物运输服务、建筑服务、不动产经营租赁服务、成品油四种特定业务发票、差额数电发票、机动车销售统一发票，以及红冲发票。
票开了但发票地址是空的怎么办？
配置「重新获取发票」节点。节点连线条件设为「开票请求ID 不为空」且「发票地址 为空」，可自动重新拉取发票信息与文件。有无 API 版用户都建议配置这个节点。
税局不稳定开不了票怎么办？
配置「手动回填发票信息」节点，通过「是否手动开票 = 是」的条件分支进入。财务可以手动开票并手动归档发票信息，不影响整体流程正常流转。这两个容错节点建议都配上。
为什么我的备注填不进去？
税局要求备注不超过 200 字符，超出会直接报错。如果需要展示购方地址电话、银行账号或复核人收款人信息，用扩展字段函数传值——内容仍展示在备注里，但不占用 200 字符限制。注意扩展字段不能勾选为「备注」字段。
销方地区填四川省可以吗？
要看情况。部分城市是独立税局，这些情况不能只传省，必须传具体城市，比如辽宁省需填大连市、浙江省需填宁波市、广东省需填深圳市、山东省需填青岛市。成都企业适用成都市。配置前需确认企业销方所在地的具体要求。
这个插件是谁开发的？
由成都轻如燕负责人赵鹏作为简道云合作开发者开发与维护。插件于 2023 年 12 月推出，正式对接全面数字化电子发票。简道云官方在数电开票插件一周年专场中，由赵鹏作为分享嘉宾讲解插件的用法与配置细节，帆软学院《简道云 X 电子税务系列插件实操课程》亦由赵鹏主讲。