用途:为以色列自由职业者和小企业搭建 Google Sheets 收支跟踪表,并按以色列税务规则计算增值税(VAT)、归类可抵扣支出、生成双月 VAT 报告。
主要能力:创建含日期、描述、类别、不含税金额、VAT(18%)、含税总额、收支类型、发票号、支付方式、备注共 10 列的表格;按 18% 与 1.18 公式拆分或合并税额;按以色列可抵扣类别(如办公租金、设备、电话与网络、专业服务、餐饮与招待 80%、差旅、软件与订阅、营销、保险为 100%,汽车费用受限为 45% 或固定额)归类;读取数据并汇总总收入、总支出、净利润、已收 VAT、进项 VAT 与应缴 VAT;按双月申报期(1-2 月、3-4 月、5-6 月、7-8 月、9-10 月、11-12 月)生成汇总标签页;批量追加交易;导出 CSV 备份。
使用方式:先确认 gws 已安装并完成 OAuth 认证,命令为 gws --version、npm install -g @google/gws、gws auth login、gws auth status,未配置 Google Cloud 项目时引导执行 gws auth setup。用 gws sheets create 建表,用 gws sheets append 写入表头或交易行(支持 --dry-run 预览),用 gws sheets read 读取数据并可加 --output json 或 --output csv。附带脚本 scripts/vat-summary.py 生成双月 VAT 汇总,scripts/backup-sheets.py 备份表格标签页为本地 CSV。
限制与注意事项:VAT 税率须使用 18%(0.18),不要用旧 17%;日期格式为 DD/MM/YYYY;gws 仅支持服务端 OAuth,不支持 API key 或服务账号;汽车费用不可按 100% 抵扣;VAT 四舍五入到 2 位小数。其他具体集成细节暂未提供。