מרכז הידע / ממשקים - ישן לפני שנת 2020

יצירת מסמך (חשבונית / קבלה וכו') לעסקת אשראי. (לעסקת פ.נמוך ראשונית או חיוב אסימון)

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

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

    מקרא:
    פרמטר אדום - חובה
    פרמטר מודגש - מומלץ
    פרמטר לא אדום ולא מודגש - אופציונלי

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

מספר פרמטר ערכים אפשריים לדוגמה תיאור
 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 -  שקל
2  - דולר 
978 - אירו
ראה רשימת קודי מטבעות נוספים - רשימת קודי מטבעות

 מטבע מסמך -
תקף רק בהפקת מסמך ללא חיוב,
במידה ומפיקים מסמך עם חיוב המטבע נקבע לפי מטבע חיוב אשראי
 13 InvoiceHead.ExtIsVatFree true = ללא מע"מ האם המסמך כולו הוא ללא מע"מ - מתאים ללקוח חו"ל
 14  InvoiceHead.ManualInvoiceNumber    מספור ידני של המסמך. ניתן לשימוש רק ביצירת מסמך ללא חיוב. יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה. ראה הערות בסוף המאמר.

במקרים נדירים ניתן להעביר את מספר החשבוניות שהמערכת תיצור במקום להשתמש במונה הפנימי של המערכת. שים לב! במידה וישנה התנגשות במונים החשבונית לא תיווצר , יש לבקש הרשאה מיוחדת לשימוש בפרמטר זה.
 15  InvoiceHead.IsAutoCreateUpdateAccount false - כל הלקוחות ירשמו על "לקוחות שונים".

true - יפתח כרטיס לקוח לכל עסקה , ומידה וקים יבוצע שיוך ללקוח לפי ההסבר.

האם ליצור ללקוח כרטיס לקוח במערכת.
מצב זה חובה להעביר את פרמטר: InvoiceHead.CompID - ת.ז. / ח.פ. של הלקוח.
אם הלקוח כבר קיים לא יפתח כרטיס חדש.

במידה ולא מועבר יתבצע איתור לפי  מפתח זר ולאחר מכן לפי מזהה ייחודי אתר ואז לפי  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
  • מאפשר ערבוב של פריטים עם מע"מ וללא מע"מ בחשבונית אחת. האם המחיר שורה פטור  מע"מ. ברוב המקרים "לא".
  • במידה וכול החשבונית היא ללא מע"מ יש להשתמש בפרמטר InvoiceHead.ExtIsVatFree של כותרת החשבונית.

 

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

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 ספרות אחרי הנקודה העשרונית.

* ניתן לתת שורת הנחה במינוס , אך יש לדאוג שסה"כ סכום החשבונית יהיה תואם בדיוק לסכום העסקה.

האם המאמר הזה עזר לך?