יצירה או עריכת ספק ב-API
- ניתן לפנות ל- API של Invoice Maven באמצעות בקשת JSON.
- יש לפנות באמצעות POST .
- החיבור צריך להתבצע באמצעות SSL (פורט 443).
- לכל פניה יתווסף מפתח API שהוא בעצם מזהה חד ערכי לחשבון הספק במערכת.
- לאחר הפניה ליצירת ספק השרת יחזיר תשובה בפורמט JSON המציינת האם הפעולה הצליחה ואם לא את קוד ותיאור השגיאה.
- את שמות השדות המועברים יש לכתוב ב- lowercase בלבד.
- הקידוד של הפניה צריך להיות UTF-8.
בקשה ליצירה או עריכה של ספק – AddOrUpdateSupplier
יש לפנות לכתובת:
https://app.invoice-maven.co.il/api/suppliers/addOrUpdateSupplier
יש להעביר את הפרמטרים הבאים בפורמט JSON:
שדות כלליים:
| שדה | ברירת מחדל | חובה | תיאור |
| api_key | כן | מפתח ייחודי המשוייך לעסק במערכת ויש להעביר אותו עם כל בקשה. | |
| test | כן | האם להקים ספקים לבדיקה בלבד (יש להעביר 1 כדי לבצע בדיקות לפני הפקת מסמכים אמיתיים):
0- יצירת ספק אמיתי 1- הקמת ספקים לבדיקה. במצב זה יוקם לקח ללא שמירה במערכת. |
|
| contact_email | כן | אימייל של מפתח התוכנה ליצירת קשר במקרה של בעיה. | |
| contact_phone | כן | טלפון של מפתח התוכנה ליצירת קשר במקרה של בעיה. | |
| supplier_id | לא | מספר מזהה יחודי לבקשה. במידה ויתקבלו 2 פניות עם אותו מזהה, בפניה השניה לא יוקם ספק. | |
| id | לא | GUID של הספק, כפי שהוחזר ביצירה. אם נמצא ספק לפי id, לפי identification או לפי email (בסדר הזה), הוא יעודכן. אחרת ייווצר ספק חדש. | |
| name | כן | שם הספק | |
| address | לא | כתובת | |
| city | לא | עיר | |
| zip_code | לא | מיקוד | |
| identification | לא | ת.ז או ח.פ שיופיעו על גבי המסמך | |
| לא | כתובת אימייל | ||
| cell_phone | לא | נייד | |
| fax | לא | פקס | |
| phone_number | לא | טלפון | |
| country_code | לא | קוד מדינה בתקן ISO, למשל IL לישראל או US לארה"ב. קוד שאינו מוכר מחזיר שגיאה. | |
| emails | לא | מערך של כתובות מייל נוספות, למשל ["a@example.com", "b@example.com"]. הכתובות נשמרות בנוסף ל-email. אם לא נשלח email, הכתובת הראשונה במערך תשמש כמייל הראשי. בכל עדכון רשימת המיילים נכתבת מחדש מתוך email ו-emails, ולכן יש לשלוח בכל עדכון את כל הכתובות הנוספות שרוצים לשמור. | |
| bank_name | לא | קוד הבנק (מספר, לא שם), עד 2 ספרות בלבד. לדוגמה 12 = הפועלים, 10 = לאומי. שליחת ערך ריק מוחקת את הערך הקיים. | |
| bank_branch | לא | מספר הסניף, עד 3 ספרות בלבד. שליחת ערך ריק מוחקת את הערך הקיים. | |
| bank_account_no | לא | מספר החשבון, עד 9 ספרות בלבד. שליחת ערך ריק מוחקת את הערך הקיים. | |
| occasional_yn | 0 | לא | ספק מזדמן: 1 = מזדמן, 0 = קבוע. זהה לתיבת הסימון "ספק מזדמן" בכרטיס הספק. בעדכון, אם לא נשלח, הערך הקיים נשמר. |
| מפתח של שדה מותאם | לא | ערך לשדה מותאם של הספק. שם השדה ב-JSON הוא מפתח השדה, כפי שמופיע בהגדרת השדות המותאמים. בשדה מסוג רשימת בחירה יש לשלוח את הטקסט של אחת האפשרויות, וערך שאינו ברשימה לא יישמר. |
אם הפעולה הצליחה, התשובה כוללת את השדה id: מזהה ה-GUID של הספק, שבו משתמשים כדי לעדכן אותו בהמשך.