invoice-ofd2json
解析电子发票ofd为json
今日安裝
0
總安裝量
6
創建日期
2023-09-04T02:10:19+00:00
更新日期
2023-09-04T02:10:19+00:00
用户評分
暫無評分
// @require https://scriptcat.org/lib/1265/1.0.1/invoice-ofd2json.js
論壇帖子
v1.0.1@require库

额外说明

库已做兼容处理,一份代码同时兼容HTML(现代浏览器)、JS(脚本猫油猴)、Node.js
不只局限于脚本管理器(脚本猫油猴)

开源仓库

GitHub: https://github.com/DreamNya/invoice-ofd2json
NPM: https://www.npmjs.com/package/invoice-ofd2json

说明

功能

轻量化JavaScript库,可解析输入的ofd发票文件内容,并将其提取转为json格式输出

特点

  • 可解析电子发票
  • 可解析全电发票
  • 轻量化JavaScript库
  • 即开即用 易于使用
  • 兼容前端浏览器
  • 兼容后端Node.js

TODO(欢迎PR)

  • 兼容特殊类型发票(例如:成品油、建筑服务类特殊发票,缺少特殊发票样本)
  • 可解析多页发票、销货清单(目前暂时只支持解析发票第一页,缺少多页发票样本)

原理

通过JSZip解压ofd发票,提取CustomTag.xml以及Pages/*/Content.xml文件并对其进行解析
(所有解析内容来源均为ofd发票文件,仅支持正规格式。受ofd格式限制,文件内部分信息缺失,暂时无法做到100%准确,仅能依靠预定义解决)

使用方法

Node.js

安装(NPM)

npm install invoice-ofd2json

使用

const ofd2json = require("invoice-ofd2json");
/**
 * 解析输入的ofd文件内容并将其转换为json输出
 * @param ofd 任意符合JSZip输入格式的ofd文件格式
 * @param logMessage 用于调试输出时附带的信息
 * @return json格式的解析后的ofd内容
 */
await ofd2json(ofd, ?logMessage)

Browser

安装(CDN)

<script src="https://cdn.jsdelivr.net/npm/jszip@3.10.1/dist/jszip.min.js" crossorigin="anonymous"></script>
<script src="https://cdn.jsdelivr.net/npm/invoice-ofd2json/src/parser.js" crossorigin="anonymous"></script>

使用

/**
 * 解析输入的ofd文件内容并将其转换为json输出
 * @param ofd 任意符合JSZip输入格式的ofd文件格式
 * @param logMessage 用于调试输出时附带的信息
 * @return json格式的解析后的ofd内容
 */
await ofd2json(ofd, ?logMessage)

UserScript

安装(CDN)

// @require https://cdn.jsdelivr.net/npm/jszip@3.10.1/dist/jszip.min.js
// @require https://cdn.jsdelivr.net/npm/invoice-ofd2json/src/parser.js

安装(ScriptCat)

// @require https://cdn.jsdelivr.net/npm/jszip@3.10.1/dist/jszip.min.js
// @require https://scriptcat.org/lib/1265/1.0.1/invoice-ofd2json.js

使用

/**
 * 解析输入的ofd文件内容并将其转换为json输出
 * @param ofd 任意符合JSZip输入格式的ofd文件格式
 * @param logMessage 用于调试输出时附带的信息
 * @return json格式的解析后的ofd内容
 */
await ofd2json(ofd, ?logMessage)

应用场景

详见Demo
(UserScript Demo待补充)

License

MIT

腳本評分
empty image
還沒有人來給腳本打分,快來成為第一個打分的人吧