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

Webhooks

Webhooks הן קריאות שהמערכת יכולה לבצע לאחר שמתרחש אחד מהאירועים הבאים:


1. עדכון של יתרת לקוח. - AfterCustomerBalanceUpdate

2. הדפסה של מסמך בכספית (כולל "הדפסה" תוך כדי משלוח של המסמך במייל). - AfterDocumentPrint

3. ביטול של מסמך. - AfterDocumentCancelled

4. חיוב של כרטיס אשראי - AfterCreditCardCharged 

5. שינוי של הסכום האפקטיבי ("הסכום לתשלום" או "הסכום הפתוח" בחשבונית) של מסמך- AfterDocumentEffedtiveSumChanged 
לדוגמה, לאחר שמופקת קבלה לחשבונית מס, המערכת מאפסת את הסכום האפקטיבי ("הסכום לתשלום") של החשבונית.
המערכת לא מסננת את המסמכים לפי הסוג. היא תשלח קריאה עבור כל מסמך שהשדה EffectiveSum1 שלו השתנה, כולל הזמנות עבודה, חש/עסקה וכו'.
אתה יכול לסנן את המידע בצד שלך בעזרת השדה TrxTypeId של CaspitDocument שקיבלת.

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

מה נשלח בקריאות?

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

1. AfterCustomerBalanceUpdate - פעולת POST של אוביקט JSON מסוג CaspitContact כפי שמתועד כאן.

2. AfterDocumentPrint - פעולת POST של אוביקט JSON מסוג CaspitDocument כפי שמתועד כאן.

3. AfterDocumentCancelled - פעולת POST של אוביקט JSON מסוג CaspitDocument כפי שמתועד כאן.

4. AfterCreditCardCharged - פעולת POST של אוביקט JSON מסוג CaspitCreditCard כפי שמתועד כאן.

5. AfterDocumentEffedtiveSumChanged - פעולת POST של אוביקט JSON מסוג CaspitDocument כפי שמתועד כאן.


המבנה של המידע

ה-JSON נשלח ב-POST. הוא מכיל את השדות הבאים:

WebhookMessageId - מספר ההודעה. אתה יכול להשתמש בו לזהות קריאות כפולות.

Message - האוביקט הרלוונטי כמו CaspitDocument או CaspitContact

TriedToSendCount - כמה פעמים המערכת כבר ניסתה לקרוא למערכת שלך

LastTryDate - המועד של הניסיון האחרון

DateCreated - המועד שבו נווצרה הקריאה
UserCreated - המשתמש ש-"יצר" את הקריאה

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

EventId - סוג ההודעה
Contact_Balance_Update        = 1,
 Document_Printed              = 2,
Document_Cancelled            = 3,
 CC_Charged                    = 4,
Document_EffedtiveSum_Changed = 5        

BusinessId - הזיהוי של העסק שעבורו נשלחה הקריאה.

דוגמה ל Document_Printed

POST https://xxxx.com/webhook/xxxx-caspit-after-document-print 
Content-Type: application/json
Host: xxxx.com 
Content-Length: 3871
Expect: 100-continue 

"WebhookMessageId": 117823
"Message": "{ "BusinessId": "XXXXXX-cfb0-427f-8a1a-43e88d9a2d73", "DocumentId": "XXXXX-61a0-43e7-a411-ad0751712ff9",
"DocumentSource": 0,
"DocumentNumberBranch": 1,
"TrxTypeId": 31,
"Number": "01/240783",
"Date": "2025-09-21",
"CustomerId": "XXXX-22f4-4de8-90d2-6610d6bd6644",
"CustomerBusinessName": "XXXXX",
"CustomerOsekMorshe": "XXXX732",
"CustomerAddress1": "XXXX 77",
"CustomerPostalCode": "XXXX",
"CustomerEmail": "XXXX@XXXXX.com",
"MobilePhone": "XXXX",
"Details": "הוראת קבע 17335",
"Comments": "",
"TotalLinesChargeVAT": 0.00,
"Rebate": 0.0,
"RebatePercent": 0.0,
"RountTotal": false,
"RebateRounding": 0.0,
"TotalBeforeVAT": 60.00000000,
"TotalBeforeVATChargeVAT": 0.00,
"TotalNoChargeVat": 60.00000000,
"Vat": 0.0,
"Total": 60.00000000,
"EffectiveTotal": 0.0,
"VatRate": 0.0,
"Payment": 60.0000,
"TaxDeduction": 0.0,
"TotalPayment": 60.0000,
"ReceiptCurrencySymbol": "₪",
"ReceiptRate": 1.00,
"TaxDeductionNIS": 0.00,
"PaymentNIS": 60.000000,
"TotalPaymentNIS": 60.000000,
"DocumentLines": [
{
"Number": 1,
"ProductId": "XXXXX-4672-47ce-8586-91fd8b995039",
"ProductName": "התמחות עיכול - חברות במסלול בוגרים",
"Details": " התמחות עיכול - חברות במסלול בוגרים, תשלום חודשי",
"UnitPrice": 30.0000,
"Qty": 1.00,
"CurrencySymbol": "₪",
"Rate": 1.00,
"Rebate": 0.00,
"ExtendedPrice": 30.00000000,
"ChargeVAT": false,
"VATRate": 0.0,
"VAT": 0.00
},
{
"Number": 2,
"ProductId": "XXXXXX-7e6f-4e17-a99f-3f60d75d93b5",
"ProductName": "התמחות בריאות האישה - חברות במסלול בוגרים",
"Details": " התמחות בריאות האישה - חברות במסלול בוגרים, תשלום חודשי",
"UnitPrice": 30.0000,
"Qty": 1.00,
"CurrencySymbol": "₪",
"Rate": 1.00,
"Rebate": 0.00,
"ExtendedPrice": 30.00000000,
"ChargeVAT": false,
"VATRate": 0.0,
"VAT": 0.00
}
],
"ReceiptLines": [
{
"Number": 1,
"PaymentTypeId": 6,
"AccountNumber": "xxxx-6997",
"BranchOrValidTo": "0126",
"CheckNumber": "410189511",
"PaymentDate": "2025-10-08",
"Payment": 60.0000,
"Rate": 1.00,
"CanBeChanged": false,
"DateCreated": "2025-09-21",
"UserCreated": "CEO",
"DateUpdated": "2025-09-21",
"UserUpdated": "CEO"
}
],
"TrxCode": "הכנסות/מכירות",
"TrxCodeNumber": 3,
"Status": 2,
"DueDate": "2025-10-31",
"RowVersion": "AAAAAAlpjA0=",
"LinkToPdf": "https://app.caspit.biz:443/api/v1/Pdf/XXXXX-61a0-43e7-a411-ad0751712ff9?token=_REPLACE_WITH_YOUR_TOKEN_",
"RelatedDocuments": [],
"DateCreated": "2025-09-21",
"UserCreated": "XXX",
"DateUpdated": "2025-09-21",
"UserUpdated": "CEO"
}", 
"TriedToSendCount": 12, 
"LastTryDate": "2025-09-21 17:02:34", 
"DateCreated": "2025-09-21 06:32:03", 
"UserCreated": "XXXX", 
"DateUpdated": "2025-09-21 17:02:34", 
"UserUpdated": "Anonymous", 
 "EventId": 2,
"BusinessId": "XXXXXcfb0-427f-8a1a-43e88d9a2d73"
}

דוגמה לקריאה מסוג AfterDocumentEffectiveSumChanged

POST http://localhost:8085/AfterDocumentEffectiveSumChanged
Content-Length: 2562
Content-Type: application/json
Expect: 100-continue
Host: localhost:8085

{
  "WebhookMessageId": 100018,
  "Message": "{\r\n  \"BusinessId\": \"76b6a614-83b4-42fb-b7af-861b7293bca8\",\r\n  \"DocumentId\": \"3dc2bf8b-d8bc-4124-a59d-e8e1b9dc372e\",\r\n  \"DocumentSource\": 0,\r\n  \"DocumentNumberBranch\": 1,\r\n  \"TrxTypeId\": 30,\r\n  \"Number\": \"01/100011\",\r\n  \"Date\": \"2026-06-15\",\r\n  \"CustomerId\": \"f1500c72-b37d-45ac-aeb2-2c3003dcefbb\",\r\n  \"CustomerBusinessName\": \"????~?T ?"?`\",\r\n  \"TotalLinesChargeVAT\": 0.0000,\r\n  \"Rebate\": 0.0000,\r\n  \"RebatePercent\": 0.00000,\r\n  \"RountTotal\": false,\r\n  \"RebateRounding\": 0.0000,\r\n  \"TotalBeforeVAT\": 300.0000,\r\n  \"TotalBeforeVATChargeVAT\": 0.0000,\r\n  \"TotalNoChargeVat\": 300.0000,\r\n  \"Vat\": 0.0000,\r\n  \"Total\": 300.0000,\r\n  \"EffectiveTotal\": 0.00000000,\r\n  \"VatRate\": 0.00,\r\n  \"Payment\": 0.0000,\r\n  \"TaxDeduction\": 0.0000,\r\n  \"TotalPayment\": 0.0000,\r\n  \"ReceiptRate\": 1.0000,\r\n  \"TaxDeductionNIS\": 0.00000000,\r\n  \"PaymentNIS\": 0.00000000,\r\n  \"TotalPaymentNIS\": 0.00000000,\r\n  \"DocumentLines\": [\r\n    {\r\n      \"Number\": 1,\r\n      \"ProductName\": \"???"?¡ ?¢?-?"?" ?"???c?? ?"\",\r\n      \"UnitPrice\": 300.0000,\r\n      \"Qty\": 1.0000,\r\n      \"CurrencySymbol\": \"ג,x\",\r\n      \"Rate\": 1.0000,\r\n      \"Rebate\": 0.0000,\r\n      \"ExtendedPrice\": 300.000000000000,\r\n      \"ChargeVAT\": false,\r\n      \"VATRate\": 0.00,\r\n      \"VAT\": 0.0000\r\n    }\r\n  ],\r\n  \"ReceiptLines\": [],\r\n  \"TrxCode\": \"?"?>? ?¡??x/???>?T?"??x\",\r\n  \"TrxCodeNumber\": 3,\r\n  \"Status\": 2,\r\n  \"DueDate\": \"2026-07-31\",\r\n  \"RowVersion\": \"AAAAAAFhTdg=\",\r\n  \"LinkToPdf\": \"https://localhost:44310/api/v1/Pdf/3dc2bf8b-d8bc-4124-a59d-e8e1b9dc372e?token=_REPLACE_WITH_YOUR_TOKEN_\",\r\n  \"ViewUrl\": \"https://casp.it/we7h2RApvj\",\r\n  \"RelatedDocuments\": [\r\n    {\r\n      \"DocumentId\": \"44cd027c-f5c9-4af7-98ec-f474df204509\",\r\n      \"TrxTypeId\": 34,\r\n      \"Date\": \"2026-06-15\",\r\n      \"DocumentNumber\": \"01/600002\",\r\n      \"DocumentSum\": 300.0000,\r\n      \"DocumentRelation\": 2\r\n    }\r\n  ],\r\n  \"DateCreated\": \"2026-06-15\",\r\n  \"UserCreated\": \"demo\",\r\n  \"DateUpdated\": \"2026-06-15\",\r\n  \"UserUpdated\": \"demo\"\r\n}",
  "TriedToSendCount": 1,
  "LastTryDate": "2026-06-15 20:25:36",
  "DateCreated": "2026-06-15 20:25:36",
  "UserCreated": "demo",
  "DateUpdated": "2026-06-15 20:25:36",
  "UserUpdated": "demo",
  "EventId": 5,
  "BusinessId": "76b6a614-83b4-42fb-b7af-861b7293bca8"
}

מה התזמון של הקריאות?

הקריאה הראשונה מתבצעת מייד לאחר ביצוע הפעולה בכספית. כלומר תוך שנייה-שתיים בהתאם לעומס על המערכת.
אם לא מתקבלת תשובה 200 OK, אז המערכת תתנסה 11 פעמים (כלומר בסה"כ 12 פעמים) בזמני המתנה הולכים וגדלים. הקריאה האחרונה תתבצע בערך 12 שעות לאחר הקריאה הראשונה. 

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



175


כל הזכויות שמורות לכספית תוכנה בע"מ 2014 | תמיכה? support@caspit.biz צור קשר 077-9233325 | רישיון ההפעלה של כספית בענן | נגישות | גרסה 2.4.9678.37872 עיצוב ממשק משתמש AStudio