18 במאי 2020, 18:22

ב"ה

מערכת מכירת כסאות לבתי כנסת , אירועים וכד'

type=sale_seats

מכיוון שהושקעו במודול זה טרחה רבה, ועדיין לא כוסו הוצאות ההקמה, ומכיוון שאנו סומכים על משתמשי הפורום שיתנהגו בהגינות וביושר לכן העלינו לכאן את כל הפרטים וכל לקוח המעוניין להשתמש במודול זה ישלם 500 ש"ח+מע"מ למערכת חד פעמי ובנוסף 100 ש"ח+מע"מ למכירה נוספת באותה מערכת.

מי שמעוניין להתשמש במודל ללא תשלום - עליו להגיש בקשה בכתב לימות המשיח, עם הסבר מדוע מתבקש השימוש ללא תשלום - והנהלת ימות המשיח תשקול את הנושא.

חשוב להדגיש - אין שום בעיה לבדוק את המודול ואת ההגדרות לצורך התנסות ובדיקה ללא תשלום, התשלום הוא רק כאשר הפונקציה יוצאת לשימוש המאזינים

באחריות המשתמשים לפנות לשרות הלקוחות ולשלם.


קישורים לתוספים שניתנים להגדרה בכל מודול

רשימת כל ההגדרות שניתנות להטמעה בכל מודול
הגדרות זיהוי בכניסה לשלוחה
במודול זה הכניסה היא ברירת מחדל לפי טלפון
הסבר על הודעת ברוכים הבאים (הודעה ראשונה בשלוחה)
הרשאות כניסה לשלוחה

המכירה היא בעצם אחד לכל מערכת
כאשר ניתן לגשת למכירה משלוחות שונות לצורך שפות שונות לדוגמא אבל המקומות בכל המערכת הם אותם מקומות שנמכרים

התיקיה של המכירה היא תיקיית SaleSeats שתחת התיקיה הראשית

בתיקיה זו יש להכניס קובץ בשם:

sale_seats.ini

ובו כל הכסאות למכירה
המכירה כוללת בחירת שורה (אפשר להשתמש בזה לצורך הענין לבחירת אזור)
ולאחר מכן בחירת מושב
בנוסף יש הגדרה כמה המחיר לכל כסא וכן האם מי שבוחר כסא אקראי האם לתת את המושב הזה
(יש כסאות שמי שבוחר דווקא אותם תתן לו אבל מי שלא אכפת לו איפה לא תתן לו אותם, ולכן הערך מגדיר האם לאפשר את הכסא בצורה רנדומלית.

הסדר בקובץ הוא:
מספר שורה-מספר כיסא-מחיר-האם לתת באקראי או לא = תפוס/פנוי/בהזמנה

01-12-800-random=available

הסבר:
שורה 01
כסא 12
מחיר 800
לתת למי שרוצה את הכסא בצורה אקראית random
בשביל לא לאפשר את הכסא בבחירה אקראית יש לכתוב במקום random את המילה select
= תוצאה הכסא פנוי available

כאשר כסא באמצע הזמנה
התוצאה במקום available תהיה
middle_sale
בתוספת צורת ההתחברות
לדוגמא

middle_sale-id-phone-0501234567

הפרוש שמשתמש 0501234567
עכשיו באמצע הזמנה של הכסא והכסא תפוס עד שהמשתמש יבטל או ינתק - שאז הכסא מיידית יחזור למצב של available או שיקנה את הכסא ואז הכסא יעבור למצב קבוע של
Sold
בתוספת צורת ההתחברות
לדוגמא

Sold-id-teudat_zehut-123456789

הכסא נקנה על ידי משתמש תעודת זהות שמספרו 123456789

בנוסף על כל תפיסת כסא / ביטול / קניה
הפעולה נרשמת בתיקית SaleSeats בקובץ sale_seats_log.ymgr
ביחד עם שם הלקוח בנוסף לכל הפרטים

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


הגדרת כיסאות שמורים מראש

ניתן להגדיר מקומות קבועים שמורים מראש למשתמש מסויים (לפי ID).
הכיסאות השמורים יהיו זמינים לרכישה אך ורק למשתמש אליו הוקצה הכיסא בלבד.
כדי שהשמירה תחול, יש לכתוב בקובץ sale_seats.ini בשורת הכסא 'שמור' במקום 'פנוי':

01-12-800-random=reserved_sale-id-phone-0773137770

בדוגמה, כיסא 12 הנמצא בשורה 1 שמחירו 800 ש"ח שמור ל ID מסוג 'phone' שמספרו 0773137770
כמובן שצריך לעשות לשלוחה כניסה לפי ID המובא כאן


כברירת מחדל משתמש שיש לו כסאות שמורים, לא יכול לרכוש כיסאות אחרים שלא שמורים לו.
כדי שיתאפשר למשתמש לרכוש כיסא מכלל המקומות שיש בנוסף לכיסאות השמורים לו, יש להגדיר:

sale_seats_purchase_of_unreserved_seats=yes

שמירת כיסא עם פג תוקף

כדי להחיל הגבלה שהכיסא ישמר עד זמן מסויים ולאחר מכן יהיה פנוי לכולם, אפשר להשתמש בהגדרת פג תוקף בקבצי ini

01-12-800-random(2023-08-30-23-59-59|available)=reserved_sale-id-phone-0773137770

בדוגמה, הכיסא יהיה שמור למתקשר מטלפון 0773137770 עד תאריך 30/08/2023 בשעה 23:59:59
לאחר תוקף זה, הכיסא יהיה זמין לכולם.

כברירת מחדל המערכת אומרת מתי פג תוקף השמירה לכיסא.
כדי שלא יגיד תאריך תפוגה, יש להגדיר:

sale_seats_reserved_say_expiration_date=no

הודעות מערכת קשורות

M4154 יש כיסאות שמורים על שמך
M4155 לשמיעת הכיסאות השמורים ומעבר לרכישה הקישו 1
M4156 לרכישת כיסאות אחרים הקישו 2
M4157 אנא בחרו את הכסא לרכישה
M4158 לרכישת כסא מספר..
M4159 הנמצא בשורה..
M4160 במחיר של...
M4161 הקישו..
M4162 שימו לב, הכסא שמור עד
M4163 לסיום ומעבר לתשלום הקישו 1 לבחירת מקום נוסף הקישו 2
M4164 אין מקום נוסף שמור על שמך
M4828 עד
M4829 היום
M4830 בעוד
M4831 שעות
M4832 מחר
M4833 תאריך
M4834 בשעה
M4835 ו
M4836 דקות


הגבלת קנית כסאות

ברירת מחדל שכל אחד יכול לקנות כמה כסאות שהוא רוצה
אם רוצים ניתן לעשות הגבלה

sale_seats_max_sold=yes

במצב כזה כל אחד יוכל לקנות 2 מקומות
אם רוצים לשנות את ערך ברירת המחדל לכולם ניתן להגדיר

sale_seats_max_sold_amount=8

ואז כולם יכולים להזמין 8 מקומות
באם יש אנשים פרטים שבשבילהם רוצים לתת יותר או פחות כסאות להזמנה ניתן להכניס אותם ברשימה בתיקית SaleSeats בקובץ
sale_seats_max_sold.ini
בתוך הקובץ יש להכניס מספר זיהוי = כמות מקומות
לדוגמא

0771234567=10

כאן רואים שזיהוי הנ"ל יכול להזמין 10 מקומות

מספר הספרות בבחירת שורה וכסא

ברירת מחדל שורה 2 ספרות
וכסא 2 שורות
ואז יש להכניס בקובץ

01-08-800-random=available

כלומר שורה 1 כסא 8 אבל להכניס לקובץ עם 2 ספרות ולכן כתוב 01-08
ללקוחות בטלפון ניתן לומר להקיש אחת וסולמית במקום להקיש אפס אחת - והמערכת לבד תוסיף את ה0

אם מגדירים ספרה אחת לדוגמא בשורה ו4 ספרות בכסא אז זה יראה ככה

1-4567-800-random=available

הגדרות בשלוחה
ברירת מחדל ההודעות על תשלום הם בשקלים
במידה והגדרתם במנוע הסליקה חיוב בדולרים credit_card_currency=2
אז גם ההודעה במודול זה במקום שקלים (M1521) תהיה דולרים (M1829)

השינוי עבור כמות הספרות בשורה

sale_seats_digits_line=5

בדוגמא השורה היא של 5 ספרות

השינוי עבור כמות הספרות בכסא

sale_seats_digits_seat=3

בדוגמא הכסא הוא של 3 ספרות

לאחר בחירת שורה המערכת משמיע בצורה אוטומטית את כל הכסאות הפנויים בשורה
ניתן גם לבחור שיתן כסא אקראי מאותה השורה

לאחר בחירת מקום
אם עדין לא הגיע למקסימום כסאות שהוא יכול להזמין
המערכת תציע לו כסא נוסף סמוך, או כסא מהשורה או בחירת כסא נוסף משורה אחרת
וכמובן אפשרות לסיום הזמנה

בסיום הזמנה המערכת תשמיע את כל המקומות שהלקוח בחר - המחיר של כל אחד והמחיר הכולל
הלקוח יכול לאשר או לבטל את ההזמנה

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

sale_seats_payment_record=yes

ההודעות הקשורות הם
M1549 אנא הקליטו את השם שעבורו אתם רוכשים את המקומות וכן את הכתובת למשלוח דואר שלו, בסיום ההקלטה הקישו סולמית
M1553 "
לאישור ההקלטה הקישו 1
לשמיעה הקישו 2
להקלטה מחדש 3"
M1554 הפרטים נקלטו בהצלחה
M1305 ההודעה קצרה מידי

ניתן להגדיר שמיד בסיום הקלטה יועבר להמשך ללא השמעת ההודעה - כלומר ללא צורך לאשר אלר מיד ישמע "הפרטים הוקלטו בהצלחה" ויועבר לאמצעי תשלום

sale_seats_record_ok=#

לגבי התשלום בפועל כרגע יש 3 אפשרויות - 3 שלוחות- ואם יש צורך נפתח ונתאים את צורות התשלום לכל המעוניין
כרגע שלוחה 1 מחוברת לנדרים פלוס וכן לקארדקום, במידת הצורך נחבר את סליקה גם דרך פלאקארד ועוד.

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

nedarim_plus_terminal_number=1122334

במידה והסליקה בוצעה עם סטטוס של OK
אז בנוסף לדוח של נדרים פלוס ממנו ישירות ובנוסף לדוחות והאיימיל שלנו על הסליקה דרך נדרים פלוס
תוכלו לראות בקובץ לוג של sale_seats_log.ymgr
ערך
PaymentType
עם תוצאה של
NedarimPlus

לסליקה דרך "קארדקום"
יש צורך להגדיר

sale_seats_payment_credit_type=cardcom

וכן להגדיר את מספר המסוף ושם משתמש וסיסמה
;שם משתמש - חובה

cardcom_user_name=meserchabad

מספר מסוף - חובה

cardcom_terminal_number=112233

;מספר חנות - ברירת מחדל 555

cardcom_register_number=123

במידה והסליקה בוצעה עם סטטוס של OK
אז בנוסף לדוח של קארדקום ישירות מהם, ובנוסף לדוחות והאיימיל שלנו על הסליקה דרך קארדקום
תוכלו לראות בקובץ לוג של sale_seats_log.ymgr
ערך
PaymentType
עם תוצאה של
Cardcom

שלוחה 2 מודיע "דרך הוראת הקבע הקבועה"
צריך להכניס את הזיהוי של המשתמש לתוך קובץ
sale_seats_postpay.ini
ובו כל מספרי הזיהוי המאושרים לתשלום בהוראת קבע
לעשות את זיהוי ואז שורה חדשה ועוד זיהוי ועוד שורה חדשה כו'
לדוגמא אם הזיהוי האישי הוא תעודת זהות אז יש להכניס את כל התעודת זהות שלהם מאושר להרשם דרך ההוראת קבע
אחרת המערכת תודיע
M1539 אין הרשאה לחיוב בהוראת קבע

כאשר המספר הזיהוי מאושר לתשלום בהוראת קבע - מיד שומר לתמיד את המקום בקובץ sale_seats.ini עם ערך של Sold
ובנוסף מציין לכם בלוג
PaymentType
עם תוצאה של
Postpay

שלוחה 3
מבקש להקיש קופון
הלקוח יכול להקיש כל קופון ובכל אורך שרוצה
לאחר שהלקוח אישר
המערכת בודקת בקובץ
sale_seats_coupon.ini
האם הקופון מופיע בקופונים המאושרים
יש להכניס את הקופון ואז שורה חדשה ועוד טלפון ועוד שורה חדשה כו'

אם הקופון לא מופיע המערכת תודיע
M1538 הקופון שהוקש שגוי
שימו לב שמערכת הקופונים לא מוחקת את הקופון וכל אחד יכול להשתמש כמה פעמים שרותים עם אותו הקופון
במידת הצורך יוכלו להרחיב מודול זה בהמשך שיהיה אפשרות של שילוב קופון עם מחיר ושימוש חד פעמי בקופון , והמערכת תדע לקחת חלק בקופון ואת היתרה באשראי או בהוראת קבע וכד'

באם הקופון מאושר
המערכת שומרת לתמיד את המקום בקובץ sale_seats.ini עם ערך של Sold
ובנוסף מציין לכם בלוג
PaymentType
עם תוצאה של
Coupon-6282255
כלומר קופון מספר 6282255

לאחר שהלקוח שילם באחד מהצורות המאושרות
הלקוח מקבל מספר אישור
ברירת מחדל מספר אישור מתחיל מ1001 ומעלה
במידת הצורך ניתן לשנות את מספר האישור ההתחלתי בערך
[codesale_seats_approval_number_start=770[/code]
כאן רואים שיתחיל את האישורים מהמספר הבא שלאחר 770 - כלומר המזמין הראשון יקבל 771

בכל סיום הזמנה מאושרת
נשלח במייל קובץ עם כל הפעולות וההזמנות המאושרות, ובמידה ויש הקלטה של השם והכתובת שהוגדר בערך sale_seats_payment_record=yes אז גם תצורף ההקלטה

אם רוצים לבטל את השליחה למייל ניתן להגדיר

email_send=no

האיימיל נשלח לפי השם והאימייל הוגדר בחייגן
במידת הצורך ניתן לשנות בערכים

email_address=a@jj.vv.vv
email_name=aba

ניתן להגדיר שישלח את המייל למייל נוסף

email_address2=mail@mail.com

החלפת שמות העברית בקבצים

קובץ

sale_seats_log.ini

ערכים:

sale_seats_log=דו"ח כללי במכירת כיסאות
Folder=שלוחה
IdType=סוג זיהוי
teudat_zehut=תעודת זהות
digits=הקשת ספרות
list=רשימה
phone=טלפון
enter_phone_list=רשימת טלפונים
EnterId=מספר זיהוי
ValName=שם
Phone=טלפון
Date=תאריך
Time=שעה
HebrewDate=תאריך עברי
Line=שורה
Seat=כסא
Price=מחיר הכסא
Log=פעולה
middle_sale=כסא במהלך הזמנה
CancelOk=הזמנה מבוטלת
SoldOk=כסא קנוי
FullValue=ערך מלא של המקום
AmountSeat=סה"כ כסאות
TotalPayment=סה"כ לתשלום
PaymentType=סוג תשלום
Postpay=נציג
NedarimPlus=נדרים פלוס
Coupon=קופון
ApprovalNumber=מספר הזמנה

קובץ

sale_seats_ok.ini

הערכים

sale_seats_ok=כסאות שנמכרו בהצלחה
Folder=שלוחה
IdType=סוג זיהוי
teudat_zehut=תעודת זהות
digits=הקשת ספרות
list=רשימה
phone=טלפון
enter_phone_list=רשימת טלפונים
EnterId=מספר זיהוי
ValName=שם
Phone=טלפון
Date=תאריך
Time=שעה
HebrewDate=תאריך עברי
Line=שורה
Seat=כסא
Price=מחיר הכסא
Log=פעולה
middle_sale=כסא בהזמנה
SoldOk=כסא קנוי
FullValue=ערך מלא של המקום
AmountSeat=סה"כ כסאות
TotalPayment=סה"כ לתשלום
PaymentType=סוג תשלום
Postpay=נציג
NedarimPlus=נדרים פלוס
Coupon=קופון
ApprovalNumber=מספר הזמנה

התחברות לאחר הזמנה
כאשר הלקוח מתקשר פעם שניה לאחר ההזמנה המערכת תציע לו לשמוע את הכסאות שכבר הזמין או הזמנת כסאות נוספים

הגדרות כלליות למודול

timeout=7

בשביל זמן המתנה לאחר הקשה עד שבודק מה הקישו

קובץ מיוחד לכל אישור

הוספנו קובץ מיוחד לכל אישור
כל הקבצי ymgr וקבצי html שנוצרים לכל אישור, נשמרים בתיקיה בשם ApprovalOk שמתחת לתיקית SaleSeats שתחת התיקיה הראשית

שימו לב שבשביל שהמערכת תמיר לכם למילים שאתם רוצים שיופיעו בדוח

יש לשמור את הנתונים בקובץ בשם

SaleSeatsApprovalOk.ini

את הקובץ יש לשים בתוך תיקיית האישורים המיוחדת - בתוך תיקית ApprovalOk
במידת הצורך (אם עדיין לא הזמנתם שוב דבר מהמערכת ועדיין אין תיקיה) אז תצרו את התיקיה, או עשו הזמנה אחת והמערכת תפתח לבד את התיקיה.

ברירת מחדל לקובץ

SaleSeatsApprovalOk.ini
SaleSeatsApprovalOk=כסאות שנמכרו בהצלחה בהזמנה זו 
Folder=שלוחה
IdType=סוג זיהוי
teudat_zehut=תעודת זהות
digits=הקשת ספרות
list=רשימה
phone=טלפון
enter_phone_list=רשימת טלפונים
EnterId=מספר זיהוי
ValName=שם
Phone=טלפון
Date=תאריך
Time=שעה
HebrewDate=תאריך עברי
Line=שורה
Seat=כסא
Price=מחיר הכסא
Log=פעולה
middle_sale=כסא בהזמנה
SoldOk=כסא קנוי
FullValue=ערך מלא של המקום
AmountSeat=סה"כ כסאות
TotalPayment=סה"כ לתשלום
PaymentType=סוג תשלום
Postpay=נציג
NedarimPlus=נדרים פלוס
Coupon=קופון
ApprovalNumber=מספר הזמנה
DealSuccessfully=אישור אשראי

הודעות קשורות

M1498 "אנא הקישו את מספר השורה המבוקש
ליציאה הקישו סולמית."
M1499 אין כסאות לבחירה בשורה זו
M1500 בשורה...
M1501 יש
M1502 כסאות זמינים
M1503 אנא הקישו את מספר הכסא המבוקש, לבחירת כסא אקראי הקישו 0 וסולמית ליציאה הקישו סולמית.
M1504 הכסאות הזמינים הם:
M1505 כסא זה אינו זמין למכירה
M1506 בחרת שורה
M1507 כסא
M1508 הסכום לתשלום על הכסא הינו:
M1509 "לשמירת המקום הקישו 1
לבחירת כסא אחר הקישו 2"
M1510 הכסא נשמר עד לסיום השיחה
M1511 "(כסא...) עדין פנוי באם ברצונך לרכוש גם אותו הקש 1
לחזרה לתפריט הקישו 2"
M1512 שגיאה בשמירת הכסא
M1513 סיום הזמנה
M1514 הוזמנו (X כסאות)
M1515 (הוזמנו X) כסאות
M1516 הסך הכולל לתשלום
M1517 להלן הפירוט
M1518 שורה..
M1519 מחיר
M1520 הסך הכולל לתשלום
M1521 שקלים
M1522 "לאישור ההזמנה הקישו 1
לביטול ההזמנה הקישו 2"
M1523 "ההזמנה בוטלה
שלום ותודה"
M1524 "לתשלום בכרטיס אשראי הקישו 1
לתשלום בהוראת קבע הקובעה במוסד הקישו 2
להקשת קופון הקישו 3"
M1525 המקומות נרכשו בהצלחה
M1526 הגעת למקסימום כרטיסים הניתן לשמור עבורך הינך מועבר לתשלום
M1527 כבר יש כסאות קנויים על שמך, לשמיעת הפרטים הקישו 1, להזמנה נוספת הקישו 2, ליציאה הקישו כוכבית
M1528 "כבר קנית את מקסימום כסאות האפשרי עבורך, לא ניתן להזמין כסאות נוספים
M1529 נקנו... (כסאות)
M1530 "לסיום ומעבר לתשלום הקישו 1
לקניית כסא נוסף סמוך הקישו 2
לבחירת כסא נוסף בשורה זו הקישו 3
לבחירת מקום בשורה אחרת הקישו 4"
M1531 ...אינו זמין למכירה אנא נסו אפשרויות נוספות
M1532 אין כסא אקראי לבחירה בשורה זו אנא בחר כסא מהתפריט
M1533 העיסקה נקלטה בהצלחה
M1534 חובה לודא מול הנציג תוך 24 שעות שהוראת הקבע נקלטה ותקינה, אחרת הרישום יבוטל
M1535 חובה לודא מול הנציג תוך 24 שעות שהקופון נקלט ותקין אחרת הרישום יבוטל
M1536 אנא הקישו את קוד הקופון שברשותכם וסולמית לסיום
M1537 "לסיום ומעבר לתשלום הקישו 1 לבחירת מקום נוסף הקישו 2"
M1538 הקופון שהוקש שגוי
M1539 אין הרשאה לחיוב בהוראת קבע
M1587 עדיין אין כסאות בהזמנה זו
M1588 "לבחירת כסא נוסף בשורה זו הקישו 1
לבחירת כסא נוסף בשורה אחרת הקישו 2
לסיום ומעבר לתשלום הקישו 3"
M2537 כסא נוסף סמוך אינו זמין במצב זה
M4154 יש כיסאות שמורים על שמך
M4155 לשמיעת הכיסאות השמורים ומעבר לרכישה הקישו 1
M4156 לרכישת כיסאות אחרים הקישו 2
M4157 אנא בחרו את הכסא לרכישה
M4158 לרכישת כסא מספר..
M4159 הנמצא בשורה..
M4160 במחיר של...
M4161 הקישו..
M4162 שימו לב, הכסא שמור עד
M4163 לסיום ומעבר לתשלום הקישו 1 לבחירת מקום נוסף הקישו 2
M4164 אין מקום נוסף שמור על שמך
M4828 עד
M4829 היום
M4830 בעוד
M4831 שעות
M4832 מחר
M4833 תאריך
M4834 בשעה
M4835 ו
M4836 דקות