用途
该技能用于按以色列税务局（SHAAM）标准生成、校验和管理以色列电子发票（hashbonit electronit）。当用户需要创建以色列发票、判断发票类型、计算增值税或检查分配号（allocation number）要求时使用。
主要能力
- 依据 SHAAM 官方文档类型代码（表 2.5）确定发票类型，包括：300 交易发票、305 税务发票、310 定期税务发票、320 税务发票/收据、330 贷项发票、332 形式发票，以及 v2 规范新增的 340 预订税务发票、345 代理税务发票、348 日志命令。
- 收集必填字段：卖方信息（企业名称、TIN/mispar osek、地址、电话）、买方信息（企业名称或个人、TIN、地址）、交易信息（日期、项目描述、数量、单价）、付款信息（方式、条款）。
- 按 18% 标准税率计算增值税：vat_amount = net_amount * 0.18，gross_amount = net_amount + vat_amount。对于 osek patur（免税经营者）不设增值税行，应开具普通收据（kabala），不得使用 320 代码。
- 判断是否需要分配号：需同时满足四个条件——税前金额超过当前阈值、发票含非零增值税、客户为 osek murshe（持证经营者）、客户要求分配号。文档类型也须属于携带分配号的类型（305、310、320、332 及 v2 的 340、345、348）。
- 提供分配号阈值时间线：2024 年 5 月 4 日至 2024 年 12 月净额 > 25,000 NIS；2025 年 1 月至 2025 年 12 月净额 > 20,000 NIS；2026 年 1 月至 2026 年 5 月净额 > 10,000 NIS；2026 年 6 月 1 日起净额 > 5,000 NIS。
- 处理申请失败或系统故障：区分实质性拒绝（可取消、无号继续、反向收费、申请听证）与技术故障（通过独立 Web 应用申请、等待故障清除、先开票后补号）。
- 提供校验脚本 scripts/validate_invoice.py，检查必填字段、TIN 格式与校验位、发票类型代码、增值税计算准确性及分配号阈值。
- 提供参考文档：references/shaam-api-reference.md（API 端点、OAuth2 认证、请求/响应格式）、references/invoice-types.md（文档类型代码完整列表）、references/compliance-timeline.md（合规时间线）。
使用方式
按步骤操作：第一步确定发票类型；第二步收集必填字段；第三步计算增值税；第四步检查分配号要求；第五步生成发票文档（日期同时使用公历 DD/MM/YYYY 和希伯来历，金额用 NIS，增值税单独列行，发票号按卖方序列连续，附分配号）；第六步运行校验检查。若校验失败，报告具体错误及修复方法。
适用场景
- B2B 销售与服务开票（305）
- 定期汇总开票（310）
- 即时付款的销售（320）
- 退款、更正、退货（330）
- 报价与预开票（332）
- 小额 B2C 收据（kabala）
- 与 SHAAM 电子发票 API 集成
限制
该工具为 AI 模型运营的免费信息工具，输出自动生成，未经税务顾问或会计师审查或批准。输出不是税务意见、不是持牌代表准备的申报表，也不是专业建议，仅为一般计算和解释。AI 模型可能出错、遗漏数据或给出错误结论。工具生成的任何表格或文本仅为个人准备用的自动草稿，不是已提交的申报表。申报和纳税责任由用户承担，具有约束力的计算以税务局为准，在税务局面前代表的权利保留给法律允许的人员。该工具不能替代考虑个人具体情况和需求的建议。提交或付款前请咨询税务顾问或会计师。所有输出使用由用户自行负责。
常见陷阱
- 代理可能生成无 SHAAM 分配号的发票，这在税务上无效。
- 以色列个人 TIN 为 9 位带校验位算法，代理可能不校验校验位而接受无效 TIN。
- cheshbonit mas（305）与 cheshbonit mas/kabala（320）的法律含义不同，不可互换。
- 以色列电子发票 XML 模式遵循 SHAAM 特定标准，不是欧洲 Peppol 或 UBL 格式。
- 贷项发票（cheshbonit zikui）必须引用原始发票号。
- 客户号必填，遗漏返回错误 432；不抵扣进项税的客户用哨兵值 999999998。
- 460 不是 HTTP 状态，Approval 服务即使未批准也返回 HTTP 200，需检查 approved 字段和 confirmation_number。
- 打印的是确认号最右 9 位字符。
- 分配号的真正归宿是 PCN 874 详细报告，打印在发票上必要但不充分。