
Webhook מפרט טכני
כעת נתעמק בצד הטכני של מודול ניהול Webhooks של ביג בוס – תוכנה לניהול עסק
בדף זה נתאר את מבנה ה-נתונים (Payload) אשר נשלח ע"י המערכת עבור כל אחד מסוגי האירועים.
להלן רשימת האירועים הנתמכים במערכת:
– הקמה \ עדכון \ מחיקה של ליד
– הקמה \ עדכון \ מחיקה של לקוח
– הקמה \ עדכון \ מחיקה של ספק
– הקמה \ עדכון \ מחיקה של פריט
– עדכון של מלאי
ליד – פרטי הנתונים
להלן ה-Payload אשר יישלח עבור כל הפעילויות מול ליד:
שדה | סוג הנתון | תיאור |
---|---|---|
lead_id |
מספר (int) | מזהה ייחודי של הליד ממערכת הנתונים |
company_name |
מחרוזת | שם החברה |
contact_name |
מחרוזת | שם איש הקשר |
address |
מחרוזת | כתובת מלאה של איש הקשר |
city |
מחרוזת | העיר |
zip |
מחרוזת | מיקוד |
tel |
מחרוזת | טלפון קווי |
cel |
מחרוזת | טלפון נייד |
email |
מחרוזת | כתובת דוא"ל |
comments |
מחרוזת | הערות כלליות חופשיות |
דוגמא של נתונים:
{
"lead_id": 1234,
"company_name": "שם החברה",
"contact_name": "שם איש הקשר",
"address": "כתובת",
"city": "עיר",
"zip": "מיקוד",
"tel": "+972501234567",
"cel": "+972521234567",
"email": "[email protected]",
"comments": "הערות חופשיות"
}
לקוח \ ספק – פרטי הנתונים
להלן ה-Payload אשר יישלח עבור כל הפעילויות מול לקוח וספק:
שדה | סוג | תיאור |
---|---|---|
customer_id |
int | מזהה ייחודי של הלקוח |
company_hp |
string | מספר העסק/ח.פ. |
company_name |
string | שם החברה |
contact_name |
string | שם איש הקשר |
address |
string | כתובת מלאה |
city |
string | עיר |
zip |
string | מיקוד |
tel |
string | טלפון קווי |
cel |
string | טלפון נייד |
email |
string | כתובת דואר אלקטרוני |
comments |
string | הערות נוספות |
account_code |
string | קוד חשבון |
vat_exemption |
int | פטור ממע"מ (1 או 0) |
דוגמא של נתונים:
{
"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 |
int | מזהה ייחודי של הפריט |
item_name |
string | שם הפריט |
catalog_number |
string | מק"ט |
barcode |
string | ברקוד |
group_id |
int | מזהה קבוצה של פריטים |
group_name |
string | שם הקבוצה |
price_buy_nis |
decimal | מחיר עלות בש"ח (לפני מע"מ) |
price_sell |
decimal | מחיר מכירה |
price_sell_matvea_id |
int | מזהה קבוצת מחיר לפי מתווה |
price_sell_matvea_code |
string | קוד קבוצת מחיר |
price_sell_vat_included |
int | האם מע"מ כלול? (1/0) |
image_url |
string | URL לתמונה של הפריט |
extended_description |
string | תיאור מורחב |
managed_in_inventory |
int | האם מתוחזק במלאי? (1/0) |
inventory_min_qtty |
decimal | מינימום מלאי |
inventory_max_qtty |
decimal | מקסימום מלאי |
דוגמא של נתונים:
{
"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 |
int | מזהה ייחודי של הפריט |
catalog_number |
string | מק"ט לפריט |
item_name |
string | שם הפריט |
group_id |
int | מזהה קבוצה של הפריטים |
group_name |
string | שם הקבוצה |
warehouse_id |
int | מזהה ה‑warehouse |
warehouse_name |
string | שם המחסן |
quatity |
decimal | הכמות במלאי – יכולה להיות מספר עשרוני |
דוגמא של נתונים:
{
"item_id": 3456,
"catalog_number": "123-ABC",
"item_name": "שם הפריט",
"group_id": 10,
"group_name": "קטגוריית פריטים",
"warehouse_id": 2,
"warehouse_name": "מחסן מרכזי",
"quatity": 150.75
}
מסך ניהול Webhook של ביג בוס – תוכנה לניהול עסק, מספקות כלים להגדרת תהליכי אוטומציה חכמים, החל מבחירת סוגי אירועים ועד לניהול אבטחת התקשורת והפניית הנתונים למערכות חיצוניות בזמן אמת.