Receipt Module Integration

מבוא

לצורך יצירת קבלות בתוך ה-CRM והפקתם במערכת הנהלת החשבונות הרצויה של הלקוח בצורה תקינה וללא כפילויות במידע, יש צורך לבדוק האם קיים חבר קהילה במערכת.

במידה ולא קיים, יש ליצור רשומה שלו ואז ליצור את הקבלה על התשלום שהוא ביצע.

התהליך מתנהל כך:

1. Get Contact
   
2. במידה ולא קיים, אז יש לבצע Create Contact
   
3. Create Receipt

כאן ניתן לקרוא על יצירת רשומות של חברי קהילה.

בעת שימוש בדוקומנטציה של Zoho CRM API יש להשתמש בדומיין של ComeUnity: https://www.chabad.zohoplatform.com במקום https://www.zohoapis.com.

שדות חובה במודול קבלות Receipt

שם השדה	API Name	הסבר קצר
שם קבלה	Name	שם הרשומה במודול קבלות. בדרך כלל שם קצר שמתאר את התשלום או התרומה.
סוג הקבלה	Receipt_Type	סוג המסמך או הקבלה שהמערכת צריכה להפיק: תרומה או מוצר / שירות
חבר הקהילה	Linked_Community_Member	חבר הקהילה שאליו משויכת הקבלה. ללא חבר קהילה מקושר לא ניתן להפיק את הקבלה.
אמצעי התשלום	Payment_Method	אמצעי התשלום שבו התקבל הכסף. לפי הערך הזה נדרשים פרטי תשלום נוספים.
תאריך התשלום	Payment_Date	תאריך קבלת התשלום בפועל.
מסוף / ספק תשלום	Payment_Terminal	נדרש כאשר אמצעי התשלום הוא אפליקציית תשלומים כללית, או כשצריך לזהות דרך איזה מסוף/ספק התקבל התשלום, למשל Bit או אפליקציות תשלום אחרות.
מערכת הנהלת חשבונות להפקת הקבלה	Create_Receipt_With_The_Accounting_App	שם מערכת הנהלת החשבונות שבה ComeUnity צריכה להפיק את הקבלה, למשל ריווחית.
סכום שהתקבל	Amount_Received	הסכום שהתקבל בפועל ושעליו תופק הקבלה.
ת.ז./ח.פ. של מקבל הקבלה	ID_Number
הפקה ללא ת.ז.	Allow_no_Vat_ID	מסמן שמותר להפיק ללא ת.ז./ח.פ. כאשר התורם מעוניין בכך.
תורם אינו ישראלי	Donor_is_not_Israeli	מסמן שהתורם אינו ישראלי, ומשפיע על בדיקות ת.ז./ח.פ. ואישור רשות המסים.
4 ספרות אחרונות באשראי	Last_Four_Digits	נדרש בתשלומי אשראי. יש לשמור אפסים מובילים אם קיימים.
סוג כרטיס אשראי	Credit_Card_Type	נדרש בתשלומי אשראי.
מזהה עסקה	Transaction_ID	מזהה העסקה מספק הסליקה. אם אינו קיים, בחלק מהמקרים אפשר להשתמש במספר אישור.
מספר אישור	Confirmation_Code	מספר אישור העסקה, משמש כחלופה או כתוספת למזהה עסקה לפי מקור התשלום.
סטטוס	Status	כדי להפעיל את האוטומציה יש לשלוח את הסטטוס: נוצר באופן אוטומטי - לא הופק במערכת הנהלת חשבונות.

חשוב!

חובה להכניס את המידע של כל אמצעי תשלום, בהתאם לאמצעי התשלום.

טיפ!

את הערכים הרלוונטיים לכל סוג אמצעי תשלום ניתן לראות כאן, וגם באמצעות ה-API בקריאת Fields Meta Data.

רפורמת 2026 ומספר הקצאה

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

אם אין ת.ז. ישראלית או שהתורם אינו ישראלי, יש להשתמש בשדות המתאימים לפי הגדרות הלקוח ומערכת הנהלת החשבונות: Allow_no_Vat_ID ו-Donor_is_not_Israeli.

באשראי יש להקפיד על פרטי התשלום הנדרשים, ובמיוחד Last_Four_Digits עם שמירת אפסים מובילים, Credit_Card_Type ו-Card_Holder_ID כאשר קיים.

פרטי תשלום לפי אמצעי תשלום

• אשראי חד-פעמי: Transaction_ID או Confirmation_Code, ובמידת הצורך גם Last_Four_Digits ו-Credit_Card_Type.
• אפליקציית תשלומים / Bit: כאשר Payment_Method הוא אפליקציית תשלומים כללית, או כשצריך לזהות את מסלול התשלום, יש לשלוח Payment_Terminal.
• העברה בנקאית: Transfer_Reference, Bank_Number, Branch_Number, Account_Number כאשר קיימים.
• צ׳קים: יש לשלוח את פרטי הצ׳קים לפי מבנה השדות או תת-הטבלה שמופיעים ב-Fields Meta Data של המודול.

את ערכי ה-Picklist, שמות השדות ושמות תתי-הטבלאות יש לוודא מול Fields Meta Data, משום שהם יכולים להשתנות בין פריסות, שפות ומערכות הנהלת חשבונות.

הסבר על צורת הפקת הקבלות בפועל

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

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

הטריגר של מערכת ה-CRM להפקת הקבלות מותנה בשני פרמטרים:

1. שם המערכת להפקת הקבלה.
   
2. סטטוס הקבלה.
   כדי להטריג את האוטומציה הפנימית להפיק את הקבלות במערכת בפועל, יש להכניס את הערך נוצר באופן אוטומטי - לא הופק במערכת הנהלת חשבונות.
3. יש לשלוח trigger: ['workflow']

לאחר שהתנאים האלו מתקיימים, ובהנחה שהמידע של אמצעי התשלום, תאריך התשלום Payment_Date ושדות החובה התקבלו בצורה תקינה, המערכת תפיק את המסמכים ותשלח לחבר הקהילה שביצע את התשלום.

• Related Articles

• Community Members Module Integration

  מבוא לצורך יצירת רשומות של חברי קהילה בתוך ה-CRM בצורה תקינה וללא כפילויות במידע, יש צורך לבדוק האם קיים חבר קהילה במערכת. במידה ולא קיים, יש ליצור רשומה שלו. התהליך מתנהל כך: Get Contact. במידה ולא קיים, אז יש לבצע Create Contact. שדות חובה במודול ...

• Calls Module Integration

  מבוא לצורך יצירת רשומות של שיחות בתוך ה-CRM בצורה נכונה, יש צורך לבדוק האם קיים חבר קהילה במערכת. במידה ולא קיים, יש ליצור רשומה שלו ובסיום השיחה ליצור רשומת שיחה ולקשר אותה לחבר הקהילה. התהליך מתנהל כך: Get Contact במידה ולא קיים, אז יש לבצע Create ...