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

רשימת שדות

Field	Remarks	Type	Max length
accountKey Required		alpha numeric	15	מפתח לקוח
docNumber Required	מספר זה לא נשמר בעת הפקת הקבלה בחשבשבת	Numeric	9	מספר קבלה
transType Required	בהתאם לטבלת סוגי תנועה בהמשך בסוג תנועה מציינים את מספר המסמך שיווצר	alpha numeric	3	סוג התנועה
payDate		Date	8	תאריך הקבלה
dueDate		Date	8	תאריך ערך (פרעון)
details		alpha numeric	20	פרטים
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	20	שם כרטיס אשראי
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	30	טלפון
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	8	תאריך נוסף 1
stockExtraDate2		Date	8	תאריך נוסף 2
stockExtraNum1		Numeric	9	מספר נוסף 1
stockExtraNum2		Numeric	9	מספר נוסף 2
contactmail		alpha numeric	250	דוא"ל איש קשר
Voucher_Number		Numeric	50	מספר שובר
Ref3		Numeric	9	אסמכתא3
CostCode		alpha numeric	8	קוד תמחיר

סוגי תנועה

קיימות 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

• שמות כרטיסי האשראי בקובץ שנשלח חייבים להיות בדיוק לפי השמות המצוינים וללא תוספות:
  • ויזה
  • ישראכרט
  • אמריקן אקספרס
  • דיינרס
  • אלפא קארד/לאומי קארד
  • JCB

הגדרה כללית במסופון 2

הגדרת קובץ ה-batch

דוגמת JSON

{
    "station": "0******a-****-****-****-d*********a",
    "plugin": "kupain",
    "company": "d*****i",
    "message": {
        "netPassportID": "25***2",
        "pluginData": [
            {
                "accountKey": "30******34",
                "docNumber": "51006",
                "transType": "13",
                "suF": "1.68",
                "4Digits": "0638",
                "creditFirm": "ישראכרט",
                "stockRemarks": "תשלום עבור הזמנה:16046 מס אישור: 112303354"
            }
        ]
    },
    "signature": "7***********************3"
}