סייר
 
אפשריות
Rss קטגורייות

טבלת פרמטרים : יצירת מסמך (חשבונית / קבלה וכו)

מספר מאמר: AA-00244 צפיות: 10295 נוצר: 06/05/2012 11:02 עדכון אחרון: 22/10/2017 16:46 50 דירוג/ 1 מצביע

טבלת פרמטרים : יצירת מסמך (חשבונית / קבלה וכו)

מאמר זה מסביר את הפרמטרים שיש להעביר על מנת ליצור מסמך . 

הערות:

  1. יש להוסיף את הפרמטרים באותה פנייה קיימת של בקשה לחיוב.
  2. יש לדאוג שסה"כ שורות החשבונית שווה לסכום החיוב בבקשה לחיוב.
  3. סה"כ עלות של שורה בחשבונית היא: מחיר*כמות.
  4. שדות באדום הם שדות חובה.
  5. ישנה דוגמה מתודית בסוף המאמר כיצד להעביר מספר שורות לחשבונית ב https post.
  6. ב-Web Service  המחלקות לשימוש הם: ראש חשבונית: InvExtHead. שורות חשבונית : InvExtHeadLines
  7. יש לבצע urlencode לכול הערכים המועברים.
  8. במידה ומשתמשים בhttp post יש להוסיף פרמטר  codepage=65001  האומר את קידוד UNICODE  של הנתונים בעברית.


טבלת פרמטרים כותרת מסמך :

פרמטר תיאור ערכים אפשריים לדוגמה
InvoiceHead.CustName שם לקוח למסמך yaniv
 InvoiceHead.SendByEmail  האם לשלוח מסמך בדואר אלקטרוני. במידה וכן יש לציין כתובת דואר.  true
 InvoiceHead.Language  שפת המסמך  he - עברית
en - אנגלית
 InvoiceHead.Email  כתובת דואר לקוח, לשם שתשלח המסמך.  yaniv@site.com
InvoiceHead.CustAddresLine1 כתובת לקוח , שורה ראשונה Saharov 22
InvoiceHead.CustAddresLine2 כתובת לקוח, שורה שנייה P.O. 1234
InvoiceHead.CustCity עיר Reshin-Le-Zion
InvoiceHead.CustLinePH טלפון קווי 972-3-9619611
InvoiceHead.CustMobilePH טלפון נייד 0549876543
InvoiceHead.CompID מספר ת.ז. או ח.פ חברה 040617640
InvoiceHead.Comments הערות למסמך - יודפסו במסמך למטה
דוגמא:אחריות של שנה מיום החשבונית( 250 תווים )
InvoiceHead.CoinID מטבע מסמך -
תקף רק בהפקת מסמך ללא חיוב ,
במידה ומפיקים מסמך עם חיוב המטבע נקבע לפי מטבע חיוב אשראי
1- שקל
2 - דולר 
אחרת לפי מאמר : רשימת קודי מטבעות לחיוב
InvoiceHead.ExtIsVatFree האם המסמך הוא ללא מע"מ - מתאים ללקוח חו"ל true = ללא מע"מ
 InvoiceHead.ManualInvoiceNumber   מספור ידני של המסמך. ניתן לשימוש רק ביצירת מסמך ללא חיוב. יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה. ראה הערות בסוף המאמר.  
 InvoiceHead.IsAutoCreateUpdateAccount האם ליצור ללקוח כרטיס לקוח במערכת.
מצב זה חובה להעביר את פרמטר: InvoiceHead.CompID - ת.ז. / ח.פ. של הלקוח.
אם הלקוח כבר קיים לא יפתח כרטיס חדש.

במידה ולא מועבר יתבצע איתור לפי  מפתח זר ולאחר מכן לפי מזהה יחודי אתר ואז לפי  EMAIL לקוח.
false - כל הלקוחות ירשמו על "לקוחות שונים".

true - יפתח כרטיס לקוח לכל עיסקה , ומידה וקים יבוצע שיוך ללקוח לפי ההסבר.
 InvoiceHead.AccountForeignKey מספר מפתח זר של הלקוח - פעיל רק אם יוצר ללקוח כרטיס לקוח.
(מספר הנח"ש)
 (String)
 InvoiceHead.Date תאריך המסמך - ניתן להעביר תאריך מסמך במבנה   dd/MM/yyyy - לא חובה .
(לא פעיל בדף פרופיל נמוך)
28/02/2014 
 InvoiceHead.DepartmentId קוד מחלקה להצגה בדוחות והעברה להנח"ש. 123  (int)
 InvoiceHead.SiteUniqueId מזהה יחודי לאתר - פרמטר אינפורמטיבי.
(מזהה נוסף)
 (String)
 InvoiceHead.AccountIDמספר הלקוח במערכת אישורית זהב לשיוך המסמך
(לא פעיל בעסקה מושהת )
 (int) 123

טבלת פרמטרים שורות המסמך :

 
פרמטר תיאור ערכים אפשריים לדוגמה
InvoiceLines.Description תיאור המוצר  Intel Computer
InvoiceLines.Price מחיר יחידה של פריט לחיוב. 1559
InvoiceLines.Quantity
כמות הפריטים 1
InvoiceLines.IsPriceIncludeVAT לא פעיל ! חייב להיות true true
InvoiceLines.ProductID קוד פריט - מומלץ להעביר לשם דוחות ZZASA AASSA - 12
 InvoiceLines.IsVatFree
  • מאפשר ערבוב של פריטים עם מע"מ וללא מע"מ בחשבונית אחת.האם המחיר שורה פטור  מע"מ. ברוב המקרים "לא".
  • במידה וכול החשבונית היא ללא מע"מ יש להשתמש בפרמטר InvoiceHead.ExtIsVatFree של כותרת החשבונית.

 false 
true

הערות :

1. פרמטר ManualInvoiceNumber במבנה ראש המסמך : במקרים נדירים ניתן להעביר את מספר החשבוניות שהמערכת תיצור במקום להשתמש במונה הפנימי של המערכת. שם לב! במידה וישנה התנגשות במונים החשבונית לא תיוצר , יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה.

2.במקרים של מספרים עשרוניים - יש לעשות חישוב ולקצץ בהתאם ל 2 ספרות אחרי הנקודה העשרונית


דוגמה מתודית ליצירת חשבונית HTTPS POST במספר שורות

שם לב שעל מנת ליצור מספר שורות יש למספר את הקידות של שורות לחשבונית , InvoiceLines1.Description אומר שורה ראשונה , InvoiceLines2.Description אומר שורה שנייה.

פרמטרים לראש המסמך :

InvoiceHead.CustName=Yaniv&InvoiceHead.Languge=he&InvoiceHead.CoinID=1&InvoiceHead.Email=test@gmail.com

פרמטרים לשורה שנייה במסמך:

InvoiceLines1.Description=Item2&InvoiceLines1.Price=200.50&InvoiceLines1.Quantity=2&InvoiceLines1.IsPriceIncludeVAT=true

פרמטרים לשורה שנייה במסמך:

InvoiceLines2.Description=Item2&InvoiceLines2.Price=200.50&InvoiceLines2.Quantity=2&InvoiceLines2.IsPriceIncludeVAT=true

פרמטרים לשורה שלישית במסמך:

InvoiceLines3.Description=Item3&InvoiceLines3.Price=100&InvoiceLines3.Quantity=3&InvoiceLines3.IsPriceIncludeVAT=true


הערות
  • אין הערות למאמר זה.
תמיכה 03-9436100
כל הזכויות שמורות לחברת קארדקום בע"מ