用途
该技能面向以色列电子发票（hashbonit electronit）的生成、校验与管理，遵循以色列税务局（SHAAM）标准。当用户需要创建以色列发票、收据、贷项发票或形式发票时使用。
主要能力
技能按步骤引导完成发票处理：
-
确定发票类型：提供类型代码对照，包括300（税务发票，用于B2B销售、超过阈值的服务）、305（税务发票/收据，用于即时付款的B2C）、310（贷项发票，用于退款、更正、退货）、320（收据，仅付款确认）、330（形式发票，用于报价、预开票，无需分配号）。
-
收集必填字段：卖方信息（企业名称、TIN/mispar osek、地址、电话）、买方信息（企业名称或个人、B2B需TIN、地址）、交易信息（日期、项目描述、数量、单价）、付款信息（方式如现金、转账、支票、信用卡，以及条款）。
-
计算增值税：标准以色列增值税率需始终向税务局核实（资料注明2024-2026年标准税率为17%，但税率可能变化）。计算公式为 vat_amount = net_amount * vat_rate，gross_amount = net_amount + vat_amount。对于免税交易（osek patur），不设增值税行，应改用收据（320）。
-
检查分配号要求：判断是否需要分配号。当发票金额达到当前阈值且发票类型为300、305或310时需要；收据（320）、形式发票（330）及低于阈值的发票不需要。当前阈值需始终向税务局核实。若需要分配号，需告知用户必须在开票前向SHAAM申请，并提供API调用结构（见 references/shaam-api-reference.md），分配号必须出现在打印或发送的发票上。
-
生成发票文档：按以色列标准格式化所有字段，包括公历（DD/MM/YYYY）与希伯来历日期、金额以新谢克尔（NIS）计、增值税单独列行、卖方序列中的连续发票号、分配号（如适用）。
-
校验：运行检查，包括所有必填字段是否齐全、TIN格式是否有效（9位数字含校验位）、增值税计算是否正确、发票号是否连续、日期是否不在未来、超过阈值时是否包含分配号。若校验失败，报告具体错误及修复方法。
使用方式
技能提供示例引导：
- 示例1：简单B2B税务发票。用户要求为网站开发项目开具15,000 NIS的税务发票给ABC Ltd。识别为税务发票（类型300），超过阈值需分配号；收集买卖双方信息；按当前税率计算净额15,000加增值税；指导从SHAAM申请分配号；生成格式化发票文档。
- 示例2：小额B2C收据。用户要求为500 NIS现金付款开具收据。识别为收据（类型320），低于阈值无需分配号；收集信息；生成收据文档。
- 示例3：退款贷项发票。用户要求为发票#1234开具部分退款3,000 NIS的贷项通知。识别为贷项发票（类型310）；引用原发票#1234；计算含增值税冲回的贷项金额；根据金额检查分配号要求；生成引用原发票的贷项发票。
捆绑资源
脚本：scripts/validate_invoice.py — 根据SHAAM要求校验以色列电子发票JSON，检查必填字段、TIN（mispar osek）格式与校验位、发票类型代码、增值税计算准确性及分配号阈值。运行：python scripts/validate_invoice.py --help
参考：
- references/shaam-api-reference.md — SHAAM（税务局）API端点，用于申请分配号、OAuth2认证设置及请求/响应格式。
- references/invoice-types.md — 以色列发票类型代码完整列表（300、305、310、320、330、400），含各类型必填字段、增值税适用性及分配号要求。
- references/compliance-timeline.md — 增值税法第157号修正案的渐进式电子发票强制时间线，显示阈值从25,000 NIS降至所有发票。
适用场景
适用于需要处理以色列本地发票合规的财务、税务与业务场景，包括B2B销售、B2C即时付款、退款更正、付款确认、报价预开票等。
限制与注意事项
- 以色列电子发票需要SHAAM分配号（mispar hiktza'a），代理可能生成无此号码的发票，导致不合规。
- 电子发票XML架构遵循以色列税务局规范，而非欧洲Peppol或UBL标准；代理可能生成以色列系统无法处理的UBL格式XML。
- 自2024年起，营业额超过阈值的以色列企业必须开具电子发票；代理可能未检查企业是否达到该阈值。
- SHAAM系统实时验证买方税号（mispar osek），代理可能使用占位符或无效税号，会被验证服务拒绝。
- 增值税率与分配号阈值可能变化，需始终向税务局核实。
故障排除
- 错误“Invalid TIN format”：以色列TIN必须为9位数字且校验位有效。用校验位算法验证，运行 scripts/validate_invoice.py。
- 错误“Allocation number required”：发票金额超过强制分配号当前阈值。在开票前从SHAAM API申请分配号。
- 错误“VAT rate mismatch”：使用了错误的增值税率（税率定期变化）。始终向税务局核实当前税率。
- 错误“Invoice type not suitable”：为交易选择了错误的发票类型。常见错误：即时付款需要305（含收据）时使用了300。