פעולות : מפיצים (ספקים ) - פתיחה אוטומטית של חברה
פעולה זו מאפשרת למפיצים לפתוח חברה חדשה במערכת קארדקום בע"מ דרך ממשקים והתחלת עבודה מיידית .
יש להשתמש בקוד לדוגמה בכדי לראות אילו פרמטרים חובה בכל פעולה.
ממשק Name to Value
כתובת Name to Value היא https://secure.cardcom.solutions/Interface/CompanyOperations.aspx
אינטגרציה חדשה יש לעבוד עם ממשק Json
CompanyOperations -(חייב לעבור על זה) לאמת שדות בית עסק - (Validate company fields)
הערות ל Name to Value:
1. חובה לבצע פנייה רק ב POST.
2.חובה לבצע urlencode לכל הערכים המועברים למערכת.
3.יש להוסיף הפרמטר codepage=65001, פרמטר זה מציג את סוג הקידוד המועבר למערכת יוניקוד במקרה זה.
3. התשובה המתקבלת היא במבנה : ResponseCode=4&Description=NoPemition&LowProfileCode=601.
טבלת פרמטרים :
פרמטר באדום - חובה
מספר | פרמטר | ערכים אפשריים לדוגמה | הערות | סוג הבדיקה המתבצעת |
1 | IsValidationOnly | true | האם רק לבצע בדיקה לנתונים ללא פתיחה בפועל - יש להתחיל עם פיתוח שפרמטר זה הוא true | |
2 | TerminalInfo.TerminalNumber | מספר המסוף / טרמינל לעדכון מודולים | ||
3 | Operation | CREATE | CREATE - צור חברה חדשה AddTerminal - הוספת מסוף סליקה חדש לחברה קיימת GetTerminalModules - קבל רשימות מודלים על מסוף RegisterToCardComSlika - בצע הסבה של מסוף קיים לחברת קארדקום סליקה. | |
4 | UserName | שם משתמש של המפיץ | ||
5 | Password | סיסמת המפיץ | ||
6 | Secret | סוד המפיץ | ||
7 | RegisterAsDocumentSuppliers | false | קשר לקוח גם להפקת מסמכים -> במידה ואתה ספק מסמכים של קארדקום ניתן לבצע שיוך למסמכים. | |
8 | SupplierCompID | AA-BB-CC | אינפורמטיבי , קוד חברה כפי שקיים במערכת הפנימית שלך. לא חובה. | |
9 | PaymentInfo.PayingAuthorizationType | 2 | יש להעביר 1- במידה ובית העסק משלם עבור עצמו לקארדקום יש לפנות לתמיכה לקבלת קוד תשלום לקוח ייחודי לספק. | |
10 | SupportCallToNewCompany | true | האם קארדקום צריכה ליצור קשר טלפוני עם הלקוח - תיפתח קריאת שורות לדבר עם הלקוח לקבלת הדרכה | |
11 | CompanyInfo.Name | משה אינסטלציה בע"מ | שם חברה - שדה חובה | |
12 | CompanyInfo.BusinessRegistrationNumber | 040617 | מספר ח.פ. - שדה חובה | בדיקה של תקינות ת.ז. ח.פ. |
13 | CompanyInfo.Email | y@test.com | אימייל החברה - שדה חובה | בדיקה תקינות של EMAIL |
14 | CompanyInfo.PhoneLine | טלפון קווי - חובה במידה ואין טלפון נייד | 9 ספרות לפחות | |
15 | CompanyInfo.PhoneMobile | טלפון נייד - חובה במידה ואין טלפון קווי | 10 ספרות לפחות | |
16 | CompanyInfo.Activity | פעילות העסק ממל | ||
17 | CompanyInfo.Addres | כתובת | ||
18 | CompanyInfo.City | עיר | ||
19 | CompanyInfo.ContactMan | שם איש קשר | ||
20 | CompanyInfo.PhoneFax | פקס - פרמטר ישן לא בשימוש | ||
21 | CompanyInfo.ZipCode | מיקוד | ||
22 | CompanyInfo.IsVatFreeCompany | false | false- חייב במע"מ true - לא חייב במע"מ (מלכ"ר לדוגמה) | |
23 | CompanyInfo.IsActive | האם חברה יכולה לעבוד - משתמש בעדכון לסגור חברה. false - סוגר חברה true - מבצע פתיחה מחדש | ||
24 |
|
|
| |
24 | CompanyInfo.AgreementInfo.AgreementId | 2 | מספר הסכם סליקה - רק אם סוג המסוף הוא 6 - סליקה קארדקום ( ראה בהמשך פרמטר TerminalInfo.TerminalType ) | |
25 | UserInfo.Name | רוני | שם ש יוצר לחברה החדשה | שדה חובה ממל |
26 | UserInfo.IdentityNumber | 040 | ת.ז ש יוצר לחברה החדשה | בדיקת תקינות של הת.ז |
27 | UserInfo.LogInName | rony@gmail.com | שם משתמש כניסה למערכת קארדקום - נועד למשתמש אדמין . אין להעביר יוזר זה בממשק API , בממשק API יש להעביר APIUserName | אורך 7 עד 20 תווים בלבד |
28 | UserInfo.LogInPassword | AD!ds23 | סיסמה למערכת אישורית | אורך 7 ולהכיל אות אחת וסיפרה אחת |
29 | UserInfo.Addres | כתובת משתמש - אם לא מועבר המערכת לוקחת מפרטי החברה | ||
30 | UserInfo.City | עיר משתמש - אם לא מועבר המערכת לוקחת מפרטי החברה | ||
31 | UserInfo.Email | דואל משתמש - אם לא מועבר המערכת לוקחת מפרטי החברה | ||
32 | UserInfo.PhoneFax | פקס משתמש - אם לא מועבר נלקח מפרטי החברה | ||
33 | UserInfo.PhoneLine | טלפון קווי - אם לא מועבר נלקח מפרטי החברה | ||
34 | UserInfo.PhoneMobile | טלפון נייד - אם לא מועבר נלקח מפרטי החברה | ||
35 | UserInfo.ZipCode | מיקוד - אם לא מועבר נלקח מפרטי החברה | ||
36 | TerminalInfo.Description | שם המסוף - תיאור כללי | מסוף ראשי | |
37 | TerminalInfo.TerminalType | סוג המסוף : 6- קארדקום סליקה. | ||
39 | TerminalInfo.BankCode | מספר בנק להפקדת הכסף - סוג מסוף 4 יופיי או 6 קארדקום סליקה | מספרים בלבד | |
40 | TerminalInfo.BranchCode | מספר סניף להפקדת הכסף -- סוג מסוף 4 יופיי או 6 קארדקום סליקה | מספרים בלבד | |
41 | TerminalInfo.AccountNumber | מספר חשבון להפקדת הכסף - - סוג מסוף 4 יופיי או 6 קארדקום סליקה | מספרים בלבד | |
41.5 | TerminalInfo.UpayHaveExsistingAccount | האם ללקוח יש מסוף UPAY קיים. במידה וכן המערכת תתחבר לחשבון הקיים. אם אין יפתח חשבון חדש | false | |
42 | TerminalInfo.UpayLogInEmail | שם משתמש UPAY - חשבון חדש וקיים - כתובת EMAIL תקינה | כתובת EMAIL תקינה | |
43 | TerminalInfo.UpayLogInPassword | סיסמה UPAY - חשבון חדש וקיים | ||
44 | TerminalInfo.ModuleList1.ModuleID | רשימת מודלים לפתיחה. לדוגמה: TerminalInfo.ModuleList1=ABC&TerminalInfo.ModuleList=DEF |
פרמטרים שמוחזרים :
מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
1 | ResponseCode | 0 | קוד תשובה של פתיחה |
2 | Description | תיאור תשובה במידה ושגוי. | תקין |
3 | ShowErrorToEndUser | false | האם בעיה בקלט ל הנתונים שניתן להציג למשתמש את ההודעה |
4 | CompanyInternalID | e7574378-d3ef-444b-b525-96e8099a75ab | מספר חברה ב קארדקום מסוג GUID - יש לשמור מידע זה |
5 | TerminalNumber | 1000 | מספר מסוף חדש במערכת קארדקום |
6 | APIUserName | ADS234324ASDFAS | שם משתמש ממשקים למערכת קארדקום |
7 | APISecret | SDFDSf345345FGHh | סיסמה למערכת קארדקום |