פרמטר 

ערכים לדוגמה

תיאור

1

BillGoldCompID

27ac3bd7-aa5d-4596-a789-6f326d750eb4

מזהה ייחודי חברה של קארדקום (מס 3)

2

 DocType

1 - חשבונית מס קבלה
3- קבלה למכ"ר
101 - הזמנה מאתר

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

3

 DocNumber

1006

 מספר מסמך

5

ExternalCompID

DemoCompany

 מזהה חברה יחודי כפי שהוקלד (מס 4)

6

פרטמרים נוספים לפי סעיף 7

data=1&otherInfo=2

7

ResponseCode

0

הפעולה בוצעה בהצלחה

8

InvoiceDefHe_InvoiceComments

תודה שרכשת נשמח לשמוע

הערות למסמך שהוגדרו ברמת הממשק

9

InvoiceDefHe_Name

אבי מזגנים בע"מ

שם החברה במערכת קארדקום

10

InvoiceDefHe_Line1

חולון

כתובת שורה 1 המוגדרת במערכת

11

InvoiceDefHe_Line2

הבקעה

כתובת שורה 2 המוגדרת במערכת

12

InvoiceDefHe_Line3

23

כתובת שורה 3 המוגדרת במערכת

13

InvoiceDefEn_InvoiceComments

thank you for you purcase

הערות באנגלית שהוגדרו ברמת הממשק

14

InvoiceDefEn_Name

avi Father of air conditioners LTD

שם החברה באנגלית בקארדקום

15

InvoiceDefEn_Line1

Holon

כתובת אנגלית שורה 1 המוגדרת במערכת

16

InvoiceDefEn_Line2

Ha-Bika

כתובת אנגלית שורה 2 המוגדרת במערכת

17

InvoiceDefEn_Line3

23

כתובת אנגלית שורה 3 המוגדרת במערכת

18

CashNIS

150

אמצעי תשלום מזומן שתועד במסמך

19

ExtReadInvoiceHead_CustName

Jhonas

שם הלקוח למסמך

20

ExtReadInvoiceHead_CustAddresLine1

סחרוב 22

כתובת הלקוח למסמך

21

ExtReadInvoiceHead_CustAddresLine2

בניין 2

כתובת שורה 2 למסמך

22

ExtReadInvoiceHead_CustCity

Vegas

עיר הלקוח למסמך

23

ExtReadInvoiceHead_CustLinePH

03-4572354

טלפון קווי של הלקוח למסמך

24

ExtReadInvoiceHead_CustMobilePH

054-7654221

טלפון נייד של הלקוח למסמך

25

ExtReadInvoiceHead_CompID

435128744

ת.ז או ח.פ של הלקוח למסמך

26

ExtReadInvoiceHead_Languge

עברית

שפת המסמך

27

ExtReadInvoiceHead_Comments

thank you for your purchase

הערות למסמך שהוספו ברמת הקוד

28

ExtReadInvoiceHead_CoinID

1 - שקל

2 - דולר

סוג המטבע שנבחר

ניתן לראות רשימה מלאה ב - רשימת קודי מטבע

29

ExtReadInvoiceHead_Email

test@gmail.com

מייל הלקוח

30

ExtReadInvoiceHead_SendByEmail

True / False

האם לשלוח מסמך ללקוח או לא

31

ExtReadInvoiceHead_CustomerNumber

8539

מס' הלקוח שנוצר בקארדקום

32

ExtReadInvoiceHead_Discount

0.0

סכום ההנחה שהוגדר

33

ExtReadInvoiceHead_InvoiceDate

23.1.2023

תאריך הפקת המסמך (מתעד גם כאשר מגדירים הפקה של מסמך בתאריך שונה מיום העסקה)

34

ExtReadInvoiceHead_InvoiceType

1 -מס קבלה

וכו'

סוג המסמך שהוגדר להפקה

ניתן לראות רשימה מלאה ב - 

35

ExtReadInvoiceHead_InvoiceNumber

511284

מס' החשבונית שהופקה

36

ExtReadInvoiceHead_TerminalNumber

1000

מס' הטרמינל שביצע את הפעולה

37

ExtReadInvoiceHead_TotalIncludeVAT

150

סכום מלא כולל מע"מ

38

ExtReadInvoiceHead_TotalNoVat

128.21

סכום מלא לא כולל מע"מ

39

ExtReadInvoiceHead_TotalVatFree

0.0

סכום שאינו חייב במע"מ

40

ExtReadInvoiceHead_VAT

0.17

אחוז המע"מ שנגבה

41

ExtReadInvoiceHead_VATOnly

21.79

סכום המע"מ שנגבה

42

ExtReadInvoiceHead_IsOpen

True / False

האם המסמך פתוח או סגור

43

ExtReadInvoiceHead_DepartmentID

36

מס' המחלקה שתחתיה הופק המסמך

ניתן לראות מספרי מחלקות ב - 

בעת הפקת מסמך במטבע שאינו שקלים

44

ExtReadInvoiceHead_TotalIncludeVATNIS

150

סכום מלא כולל מע"מ בשקלים (NIS)

45

ExtReadInvoiceHead_TotalNoVatNIS

128.21

סכום מלא ללא מע"מ בשקלים (NIS)

46

ExtReadInvoiceHead_TotalVatFreeNIS

0.0

סכום שאינו חייב במע"מ בשקלים (NIS)

47

ExtReadInvoiceHead_VATOnlyNIS

21.79

סכום המע"מ שנגבה בשקלים (NIS)

פרמטרים ברמת שורת המסמך

48

TotalExtReadInvoiceLines

1

מס' השורות במסמך

49

ExtReadInvoiceLines_CostNoVat

128.21

סכום מלא ללא מע"מ ברמת שורת המוצר

50

ExtReadInvoiceLines_Description

test product

שם המוצר בשורה

51

ExtReadInvoiceLines_InvoiceNumber

511284

מס' המסמך שהופק

52

ExtReadInvoiceLines_ProductID

GLSY

מס' מק"ט מוצר

53

ExtReadInvoiceLines_Quantity

1

כמות המוצר

54

ExtReadInvoiceLines_TotalLineCostIncludeVAT

150

סכום כולל מע"מ

56

ExtReadInvoiceLines_TotalLineCostNoVat

128.21

סכום ללא מע"מ

57

ExtReadInvoiceLines_TotalLineCostVATOnly

21.79

מע"מ שנגבה

58

ExtReadInvoiceHead_VAT

0.17

אחוז מע"מ שנגבה

59

ExtReadInvoiceHead.ExternalId

Order 1234

מזה עסקה חיצוני

60

ExtReadInvoiceHead_RoundUp

0.01

הנחת עיגול לשלמים

פרמטר

ערכים אפשריים לדו'

תיאור

1

ExtShvaParams.Status1

בהתאם לטבלת הודעות קודים 0-300  .
זהירות- ישנם קודים ששונים מ -0 אבל עדיין אומרים עסקה תקינה !

קוד תשובה של הפנייה לחברות האשראי

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

שם לב!
כאשר ExtShvaParams.CreditType63=6  עסקה של 6 תשלומים יופיע 6.

שם לב !
כאשר ExtShvaParams.CreditType63=6
שדה זה מייצג את סה"כ מספר התשלומים !

12

ExtShvaParams.CardTypeCode60

קודים של חברה סולקת בהתאם למאמר :תיאור קודים חברות האשראי

קוד חברת האשראי המנפיקה

13

ExtShvaParams.Mutag24

0 - כרטיס פרטי של חברה מנפיקה(PL)
1 - מסטרכרד
2 - ויזה
3 - מאסטרו
5 - ישראכראט

קוד מותג הכרטיס

14

ExtShvaParams.CardOwnerName 

Yaniv 

שם בעל הכרטיס כפי שהוקלד ע"י המשלם

15

 ExtShvaParams.CardToken

AA-BB-CC

אסימון הכרטיס במידה ונוצר מסוג GUID

16

 ExtShvaParams.CardHolderIdentityNumber

040000000 

 ת.ז. בעל הכטיס

17

 ExtShvaParams.CreditType63

1- רגיל
2 - ישראקרדיט, עדיף 30+
3 - חיוב מידי
4 - אשראי מועדון
5 - סופר קרדיט
6 - קרדיט בתשלומים
8 - תשלומים
9 - מועדון בתשלומים.

סוג חיוב האשראי

18

 ExtShvaParams.AbroadCard119

0 - כרטיס ישראלי
1 - כרטיס תייר
2 - כרטיס דלק
3 - כרטיס חיוב מיידי
4 - כרטיס מתנה / נטען ( פרט לכרטיס שמופק ע"י חברת ויזה כא"ל בשלב זה)

סוג כרטיס חיוב

19

ExtShvaParams.DealType61 

00 - כרטיס חסום
01 - עסקת חובה רגילה
02 - עסקת חובה מאושרת
03 - עסקה מאולצת.
51 - עסקת זכות.
52 - עסקת ביטול.
53 - עסקת זכות מאושרת. 

סוג עסקה

20

ExtShvaParams.ChargType66 

 00 - עסקה רגילה
01 - שירות עצמי
02 - שירות עצמי בתחנות דלק
05 - contactless
06 - contactless self service
50 - עסקה טלפונית
51 - עסקת חתימה בלבד.

קוד עסקה 

21

 ExtShvaParams.BinId

1-  כרטיס אשראי שופרסל  (4580XX44)
2 - כרטיס חבר   185000000 - 195000000

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

22

 ExtShvaParams.InternalDealNumber

123456   

 מספר עסקה פנימי של קארדקום (Int64)

23

 ExtShvaParams.CouponNumber

 120112011

 מספר שובר - מחרוזת 

24

ExtShvaParams.DealDate

תאריך ביצוע העיסקה

25

ExtShvaParams.CardOwnerPhone

טלפון בעל הכרטיס

26

BillLocation

Direct = 1 [ממשק ישיר]
Open = 2 [ דף אישורית זהב]

LowProfile = 7 [פרופיל נמוך]
Suspended= 9 [עסקה מושהית]
RecuringBilling = 10 [הוראת קבע]

מקום ביצוע העסקה בעסקת אשראי

27

InvoiceCreatorUserID

83

מספר היוזר/משתמש שהפיק את המסמך
ניתן לבדוק את היוזר במערכת תחת :
הגדרות 1 - 2 הרשאות משתמשים בטבלה תחת - מספר משתמש.

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

 

פרמטר

ערכים אפשריים לדוגמה

תיאור

1

CashNIS

100.2

סה"כ מזומן בשקל

פרמטר

ערכים אפשריים לדוגמה

תיאור

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

סכום המחאה

פרמטר

ערכים אפשריים לדו'

תיאור

1

CustomPay.TransactionID

32

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

2

CustomPay.TranDate

31/12/2012

תאריך  אסמכתה

3

CustomPay.Description

קבלת תשלום מPayPal

תיאור פעולה 

4

CustomPay.Asmacta

123456-ZZC

מספר אסמכתה פעולה 

5

CustomPay.Sum

150.00

סכום