ממיר מטבע שקל

שלב 1: זיהוי בקשת המרה

נתחו את בקשת המשתמש ואתרו:

• מטבע מקור ומטבע יעד (לפחות אחד מהם צריך להיות ש"ח/ILS)
• סכום להמרה
• תאריך (נוכחי או תאריך היסטורי ספציפי)
• מטרה (מידע כללי מול שער יציג רלוונטי למס)

קודי מטבע נפוצים:

שלב 2: שליפת שער חליפין

השתמשו ב-API של בנק ישראל לקבלת השער:

שער נוכחי:

Fetch: https://www.boi.org.il/currency.xml
Parse XML for the requested currency code
Extract: rate, unit, change from previous day

שער היסטורי:

Fetch: https://www.boi.org.il/PublicApi/GetExchangeRates?date=YYYY-MM-DD
Parse response for requested currency
Note: Rates not available for Shabbat/holidays -- use last available business day

שלב 3: חישוב ההמרה

If converting FROM NIS:
  result = amount / rate * unit

If converting TO NIS:
  result = amount * rate / unit

If converting between two foreign currencies:
  nis_amount = amount * rate_source / unit_source
  result = nis_amount / rate_target * unit_target

הערה: שערי בנק ישראל מבטאים כמה שקלים ליחידה/יחידות של מטבע זר. דוגמה: שער USD = 3.65, יחידה = 1 פירושו 1 USD = 3.65 ש"ח. שער JPY = 2.45, יחידה = 100 פירושו 100 JPY = 2.45 ש"ח.

שלב 4: הצגת תוצאות

עצבו את התוצאה עם:

• סכום מומר (2 ספרות עשרוניות לש"ח, דיוק מתאים למטבעות אחרים)
• שער החליפין שנעשה בו שימוש ותאריכו
• מקור: "שער יציג של בנק ישראל (shaar yatzig)"
• שינוי מהיום הקודם (אם זמין)
• הערה: "שער יציג לעיון בלבד. שערי הבנקים בפועל עשויים להיות שונים."

דוגמה 1: המרת דולר לשקל פשוטה

המשתמש אומר: "המר 1000 דולר לשקלים" תוצאה: "1,000 USD = 3,650.00 ש"ח (לפי שער בנק ישראל 3.6500, פורסם 24 בפברואר 2026)"

דוגמה 2: שער היסטורי

המשתמש אומר: "מה היה שער הדולר ב-1 בינואר 2026?" תוצאה: "שער יציג USD/ILS ליום 1 בינואר 2026: 3.5800 (שער יציג בנק ישראל)"

דוגמה 3: שער רלוונטי למס

המשתמש אומר: "אני צריך את שער האירו לדוח מע"מ לדצמבר 2025" תוצאה: מספק את השער היציג לתאריך הרלוונטי, עם ציון שזהו השער הרשמי לצרכי מס.

סקריפטים

• scripts/fetch_rates.py — שולף שערי חליפין יציגים רשמיים של בנק ישראל ומבצע המרות מטבע מול ש"ח. תומך בשערים נוכחיים, חיפוש תאריכים היסטוריים, והצגת כל המטבעות הזמינים. הרצה: python scripts/fetch_rates.py --help

חומרי עזר

• references/boi-api-guide.md — תיעוד API של שערי חליפין של בנק ישראל כולל נקודות קצה, מבנה תגובת XML, לוח זמני עדכון (יומי ~15:30 שעון ישראל), ופרמטרים לשאילתת שערים היסטוריים. היעזרו בקובץ זה בעת פתרון בעיות בקריאות API או הבנת זמני פרסום שערים.
• references/currency-codes.md — קודי מטבע נתמכים עם שמות בעברית, טווחי שער אופייניים מול ש"ח, וערכי יחידה (חשוב ל-JPY ומטבעות מרובי יחידות אחרים). היעזרו בקובץ זה בעת פענוח בקשות מטבע של משתמשים או טיפול בהמרות מבוססות יחידות.

שגיאה: "Rate not available for date"

סיבה: התאריך המבוקש הוא שבת, חג, או תאריך עתידי פתרון: השתמשו בשער יום העסקים האחרון הזמין. בנק ישראל מפרסם שערים בימים ראשון עד חמישי.

שגיאה: "Currency not supported"

סיבה: בנק ישראל אינו מפרסם שער למטבע זה פתרון: הציעו שימוש בדולר או אירו כמטבע ביניים להמרה.