איזו גרסה של כספית מתאימה לי?

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

תוכל להוריד התקנה ולבדוק אותה מכאן.


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

לכספית בענן, שעובדת באינטרנט, יש מספר ורסיות:

כספית הרגילה, כספית+ שבה הוספנו יכולת לנהל רשימת פריטים, כספית+מלאי, כספית+עמותות וכספית+יועצים.

יש הסבר על כל אחת מהוורסיות האלה כאן.

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

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

כיצד מפיקים עותק נאמן למקור?

לפי הוראות ניהול ספרים יש מקור ויש העתק.

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

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

כלומר אין כלל הגדרה של "עותק נאמן למקור".

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

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

 

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

איפה אני יכול לבדוק את האינטגרציה שלי?

בכדי לבדוק את האינטגרציה שלך אתה יכול להשתמש באחד מהחשבונות הבאים:

  1. ליצור לעצמך חשבון בדיקה – החשבון יהיה פתוח לחודש אחד. אתה יכול לפנות אלינו ונאריך לך את הרישיון לכמה זמן שתצטרך.
  2. להשתמש בחשבון הדמו של כספית. החשבון זמין לכניסה מדף הכניסה של כספית, חפש בצד שמאל. פרטי המשתמש הם:
    username = demo, password = demodemo,
    מספר העוסק מורשה תלוי בגרסה שאתה רוצה להשתמש:
    כספית רגילה = 222222222
    כספית+ = 444444444
    כספית+מלאי = 123456789
    כספית+יועצים = 555555555
    כספית+עמותות = 777777777

בעת יצירה של קבלה עבור תשלום במט"ח, מהיכן נשלף שער החליפין?

המטבע ושער החליפין נלקחים מהנתונים (ReceiptRate, ReceiptCurrencySymbol) שאתה שולח ל-API. ברירת המחדל היא ש"ח ו-1.00.
כלומר, אם תשלח מטבע $, אבל לא תשלח שער חליפין אז כספית תקבע את שער החליפין ב-1.00.
בכדי להקל עליך אתה יכול לשלוף את שער החליפין מכספית לפני יצירת הקבלה.

בעת יצירה של חשבונית ובה שורות חשבונית במט"ח, מהיכן נשלף שער החליפין?

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

כיצד כספית מאפשרת מסמכים במט"ח

בכספית יש גישה מעורבת בתמיכה במט"ח. היא נובעת מההיסטוריה שבה פותחה התמיכה הזו:
חשבוניות — כל שורת חשבונית יכולה להכיל מטבע שונה ושער חליפין שונה.
קבלות — יש רק מטבע אחד ושער חליפין אחד משותפים לכל שורות הקבלה.
חשבוניות/קבלה — בחלק שורות החשבונית אפשר לתת מטבע שונה ושער חליפין שונה לכל שורה. בחלק הקבלה יש רק מטבע אחד ושער חליפין אחד זהה לכל שורות הקבלה. אין חובה ששער החליפין והמטבע יהיו זהים בין חלק החשבונית לחלק הקבלה. אבל חובה שהסכום הכללי בש"ח יהיה זהה בין חלק החשבונית לחלק הקבלה.

אני מייצר מסמך חדש (לדוגמה, חשבונית מס) דרך ה API. מה צריך לרשום בשדה "*מפתח של המסמך"?

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

לכן ישנן שתי אפשרויות:

אם אתה רוצה שכספית תייצר מפתח עבורך –
השאר את השדה NULL. כספית תייצר מפתח שהוא GUID, לדוגמה: f3a6f8e6-1933-48ca-af1d-8c4aaa033545
אם אתה רוצה לעדכן את המסמך בעתיד, אז שמור את המפתח שתקבל בתשובה של כספית.

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

מה ההבדל בין TrxTypeId לבין TrxCodeNumber? מה הערכים שצריך לשלוח בסוגי המסמכים השונים?

TtrxTypeId הוא סוג המסמך: חשבונית מס, חש/קבלה, קבלה וכו'.
TrxCodeNumber הוא סיווג התנועה של המסמך. כספית מגיעה עם מספר סיווגי תנועה מוכנים. נציין שניים חשובים: 3-מכירות/הכנסות, 2-קבלות.
המשתמש יכול להוסיף סיווגים משלו על מנת להבחין בין חשבוניות מסוגים שונים של הכנסות.

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

שם המסמך TrxTypeId TrxCodeNumber
חשבונית מס 1 3
חשבונית/קבלה 7 3
חשבונית עסקה 6 3
חשבונית זיכוי 9 3
תעודת משלוח 15 3
קבלה 2 2
קבלה לתרומה 19 2
תעודת החזר 13 2

כיצד אפשר לעדכן את ה-id של לקוח בכספית?

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

אני רוצה לשלוף לקוח אבל אין לי ה-id שלו, אלא רק מספר עוסק מורשה

שלוף את הלקוח באמצעות הע"מ שלו
https://app.caspitweb.biz/api/v1/Contacts/?osekmorshe=234567777&d=1&token=[TOKEN]

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

יש המון דוגמאות כאן:
http://www.caspitweb.biz/Content/misc/Api%20Examples%201.txt

האם אפשר להדפיס מסמך דרך ה-API?

אין אפשרות "להדפיס" מסמך במובן של משלוח שלו למדפסת.
בכדי להדפיס אותו במדפסת מקומית של המשתמש תצטרך "להדפיס" אותו במובן של יצירת מסמך PDF, ואז לשלוח את ה-PDF למדפסת מקומית.
ה-API המתאים הוא:
POST api/v1/PrintDocument/{id}?token={token}&documentNumber={documentNumber}&trxTypeId={trxTypeId}&lan={lan}&createSignedPdf={createSignedPdf}
הקריאה תחזיר לך את ה-PDF שנוצר ב-body של התשובה. ה-body יכיל את הבתים של ה-PDF ועליך לשמור אותם לקובץ.
בנוסף הקריאה תחזיר לך URL להצגת מסמך ה-PDF בשדה location ב-header של התשובה.

יצרתי מסמך חדש דרך ה-API. מדוע המספר שלו לא ברצף למסמכים הקיימים בכספית?

כספית מאפשרת ליצור סדרות של מסמכים. כלומר אתה יכול ליצור סידרה 01 לסניף א' של העסק, וסידרה נפרדת 02 לסניף ב' של העסק. ואז במסמכים ימוספרו כך:
סניף א' — 01/2001, 01/2002
סניף ב' — 02/2001, 02/2002
מספר הסידרה של משתמש ה-API מאותחל לערך 98. אתה יכול לשלוח את מספר הסניף הרצוי לך דרך ה-API.
כלומר מסמכים שנוצרים כברירת מחדל מן ה-API הם תמיד מסידרה 98: 98/200001, 98/300001 וכו'
את מספר הסניף שלח בשדה DocumentNumberBranch של האוביקט CaspitDocument.

האם השדה RowVersion משמש רק עבור עדכון המסמך בכספית? מה אתה ממליץ להעביר בשדה זה?

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

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

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

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

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

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

דרך הנכונה היא זו:
1. ליצור את הלקוח דרך ה-API.
אם תעביר מפתח בשדה ContactId של CaspitContact אז כספית תשתמש בו. אם תשלח null או שתשאיר את השדה ריק אז כספית תייצר עבורך מפתח ותחזיר לך אותו בתשובה.
שם לב: אם קיים לקוח עם המפתח שהעברת לכספית, אז כספתי תעדכן את הלקוח הקיים ולא תיצור לקוח חדש.
2. ליצור את החשבונית דרך ה-API. בעת יצירת החשבונית להעביר בשדה CustomerId ב-CaspitDocument את המפתח שהשתמשת בו (או שקיבלת מכספית).
בעת יצירת החשבונית עליך להעביר את פרטי הלקוח (שם, כתובת, מספר ע"מ) גם בשדות המתאימים באוביקט החשבונית.
מדוע? ראה השאלה הבאה.

האם יש לכספית קישור עם רב מסר?

כן, לכספית יש מימשק עם מערכת שלח מסר ועם מערכת רב מסר.

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