יבוא קבלות (kupain)

קובץ פרמטרים

הקליקו כאן להורדת קובץ prm.

רשימת שדות

Field	Remarks	Required	Type	Max length
accountKey		Required	alpha numeric	15	מפתח לקוח
docNumber	מספר זה לא נשמר בעת הפקת הקבלה בחשבשבת	Required	Numeric	9	מספר קבלה
transType	בהתאם לטבלת סוגי תנועה בהמשך בסוג תנועה מציינים את מספר המסמך שיווצר	Required	Numeric	3	סוג התנועה
payDate			Date	10	תאריך הקבלה
dueDate			Date	10	תאריך ערך (פרעון)
details			alpha numeric	250	פרטים
cheqNumber			Numeric	9	מספר השק
bankNumber			Numeric	3	מספר בנק
branch			Numeric	5	מספר סניף
bankAccNum			Numeric	9	מספר חשבון בנק
suF			Decimal	9.2	סכום בשקלים
suFDlr			Decimal	9.2	סכום מט"ח
currency	מטבע לפי טבלת המטבעות. שדה מטבע מוביל קובע האם הקבלה שקלית או מט"ח.		alpha numeric	5	מטבע מוביל בקבלה
currencyDlr	מטבע לפי טבלת המטבעות		alpha numeric	5	מטבע שערוך בתנועה
payments			Numeric	2	מספר תשלומים באשראי
creditFirm			alpha numeric	50	שם כרטיס אשראי
cheqsCustomerID			alpha numeric	11	תעודת זהות
stockDetails			alpha numeric	250	פרטים במסמך
stockAgent			Numeric	9	סוכן
stockBranchid			Numeric	9	סניף
stockReference			Numeric	9	אסמכתא נגדית
stockRemarks			alpha numeric	250	הערות
stockAccountName			alpha numeric	50	שם חשבון
stockAddress			alpha numeric	50	כתובת
stockCity			alpha numeric	50	עיר
stockPhone			alpha numeric	50	טלפון
4Digits			alpha numeric	4	ארבע ספרות
FirstPayment			Decimal	9.2	תשלום ראשון
stockExtraText1			alpha numeric	50	הערה נוספת 1
stockExtraText2			alpha numeric	50	הערה נוספת 2
stockExtraText3			alpha numeric	50	הערה נוספת 3
stockExtraText4			alpha numeric	50	הערה נוספת 4
stockExtraText5			alpha numeric	50	הערה נוספת 5
stockExtraSum1			Decimal	9.2	סכום נוסף 1
stockExtraSum2			Decimal	9.2	סכום נוסף 2
stockExtraSum3			Decimal	9.2	סכום נוסף 3
stockExtraDate1			Date	10	תאריך נוסף 1
stockExtraDate2			Date	10	תאריך נוסף 2
stockExtraNum1			Numeric	9	מספר נוסף 1
stockExtraNum2			Numeric	9	מספר נוסף 2

סוגי תנועה

קיימות 2 שיטות לקלוט בחשבשבת קבצי קופה: ממשק קופה זמני וממשק קופה קבוע. קיים הבדל בין סוגי המסמכים ושיטת העבודה של כל שיטה. להלן הסבר קצר:

	קופה	קופה זמני
מיועד ל....	לקוחות שהפיקו קבלות בתוכנה אחרת (מזומן, שקים אשראי) ומעונינים לקלוט בחשבשבת את המסמך כקבלת סוכן ולייצר על פי הצורך פקודת יומן בהנה"ח.	עסקים המקבלים תשלום בכרטיסי אשראי בחנות וירטואלית או תוכנה זרה אחרת, ומעונינים לייצר קבלות זמניות במאגר ייחודי בכדי להפיק בחשבשבת קבלת מקור
סוגי התנועה שניתן לקלוט המושג בממשק הוא סוג תנועה אך מתייחס לקליטת סוג מסמך	1 - שק בקבלת מקור 2 - מזומן בקבלת מקור 3 – שובר אשראי בקבלת מקור 11 – שק בקלת סוכן 12- מזומן בקבלת סוכן 13 – שובר אשראי בקבלת סוכן 21 – שק מחשבונית מס וקבלה 22 – מזומן מחשבונית מס וקבלה 23 – שובר אשראי מחשבונית מס קבלה	33 – שובר אשראי בקבלה 43 – שובר אשראי בקבלת תרומה
הפקת מסמך מסוג	קבלת סוכן	הממשק יוצר קבלה במאגר זמני. בהמשך ניתן להפיק: קבלה קבלת מט"ח קבלת תרומה קבלת תרומה מט"ח
פקודת יומן	ניתן לבחור לייצר בהגדרת מסופון 2	פקודת היומן נוצרת בעת הפקת קבלת המקור בפועל.
הפקה לדואל	לא רלוונטי. המסמך נקלט כקבלת סוכן. ניתן כמובן להפיק העתק משוחזר לדואל על פי איש קשר או רשומת חשבון.	בכדי שקבלה שנקלטה בממשק קבלה לזמני תופק לדוא"ל, יש לייבא את כתובת הדואל של הלקוח בקליטת הממשק לשדה הערה נוספת 5 / דוא"ל.

בדיקות מיוחדות והערות

• השדות מפתח לקוח, מספר קבלה וסוג תנועה הם חובה בקליטת תנועות לקובץ קופה.

• כל תנועה חייבת לכלול סכום (סכום שקל או סכום מטח).

• אם בקובץ הממשק לא מעבירים שדה תאריך או שדה תאריך ערך, ברירת המחדל תהיה תאריך המערכת במחשב בעת קליטת הממשק בחשבשבת.

• שדה מטבע מוביל בקבלה קובע האם זו קבלה בשקלים או קבלה במט"ח.

• אם לא מעבירים שדה מטבע מוביל בקבלה – ברירת המחדל היא שקל.

• אם מטבע הקבלה הוא שקל סכום התנועה נרשם בשדה סכום בשקלים. ניתן לשערך את הסכום השקלי למטבע זר. רושמים את הסכום המשוערך בשדה סכום במט"ח ואת מטבע השערוך בשדה מטבע שערוך.

• אם לא מועבר מטבע שערוך, ברירת המחדל היא מטבע מוביל לשערוך כפי שנרשם בהגדרות חברה.

• אם מטבע הקבלה הוא מט"ח סכום התנועה נרשם בשדה סכום מט"ח. אפשר לשערך את הסכום במט"ח לשקלים ולרשום את הסכום המשוערך בשדה סכום בשקלים. אין צורך לרשום את מטבע השערוך בתנועה.

• ממשק אשראי כולל שני תצורות תשלום: רגיל ותשלומים.

• יש לוודא שכרטיס קופת תלושי שי וכל כרטיסי האשראי (גם אם אינם בשימוש בפועל) מוגדרים במסך הגדרות חברה > הגדרות קופה > הגדרות קופה - אשראי.

• בעסקת תשלומים, מספר התשלומים צריך לכלול את התשלום הראשון. לדוגמה: עסקה בסך 250 שקלים ב- 5 תשלומים, תשלום ראשון 50 ש', התוכנה תוסיף אוטומטית עוד 4 תשלומים של 50 ש' כל אחד. ניתן לקבוע גם תשלומים שונים, לדוגמה: תשלום ראשון 40 ש', התוכנה תוסיף אוטומטית עוד 4 תשלומים של 52.50 ש' כל אחד.

• מספר הקבלה הוא שדה חובה שיש להעביר בקובץ KUPAIN.DAT. יש לשתול בשדה זה ערך נומרי לבחירתכם. מספר זה לא ישמר בהמשך. מספר הקבלה נקבע בפועל בעת הפקת הקבלה מהמאגר הזמני בתוכנת חשבשבת בהתאם לספרור המסמכים בחברה.

• אם כתובת הדוא"ל לא מועברת בשדה הערה נוספת 5 הקבלה תודפס במדפסת (ולא תישלח בדוא"ל).

• מומלץ לשמור את מספר האסמכתא של תנועת התשלום המקורית, שהופקה בתוכנה אחרת, באחד השדות הנוספים לבחירתכם. אם תעדכנו את אחד השדות הנומריים: אסמכתא נגדית, מספר נוסף 1, מספר נוסף 2, הערכים שלהם ירשמו גם בפקודת היומן שתיווצר בעת הפקת הקבלה בחשבשבת.

שדה בממשק	שדה בפקודת יומן
אסמכתא נגדית	אסמכתא
מספר נוסף 1	אסמכתא 4
מספר נוסף 2	אסמכתא 5

דוגמת JSON

[
    {
        "Remarks": "712",
        "accountKey": "100",
        "docNumber": "888",
        "transType": 3,
        "payDate": "23/05/2022",
        "suF": "195.74",
        "creditFirm": "ויזה",
        "cheqsCustomerID": "203463393",
        "stockPhone": "0525646024",
        "4Digits": "1880"
    }
]