סייר
 
אפשריות
Rss קטגורייות

א. אינדקס מאמרים ליצירת מסמכים - (חשבונית / קבלה למזומן , המחאות וכו)

מספר מאמר: AA-00254 צפיות: 5816 נוצר: 09/05/2012 10:00 עדכון אחרון: 16/04/2018 11:33 0 דירוג/ מצביע

א. אינדקס מאמרים ליצירת מסמכים - חשבונית / קבלה   (מזומן , המחאות וכו)

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

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

מערכת הסליקה תומכת בשתי סוגי ממשקים , 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 :

  1. חובה לבצע פנייה ב POST.
  2. חובה לבצע urlencode לכל הערכים המועברים למערכת.
  3. יש להוסיף את הפרמטר codepage=65001, פרמטר זה אומר את סוג הקידוד המועבר למערכת.
  4. התשובה המתקבלת היא במבנה :Param=value&Param1=value1
  5. הפרמטרים המתקבלים במערכת אינם Case Sensitive  לדוגמה : הפרמטר terminalnumber זהה לפרמטר TerminalNumber.

ראה בהמשך  טבלאות  פרמטרים לעברה וקבלת תשובה.


הסבר שלבי העבודה:

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

  1. פרמטרים לזיהוי לקוח וסוג המסמך.
  2. פרטי המסמך הכוללים: כותרת המסמך ושורות המסמך (חוץ ממסמך 400 ).
  3. אמצעי התשלום: יש להעביר אמצעי תשלום  כגון : מזומן , צ'קים, חיוב אשראי שבוצע בעבר או אמצעי תשלום אחר(כגון העברה בנקאית , PayPal). ניתן להעביר מספר אמצעי תשלום שונים לאותה מסמך. ( במידה ויש אמצעי תשלום למסמך )


1. פרמטרים לזיהוי לקוח וסוג המסמך להפקה

פרמטר תיאור ערכים אפשריים לדוגמה
terminalnumberמספר מסוף 1000
usernameשם משתמש לממשקיםTestUser
InvoiceTypeסוג המסמך להפקה

1 - חשבונית מס קבלה
2 -  חשבונית מס קבלה זיכוי
3 - קבלה מלכ"ר
4 - החזר כספים לקוחות (קבלה זיכוי מלכ"ר)

100 - הזמנה  - לא שולמה.

101 - אישור הזמנה - מאתר  ( מסמך פנימי לא להנח"ש) - הזמנה ששולמה
102 - זיכוי הזמנה - מאתר  ( מסמך פנימי לא להנח"ש) - הזמנה ששולמה

200 - תעודת משלוח (210 - תעודת החזר)
300 - חשבון עסקה
305 - חשבונית מס (330 - חשבונית מס זיכוי)
400 - קבלה לחשבונית מס (410 - החזר כספים לקוחות)

405 - קבלה על תרומה ( 406 - החזר תרומה ללקוח ) 





   

2. פרטי החשבוניות הכוללים: 

כותרת המסמך ושורות המסמך: טבלת פרמטרים : יצירת חשבונית מס / קבלה מלכ"ר.


3. אמצעי התשלום : 

  1. מזומן: יש להוסיף את הפרמטר cash=XXX לשם העברת מזומן לדוגמה cash=140.15
  2. שקיםטבלאות פרמטרים : המחאות לחשבוניות קבלה
  3. אשראי טבלת פרמטרים : הצלבת חיוב אשראי קיים לחשבונית מס קבלה
  4. תשלום אחרטבלת פרמטרים : הוספת "תשלום אחר" לחשבונית.


טבלת פרמטרים תשובה המתקבלת לאחר פנייה :

 
פרמטר תיאור ערכים אפשריים לדוגמה
ResponseCodeקוד תשובה ליצירת מסמך 0 - תקין
אחרת שגיאה
Descriptionתיאור קוד תשובה ליצירת המסמךתקין
InvoiceNumberמספר המסמך שנוצר9871
InvoiceTypeסוג המסמך

1 - חשבונית מס קבלה
2 -  חשבונית מס קבלה זיכוי
3 - קבלה מלכ"ר
4 - החזר כספים לקוחות (קבלה זיכוי מלכ"ר)

101 - אישור הזמנה - מאתר  ( מסמך פנימי לא להנח"ש)
102 - זיכוי הזמנה - מאתר  ( מסמך פנימי לא להנח"ש)

200 - תעודת משלוח (210 - תעודת החזר)
300 - חשבון עסקה
305 - חשבונית מס (330 - חשבונית מס זיכוי)
400 - קבלה לחשבונית מס (410 - החזר כספים לקוחות) 

הערות :

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


קבצים מצורפים
CreateRecipient.php.txt 2.4 Kb הורדת קובץ
הערות
  • אין הערות למאמר זה.
תמיכה 03-9436100
כל הזכויות שמורות לחברת קארדקום בע"מ