יצירה או עריכת ספק ב-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		לא	ת.ז או ח.פ שיופיעו על גבי המסמך
email		לא	כתובת אימייל
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 של הספק, שבו משתמשים כדי לעדכן אותו בהמשך.