הורדת מסמכים חשבונאים כקובץ PDF/HTML בAPI
הורדת חשבונית כקובץ PDF:
בממשק זה ניתן להוריד חשבונית / מסמך כקובץ PDF.
Name To Value:
כתובת Name To Value היא - https://secure.cardcom.solutions/interface/GetDocumentPDF.aspx
הפרמטרים המתקבלים למערכת הסליקה הם לא Case sensitive. לדוגמה: הפרמטר terminalnumber זהה לפרמטר TerminalNumber.
טבלה להעברת בקשה:
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | UserName | APIUser | שם משתמש API |
| 2 | UserPassword | APIPass | סיסמה API |
| 3 | DocumentNumber | 1234 | מספר חשבונית / קבלה |
| 4 | DocumentType |
1 - חשבונית מס קבלה 100 - הזמנה - לא שולמה. 101 - אישור הזמנה - מאתר ( מסמך פנימי לא להנח"ש) - הזמנה ששולמה 200 - תעודת משלוח (210 - תעודת החזר) 405 - קבלה על תרומה ( 406 - החזר תרומה ללקוח ) |
סוג מסמך |
| 5 | IsOriginal | True | האם לשלוח מסמך מקור |
התשובה המתקבלת:
התשובה המתקבלת היא כ HTTP STATUS.
לדוגמה: STATS 403 שם משתמש וסיסמה שגוי.
Status 400 - מסמך לא נמצא.
Status 200 - יתקבל הקובץ להורדה.
דוגמה לקישור Name To Value:
_________________
הורדת חשבונית במבנה HTML
בממשק זה ניתן לקבל את החשבונית במבנה HTML - מתאים לאתרים המעוניינים למשוך את החשבונית ולהציג אותה ללקוח באתר שלהם.
מערכת הסליקה תומכת בשתי סוגי ממשקים, Name To Value ו Web Service. טבלת הפרמטרים זהה לשתי סוגי הממשקים.
Web Service:
כתובת ה-Web Service היא https://secure.cardcom.solutions/Interface/BillGoldService.asmx
הפונקציה שיש להשתמש לשם העברת לפרטי העסקה לחיוב בלבד היא :InvoiceSendInvoice.
ראה בהמשך טבלאות פרמטרים להעברה וקבלת תשובה.
Name To Value:
כתובת ה Name To Value היא - https://secure.cardcom.solutions/Interface/InvoiceGetHtml.aspx
הערות ל Name To Value:
1. התשובה המתקבלת היא החשבונית עצמה ב HTML ללא קוד תשובה! במידה וישנה שגיאה מוחזרת תשובה ResponseCode=1&Description=OK. על מנת לדעת אם הבקשה הצליחה / נכשלה יש לבדוק את אורך התשובה שהתקבלה , קצר מ 200 סימן שישנה בעיה.
2. הפרמטרים המתקבלים למערכת הסליקה הם לא Case Sensitive. לדוגמה: הפרמטר terminalnumber זהה לפרמטר TerminalNumber.
טבלה להעברת בקשה:
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | UserName | APIUser | שם משתמש API |
| 2 | UserPassword | abcdeefg | סיסמה API |
| 3 | InvoiceNumber | 1234 | מספר חשבונית / קבלה |
| 4 | InvoiceType | 1 | סוג מסמך |
| 5 | GetAsOriginal | true - תתקבל כמסמך מקור, אחרת לפי הרשום במערכת אישורית זהב | האם לקבל את החשבונית כמקור |
סוגי מסמכים:
1 - חשבונית מס קבלה
2 - חשבונית מס קבלה זיכוי
3 - קבלה מלכ"ר
4 - החזר כספים לקוחות (קבלה זיכוי מלכ"ר)
100 - הזמנה - לא שולמה.
101 - אישור הזמנה - מאתר (מסמך פנימי לא להנח"ש) - הזמנה ששולמה
102 - זיכוי הזמנה - מאתר (מסמך פנימי לא להנח"ש) - הזמנה ששולמה
200 - תעודת משלוח (210 - תעודת החזר)
300 - חשבון עסקה
305 - חשבונית מס (330 - חשבונית מס זיכוי)
400 - קבלה לחשבונית מס (410 - החזר כספים לקוחות)
405 - קבלה על תרומה (406 - החזר תרומה ללקוח)
התשובה המתקבלת:
1. התשובה המתקבלת בHTTP POST היא החשבונית עצמה ב HTML ללא קוד תשובה! במידה וישנה שגיאה מוחזרת תשובה ResponseCode=1&Description=OK. על מנת לדעת אם הבקשה הצליחה / נכשלה יש לבדוק את אורך התשובה שהתקבלה , קצר מ 200 סימן שישנה בעיה.
2. ב Web Service התשובה נמצאת בתוך הפרמטר HTMLInvoice
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 | ResponseCode | APIUser | שם משתמש API |
| 2 | Description | abcdeefg | ססמה API |
| 3 | HTMLInvoice | החשבונית במבנה HTML | רק ב WebService |
דוגמה לקישור https POST:
URL:
https://secure.cardcom.solutions/Interface/InvoiceGetHtml.aspx
PostData
UserName=APIUser&UserPassword=APIPassword&InvoiceNumber=1234&InvoiceType=1