א. אינדקס מאמרים ליצירת מסמכים - חשבונית / קבלה (מזומן , המחאות וכו)
מאמר זה מסכם כיצד ניתן ליצור מסמכים באופן עצמאי ללא חיוב אשראי.
מיועד להפקת מסמך כאשר החיוב הוא לא באשראי כגון צ'קים מזומן והעברות בנקאיות. במידת הצורך ניתן גם להצליב את המסמך לעסקת חיוב קיימת במערכת.
כאשר רוצים להפיק מסמך בעת חיוב האשראי , יש להעביר את פרטי המסמך וסוג המסמך עם פרטי החיוב ולא להשתמש בממשק זה.
מערכת הסליקה תומכת בשתי סוגי ממשקים , Name To Value ו Web Service. טבלת הפרמטרים זהה לשתי סוגי הממשקים.
Web Service
כתובת ה Web Service היא : https://secure.cardcom.solutions/Interface/BillGoldService.asmx
הפונקציה שיש להשתמש לשם העברת לפרטי העסקה לחיוב בלבד היא : CreateTexInvoice.
ראה בהמשך טבלאות פרמטרים לעברה וקבלת תשובה.
Name To Value
כתובת Name To Value היא :https://secure.cardcom.solutions/Interface/CreateInvoice.aspx
הערות ל Name To Value :
- חובה לבצע פנייה ב POST.
- חובה לבצע urlencode לכל הערכים המועברים למערכת.
- יש להוסיף את הפרמטר codepage=65001, פרמטר זה אומר את סוג הקידוד המועבר למערכת.
- התשובה המתקבלת היא במבנה :Param=value&Param1=value1
- הפרמטרים המתקבלים במערכת אינם Case Sensitive לדוגמה : הפרמטר terminalnumber זהה לפרמטר TerminalNumber.
ראה בהמשך טבלאות פרמטרים לעברה וקבלת תשובה.
הסבר שלבי העבודה:
על מנת ליצור מסמך יש לפנות פעם אחת לשרת הסליקה אישורית זהב ולעביר את הפרמטרים המתאימים. הפרמטרים מתחלקים ל 3 קבוצות:
- פרמטרים לזיהוי לקוח וסוג המסמך.
- פרטי המסמך הכוללים: כותרת המסמך ושורות המסמך (חוץ ממסמך 400 ).
- אמצעי התשלום: יש להעביר אמצעי תשלום כגון : מזומן , צ'קים, חיוב אשראי שבוצע בעבר או אמצעי תשלום אחר(כגון העברה בנקאית , PayPal). ניתן להעביר מספר אמצעי תשלום שונים לאותה מסמך. ( במידה ויש אמצעי תשלום למסמך )
1. פרמטרים לזיהוי לקוח וסוג המסמך להפקה
פרמטר | תיאור | ערכים אפשריים לדוגמה |
terminalnumber | מספר מסוף | 1000 |
username | שם משתמש לממשקים | TestUser |
InvoiceType | סוג המסמך להפקה | 1 - חשבונית מס קבלה 2 - חשבונית מס קבלה זיכוי 3 - קבלה מלכ"ר 4 - החזר כספים לקוחות (קבלה זיכוי מלכ"ר)
50- הצעת מחיר 100 - הזמנה - לא שולמה. 101 - אישור הזמנה - מאתר ( מסמך פנימי לא להנח"ש) - הזמנה ששולמה 102 - זיכוי הזמנה - מאתר ( מסמך פנימי לא להנח"ש) - הזמנה ששולמה
200 - תעודת משלוח (210 - תעודת החזר) 300 - חשבון עסקה
301 - דרישה לתשלום (302 - ביטול דרישה לתשלום) 305 - חשבונית מס (330 - חשבונית מס זיכוי) 400 - קבלה לחשבונית מס (410 - החזר כספים לקוחות) 405 - קבלה על תרומה (406 - החזר תרומה ללקוח)
303 - חשבון קבלה ( כמו חשבונית לעוסק פטור , נדיר לשימוש , 304 - חשבון קבלה זיכוי )
|
| | |
2. פרטי החשבוניות הכוללים:
כותרת המסמך ושורות המסמך: טבלת פרמטרים : יצירת חשבונית מס / קבלה מלכ"ר.
3. אמצעי התשלום :
- מזומן: יש להוסיף את הפרמטר cash=XXX לשם העברת מזומן לדוגמה cash=140.15
- שקים: טבלאות פרמטרים : המחאות לחשבוניות קבלה
- אשראי: טבלת פרמטרים : הצלבת חיוב אשראי קיים לחשבונית מס קבלה
- תשלום אחר: טבלת פרמטרים : הוספת "תשלום אחר" לחשבונית.
טבלת פרמטרים תשובה המתקבלת לאחר פנייה :
פרמטר | תיאור | ערכים אפשריים לדוגמה |
ResponseCode | קוד תשובה ליצירת מסמך | 0 - תקין אחרת שגיאה |
Description | תיאור קוד תשובה ליצירת המסמך | תקין |
InvoiceNumber | מספר המסמך שנוצר | 9871 |
InvoiceType | סוג המסמך
| 1 - חשבונית מס קבלה 2 - חשבונית מס קבלה זיכוי 3 - קבלה מלכ"ר 4 - החזר כספים לקוחות (קבלה זיכוי מלכ"ר)
101 - אישור הזמנה - מאתר ( מסמך פנימי לא להנח"ש) 102 - זיכוי הזמנה - מאתר ( מסמך פנימי לא להנח"ש)
200 - תעודת משלוח (210 - תעודת החזר) 300 - חשבון עסקה 305 - חשבונית מס (330 - חשבונית מס זיכוי) 400 - קבלה לחשבונית מס (410 - החזר כספים לקוחות) |
הערות :
1. פרמטר ManualInvoiceNumber במבנה ראש המסמך : במקרים נדירים ניתן להעביר את מספר המסמך שהמערכת תיצור במקום להשתמש במונה הפנימי של המערכת. שם לב! במידה וישנה התנגשות במונים המסמך לא יווצר , יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה.