IamRamgarhia/Free-GST-Billing-Software

Free GST Billing Software 是一款 MIT 许可的开票与账单应用，面向需要合规 GST 发票与申报数据、又不想订阅付费的印度企业。它以本地 Web 应用形式运行（Express 服务端加 React 前端），所有数据以纯 JSON 文件保存在本机，核心流程不需要账号或云服务。

实际工作流程

安装后，欢迎向导会设置地区、企业信息、GSTIN、银行账户和 UPI ID。开票时可选择货物或服务单位、填写 HSN/SAC 编码和税率；应用会自动计算邦内销售的 CGST/SGST 或跨邦的 IGST，并支持覆盖 Place of Supply 及 SEZ 标记。发票类型包括 Tax Invoice、Proforma、Bill of Supply、Credit Note 和 Delivery Challan；作废发票会保留编号并盖上 CANCELLED 标记，而不是直接删除。PDF 可下载、通过 WhatsApp 或邮件分享，也可选自动上传到用户自己的 Google Drive。可参阅功能概览和五分钟首张发票教程。

GST 数据与申报边界

应用按 GSTN 离线工具 JSON 格式生成 GSTR-1 和 GSTR-3B 数据，并可导入 GSTR-2B 与采购记录做对账。它不直接提交申报：文档中的流程是导出 JSON、上传到 GST 门户，再回到应用标记已申报；直接门户上传列在后续计划中。费用录入会为 3B 计算提供进项税抵扣，TDS/TCS 开关会汇总 Form 26Q/27EQ 所需数据。

安装路径与平台范围

一键启动器只适用于 Windows 10/11；README 称它不需要管理员权限，缺少 Node.js 时会装进应用文件夹。macOS 和 Linux 可用发布 ZIP 内的启动器，或按开发者方式安装（需要 Node.js 18+），也可从 Chromium 浏览器把应用安装为 PWA。另有四种在线部署方案用于多设备或团队访问，但 README 明确提醒这会把业务数据放到别人的服务器上。各路径均有独立文档，先决条件汇总见 Quick Start。

需要注意的限制

• 服务端默认只接受 localhost 请求。若要让店铺局域网内的 POS 平板访问，需要手动把局域网来源加入 server.js 的 CORS 白名单；README 也指出，未单独锁定的来源会让同一 Wi-Fi 上的其他设备也能访问。详见仓库 README。
• Windows 版本没有代码签名，需要手动绕过 SmartScreen 提示；macOS 版本也没有 Apple 签名。首次安装需要联网下载依赖，之后可离线使用；可选的联网功能只有 Google Drive 备份和更新检查。
• 更新只替换应用代码，数据与 PDF 归档按文档说明不会被改动，且更新前会先往用户的文档目录写备份。若目标位置已有带数据的安装，更新会停止而不是覆盖。
• 数据保存在本地 JSON 文件；README 称卸载不会删除数据文件夹，迁移或重新导入时请按用户指南中的备份/恢复流程操作。
• 目前不支持 E-invoicing/IRN、GST 补偿税（cess）、原生手机应用或直接向 GSTR 门户提交；这些都在路线图中。Tally XML 导入也尚未提供，但客户和产品支持 CSV 导入。
• 采用 MIT 许可，允许商用和修改。