Webhooks

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

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

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

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

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

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

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

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

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

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

דוגמה

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",

"BusinessId": "XXXXXcfb0-427f-8a1a-43e88d9a2d73"}

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

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

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

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

175