מרכז הידע / ממשקים - ישן לפני שנת 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 ספרות אחרי הנקודה העשרונית.

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

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