הגדרות ->3. מסמכים ->4. הגדרות מסמכים בממשקים

הגדרות כלליות בהפקת חשבוניות ממשקים

תוכן העמוד

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

ההגדרות רלוונטיות למסמכים שמופקים דרך:

• דף אישורית זהב.
• פרופיל נמוך וחיוב עסקה מושהית.
• הוראת קבע בענן.

בנוסף, ניתן להגדיר דיווח אוטומטי למערכת חיצונית לאחר יצירת מסמך, באמצעות שליחת פנייה ב־POST.

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

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

הרשאות: משתמש ללא הרשאה לעריכת פרטי חברה יוכל לצפות בהגדרות, אך לא יוכל לערוך או לשמור אותן.

בחירת מסוף

בחר מסוף

רשימה נפתחת לבחירת המסוף שעבורו יוצגו וייערכו ההגדרות ברמת המסוף.

בחירת מסוף אחר טוענת את ההגדרות השמורות עבור אותו מסוף.

חשוב לדעת:

• הרשימה מציגה רק מסופים שלמשתמש יש הרשאה אליהם.
• הגדרות ברמת המסוף נשמרות בנפרד לכל מסוף.
• הגדרות ברמת החברה נשארות זהות לכל המסופים.

סוג המסמך להפקה

סוג מסמך להפקה

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

האפשרויות כוללות:

• חשבונית מס קבלה.
• קבלה — מתאים למלכ"ר.
• הזמנה מלקוח - מאתר / אישור תשלום.
• קבלה על תרומה.

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

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

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

דיווח על יצירת מסמכים למערכות חיצוניות

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

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

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

הגדרות ברמת החברה

מזהה חברה ייחודי של מערכת אישורית זהב

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

המזהה מוצג לקריאה בלבד ואינו ניתן לשינוי.

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

מזהה חברה ייחודי במערכת המקבלת — אופציונלי

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

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

אם השדה נשאר ריק, לא יישלח מזהה נוסף.

כללי תקינות:

• ניתן להזין עד 250 תווים.
• ההגדרה נשמרת ברמת החברה וזהה לכל המסופים.

הגדרות ברמת המסוף

ההגדרות הבאות נשמרות בנפרד לכל מסוף, בהתאם למסוף שנבחר בראש העמוד.

דיווח על יצירת מסמך למערכת חיצונית

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

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

אם לא הוזנה כתובת URL, לא תישלח פנייה.

כתובת URL לדיווח — הדיווח מתבצע ב־POST

כתובת האינטרנט שאליה יישלח הדיווח על יצירת המסמך.

הפנייה נשלחת בשיטת POST.

חשוב לדעת:

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

כללי תקינות:

• ניתן להזין עד 1000 תווים.
• יש להזין כתובת אינטרנט תקינה.

מחרוזת תוספת לפנייה

שדה להזנת פרמטרים נוספים שיצורפו לפנייה למערכת החיצונית.

לדוגמה:

Term=1234&secret=abcs

הפרמטרים שיוזנו כאן יצורפו לכל פנייה שתישלח ב־POST, בנוסף למזהים ולפרטי המסמך הסטנדרטיים.

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

כללי תקינות:

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

הוסף את פרטי המסמך ב־POST

תיבת סימון הקובעת האם לכלול את פרטי המסמך המלאים בגוף הפנייה למערכת החיצונית.

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

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

הגדרה זו נשמרת ברמת המסוף.

שמירת השינויים

בסיום העריכה יש ללחוץ על כפתור "שמור".

השמירה מעדכנת את ההגדרות עבור המסוף שנבחר, כולל:

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

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

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

לאחר שמירה מוצלחת תוצג ההודעה:

"הנתונים נשמרו".

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