用途:将外币换算为以色列新谢克尔(NIS/ILS),或反向换算。至少一方须为 NIS/ILS。
主要能力:读取以色列央行实时 JSON 汇率接口 https://www.boi.org.il/PublicApi/GetExchangeRates ,解析 exchangeRates 数组中的 key、currentExchangeRate、unit、currentChange、lastUpdate。历史或税务指定日期使用 SDMX 序列:https://edge.boi.gov.il/FusionEdgeServer/sdmx/v2/data/dataflow/BOI.STATISTICS/EXR/1.0/RER_<CUR>_ILS?startPeriod=YYYY-MM-DD&endPeriod=YYYY-MM-DD&format=csv ,取 OBS_VALUE 与 TIME_PERIOD。若目标日无发布(周六、周日、节假日),回溯至最近已发布日期并说明所用日期。
计算方式:从 NIS 换算:amount / rate * unit;换算为 NIS:amount * rate / unit;两种外币之间经 NIS 间接换算,须标注为派生数值而非官方代表汇率。汇率单位以 unit 为准(如 JPY 常为 100)。
使用方式:可用捆绑脚本 python scripts/fetch_rates.py --help;参考资料含 references/boi-api-guide.md、references/currency-codes.md。可搭配 boi-exchange MCP 服务器获取官方汇率。
适用场景:税务换算(收入按应计/收讫日汇率、支出按支付日汇率、年末按 12 月 31 日汇率、资本利得分别用取得日与处置日汇率)、一般汇率查询。
限制:仅覆盖央行公布的 14 种货币(USD、GBP、JPY、EUR、AUD、CAD、DKK、NOK、ZAR、SEK、CHF、JOD、LBP、EGP)。不提供加密货币、银行卡或银行实际兑换价。实时接口的 ?date= 参数被忽略,历史查询须用 SDMX。货物进口增值税使用以色列税务局每周公布的海关汇率,服务反向征税使用普通代表汇率。NIS 格式为符号前置、千分位逗号、小数点句点。