API - כספית כמודול הנהלת חשבונות בעזרת ממשק תיכנותי

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

כספית יכולה להתאים לאפליקציה "שולחנית" (desktop) שדרוש לה מודול הנהלת חשבונות.

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

ה-API ממומש בתור קומפוננטה ActiveX. הוא מותקן על-ידי כספית החל מגרסה 2.41.

אפשר להפעיל את ה-API מכל מערכת שתומכת בהפעלה של אובייקטי COM: אקסס (ואפליקציות אחרות שיש להן VBA כמו אקסל), אפליקציות VB, וגם C++ וגם מ .Net.

עדכון של ה-API לכספית 3.2

לאחרונה (מאי, 2011) עדכנו את ה-API והתאמנו אותו לכספית גרסה 3.2 . ישנם מספר שינויים מהותיים (ופחות מהותיים) בגרסה 3.2:

 1. כספית 3.2 תומכת בעבודה עם מספר עסקים בכספית אחת – דווקא זה שינוי שלא משפיע על קוד שנכתב לגרסה 3.1  משום שברירת המחדל של ה-API היא לעבוד עם עסק מספר 1. כלומר, כל עוד הלקוח הסופי משתמש רק בעסק מספר 1 לא יהיה שום שינוי.

 2. ה-ID של האובייקטים של כספית 3.2 אינו קבוע, והוא משתנה בכל פעם שמשחזרים נתונים. לכן, חשוב לעבוד עם מספר האוביקט (או עם המפתח הזר שלו), ולא עם ה-ID שלו. לדוגמא, לעבוד עם iCustomerNumber ולא עם iCustomersID.

 3. מספר העותקים בהדפסה של מסמכי מקור נקבע בכספית ולא דרך ה-REGISTRY.

האם אתה רוצה לנסות את ה-API?

אם אתה מעוניין לנסות את ה-API:

• הורד והתקן את כספית.  ההתקנה כוללת את ה-API של כספית 3.1.
• פרוייקט ההדגמה של ה-API גרסה 3.1 (כתוב ב VB 6).

גרסה 3.2

• אם אתה מתחיל בפרויקט חדש אנחנו ממליצים להשתמש בכספית 3.2. הגרסה נמצאת כרגע (יוני, 2011) בשלבים אחרונים של יציאה לשוק.  יש לינק לגרסה האחרונה של כספית 3.2 מהורדות חשובות.
• אם אתה משתמש בכספית 3.2 - הורד והתקן (בעזרת REGSVR32) את ה-API של גרסה 3.2
  
• הורד את פרויקט ההדגמה של גרסה 3.2
  

דרישות מוקדמות להפעלת ה-API

להלן רשימה של דרישות מוקדמות בכדי שיהיה ניתן להפעיל בהצלחה את ה-API של כספית:

• התקנה תקינה של כספית.
  כלומר כספית נפתחת באופן תקין וניתן להוסיף לה לקוחות, חשבוניות וכו'.
  חשוב לבדוק גם הדפסות. כלומר שניתן להדפיס באופן תקין מכספית.
  אחת המשמעויות היא שיש התקנה של Access 2003 או מאוחר יותר על המחשב.
  
  
• התקנה של CaspitAPI32.dll – זהו המימוש של ה-API עבור גרסה 3.2 של כספית. מאחר שהקומפוננטה היא ActiveX יש להריץ עליה regsvr32.
  
  
• התקנה של regobj.dll – קומפוננטה של מיקרוסופט לגישה ל-registry. יש להריץ עליה regsvr32.
  
  
• רישיון להפעלה של כספית שמכיל הרשאה לשימוש ב-API.
  אם תנסה להשתמש ב-API, כשהרישיון של כספית לא מכיל הרשאה לשימוש ב-API, חלק מהפעולות של ה-API יחסמו. לדוגמה: לא תוכל להציג מסמכים או להדפיס אותם.
  

תיעוד של ה-API

ה-API מתועד בקובץ ה-PDF הזה.

מה העלות של השימוש ב-API?

1. העלות ללקוח -- 0. הדרישה היחידה היא שהוא ירכוש את כספית+ (ולא כספית רגילה).

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