Webhook – מפרט טכני

Webhook מפרט טכני

כעת נתעמק בצד הטכני של מודול Webhook של ביג בוס – תוכנה לניהול עסק

בדף זה נתאר את מבנה ה-נתונים (Payload) אשר נשלח ע"י המערכת עבור כל אחד מסוגי האירועים. 

להלן רשימת האירועים הנתמכים במערכת:

– הקמה \ עדכון \ מחיקה של ליד

– הקמה \ עדכון \ מחיקה של לקוח

– הקמה \ עדכון \ מחיקה של ספק

– הקמה \ עדכון \ מחיקה של פריט

– עדכון של מלאי

– הפקת מסמך

ליד – פרטי הנתונים

להלן ה-Payload אשר יישלח עבור כל הפעילויות מול ליד:

דוגמא של נתונים:

{
  "lead_id": "1234",
  "company_name": "שם החברה",
  "contact_name": "שם איש הקשר",
  "address": "כתובת",
  "city": "עיר",
  "zip": "מיקוד",
  "tel": "+972501234567",
  "cel": "+972521234567",
  "email": "[email protected]",
  "comments": "הערות חופשיות"
}

לקוח \ ספק – פרטי הנתונים

להלן ה-Payload אשר יישלח עבור כל הפעילויות מול לקוח וספק:

דוגמא של נתונים:

{
  "customer_id": 5678,
  "company_hp": "123456789",
  "company_name": "שם החברה",
  "contact_name": "שם איש הקשר",
  "address": "כתובת",
  "city": "עיר",
  "zip": "מיקוד",
  "tel": "+97236123456",
  "cel": "+972521234567",
  "email": "[email protected]",
  "comments": "הערות חופשיות",
  "account_code": "AC12345",
  "vat_exemption": 1
}

פריט – פרטי הנתונים

להלן ה-Payload אשר יישלח עבור כל הפעילויות מול פריט:

דוגמא של נתונים:

{
  "item_id": 3456,
  "item_name": "שם הפריט",
  "catalog_number": "123-ABC",
  "barcode": "7290001234567",
  "group_id": 10,
  "group_name": "קטגוריית פריטים",
  "price_buy_nis": 12.34,
  "price_sell": 23.45,
  "price_sell_matvea_id": 2,
  "price_sell_matvea_code": "B",
  "price_sell_vat_included": 1,
  "image_url": "https://…/image.jpg",
  "extended_description": "תיאור מורחב של הפריט",
  "managed_in_inventory": 1,
  "inventory_min_qtty": 2.5,
  "inventory_max_qtty": 100.0
}

מלאי- פרטי הנתונים

להלן ה-Payload אשר יישלח עבור פעילות מול המלאי:

דוגמא של נתונים:

{
  "item_id": 3456,
  "catalog_number": "123-ABC",
  "item_name": "שם הפריט",
  "group_id": 10,
  "group_name": "קטגוריית פריטים",
  "warehouse_id": 2,
  "warehouse_name": "מחסן מרכזי",
  "quatity": 150.75
}

מסמך – פרטים בעת הפקת מסמך

להלן ה-Payload אשר יישלח בעת הפקת מסמך חדש:

עבור שורות המסמך:

עבור שורות התקבול במסמך:

{
"document_id": 9876,
"document_type": 3,
"document_number": 4512,
"document_date": "2025‑07‑31T14:26:00Z",
"due_date": "2025‑08‑30T14:26:00Z",
"company_id": 5678,
"company_hp": "523456789",
"company_name": "שם החברה",
"contact_name": "שם איש הקשר",
"address": "רחוב X 1, חולון",
"city": "חולון",
"tel": "+97236111111",
"cel": "+972521234567",
"email": "[email protected]",
"document_vat_type": 2,
"discount_percentage": 5.0,
"discount_amount": 120.50,
"maam_percentage": 17.0,
"amount_maam": 273.85,
"amount_total": 1889.35,
"items": [
{
"line_number": 1,
"catalog_number": "123-ABC",
"description": "תיאור פריט",
"quantity": 2.0,
"price_unit": 250.00,
"discount_percentage": 5.0,
"amount_discount": 25.00,
"matvea_code": "A",
"exchange_rate": 1.0000,
"price_nis": 475.00
}
],
"payments": [
{
"line_number": 1,
"payment_type": 1,
"amount_nis": 1889.35,
"due_date": "2025‑08‑05T14:26:00Z",
"bank_code": 12,
"branch_number": "01",
"bank_account_number": "1234567",
"cheque_number": "3456789",
"credit_card_id": null,
"credit_card_number": null
}
]
}

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