התהליך הוא זה:
המערכת שלך מפנה את הדפדפן לקישור הבא: https://openapi.taxes.gov.il/shaam/production/longtimetoken/oauth2/authorize?response_type=code&client_id=9c83a7320fecabd55319a63a82f34d7a&scope=scope&state=7778809
המערכת של רשות המיסים מציגה דף הזדהות.
המשתמש מזדהה מול המערכת של רשות המיסים.
המערכת של רשות המיסים שולחת Redirect לכתובת שהגדרת מראש ושולחת לך את ה-Authorization Code ואת ה-State
המערכת שלך משתמשת ב-Authorization Code ומקבלת Access Token.
בנוסף המערכת מקבלת גם Refresh Token.
המערכת שלך משתמשת ב-Access Token ומקבלת Allocation Number.
בפעם הבאה אפשר לעבור שוב דרך המסלול הנ"ל.
או, אם שמרת את ה-Refresh Token, להשתמש בו בכדי לקבל Access Token חדש.
זה חוסך למשתמש את ההזדהות מול רשות המיסים.
| Http Code | Http Message | More Information | Help |
|---|---|---|---|
400 | Bad Request | object syntax Invalid | Check your Json for syntax errors |
401 | Unauthorized | Cannot pass the security checks that are required by the target API or operation, Enable debug headers for more details | Make sure OAuth2 protocol is set and that the Token is up to date שגיאה שקשורה ב-Token ששלחת. לדוגמה, התוקף של ה-Token פג. |
403 | Forbidden | You don't have permission to access this service | דוגמה: שלחת Client ID של App שלא קיים במערכת של רשות המיסים. או שה-APP לא subscribed על השירות |
404 | Not Found | No resources match requested URI | Check URI is correct |
406 | 'Not Acceptable | Server cannot fulfill request | Check permission for the Vat_numebr |
422 | Unprocessable Entity | Validate: temporary:///swagger/shaa m_tsandbox_invoices_v1.js | One or more of the parameters doesn’t match the schema. Check the JSON in swagger for specific error. שגיאה בערך של אחד או יותר מהשדות ב-JSON ששלחת. |
500 | Internal Server Error | Error_Id | באג בצד של רשות המיסים. לדוגמה: שלחת ערך בפורמט שהם לא ציפו לו, החסרת שדה שהוא לא שדה חובה אבל הקוד שלהם כן מצפה לו. פנה אליהם שיעזרו לך invoices@taxes.gov.il. |
מצגת של רשות המיסים בעניין הרישום לפורטל המפתחים.
האיזור האישי של רשות המיסים האיזור האישי של רשות המיסים הוא נפרד מהאיזור האישי הממשלתי.
קישור לשע"ם – מייצגים, כספות, ובתי תוכנה
נוהל מתן הרשאה לרישום בית התוכנה מטעם בעל העסק/התאגיד
הנחיות התחברות לשרותי רשות המסים מיום 5/2023
English version:
Israel Tax Authority Login Instructions - Version 1.0 / 5.2023
הנחיות לשרותי API ליצרני תוכנות מיום 6/2023
מודל חשבוניות ישראל תיאור ה API's מיום 7/2023 הוחלף במסמך מיום 8/2023
English version: Israel Invoice Model Description of API's - Edition 7.2023 / 1.0 Replaced by a new document from 8/2023 (only an Hebrew version is available)
מודל חשבוניות ישראל תיאור ה API's מיום 8/2023
שאלות ותשובות -- על-ידי רשות המיסים
18/12/2023 עדכון בעניין שינוי ה-URL של המערכת להקצאת מספר החשבונית
הוראת ביצוע מס ערך מוסף מספר 01/2023
הקצאת מספרי חשבוניות מס – מהפכה של ממש!
רשות המסים תאשר בזמן אמת כל חשבונית מעל 25 אלף שקל
הקצאת מספרי חשבוניות על-ידי רשות המיסים
מודל חשבוניות - "הקצאת חשבוניות" - הבהרות מרשות המסים