פעולות : מפיצים (ספקים ) - פתיחה אוטומטית של חברה – מרכז התמיכה קארדקום

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

ממשק Name to Value
כתובת Name to Value היא https://secure.cardcom.solutions/Interface/CompanyOperations.aspx

אינטגרציה חדשה יש לעבוד עם ממשק Json
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 - צור חברה חדשה SETMODULES - קבע מודלים למסוף CLOSE - סגור חברה REOPEN - פתח חברה מחדש ChangeUpayAccount - שנה מסוף UPAY CreateUpayAccount צור משתמש UAPY AddTerminal - הוספת מסוף סליקה חדש לחברה קיימת GetTerminalModules - קבל רשימות מודלים על מסוף RegisterToCardComSlika - בצע הסבה של מסוף קיים לחברת קארדקום סליקה. ראה קוד לדוגמא לכל פעולה
4	UserName		שם משתמש של המפיץ
5	Password		סיסמת המפיץ
6	Secret		סוד המפיץ
7	RegisterAsDocumentSuppliers	false	קשר לקוח גם להפקת מסמכים -> במידה ואתה ספק מסמכים של קארדקום ניתן לבצע שיוך למסמכים.
8	SupplierCompID	AA-BB-CC	אינפורמטיבי , קוד חברה כפי שקיים במערכת הפנימית שלך. לא חובה.
9	PaymentInfo.PayingAuthorizationType	2	יש להעביר 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		סוג המסוף : 1 - מסוף ש.ב.א מול חברות האשראי . 4 - מסוף מאגד UPAY 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	קוד תשובה של פתיחה 0 - תקין
2	Description	תיאור תשובה במידה ושגוי.	תקין
3	ShowErrorToEndUser	false	האם בעיה בקלט ל הנתונים שניתן להציג למשתמש את ההודעה
4	CompanyInternalID	e7574378-d3ef-444b-b525-96e8099a75ab	מספר חברה ב קארדקום מסוג GUID - יש לשמור מידע זה
5	TerminalNumber	1000	מספר מסוף חדש במערכת קארדקום
6	APIUserName	ADS234324ASDFAS	שם משתמש ממשקים למערכת קארדקום
7	APISecret	SDFDSf345345FGHh	סיסמה למערכת קארדקום

קבצים מצורפים ↓

מאמרים בקטגוריית המשנה הזאת

מאמרים קשורים