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

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

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

הערות ל 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 -הדילר משלם עבור העסק. במידה ובית העסק משלם עבור עצמו יש לפנות לתמיכה לקבלת קוד תשלום לקוח יחודי לספק.
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	שם משתמש כניסה למערכת אישורית זהב	אורך 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	סיסמה למערכת אישורית זהב

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

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

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