אשף יצירת חשבוניות

השתדלנו לייצר את פיתרון הבילינג הפשוט והמקיף ביותר שאפשר, אפילו לשוק הפיננסי (מוסדות כספיים).
הייפר תומכת במספר מנגנונים החל מהזנת תוכנית ידנית, הטבות מוגבלות בזמן ועד לאיסוף כמויות מידע גדולות (Big Data) למשל ממערכות טלפוניה או פרסום באינטרנט.
הייפר יודעת לייצר במהלך אחד חשבוניות במספר שפות / מטבעות, לפי הפרופיל של כל לקוח.
עבור לקוחות שמתעקשים לקבל חשבונית בדואר, היא תופק במדפסת המקומית ואח"כ ניתן להדפיס מעטפות עם כתובת דרך מחולל הדוחות (או להשתמש במעטפות חלון).

אשף ייצור חשבוניות - תוכנת הייפר

הוראות הפעלה

בראש העמוד תמצא פרמטרים להפעלת הדוח (אפשר לעצב את רשימת השדות לפי הצורך):
שם השדה תיאור
הגש חשבון עד לתאריך הרעיון הוא לחייב כל סעיף פתוח - עד לתאריך יעד (ברירת המחדל הוא היום האחרון של החודש הקודם).
מועד הפקת מקור כברירת מחדל השדה אמור להיות ריק ובחשבוניות ירשם זמן ההפקה האמיתי, באזור הזמן של המשתמש (הדרכה בעברית... אז ישראל).
באפשרותך לקבוע תאריך קודם ושעה (למשל 31.5.2023 12:00), עד שבועיים אחורה מהיום.
עבור לקוח בודד בכדי להפיק חשבונית ללקוח בודד, בחר אותו כאן. שדה ריק משמעותו הפקת חשבוניות לכלל הלקוחות.
טבלאות מידע לחיוב הלקוחות שדה לקריאה בלבד, מציג בפניך אילו טבלאות הולכות להיסרק לצורך בניית החשבוניות - בהתאם להגדרות המערכת והמודולים שאתה מפעיל.
  • Monthly Billing for Services טבלת הוראות קבע לחיוב חוזר.
    בד"כ מתמלאת ידנית או דרך API, כמות קטנה של רשומות לכל לקוח. הוראות ישנות מועברות לארכיון.
  • Crypto Currency Exchange Custody טבלת שירות משמורן עבור מטבעות קריפטו.
    בחברת קריפטו, החיובים ירוצו רק דרך הטבלה הזו, הטבלה הקודמת מושבתת כי היא משמשת אשף (תהליך עבודה) אחר.
  • hyp_Client 3rd Party Billing for Services טבלת בילינג בכמויות גדולות (Big Data).
    נכון לעכשיו היא אינה משתתפת באשף הזה, המצב הזה הולך להשתנות בקרוב.
הגש חשבון החל מתאריך אנחנו לא ממליצים להשתמש בשדה הזה, כברירת מחדל ערכו ריק ובמקור הוא חבוי מאיזור השדות (מטמיע המערכת נדרש לחשוף אותו).
השדה מאפשר לך לקבוע את התאריך שממנו יתחיל החיוב.
הסכנה היא לפספס חיובים מתאריכים הקודמים לערך שהזנת בשדה, האשף של הייפר כבר בנוי למנוע חיובים כפולים.
הסיבה לקיומו של השדה היא בעיקר הגירה מתוכנה קודמת אל הייפר והצורך למנוע חיובים על שנים קודמות.

מתחת לאיזור השדות, נמצא איזור לחצנים. בהתחלה כולם נסתרים עד להפקת דוח מוצלחת עם נתונים שאפשר לעבוד עליהם.
הפעל דוח מבצע שאילתות על הטבלאות הרלוונטיות ובונה עבורך רשימת חיובים פתוחים הממתינים להפקת חשבונית, בחלוקה לפי לקוחות ושיטת חיוב.
הלחצן אינו רושם מידע במסד הנתונים ולכן אפשר להריץ אותו "חופשי" (לחקור את מצב הבילינג עם פרמטרים שונים).

לאחר הפקת הדוח, בשדה (טור) "תיאור" יופיעו תיבות לסימון (check box) אשר כולן ריקות כברירת מחדל.
עבור השימוש בלחצנים הבאים יהיה עליך לסמן את מקצתן או את כולן, זה המקום להזכיר שבתפריט קליק ימני ע"ג הטור בטבלה אפשר לבחור "סמן/בטל בחירה בכל התיבות".
תצוגה מקדימה של החשבוניות מייצר תצוגה לפני הדפסה של החשבוניות, על פי השורות המסומנות (V בתיבה בשדה "תיאור"). לכל לקוח חשבונית אחת.
הלחצן אינו רושם מידע במסד הנתונים ולכן אפשר להריץ אותו "חופשי"...
הפק חשבוניות אמיתיות זהירות - כאן מופקות חשבוניות מס אמיתיות ונשלחות ללקוחות !
רק לאחר שבחנת היטב את הנתונים ואולי אף צפית ב- "תצוגה מקדימה של החשבוניות", רק אז אפשר להשתמש בלחצן הזה.
מכיוון שהפעולה אינה הפיכה (צריך להפיק זיכויים), הייפר שואלת עוד פעמיים בטרם הפקת החשבוניות מתחילה לרוץ.
עבור כל לקוח שלא יכול לקבל חשבונית אלקטרונית ("מסמך ממוחשב"), הייפר תדפיס במדפסת המקומית שלך. לכן עליך להיות ערוך ולהכיר כמה חשבוניות אמורות להיות מודפסות.

Monthly Billing for Services

טבלת הוראות קבע לחיוב חוזר וגם חד פעמי. הטבלה מיועדת לכמות רשומות נמוכה (גם מאות ללקוח זה מעט), בד"כ מוזנת ידנית (אפשר גם דרך API).
בפסקה הזאת אנחנו מתארים את האלגוריתם ולכן נשתמש בשמות השדות באנגלית (באפשרותך לצפות במבנה הטבלה בסימניה מצד ימין).
השדה
[Last Billing Date]
מכיל את התאריך האחרון בו השורה (רשומה) חוייבה בחשבונית. כלומר החיוב בחשבונית הקרובה הוא מהתאריך הזה ועד לתאריך היעד בפרמטר [הגש חשבון עד לתאריך].
להלן האלגוריתם לבניית פלט הדוח מתוך הטבלה הזו:
  1. האשף מבצע שאילתה על כל הרשומות שהשדה לוגיקה
    [Logic]
    בערכים 0 או 1 (שירות חודשי מתחדש וחיוב קבוע מתחדש).
    ושתאריך הסיום שלהן
    [Service Ends At]
    הינו ריק או גבוה מהשדה
    [Last Billing Date]
    באותה הרשומה.
  2. או רשומות שהשדה לוגיקה
    [Logic]
    שווה ל- 2 (חיוב חד פעמי) ושהשדה
    [Last Billing Date]
    ריק (כי אם חוייב פעם אחת אז לא חוזרים על זה).
  3. אחד משני הסעיפים הנ"ל וגם שערך השדה
    [Service Started From]
    קטן או שווה לפרמטר [הגש חשבון עד לתאריך].
  4. וגם שערך השדה
    [Last Billing Date]
    קטן מהפרמטר [הגש חשבון עד לתאריך].
  5. מכיוון שמנהל המערכת (הבכיר) יכול לערוך את הטבלה, כל הרשומות שהועלו בשאילתה הנ"ל מועברות דרך מסנן שגיאות.
    לסיום האשף מבצע את חישוב החיוב עבור כל רשומה והתוצאה מוסברת בהמשך (פלט הדוח).

Crypto Currency Exchange Custody

שם מקור הנתונים הזה הוא כינוי ידידותי לטבלה hyp_TPM Positions PnL History, במקור עבור בורסה/CFD אבל משמשת אותנו כטבלת שירות משמורן עבור מטבעות קריפטו.
מקור הנתונים הזה זמין אוטומטית אם החברה מוגדרת כברוקר של קריפטו וגם בהכרח נחסמת חלקית הטבלה הקודמת (משמשת אותנו להוראות קבע לרכישת מטבעות בכל חודש).
אם אינך מכיר את השדות והיישום בטבלה, בבקשה קרא את משמורת על מטבעות דיגיטליים של הלקוחות, הכל מוסבר שם.
להלן האלגוריתם לבניית פלט הדוח מתוך הטבלה הזו:
  1. האשף מבצע שאילתה על כל הרשומות שהשדה "יתרה לתחילת יום"
    [Beginning of Day]
    נמצא בטווח התאריכים של שני הפרמטרים:
    [הגש חשבון החל מתאריך] ברירת מחדל שדה חבוי וריק, מטמיע המערכת יכול לחשוף אותו. [הגש חשבון עד לתאריך].
  2. וגם שערך השדה
    [Hyper Status Flag]
    הינו ריק !   כל ערך אחר מסמל שהרשומה כבר טופלה ואין לחייב את הלקוח עבורה.
  3. כל רשומה במקור הנתונים הזה, מכילה את מחיר המשמורן היומי בשקלים (ללא מעמ) עבור מטבע X, לתאריך Y.
    האשף ממיין את הרשומות החוזרות בשאילתה, כך שיהיה אפשר לבנות שורת חיוב אחת (פלט) לכל לקוח ולכל מטבע דיגיטלי.
  4. בטבלת הפלט, השדות
    [השירות ניתן החל מתאריך]
    ו-
    [השירות הסתיים בתאריך]
    יכילו את טווח התאריכים של הרשומות היומיות שנסכמו באותה שורה.
    כל השורות יהיו בשקלים,
    [Exchange Rate] = 1;   [Logic] = 0;   [Factor] = 1;   [Quantity] = 1;

    המקט יהיה סימול המטבע והתיאור המילולי של השורה יהיה: "שירות משמורת עבור: Symbol"

שים לב ! לאחר ההסברים בסעיפים 2 עד 4 זה המקום להדגיש תכונה קריטית:
האשף מתוכנן כך שאתה יכול לבצע שאילתה על חצי שנה ולקבל רשומת פלט (לדוגמה) מ- 1.1.2024 ועד 30.6.2024 אבל בפועל חזרו רשומות יומיות רק על 100 ימים, כי השאר כבר חוייבו / טופלו.
במקרה הזה שורת הפלט תכיל את טווח התאריכים המלא אבל סכום החיוב יהיה רק על אותם 100 ימים שחזרו בשאילתה.
דוגמה נוספת היא במקרה שהרשומות היומיות שחזרו היו מתאריך 4.2.24 ועד 20.6.24 ואז אלו יהיו התאריכים שגם יופיעו ברשומת הפלט.

פלט הדוח - את מי מחייבים ועל מה

שם השדה תיאור
מספר לקוח ושמו קליק כפול או Enter על שורה, יפתח את תיק הלקוח.
תיאור ומק"ט התוכן שיכתב בחשבונית. הטקסט מועתק מטבלת הוראות החיוב, ניתן לעריכה בתיק הלקוח.
סה"כ כולל מע"מ שדה מחושב עם הסכום הסופי של הסעיף (השורה עצמה, לא כל החשבונית כי יתכנו מספר שורות בחשבונית).
החישוב הוא במטבע ניהול ספרים גם אם המוצר מתומחר במט"ח (כלומר אחרי שער המרה) ו/או אם הלקוח נמצא בחו"ל ומקבל חשבונית עם ערך נקוב במט"ח.
השירות ניתן החל מתאריך מאיזה תאריך מתחיל החיוב בהפעלה הזאת.
אם השורה כבר חוייבה בחשבונית בעבר, אז זה יהיה יום אחד למחרת השדה
[Last Billing Date]
תאריך חיוב אחרון (ע"י האשף).
בהתאם לטבלה ממנה נאספו הנתונים, השדה הזה והבא אחריו יכולים לייצג טווח תאריכים של רשומות יומיות אשר סוכמו לשורת חיוב אחת.
השירות הסתיים בתאריך עד איזה תאריך אנחנו מחייבים את הלקוח בשורה הזאת, בד"כ זהה לפרמטר [הגש חשבון עד לתאריך], אלא אם השירות מסתיים לפניו.
* ביחד עם השדה הקודם, חפיפה בין תאריכים על אותו השירות מייצרת כפילות בחיוב!
* בחיוב חד פעמי, השדה הזה יהיה ריק.
כמות
יחידת מידה
מחיר לפני מע"מ (ליחידה)
מחיר לצרכן (כולל מעמ ליחידה)
שיטת תמחיר
מטבע המכירה 		השדות מועתקים מטבלת הוראות החיוב וניתנים לעריכה בתיק הלקוח (גם בחירת המקט נעשית בתיק הלקוח).

אם אינך מכיר את השדות הללו, פנה להדרכה אודות המכנה המשותף של טבלאות הפריטים.
שער המרה אם השורה מתומחרת במט"ח אזי הייפר תיישם את השער היציג, אחרת ערך השדה יהיה 1.
התאריך עבור השער תלוי בפרמטר [מועד הפקת מקור], ערך ריק = עכשיו = השער הידוע האחרון.
שיטת חיוב לפי איזו לוגיקה חושבה השורה. השדה
[Factor]
מציג את המכפלה של השורה בהתאם לציר הזמן, למשל 1 לחודש שלם או חיוב חד פעמי, 2 לחודשיים שלמים, 0.5 לחצי חודש.
להלן הערכים האפשריים:
  • שירות חודשי מתחדש (Monthly Repeating):
    מבצע חיוב יחסי עבור כמות הימים בחודש בהם ניתן השירות, לפי אלגוריתם 360 כלומר 30 ימים בכל חודש.
  • חיוב קבוע מתחדש (Fix-Price Repeating):
    מבצע חיוב על הסכום המלא בכל חודש, גם אם הלקוח היה מנוי רק ליום אחד באותו החודש.
    לדוגמה: מנוי מתאריך 1.1.2020 ועד ל- 1.2.2020 יחוייב בעבור 2 חודשים.
  • חיוב חד פעמי (One-time Event):
    הלקוח מחוייב רק פעם אחת ובתנאי שתאריך החיוב קטן מהפרמטר [הגש חשבון עד לתאריך].
תאריך חיוב אחרון (ע"י האשף) התאריך האחרון שעד אליו הופקה חשבונית מס אמיתית ללקוח.
הערות פנימיות שדה ידני מהתיק של הלקוח, מועתק לכאן בכדי לספק לך מידע פנימי זמין. כמובן שאינו נפלט החוצה לחשבונית.
סיווג מע"מ סדר העדיפות לאיתור ערך השדה: קודם דגל תשלום מעמ של הלקוח, אח"כ סניף של הלקוח ובסוף רשומת המוצר (אם יש מקט).
סעיף התחייבות מפתח הרשומה בטבלת החוזים בתיק הלקוח, או המפתח בטבלה אחרת ממנה נאסף המידע.

סיכום כל החיובים שאושרו להגשה

השדות בתחתית הטבלה מציגים את סיכום החשבוניות שיופקו, בכפוף לשורות המסומנות בשדה "תיאור" (checkbox).
שם השדה תיאור
כמות לקוחות כמות חשבונות לקוחות המיועדים לקבל חשבונית (אם יש בהייפר 2 חשבונות עבור אותה ישות משפטית,ובשניהם חיובים פעילים, אזי הם יספרו כאן כ-2 לקוחות).
כמות מסמכים בינ"ל כמה חשבוניות (כמות מסמכים) מיועדות לייצוא (לקוח שרשום ומנהל את ספריו בחו"ל).
סה"כ לפני מע"מ ₪ סך כל החיובים ללא מס ערך מוסף. השדה כולל גם חשבוניות יצוא או פריטים עם מעמ אפס.
סה"כ מע"מ ₪
סך הכל לתשלום 		המשך סיכומים בדומה לשדה הקודם.