רשימת פרמטרים שיש להעביר על מנת ליצור מסמך בנוסף לעסקת אשראי.
- יש להוסיף את הפרמטרים באותה פנייה קיימת של בקשה לחיוב.
- יש לדאוג שסה"כ שורות החשבונית שווה לסכום החיוב בבקשה לחיוב. סה"כ עלות של שורה בחשבונית היא: מחיר * כמות.
- ב-Web Service המחלקות לשימוש הם: ראש חשבונית: InvExtHead. שורות חשבונית : InvExtHeadLines
- יש לבצע urlencode לכול הערכים המועברים.
- במידה ומשתמשים ב http post יש להוסיף פרמטר codepage=65001 האומר את קידוד UNICODE של הנתונים בעברית.
- אין להעביר תווים אסורים ב ערך עצמו , כמו:
אמפרסנט & נקודה פסיק ; גרשיים "
( לדוגמא בתיאור לחשבונית שלא יהיה פריט עם תווים אלה )
מקרא:
פרמטר אדום - חובה
פרמטר מודגש - מומלץ
פרמטר לא אדום ולא מודגש - אופציונלי
טבלת פרמטרים כותרת מסמך
| מספר | פרמטר | ערכים אפשריים לדוגמה | תיאור |
| 1 |
InvoiceHead.CustName |
אלי כהן בע"מ |
שם לקוח / חברה למסמך |
| 2 | InvoiceHead.SendByEmail | true | האם לשלוח מסמך בדואר אלקטרוני. במידה וכן יש לציין כתובת דואר. |
| 3 | InvoiceHead.Language | he - עברית en - אנגלית |
שפת המסמך |
| 4 | InvoiceHead.Email | israel@gmail.com | כתובת דואר הלקוח , שלשם ישלח המסמך. |
| 5 | InvoiceHead.CustAddresLine1 | Saharov 22 | כתובת לקוח, שורה ראשונה |
| 6 | InvoiceHead.CustAddresLine2 | P.O. 1234 | כתובת לקוח, שורה שנייה |
| 7 | InvoiceHead.CustCity | Reshon-Le-Zion | עיר |
| 8 | InvoiceHead.CustLinePH | 03-9619611 | טלפון קווי |
| 9 | InvoiceHead.CustMobilePH | 0549876543 | טלפון נייד (במודול SMS ישלח SMS לנייד זה) |
| 10 | InvoiceHead.CompID | 040617640 | מספר ת.ז. או ח.פ חברה |
| 11 | InvoiceHead.Comments | דוגמא: אחריות של שנה מיום החשבונית (עד 250 תווים ) | הערות למסמך - יודפסו במסמך למטה |
| 12 | InvoiceHead.CoinID |
1 - שקל |
מטבע מסמך - תקף רק בהפקת מסמך ללא חיוב, במידה ומפיקים מסמך עם חיוב המטבע נקבע לפי מטבע חיוב אשראי |
| 13 | InvoiceHead.ExtIsVatFree | true = ללא מע"מ | האם המסמך כולו הוא ללא מע"מ - מתאים ללקוח חו"ל |
| 14 | InvoiceHead.ManualInvoiceNumber | מספור ידני של המסמך. ניתן לשימוש רק ביצירת מסמך ללא חיוב. יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה. ראה הערות בסוף המאמר. במקרים נדירים ניתן להעביר את מספר החשבוניות שהמערכת תיצור במקום להשתמש במונה הפנימי של המערכת. שים לב! במידה וישנה התנגשות במונים החשבונית לא תיווצר , יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה. |
|
| 15 | InvoiceHead.IsAutoCreateUpdateAccount | false - כל הלקוחות ירשמו על "לקוחות שונים". true - יפתח כרטיס לקוח לכל עסקה , ומידה וקים יבוצע שיוך ללקוח לפי ההסבר. |
האם ליצור ללקוח כרטיס לקוח במערכת. במידה ולא מועבר יתבצע איתור לפי מפתח זר ולאחר מכן לפי מזהה ייחודי אתר ואז לפי EMAIL לקוח. (הפרמטר הראשון שנמצא בשרת מוצא ולא ממשיך לחפש עוד ) |
| 16 | InvoiceHead.AccountForeignKey | 1234 (String) | מספר מפתח זר של הלקוח - פעיל רק אם יוצר ללקוח כרטיס לקוח. (מספר הנח"ש) |
| 17 | InvoiceHead.Date | dd/MM/yyyy | תאריך המסמך - ניתן להעביר תאריך מסמך במבנה dd/MM/yyyy - לא חובה, לפי חוק ניתן להפיק עד 14 יום אחורה. (לא פעיל בדף פרופיל נמוך) |
| 18 | InvoiceHead.DepartmentId | 123 (int) | קוד מחלקה להצגה בדוחות והעברה להנח"ש ראה הגדרת המחלקות במסוף: מיון ושימוש במחלקות |
| 19 | InvoiceHead.SiteUniqueId | (String) | מזהה ייחודי לאתר - פרמטר אינפורמטיבי. (מזהה נוסף) |
| 20 | InvoiceHead.AccountID | (int) 123 | מספר הלקוח במערכת אישורית זהב לשיוך המסמך (לא פעיל בעסקה מושהית) |
| 21 | InvoiceHead.ValueDate | dd/MM/yyyy | תאריך ערך למסמך, (לא פעיל בדף פרופיל נמוך) |
| 22 | InvoiceHead.ExternalId | (String) | מזהה מערכת חיצוני ברמת מסמך בלבד (לא נשמר ברמת כרטיס לקוח) |
| 23 | InvoiceHead.IsLoadInfoFromAccountID | true | בהפקת מסמך ידני בלבד, האם למשוך את פרטי הלקוח |
פרטי החשבוניות- שורות המסמך |
|||
|
InvoiceLines.Description |
קורס אינטרנטי | תיאור המוצר | |
| InvoiceLines.Price | 50 | מחיר יחידה של פריט לחיוב. | |
| InvoiceLines.Quantity | 1 | כמות הפריטים בהעברה של כמות מעל 1, יש להכפיל במחיר ולשלוח אמצעי תשלום מתאים. |
|
| InvoiceLines.ProductID | ZZASA AASSA - 12 | קוד פריט, מק"ט, קוד מוצר - מומלץ להעביר לשם דוחות, ניתן לראות ב דוח פריטים במסמך | |
| InvoiceLines.IsVatFree | false true |
|
|
פרמטרים לשורה ראשונה במסמך:
InvoiceLines1.Description=Item1&InvoiceLines1.Price=200.50&InvoiceLines1.Quantity=2
פרמטרים לשורה שניה במסמך :
InvoiceLines2.Description=Item2&InvoiceLines2.Price=200.50&InvoiceLines2.Quantity=2
פרמטרים לשורה שלישית במסמך :
InvoiceLines3.Description=Item3&InvoiceLines3.Price=100&InvoiceLines3.Quantity=3
הערות :
1. פרמטר ManualInvoiceNumber במבנה ראש המסמך: במקרים נדירים ניתן להעביר את מספר החשבוניות שהמערכת תיצור במקום להשתמש במונה הפנימי של המערכת. שים לב! במידה וישנה התנגשות במונים החשבונית לא תיווצר , יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה.
* במקרים של מספרים עשרוניים - יש לעשות חישוב ולקצץ בהתאם ל 2 ספרות אחרי הנקודה העשרונית.
* ניתן לתת שורת הנחה במינוס , אך יש לדאוג שסה"כ סכום החשבונית יהיה תואם בדיוק לסכום העסקה.
הערות
0 הערות
היכנס למערכת כדי להגיב.