טבלת פרמטרים : מבנה מסמכים במשיכה
טבלת פרמטרים : מבנה מסמכים במשיכה
הפרמטרים הם אופציונליים ומופיעים רק אם יש נתון.
מספר | פרמטר | ערכים אפשריים לדו' | תיאור |
1 | ResponseCode | 0 - תקין | קוד תשובה לבקשה |
2 | Description |
| תיאור קוד תשובה |
3 | CashNIS | 100.50 | סה"כ מזומן שקל |
4 | TotalExtReadInvoiceLines |
| מספר השורות במסמך |
5 | TotalExtShvaParams |
| מספר השורות במסמך |
6 | TotalCheque |
| מספר הצקים במסמך |
7 | TotalCustomPay |
| מספר אמצעי תשלום אחר במסמך |
כותרת מסמך
מספר | פרמטר | ערכים אפשריים לדו' | תיאור |
1 | ExtReadInvoiceHead.CustName | 0 - תקין | מסמך לכבוד |
2 | ExtReadInvoiceHead.CustAddresLine1 |
| כתובת שורה 1 |
3 | ExtReadInvoiceHead.CustAddresLine2 |
| כתובת שורה 2 |
4 | ExtReadInvoiceHead.CustCity |
| מקום |
5 | ExtReadInvoiceHead.CustLinePH |
| טלפון קווי |
6 | ExtReadInvoiceHead.CustMobilePH |
| טלפון נייד |
7 | ExtReadInvoiceHead.CompID |
| ת.ז. ח.פ חברה |
8 | ExtReadInvoiceHead.Languge | he - עברית. | שפת המסמך |
9 | ExtReadInvoiceHead.Comments |
| הערות לקוח |
10 | ExtReadInvoiceHead.CoinID | 1 - שקל | מטבע מסמך |
11 | ExtReadInvoiceHead.Email |
| אימייל לקוח |
12 | ExtReadInvoiceHead.SendByEmail |
| מסמך נשלך ללקוח ב אימייל ? |
13 | ExtReadInvoiceHead.CustomerNumber ExtReadInvoiceHead.AccountId |
| מספר לקוח |
14 | ExtReadInvoiceHead.Discount |
| סכום הנחה |
15 | ExtReadInvoiceHead.InternalComments |
| הערות פנימיות מערכת |
16 | ExtReadInvoiceHead.InvoiceDate |
| תאריך מסמך |
17 | ExtReadInvoiceHead.InvoiceType |
| סוג מסמך |
18 | ExtReadInvoiceHead.InvoiceNumber |
| מספר מסמך |
19 | ExtReadInvoiceHead.TerminalNumber |
| מספר מסוף מפיק |
20 | ExtReadInvoiceHead.TotalIncludeVAT |
| סה"כ כולל מע"מ לפי מטבע מסמך |
21 | ExtReadInvoiceHead.TotalNoVat |
| סה"כ חייב במע"מ לפי מטבע מסמך |
22 | ExtReadInvoiceHead.TotalVatFree |
| סה"כ לא חייב במע"מ לפי מטבע מסמך |
23 | ExtReadInvoiceHead.VAT |
| אחוז המע"מ במסמך |
24 | ExtReadInvoiceHead.VATOnly |
| סכום המע"מ הנגבה לפי מטבע מסמך |
25 | ExtReadInvoiceHead.TotalIncludeVATNIS |
| סה"כ כולל מע"מ בשקל |
26 | ExtReadInvoiceHead.TotalNoVatNIS |
| סה"כ חייב במע"מ בשקל |
27 | ExtReadInvoiceHead.TotalVatFreeNIS |
| סה"כ לא חייב במע"מ בשקל |
28 | ExtReadInvoiceHead.VATOnlyNIS |
| סכום המע"מ הנגבה בשקל |
29 | ExtReadInvoiceHead.ISORate |
| שער מטבע מסמך לשקל. |
30 | ExtReadInvoiceHead.ZReport |
| מספר דוח Z של מסמך זה |
31 | ExtReadInvoiceLines.TotalLineCostVATOnly |
| האם מסמך במצב פתוח. |
שורות מסמך
| פרמטר | ערכים אפשריים לדו' | תיאור |
1 | ExtReadInvoiceLines.CostNoVat | 500.50 | עלות שורה ללא מע"מ |
2 | ExtReadInvoiceLines.Description | פריט לדוגמה | תיאור פריט |
3 | ExtReadInvoiceLines.Discount | 123.12 | סכום הנחה |
4 | ExtReadInvoiceLines.InvoiceType |
| סוג מסמך |
5 | ExtReadInvoiceLines.InvoiceLineNum |
| מספר שורה מסמך |
6 | ExtReadInvoiceLines.InvoiceNumber |
| מספר מסמך |
7 | ExtReadInvoiceLines.IsVatFree |
| האם שורה פטורה ממע"מ. |
8 | ExtReadInvoiceLines.ProductID |
| קוד פריט - מחרוזת |
9 | ExtReadInvoiceLines.Quantity |
| כמות |
10 | ExtReadInvoiceLines.TotalLineCostIncludeVAT |
| סה"כ שורה כולל מע"מ |
11 | ExtReadInvoiceLines.TotalLineCostNoVat |
| סה"כ שורה ללא מע"מ |
12 | ExtReadInvoiceLines.TotalLineCostVATOnly |
| מע"מ נגבה בלבד |
אמצעי תשלום :
כרטיס אשראי:
טבלת פרמטרים : נתונים המתקבלים מחברות האשראי:
בנוסף לנתונים הפנימיים של מערכת הסליקה אישורית זהב, בעת ביצוע חיוב אשראי ישנם נתונים נוספים אשר מתקבלים ישירות מחבורת האשראי.
הערות:
הפרמטרים מועברים רק אם קיימים במערכת ובוצעה פנייה לחברות האשראי
הפרמטרים הם דינמיים, יתכן ויתווספו שדות נוספים בעתיד
| פרמטר | ערכים אפשריים לדו' | תיאור |
1 | ExtShvaParams.Status1 | בהתאם לטבלת הודעות קודים 0-300 . | קוד תשובה של הפנייה לחברות האשראי |
2 | ExtShvaParams.Sulac25 | קודים של חברה סולקת בהתאם למאמר :תיאור קודים חברות האשראי | חברה סולקת של הכרטיס |
3 | ExtShvaParams.CardNumber5 | 4580 | ארבע ספרות אחרונות של כרטיס אשראי של הלקוח |
4 | ExtShvaParams.JParameter29 | 0 - ברירת מחדל לפי הגדרות חברות האשראי. 2 - בדיקה בלבד של ספרת ביקורת 5 - קבלת אישור מול חברות האשראי | J- פרמטר , סוג בדיקה שבוקשה לביצוע על הכרטיס |
5 | ExtShvaParams.Tokef30 | 1229 | תוקף הכרטיס |
6 | ExtShvaParams.Sum36 | 150 | סכום שלקוח שילם באגורות - באותו מטבע - לא חייב להיות ש"ח. |
7 | ExtShvaParams.SumStars52 | 100 | סכום ששולם בכוכבים |
8 | ExtShvaParams.ApprovalNumber71 | 0 - ללא אישור , קבלת מספר האישור מחברת ש.ב.א ולא מחברות האשראי מכיוון שסכום העסקה מתחת לתקרה. | מספר אישור על ביצוע עסקה |
9 | ExtShvaParams.FirstPaymentSum78 | 50.00 | סכום תשלום הראשון |
10 | ExtShvaParams.ConstPayment86 | 20.00 | סכום מספר התשלומים הנוספים |
11 | ExtShvaParams.NumberOfPayments94 | שם לב! | שם לב ! |
12 | ExtShvaParams.CardTypeCode60 | קודים של חברה סולקת בהתאם למאמר :תיאור קודים חברות האשראי | קוד חברת האשראי המנפיקה |
13 | ExtShvaParams.Mutag24 | 0 - כרטיס פרטי של חברה מנפיקה(PL) | קוד מותג הכרטיס |
14 | ExtShvaParams.CardOwnerName | Yaniv | שם בעל הכרטיס כפי שהוקלד ע"י המשלם |
15 | ExtShvaParams.CardToken | AA-BB-CC | אסימון הכרטיס במידה ונוצר מסוג GUID |
16 | ExtShvaParams.CardHolderIdentityNumber | 040000000 | ת.ז. בעל הכטיס |
17 | ExtShvaParams.CreditType63 | 1- רגיל | סוג חיוב האשראי |
18 | ExtShvaParams.AbroadCard119 | 0 - כרטיס ישראלי | סוג כרטיס חיוב |
19 | ExtShvaParams.DealType61 | 00 - כרטיס חסום | סוג עסקה |
20 | ExtShvaParams.ChargType66 | 00 - עסקה רגילה | קוד עסקה |
21 | ExtShvaParams.BinId | 1- כרטיס אשראי שופרסל (4580XX44) | מזה סוג הכרטיס. |
22 | ExtShvaParams.InternalDealNumber | 123456 | מספר עסקה פנימי של קארדקום (Int64) |
23 | ExtShvaParams.CouponNumber | 120112011 | מספר שובר - מחרוזת |
24 | ExtShvaParams.DealDate |
| תאריך ביצוע העיסקה |
25 | ExtShvaParams.CardOwnerPhone |
| טלפון בעל הכרטיס |
מזומן :
| פרמטר | ערכים אפשריים לדוגמה | תיאור |
1 | CashNIS | 100.2 | סה"כ מזומן בשקל |
המחאות :
טבלת פרמטרים : המחאות לחשבוניות קבלה
הערות:
שם המחלקה ב Web Server היא RciExtCheque ולא Cheque!
ניתן להעביר מספר המחאות ראה דוגמה לסוף הדף
| פרמטר | ערכים אפשריים לדוגמה | תיאור |
1 | Cheque.ChequeNumber | 1234 | מספר המחאה |
2 | Cheque.BankNumber | 12 | מספר בנק |
3 | Cheque.SnifNumber | 1 | מספר סניף בנק |
4 | Cheque.AccountNumber | 123456 | מספר חשבון |
5 | Cheque.DateCheque | dd/MM/yyyy | תאריך פירעון המחאה |
6 | Cheque.Sum | 100.50 | סכום המחאה |
העברה של מספר המחאות :
על מנת להעביר "מערך" של המחאות יש למספר את האמחאות לדוגמה :
המחאה ראשונה :
Cheque.ChequeNumber=1234&Cheque.DateCheque=1/10/2011&Cheque.Sum=150.00
המחאה שנייה :
Cheque1.ChequeNumber=1234&Cheque1.DateCheque=2/10/2011&Cheque1.Sum=150.00
המחאה שלישית:
Cheque2.ChequeNumber=1234&Cheque2.DateCheque=3/10/2011&Cheque2.Sum=150.00
אחר:
טבלת פרמטרים : הוספת "תשלום אחר" לחשבונית.
ניתן להוסיף אמצעי "תשלום אחר" על חשבונית. השימוש של "תשלום אחר" הוא במידה ומתקבל כסף ממקור אחר שהוא לא כרטיס אשראי, מזומן או צ'קים כגון העברה בנקאית או קבלת תשלום פי-פאל. יש להגדיר את החשבון במערכת הניהול לפני העברת התשלום האחר בממשק ראה : הגדרות חשבוניות : חשבונות שונים
הערות:
שם המחלקה ב Web Server היא RciExtCustome ולא CustomPay.
עבודה ב Name to Value POST להשתמש כרגיל CustomPay.TransactionID לפי הטבלה .
ניתן להעביר מספר תשלומים ראה דוגמה לסוף הדף.
| פרמטר | ערכים אפשריים לדו' | תיאור |
1 | CustomPay.TransactionID | 32 | מספר חשבון המוגדר מראש במערכת הסליקה אישורית זהב. |
2 | CustomPay.TranDate | 31/12/2012 | תאריך אסמכתה |
3 | CustomPay.Description | קבלת תשלום מPayPal | תיאור פעולה |
4 | CustomPay.Asmacta | 123456-ZZC | מספר אסמכתה פעולה |
5 | CustomPay.Sum | 150.00 | סכום |
העברה של מספר "תשלום אחר":
על מנת להעביר "מערך" של תשלום אחר יש למספר את התשלומים לדוגמה:
תשלום אחר אחד:
CustomPay.TransactionID=31&CustomPay.TranDate=31/12/2011&CustomPay.Asmacta=ZZ123&CustomPay.Sum=150
תשלום אחר שתיים :
CustomPay1.TransactionID=31&CustomPay1.TranDate=31/11/2011&CustomPay1.Asmacta=ZZ123&CustomPay1.Sum=150
תשלום אחר שלוש:
CustomPay2.TransactionID=31&CustomPay2.TranDate=31/10/2011&CustomPay2.Asmacta=ZZ123&CustomPay2.Sum=150