ספקים דרך ה-API: הוספה, שליפה, רשימה ויתרה

כל מה שקראתם כאן, המערכת עושה בשבילכם בקליק

45 יום לנסות את ביג בוס בחינם. בלי כרטיס אשראי, בלי התקנה: מייל וסיסמה וזהו.

מדריך למשתמש לספקים דרך ממשק ה-API של ביג בוס

ספק שנפתח במערכת אחת, נפתח גם בביג בוס

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

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

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

הוספת ספק: supplier_new

שולחים את שם הספק ב-company_name, ואפשר להוסיף:

company_hp: מספר עוסק או ח.פ. של הספק.
פרטי קשר: contact_name, address, city, tel, cel ו-email.
withholding_tax_percent ו-withholding_tax_valid_until: אחוז הניכוי במקור של הספק, ותוקף האישור שלו.
payment_terms ו-payment_days: תנאי התשלום. בבדיקה שלנו 2 עם 30 ימים נשמרו בכרטיס כשוטף 30.
expense_account_id: סעיף ההוצאה של הספק, מתוך הרשימה שמחזירה expense_lists (בהמשך).

{
  "api_token": "<המפתח שלכם>",
  "company_name": "ספק לדוגמה",
  "company_hp": "<ח.פ. של הספק>",
  "withholding_tax_percent": 5,
  "withholding_tax_valid_until": "2026-12-31",
  "payment_terms": 2,
  "payment_days": 30
}

בהצלחה ההודעה היא "הספק נוסף", ובתשובה חוזר supplier_id, מספר הספק החדש. שומרים אותו: לפיו שולפים את הספק, רושמים לו הוצאות ותשלומים.

כשמשהו לא תקין:

ספק עם ח.פ. שכבר קיים: 409 "לא ניתן להוסיף ספק חדש: ספק עם ח.פ. זה כבר קיים", ולא נפתח כרטיס כפול.
סעיף הוצאה שלא קיים: 400. את המספרים הנכונים לוקחים מ-expense_lists.
מפתח "קריאה בלבד": 403 "מפתח זה מוגדר לקריאה בלבד".

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

שליפת ספק: supplier_get

שולחים supplier_id, ומקבלים את הכרטיס: השם, הח.פ., פרטי הקשר, קוד החשבון (account_code), ושדות הספק עצמם, כולל אחוז הניכוי, התוקף, תנאי התשלום וסעיף ההוצאה.

{
  "api_token": "<המפתח שלכם>",
  "supplier_id": 9120
}

ספק שהוגדר בביג בוס כ"לא פעיל" לא חוזר: התשובה היא 204 "ספק לא נמצא".

רשימת ספקים: supplier_list

supplier_list מחזירה את הספקים הפעילים בעמודים: page, page_size, total_count ו-suppliers, כמו רשימת הלקוחות כשמבקשים אותה בעמודים. ב-search מחפשים ספק לפי שם.

{
  "api_token": "<המפתח שלכם>",
  "search": "ספק לדוגמה",
  "page": 1
}

כשאין ספק שמתאים: 204 "לא נמצאו ספקים". ספק "לא פעיל" לא מופיע ברשימה.

נסו את מערכת ביג בוס לניהול העסק ל-45 יום בחינם >>

יתרה ומסמכים פתוחים

supplier_balance: מקבלת supplier_id ומחזירה את היתרה של הספק.
supplier_open_documents: מחזירה את המסמכים שעוד פתוחים מול הספק, כמו customer_open_documents בלקוח. כשהכול סגור: 204 "אין מסמכים פתוחים לספק".

בבדיקה שלנו, אחרי שתשלום דרך ה-API סגר את ההוצאה היחידה של הספק, supplier_open_documents החזירה 204. איך רושמים את התשלום: הוצאות ותשלום לספק דרך ה-API.

הרשימות שצריך לפני שמתחילים: expense_lists

expense_lists מקבלת רק את המפתח ומחזירה שלוש רשימות:

expense_accounts: סעיפי ההוצאה, עם המספר שלהם. את המספר שולחים ב-expense_account_id.
vat_reclaim_types: סוגי המע״מ לקיזוז.
bank_accounts: חשבונות הבנק של העסק.

כדאי לשלוף אותן פעם אחת, כשמחברים את המערכת, ולשמור את המספרים אצלכם.

מפתח לקריאה בלבד

supplier_get, supplier_list, supplier_balance, supplier_open_documents ו-expense_lists רק קוראות, ולכן הן עובדות גם במפתח "קריאה בלבד". הוספת ספק צריכה מפתח "קריאה וכתיבה".

איך ביג בוס עוזרת לפתוח ספקים מתוך המערכת שלכם, ומה היא לא עושה

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

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

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

נסו את מערכת ביג בוס לניהול העסק ל-45 יום בחינם >>

יש שאלה לפני שמתחילים? דברו איתנו