דילוג לתוכן
מרכז התיעוד
לאתר LinkNodes Energy
LinkNodesENERGYתיעוד

טוענים את החיפוש…

    חיפוש גם בתוך המאמרים ↑ ↓ לניווט Esc לסגירה

    לאתר החברה

    מסלולים ומסחר

    מדיניות מנויים מובנית

    זרימות מנוי, מצבים, החלטות הפעלה וכללי יסוד.

    זרימות מנוי, מצבים, החלטות הפעלה וכללי יסוד.

    {
      "version": "1.1.0",
      "date": "2026-11-10",
      "status": "recommended_not_activated",
      "currentBehavior": "בחירת מסלול החשבון ומכסות הרכבים פעילות. עמלת הטעינה המאושרת אחידה: 0.99% לפני מע״מ בכל המסלולים, כולל Enterprise. הוצעה תקופת ניסיון Personal בת 14 ימים ולאחריה מנוי בתשלום; הניסיון, חיוב המנויים ועמלות הטעינה אינם פעילים ולא נגבה תשלום.",
      "flows": [
        {
          "id": "activation",
          "title": "פתיחת חשבון והפעלת מנוי",
          "timing": "לאחר אישור תנאים ותשלום מאומת",
          "summary": "פתיחת חשבון ובחירת מסלול קיימות היום. מנוי בתשלום יופעל רק אחרי השלמת מערכות החיוב.",
          "guards": [
            "זהות משלם והרשאת בעל החשבון",
            "גרסת מחיר וזכאות מאושרת ומפורשת",
            "אישור תנאים ומנדט חיוב; webhook חתום או אשראי ארגוני מאושר"
          ],
          "finance": "לכל תקופת שירות חיוב מזוהה אחד. כשל או תוצאה לא ידועה אינם מסמנים מנוי כפעיל."
        },
        {
          "id": "upgrade",
          "title": "שדרוג מסלול",
          "timing": "לאחר אישור הצעת ההפרש",
          "summary": "המלצה: מקבלים את מכסת הרכבים והיכולות החדשות אחרי אישור ההפרש ואימות התשלום.",
          "guards": [
            "רק בעלי החשבון או בעל סמכות חוזית מפורשת",
            "בדיקת זמינות היכולות לפני הבטחה מסחרית",
            "אין הרחבת הרשאות בעקבות הצלחת redirect בדפדפן",
            "במעבר לחשבון עסקי יש לאשר שינוי תחום החשיפה לצוות"
          ],
          "finance": "הצעה מפרטת זיכוי בגין יתרת השירות הישן וחיוב בגין יתרת השירות החדש. אין חיוב של שתי תקופות מלאות."
        },
        {
          "id": "downgrade",
          "title": "שנמוך מסלול",
          "timing": "בסוף התקופה ששולמה",
          "summary": "המלצה: קובעים שינוי לסוף התקופה; ניתן לבטלו לפני הכניסה לתוקף.",
          "guards": [
            "בודקים שוב מכסת רכבים וחברים במועד הכניסה לתוקף",
            "בעל החשבון בוחר אילו רכבים להוציא משימוש; אין בחירה או מחיקה אוטומטית",
            "יציאה מ־SSO דורשת כניסה חלופית שנבדקה",
            "מפסיקים חיבורים שאינם כלולים במסלול החדש רק בתיאום"
          ],
          "finance": "התוכנית הקיימת נשמרת עד סוף התקופה. אם השינוי נחסם, מבקשים החלטה מהלקוח ואינם מחדשים מסלול יקר בשקט."
        },
        {
          "id": "interval",
          "title": "מעבר בין חודשי לשנתי",
          "timing": "במועד החידוש הבא",
          "summary": "מעבר בין חודשי לשנתי מוצע במועד החידוש הבא. עבור Personal, Family ו־Business מחיר המנוי לשנה הוא 12 מחירים חודשיים בניכוי 20%, בחיוב שנתי מראש. Enterprise מתומחר לפי הסכם בלבד וללא הנחת 20% אוטומטית. אין חיוב פעיל עדיין.",
          "guards": [
            "מציגים תאריך וסכום חדש לפני אישור",
            "במעבר משנתי לחודשי נשמרת הזכאות עד סוף השנה ששולמה",
            "המחיר השנתי המפורש מקושר לגרסת המחירון המאושרת; אין להחיל הנחה זו על Enterprise ואין לחשב הנחה על עמלת טעינה"
          ],
          "finance": "אין חפיפה של תקופות ואין אובדן של יתרה ששולמה. שינוי מוקדם יותר דורש הצעה וזיכוי מפורשים."
        },
        {
          "id": "renewal",
          "title": "חידוש מנוי",
          "timing": "לפי תנאי החידוש שאושרו",
          "summary": "המלצה: הודעה מוקדמת עם סכום ותאריך החיוב, ודרך ברורה לבטל חידוש.",
          "guards": [
            "תנאי חידוש אוטומטי מוצגים לפני ההצטרפות",
            "נשלחות התראות לפני חידוש ולפני שינוי במחיר",
            "תאריך תחילת וסיום שירות נשמרים ב־UTC ומוצגים לפי אזור החשבון"
          ],
          "finance": "מחייבים פעם אחת לתקופת שירות. עדכון מחיר עתידי אינו משנה התחייבות או מסמך ישנים."
        },
        {
          "id": "payment-failure",
          "title": "תשלום שנכשל",
          "timing": "ניסיונות חוזרים ותקופת חסד לפי מדיניות",
          "summary": "המלצה: מציגים את החוב ומאפשרים עדכון אמצעי תשלום לפני הגבלת שירות.",
          "guards": [
            "מספר הניסיונות ומשך החסד חייבים להיות מוגדרים לפני הפעלה",
            "אין ניתוק טעינה שכבר אושרה בגלל כשל במנוי",
            "אין מחיקת רכבים או חשבוניות בגלל חוב",
            "תוצאת חיוב לא ידועה עוברת להתאמה לפני ניסיון חדש"
          ],
          "finance": "ניסיונות גבייה משויכים לאותה התחייבות; ניסיון חוזר אינו יוצר חוב נוסף. לאחר החסד נשארת גישה למסמכים ולפעולות פתרון החוב."
        },
        {
          "id": "cancellation",
          "title": "ביטול מנוי",
          "timing": "עצירת החידוש; תוקף לפי התנאים והדין",
          "summary": "המלצה: ניתן לבטל חידוש מהמוצר ולקבל אישור עם תאריך סיום השירות.",
          "guards": [
            "ניתן לבטל את בקשת הביטול לפני תום הזכאות",
            "מסיימים ומתחשבנים על טעינות שכבר אושרו",
            "שומרים גישה למסמכים הנדרשים לפי מדיניות השמירה",
            "מחיקת חשבון ונתונים היא בקשה נפרדת"
          ],
          "finance": "אין חיובים חדשים לתקופת מנוי לאחר סיום. חיובי טעינות שהושלמו והתחייבויות קיימות אינם נמחקים."
        },
        {
          "id": "refund",
          "title": "זיכויים, החזרים ומחלוקות",
          "timing": "לפי זכאות, תנאים והדין",
          "summary": "המלצה: זיכוי או החזר מקושרים לחיוב המקורי ולסיבת התיקון.",
          "guards": [
            "אין החזר אוטומטי בגלל לחיצה על שנמוך",
            "מפרידים זיכוי חשבונאי מהחזר כספי שבוצע אצל הסולק",
            "מונעים החזר מצטבר מעל החיוב המקורי",
            "מחזירים עמלה רק לפי מדיניות מאושרת ובסיס העמלה המקורי"
          ],
          "finance": "נשמרות שורות מנוי, טעינה, עמלה ומסים בנפרד. מסמכים מתקנים מופקים אצל ספק המסמכים, בלי עריכת חשבונית מקורית."
        },
        {
          "id": "enterprise",
          "title": "מעבר ל־Enterprise",
          "timing": "הצעה פרטית וחתימת הסכם",
          "summary": "SSO, Premium Support, API והטמעה נכללים באריזה הארגונית; היקף השירות והחיבורים נרשמים בהצעה.",
          "guards": [
            "אימות דומיין ו־IdP לפני הפעלת SSO",
            "בדיקות הרשאות וכניסה חלופית לפני אכיפת SSO",
            "SLA, שעות תמיכה ומכסות API מוגדרים בחוזה",
            "מחיר פרטי גלוי רק לארגון ולצוות מסחרי מורשה"
          ],
          "finance": "מחיר המנוי נקבע בהסכם ואינו אפס כברירת מחדל. עמלת הטעינה היא 0.99% לפני מע״מ גם ב־Enterprise. תנאי אשראי, התחייבות שימוש ושירותים חד־פעמיים דורשים אישור ומסמכים נפרדים."
        },
        {
          "id": "payer-change",
          "title": "החלפת משלם או מעבר בין ישויות",
          "timing": "לאחר אימות ואישור מפורשים",
          "summary": "המלצה: שינוי זהות משפטית או העברת בעלות דורשים בדיקה; חשבון פרטי אינו מתמזג עם חשבון מעסיק.",
          "guards": [
            "המשלם החדש מאומת ומאשר חיובים עתידיים",
            "חובות קודמים נשארים עם המשלם וההסכם המקוריים",
            "היסטוריה פרטית אינה מועברת למעסיק אוטומטית",
            "מעבר בין tenants אינו שינוי plan_code"
          ],
          "finance": "מנדט תשלום והסכם חדשים לתקופה העתידית. אין העברת חוב שקטה או שינוי בעלות במסמכים שכבר הופקו."
        },
        {
          "id": "pilot",
          "title": "ניסיון Personal ל־14 ימים ופיילוט עסקי",
          "timing": "Personal: 14 ימים ללא דמי מנוי לאחר ההשקה; לעסקים פיילוט רק בהצעה",
          "summary": "הצעת השקה: משתמש Personal חדש זכאי ל־14 ימי התנסות ללא דמי מנוי, ולאחריהם מנוי חודשי בתשלום. אין מסלול Personal חינמי קבוע, ואין חיוב ללא הסכמה ומנדט שאומתו. התהליך עדיין אינו פעיל.",
          "guards": [
            "תקופת הניסיון תימדד בשרת לפי התחלה וסיום; ניסיונות חוזרים אינם עוקפים זכאות קודמת",
            "מחיר, מועד תחילת החיוב, חידוש אוטומטי אם יוגדר ודרך ביטול מוצגים לפני הסכמה",
            "ללא הסכם ומנדט תקפים לא יתבצע חיוב אוטומטי; זכאות לאחר הניסיון תיקבע במדיניות ההשקה",
            "עלות טעינה בזמן ניסיון אינה בחינם; עמלת 0.99% בתוספת מע״מ תחול על טעינה דרך LinkNodes לאחר הפעלת השירות, בנפרד ממחיר הספק",
            "פיילוט Business/Enterprise דורש הצעה, אישור ותאריך סיום נפרדים"
          ],
          "finance": "הניסיון פוטר מדמי מנוי ל־14 ימים בלבד. חיובי המנוי לאחר הניסיון מחייבים הסכמה וגובה מאומת; אין כפל חיוב או הארכה אוטומטית של ניסיון."
        },
        {
          "id": "pause",
          "title": "השהיה וחזרה לשירות",
          "timing": "יכולת עתידית, לאחר הגדרת תנאים",
          "summary": "המלצה: לא להציע השהיה בתשלום לפני שמוגדרים משך, זכאות, נתונים ותנאי חזרה.",
          "guards": [
            "חסימת חשבון לצורך אבטחה אינה השהיית מנוי",
            "אין גבייה אוטומטית או פתיחת זכאות חדשה ללא הסכם",
            "חוזרים למסלול ולמחיר מפורשים"
          ],
          "finance": "מועד סוף השירות והחידוש חייבים להתאים לתנאי ההשהיה. אין הנחת זכאות או יתרת זמן מחושבת בדפדפן."
        }
      ],
      "states": [
        {
          "id": "draft",
          "meaning": "אין זכאות בתשלום; החשבון יכול להיות במצב הכנה"
        },
        {
          "id": "pending_payment",
          "meaning": "אושרו תנאים; ממתינים לאימות תשלום או אישור אשראי"
        },
        {
          "id": "trialing",
          "meaning": "ניסיון Personal מוגבל ל־14 ימים כאשר יופעל, או פיילוט עסקי מאושר; לא מופעל חיוב אוטומטי."
        },
        {
          "id": "active",
          "meaning": "זכאות בתוך תקופת שירות מאושרת"
        },
        {
          "id": "past_due",
          "meaning": "חוב פתוח; תקופת חסד לפי מדיניות מפורשת"
        },
        {
          "id": "suspended",
          "meaning": "שירות חדש מוגבל; מסמכים ופתרון חוב עדיין נגישים"
        },
        {
          "id": "canceled",
          "meaning": "החידוש בוטל; הזכאות הקיימת נשמרת עד תום התקופה"
        },
        {
          "id": "expired",
          "meaning": "תקופת הזכאות הסתיימה"
        }
      ],
      "decisionsBeforeActivation": [
        "אישור משפטי ומיסוי של מחירי ההשקה החודשיים והשנתיים (20% הנחה לשלושת המסלולים בלבד), שיעורי העמלה ותנאי Enterprise מותאמים",
        "מנגנון הסכמה, חידוש, ביטול ותקופת ניסיון Personal ל־14 ימים, ללא חיוב אוטומטי ללא הרשאה תקפה",
        "בסיס העמלה, מסים וכללי עיגול",
        "מדיניות חיוב יחסי והחזרים ואישור משפטי",
        "חלון התראת חידוש ושינוי מחיר",
        "משך חסד, מספר ניסיונות גבייה ותזמונם",
        "ספקי סליקה, מסמכים, הנהלת חשבונות וטעינה",
        "היקף SLA, זמני תגובה והפעלת צוות תמיכת Premium",
        "מכסות API, מדיניות שמירה והיקף הטמעה ב־Enterprise"
      ],
      "architecture": [
        {
          "entity": "plan_versions / feature_entitlements",
          "purpose": "גרסת חבילה בלתי משתנה, מכסות ופיצ׳רים. הגדרת תכולה נפרדת ממצב המימוש והזמינות בפועל."
        },
        {
          "entity": "price_versions / accepted_agreements",
          "purpose": "סכומים באגורות, אחוזים בנקודות בסיס, משלם, תקופה, תנאי מס וגרסת הסכמה. ללא ברירות מחדל כספיות."
        },
        {
          "entity": "subscriptions / subscription_periods",
          "purpose": "מחזור חיי מנוי ותקופות שירות רציפות, עם לכל היותר מנוי אחד אפקטיבי לכל חשבון בזמן נתון."
        },
        {
          "entity": "subscription_changes / quotes",
          "purpose": "מסלול נוכחי ומבוקש, מועד תחילה, גרסת ציפייה, תוקף הצעה, חסמי שינוי ומפתח idempotency."
        },
        {
          "entity": "billing_obligations / payment_attempts",
          "purpose": "הפרדת חוב מניסיונות גבייה; webhook חתום או התאמה מאמתים תשלום. תוצאה לא ידועה אינה כישלון ודאי."
        },
        {
          "entity": "documents / refunds / ledger",
          "purpose": "מסמכים חוקיים, זיכויים, החזרים ורישומים חשבונאיים מול מקור החיוב; אין שכתוב היסטוריה."
        },
        {
          "entity": "entitlement_projection / outbox / audit",
          "purpose": "עדכון זכאות אטומי לאחר תשלום מאומת, שליחת אירועים אמינה ויומן ביקורת. נעילה ובדיקת מכסה חוזרת לפני הפעלת שינוי."
        }
      ],
      "invariants": [
        "מחירון ותכולת אתר אינם מקור הרשאה להפעלת תכונה או טעינה.",
        "זכאות אפקטיבית = חברות פעילה + תפקיד מורשה + חבילה מאושרת + תכונה ממומשת + חיבור ספק כשנדרש.",
        "אין הורדת יכולות אבטחה בסיסיות, בידוד נתונים או גישה למסמכים מטעמי אריזה מסחרית.",
        "טעינה שומרת צילום הסכם, משלם, מחיר ספק, עמלה ומסים בזמן האישור; שינויים חלים על טעינות עתידיות בלבד.",
        "בדיקת מכסה חוזרת מתבצעת בתוך עסקה לפני כניסת שנמוך לתוקף, גם אם הבדיקה המוקדמת הצליחה.",
        "רכב מושהה נספר; רכב שהוצא משימוש אינו נספר אבל נשאר בהיסטוריה.",
        "פעולה כפולה או webhook חוזר אינם יוצרים תקופה, חוב, זיכוי או זכאות כפולים.",
        "אין שיתוף נתונים בין חברות בעקבות רכישת Enterprise; חיבור כל ישות דורש הרשאה מפורשת."
      ]
    }