שער עולמי: מה עמיל מכס צריך לדעת על הממשק החדש של המכס

מה זה שער עולמי?

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

לאורך השנים התקשורת עם שער עולמי התבססה על הודעות XML שעברו דרך ערוץ תקשורת ותיק. הממשק החדש, "שדירת המידע", מחליף את הערוץ הזה בשירותי REST שמחליפים מידע בפורמט JSON, ומאפשר למערכות התוכנה לעבוד מול המכס בצורה ישירה, מהירה ושקופה יותר.

מה משתנה בממשק החדש

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

• הזדהות בתקן OAuth 2.0: המערכת מקבלת אסימון גישה (Token) לכל שירות, לפרק זמן מוגבל.
• תעודה דיגיטלית ממשלתית (mTLS): כל קריאה נחתמת בתעודת לקוח שמונפקת למשרד ומקושרת למספר החברה שלו.
• כתובת IP קבועה: התעודה מקושרת לכתובת שממנה יוצאות הקריאות, ולכן התקשורת יוצאת משרת קבוע ומוכר.
• זיהוי בית התוכנה: כל הודעה מציינת את התוכנה ששלחה אותה, כך שהמכס יודע מאיזו מערכת הגיע כל שידור.
• הרשאה לכל שירות: שאילתות, חישוב מסים, צרופות והצהרות נפתחים כל אחד בנפרד.
• הודעות שגיאה ברורות: כשהמכס דוחה בקשה, התשובה כוללת את הסיבה בעברית ומזהה קריאה שמאפשר לברר אותה מול מוקד התמיכה.

מה נדרש ממשרד עמילות המכס

החיבור לממשק החדש הוא תהליך חד-פעמי, אבל יש בו כמה שלבים שכדאי להכיר מראש. רובם מבוצעים יחד עם בית התוכנה, ובחלקם נדרשת פנייה של המשרד עצמו.

• הנפקת תעודה דיגיטלית לתקשורת עם המכס, על בסיס בקשת חתימה (CSR) שמופקת עבור המשרד.
• קבלת פרטי גישה (מזהה לקוח וסיסמת לקוח) ורישום כתובת ה-IP שממנה תצא התקשורת.
• בקשת הרשאות לשירותים שהמשרד צריך, בנפרד בסביבת הבדיקות ובסביבת הייצור.
• בדיקת תקשורת מקצה לקצה בסביבת הבדיקות לפני מעבר לעבודה שוטפת.
• שמירה מאובטחת של התעודה, המפתח הפרטי והסיסמאות: הם לעולם לא נשלחים בדואר, לא נשמרים על מחשב אישי ולא נחשפים לדפדפן.

אילו שירותים הממשק מספק

הממשק החדש מרכז שורה של שירותים שמשרד עמילות משתמש בהם כל יום. חלקם שאילתות שמחזירות מידע, וחלקם שידורים שמעדכנים את המכס.

• שאילתת סטטוס הצהרה, גם לפי מספר שטר המטען כשמספר ההצהרה עוד לא ידוע.
• חישוב מיסי יבוא לפי הסיווג, הערך וארץ המקור.
• ספר המכס: יחידות המידה שבהן מוצהר כל פרט מכס.
• מאגר הספקים של המכס, לאיתור מספר ספק.
• צירוף מסמכים (חשבון ספק, רשימת אריזה, שטר מטען) לתיק במכס.
• טבלאות הקוד של המכס: בתי מכס, סוגי אריזות, סוגי מסמכים ועוד.

מה לבדוק במערכת עמילות המכס שלכם

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

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

איך Corso עובדת מול שער עולמי

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