返回资讯中心
外部精选
软件工程
#开发者实时流

开发者用手机上的 Termux 打造 GST 开票工具 PakkaGst

来源标题:PakkaGst – A GST invoicing tool built on a phone in termux

印度自由职业开发者用手机上的 Termux 环境开发出终端开票工具 PakkaGst,无需订阅、账号或云端。它通过问答生成带 UPI 二维码的税务发票 PDF,能按同邦或跨邦自动计算 CGST+SGST 或 IGST,并支持信用票据、送货单和 HSN/SAC 编码本地查询。

Hacker News 最新PakkaGst2026/11/19 · 今天18 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一个从终端运行的 GST 开票工具。无需订阅、无需账号、无需云端。

我是印度的一名自由职业开发者。每次给客户开发票,我要么手动改 Word 模板(偶尔还会把 CGST/SGST 的拆分算错,这可是惹恼客户财务团队的好办法),要么盯着 Vyapar/myBillBook 的定价页面然后默默关掉标签页。反正我平时就是靠在手机上的 Termux 里写东西,索性就做了个自己想要的开票工具。

它会问你一些问题,你回答,然后你就能拿到一份像样的税务发票 PDF,上面带着 UPI 二维码。这就是全部卖点。

正确的 GST 计算——你和客户在同一个邦时用 CGST+SGST,不在同一个邦时用 IGST,未注册 GST 时零税率 当已注册 GST 的卖方收取零税率时,自动生成 Bill of Supply 而不是 Tax Invoice(这是真正的法律规则,不是瞎猜的) Credit note,会引用原始发票,所以修正和退款不是随便开一张带奇怪负数、谁也追溯不到的二手发票 Delivery challan,万一你需要在不构成销售的情况下转移货物 HSN/SAC 代码查询,来自本地可搜索的表(而不只是「记住你上次输入了什么」) GST 申报汇总导出(GSTR-1 / GSTR-3B 的外销部分)为 CSV,直接从你的发票和 credit note 生成——详见下面的诚实说明 UPI 支付二维码在你的设备上生成,不调用第三方 API,没有 Pillow 的麻烦 还有可分享的支付链接,附带为客户预填好的 WhatsApp 消息 报价单,不只是发票 把任意发票保存为模板,下个月几下点击就能重新生成——还可以选择按周/月/年重复(关于「自动」到底意味着什么,见下文) PDF 上有金额大写,INR 用印度 lakh/crore 风格,其他货币用标准进制 多业务档案,如果你用这个工具跑不止一项业务,每个都有自己的编号 多币种,如果你在印度以外开票 支付跟踪——未付 / 已付 / 逾期,直接在终端里看 一切都本地存储在 SQLite 里。除非你主动让它联网,否则什么都不会离开你的设备(二维码短链和税率表更新检查是仅有的两个会联网的功能,而且离线时都会安全失败)

关于「重复」发票,说实话

一个模板可以按周/月/年重复。这实际意味着:每次你打开 PakkaGst,它会检查有没有到期的东西,并当场提示生成——所以即使你一周才打开一次工具,也不会漏掉任何东西,不需要 cron job。如果你在某个真正一直开着的地方运行它——VPS、永不关机的笔记本——菜单里还有「Enable Daily Auto-Check (cron)」,它会安装一条真正的 crontab 条目,这样不用你打开任何东西它也能生成发票。在没有 crontab 的纯 Termux 上,那个选项只会告诉你这一点,不会做任何破坏性的事——上面说的打开时补生成仍然照常工作。我不声称在一部 Android 一脱手就会杀进程的手机上能有什么后台魔法;我声称的是它能可靠地补上,而这才是真正重要的部分。

电子发票(通过政府门户的 IRN)和 e-way bill。我在写第一行代码之前把两者都研究过了。电子发票只在营业额超过 ₹5 crore 时才法律强制要求,而且即便低于这个线,现实中也需要付费的 GSP 订阅才能接入——不是自由职业者需要的东西。E-way bill 是用于转移实物货物的,不是给服务类自由职业者用的。如果你的开票量真的到了这两者适用的程度,那你已经超出这个工具的范围了,该去看 Vyapar 或者找会计,而不是一个手机上的 CLI。

pkg install python-pillow # 仅 Termux,一次性 git clone https://github.com/hunzo1/PakkaGST cd PakkaGST pip install -e . pakkagst

首次运行会引导你设置业务档案。之后就是输入 pakkagst,然后从菜单里选你想做什么。

第一次运行 pakkagst 时,它会问你的业务/自由职业名称、你所在的邦(用来判断是 CGST+SGST 还是 IGST),以及你的 GSTIN(如果有的话)——如果你没注册 GST,就留空,工具两种情况都能正确处理(零税率,用 Bill of Supply 而不是 Tax Invoice)。你还可以在这里填一个 UPI ID,如果你想在发票上带支付二维码的话,但这是可选的。

之后,每次打开它你都会进入一个菜单。你最常用的是 New Invoice:

它会生成一个 PDF——路径就显示在终端里——如果你设置了的话,还有一个 UPI 二维码。在 Termux 上,PDF 会落在 ~/.pakkagst/invoices/ 下,你可以用任何你有的 PDF 查看器打开(或者如果你装了 termux-api,直接 termux-open yourfile.pdf),通过 AirDrop/分享传出去,或者 cat 到你用来给客户发东西的任何工具里。

菜单里其他东西基本就是字面意思——View Invoices / Track Payments 用来把某张标记为已付或逾期,Manage Clients 用来编辑已保存的客户,HSN/SAC Lookup 用来在不创建发票的情况下搜索税率表,Recurring Templates 如果你想让月度固定费用发票自动重新生成,Business Profiles 如果你用这个工具跑不止一项业务。随便点点,里面没有什么会损坏你的数据——最坏的情况就是你做了一张自己不在乎的测试发票(对,我也是这么测试的)。

HSN/SAC 表上的 GST 税率不是从政府实时拉取的——那没有免费的数据源,谁都没有,付费工具也是手动更新的。这个工具改为检查本仓库里的一个版本文件(菜单里的「Check for GST Rate Table Updates」),我会保持它更新。如果哪个税率错了,开个 issue,我真的宁愿知道,也不想让它一直错着。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →