יצירת ספק ב-API
- ניתן לפנות ל- API של Invoice Maven באמצעות בקשת JSON.
- יש לפנות באמצעות POST .
- החיבור צריך להתבצע באמצעות SSL (פורט 443).
- לכל פניה יתווסף מפתח API שהוא בעצם מזהה חד ערכי לחשבון הספק במערכת.
- לאחר הפניה ליצירת ספק השרת יחזיר תשובה בפורמט JSON המציינת האם הפעולה הצליחה ואם לא את קוד ותיאור השגיאה.
- את שמות השדות המועברים יש לכתוב ב- lowercase בלבד.
- הקידוד של הפניה צריך להיות UTF-8.
בקשה להפקת ספק – AddSupplier
יש לפנות לכתובת:
https://app.invoice-maven.co.il/api/suppliers/addSupplier
יש להעביר את הפרמטרים הבאים בפורמט JSON:
שדות כלליים:
שדה | ברירת מחדל | חובה | תיאור |
api_key | כן | מפתח ייחודי המשוייך לעסק במערכת ויש להעביר אותו עם כל בקשה. | |
test | כן | האם להקים ספקים לבדיקה בלבד (יש להעביר 1 כדי לבצע בדיקות לפני הפקת מסמכים אמיתיים):
0- יצירת ספק אמיתי 1- הקמת ספקים לבדיקה. במצב זה יוקם לקח ללא שמירה במערכת. |
|
contact_email | כן | אימייל של מפתח התוכנה ליצירת קשר במקרה של בעיה. | |
contact_phone | כן | טלפון של מפתח התוכנה ליצירת קשר במקרה של בעיה. | |
supplier_id | לא | מספר מזהה יחודי לבקשה. במידה ויתקבלו 2 פניות עם אותו מזהה, בפניה השניה לא יוקם ספק. | |
name | כן | שם הספק | |
address | לא | כתובת | |
city | לא | עיר | |
zip_code | לא | מיקוד | |
identification | לא | ת.ז או ח.פ שיופיעו על גבי המסמך | |
לא | כתובת אימייל | ||
cell_phone | לא | נייד | |
fax | לא | פקס |