המאמר הזה למי שעובדים עם ה-API במפתח של חשבון Financy. כאן מוסבר מה עולה קרדיטים ואיך מרעננים נתונים מהקוד. למדריך הכללי על רענון באפליקציה: מתי הנתונים ב-Financy מתעדכנים, ואיך מרעננים עכשיו.
מה עולה קרדיטים
קריאות רגילות לא עולות קרדיטים: חיבורים, חשבונות, יתרות ותנועות.
עולים קרדיטים: רענון יזום, ושיחות עם ה-AI של Financy.
שניהם יורדים מאותה מכסת קרדיטים של הארגון, אותה מכסה שהאפליקציה משתמשת בה. פרטים על המכסות בתוכניות, מחירים וקרדיטים ב-Financy.
רענון יזום דרך ה-API
POST https://api.open-finance.ai/chat/chat/connections/refresh
שימו לב ל-
chatפעמיים בכתובת. נדרשת ההרשאהread:connections.הקריאה פונה לבנקים מיד ומרעננת את כל החיבורים יחד, ב-20 קרדיטים בסך הכול, לא לכל חיבור.
אם כבר רץ רענון, התשובה היא
already_runningולא יורדים קרדיטים.כדי לדעת שהרענון הסתיים, בדקו את
lastFetchedAtבכל חיבור ב-GET /v2/connections. כשהערך מתקדם, ודאו גם שהסטטוסACTIVEושאין שגיאה.
תשובות אפשריות
200עםaccepted: הרענון התחיל, ו-20 קרדיטים ירדו.200עםalready_running: רענון כבר רץ. לא ירדו קרדיטים.402עםinsufficient_credits: אין מספיק קרדיטים.409עםno_refreshable_connections: אין חיבור שאפשר לרענן. חברו בנק מחדש.
GET /v2/connections/refresh/{connectionId} לא זמין לחשבונות Financy. השתמשו בכתובת שלמעלה.
רענון אוטומטי
הרענון האוטומטי מתחיל בכל בוקר ב-07:00 (06:00 בשעון חורף), בלי קרדיטים. הנתונים מתעדכנים במהלך הבוקר, בדרך כלל עד 11:00, תלוי בבנק או בחברת האשראי. ב-Free וב-Starter יש רענון אחד ביום, וב-Pro וב-Ultra ארבעה. מנויי Starter יכולים להוסיף רענונים יומיים, ב-49 ₪ לחודש לכל רענון נוסף, עד 4 ביום, בהגדרות תחת פרטי התוכנית. גם הם לא עולים קרדיטים.
יתרה בעו״ש בלאומי
בחשבון עו״ש בלאומי מתקבלים סוגי היתרה closingBooked ו-expected.
שאלות נפוצות
משיכת תנועות דרך ה-API עולה קרדיטים?
לא. רק רענון יזום ושיחות עם ה-AI עולים קרדיטים.
רענון של 5 חיבורים עולה 100 קרדיטים?
לא. 20 קרדיטים לכל הקריאה, לכל החיבורים יחד.
קראתי לרענון פעמיים ברצף. ירדו 40 קרדיטים?
לא, אם הרענון הראשון עוד רץ. השנייה תחזיר already_running בלי חיוב.
איך יודעים שהרענון הסתיים?
אין הודעה על סיום. בדקו את lastFetchedAt ב-GET /v2/connections כל כמה דקות.