באמצעות webhooks, ניתן להגדיר למערכת iCount להעביר מידע למערכת שלישית בכל פעם שמופק מסמך בחשבון שלך. כך למשל, אם יש לך עוד מערכת שצריך ליידע אותה בכל פעם שמופק מסמך, ניתן להגדיר ב iCount לשלוח webhook עם כל הנתונים על המסמך, לכתובת מסוימת וברגע שמופק מסמך ב iCount, iCount תשלח אוטומטית את המידע עליו ב POST לכתובת שציינת.
איך מפעילים את ה WebHooks?
כדי להגדיר את ה WebHooks יש להיכנס ל"מערכת->הגדרות->מודולים" ולגלול למודול WebHooks כדי להפעיל אותו. לאחר ההפעלה, יש להיכנס ל"מערכת->הגדרות->אוטומציה" שם תופיע תווית WebHook בה ניתן להגדיר את ה WebHook כפעיל, ולהגדיר את הכתובת שלו.
פורמט ה WebHooks
ה-WebHooks נשלחים מתוך iCount בפורמט JSON והם כוללים את כל המידע שיש על המסמך. אין הגבלה על גודל תוכן ה WebHook אז יש לקחת בחשבון שהוא יכול להיות מרוד גדול במקרה ומדובר במסמכים שמכילים הרבה מידע.
כדי לתפוס את ה-WebHook עליכם להכין מראש בצד השרת המקבל, קוד שידע לעבד את הנתונים הנכנסים. הנה דוגמה לקוד שלנו שיודע לטפל ב-WebHook הנכנס:
$data = json_decode(file_get_contents("php://input"), true);
במקרה הזה ניתן לראות שאנחנו תופסים את ה input, ומפענחים אותו באמצעות json_decode. לאחר מכן אנחנו יכולים להתיחס לתוכן הקובץ שנמצא כרגע בתוך משתנה data$.
שליחה חוזרת של WebHooks ממסמך שכבר נוצר
מתוך עמוד חיפוש מסמכים, ניתן למצוא את המסמך הרלוונטי ואז ללחוץ על המספר שלו על מנת להיכנס אליו. שם, ניתן ללחוץ על אפשרויות ולבחור resend WebHook על מנת לשלוח את ה WebHook מחדש.
דוגמה ל-WebHooks מלא
להלן דוגמה לתוכן ה-webhook של המסמך הזה:
[
{
"doctype": "invrec",
"docnum": "3006",
"timeissued": "2024-01-11 12:16:48",
"clientname": "ישראל ישראלי",
"clientaddress": "ההדס 2\r\nנווה פריצקי\r\n123456\r\nIL",
"safety_issue_field": "",
"inv_rec_number": "3006",
"dateissued": "2024-01-11",
"comment": "",
"totalsum": "2778.63",
"totalvat": "472.37",
"vat_percent": "17",
"totalwithvat": "3251",
"ammountb4nicui": "3251",
"nicui": "",
"totalwithnicui": "3251",
"roundup": "",
"afterdiscount": "2778.6324786325",
"income_type": "0",
"tax_exempt": "0",
"based_on_order": "",
"salesman_id": null,
"invoice_po_number": "",
"orig_printed": "0",
"imported": "0",
"lawyer_fees_ov": "0.00",
"lawyer_fees_nov": "0.00",
"lawyer_expenses_ov": "0.00",
"lawyer_expenses_nov": "0.00",
"lawyer_deposits_ov": "0.00",
"lawyer_deposits_nov": "0.00",
"has_cash": "1",
"has_cheques": "1",
"has_cc": "1",
"has_bt": "1",
"has_hk": "0",
"has_pp": "1",
"has_barter": "1",
"maampercent": "17",
"user_id": "1",
"currency": "5",
"rate": "1",
"hwc": null,
"discount": "0",
"docnum_base": null,
"doctype_base": null,
"cash.sum": "200",
"banktransfer.depositedTO": "2",
"banktransfer.totalPayment": "1",
"banktransfer.peraonDate": "2024-01-11",
"banktransfer.bank": "",
"banktransfer.snif": "",
"banktransfer.account": "",
"issuer": "ליאב בדיקות",
"items": [
{
"item_id": "24",
"doctype": "invrec",
"docnum": "3006",
"inventory_item_id": "0",
"inventory_item_makat": "",
"serial": "",
"description": "שורה ראשונה",
"long_description": "",
"unitprice": "769.23076923077",
"quantity": "1",
"currency": "5",
"rate": 1,
"vat_exempt": "0",
"income_type_id": "0",
"is_refunded": "0",
"sku": ""
},
{
"item_id": "28",
"doctype": "invrec",
"docnum": "3006",
"inventory_item_id": "0",
"inventory_item_makat": "",
"serial": "",
"description": "שורה שנייה",
"long_description": "",
"unitprice": "129.05982905983",
"quantity": "1",
"currency": "5",
"rate": 1,
"vat_exempt": "0",
"income_type_id": "0",
"is_refunded": "0",
"sku": ""
},
{
"item_id": "32",
"doctype": "invrec",
"docnum": "3006",
"inventory_item_id": "0",
"inventory_item_makat": "",
"serial": "",
"description": "שורה שלישית",
"long_description": "",
"unitprice": "854.70085470085",
"quantity": "1",
"currency": "5",
"rate": 1,
"vat_exempt": "0",
"income_type_id": "0",
"is_refunded": "0",
"sku": ""
},
{
"item_id": "36",
"doctype": "invrec",
"docnum": "3006",
"inventory_item_id": "0",
"inventory_item_makat": "",
"serial": "",
"description": "שורה רביעית",
"long_description": "",
"unitprice": "769.23076923077",
"quantity": "1",
"currency": "5",
"rate": 1,
"vat_exempt": "0",
"income_type_id": "0",
"is_refunded": "0",
"sku": ""
},
{
"item_id": "40",
"doctype": "invrec",
"docnum": "3006",
"inventory_item_id": "0",
"inventory_item_makat": "",
"serial": "",
"description": "תשלום עודף",
"long_description": "",
"unitprice": "256.41025641026",
"quantity": "1",
"currency": "5",
"rate": 1,
"vat_exempt": "0",
"income_type_id": "0",
"is_refunded": "0",
"sku": ""
}
],
"paypal": {
"id": "4",
"docType": "invrec",
"docNum": "3006",
"paypalPaymentID": "1212212121",
"asmachtaDate": "2024-01-11",
"paymentFrom": "israel@israeli.com",
"ppSum": "20",
"refunded": "0",
"sum": "20",
"payment_date": "2024-01-11"
},
"cc_payments": [
{
"id": "8",
"doctype": "invrec",
"docnumber": "3006",
"cc_cardtype": "VISA",
"cc_paymenttype": "",
"cctotal": "1930",
"ccfirstpayment": "1930",
"cc_numofpayments": "1",
"cc_peraondate": "2024-01-11",
"cc_shovar": "455544545",
"cc_cardnumber": "4555",
"cc_holdername": "",
"cc_month": "0",
"cc_year": "0",
"refunded": "0",
"deal_id": "",
"is_chargeback": "0",
"sum": "1930",
"payment_date": "2024-01-11"
}
],
"custom": [],
"client_id": "12",
"vat_id": "1111111111",
"cheques": [
{
"id": "4",
"invrecnumber": "3006",
"chequeDate": "2024-01-11",
"chequeNumber": "11111111",
"accountNumber": "1111",
"chequeSnif": "111",
"chequeBank": "9",
"chequeAmmount": "1000",
"deposited": "",
"accounting_card_id": "0"
}
],
"client": {
"custom_client_id": "",
"email": "israel@israeli.com",
"phone": "025900000",
"mobile": "0500001111",
"date_created": "2024-01-11",
"accounting_foreign_account": "200004",
"bank_number": "",
"bank_branch_number": "",
"bank_account_number": "",
"client_vat_id": "1111111111"
},
"doc_link": "https://app.icount.co.il/hash/p_print.php?code=QmRPb3ZHMXptSStCbTUvTEpyRE9SdUdCeTlwSWw0bHBNZVZjRHNwNm5jV0NEbVQrVHY0QnpRPT0%3D",
"pdf_link": "https://s3.amazonaws.com/icount-pdfs/110144163_bee0b770f8fb1ff064db7941cd12d6c4.pdf"
}
]
