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

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

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

    לאתר החברה

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

    מפרט מסחרי מובנה

    תחומי אחריות, תהליכים, ישויות וכללים של המערכת המסחרית.

    תחומי אחריות, תהליכים, ישויות וכללים של המערכת המסחרית.

    {
      "meta": {
        "name": "LinkNodes Energy Commercial System",
        "version": "1.4.0",
        "date": "2026-11-21",
        "scope": "מודל עסקי מאושר, ארכיטקטורה פיננסית וחוזי חישוב בקוד. גבייה, מנויים פעילים, הפקת מסמכים והנהלת חשבונות עדיין אינם מחוברים.",
        "pricingStatus": "מחירי השקה חודשיים ועמלות מפורסמים באתר; Personal כולל 14 ימי ניסיון. מחיר שנתי אושר: 20% הנחה על 12 חודשי מנוי Personal, Family ו־Business, ללא הנחה אוטומטית ב־Enterprise. הגבייה עדיין אינה פעילה.",
        "packagingSource": "lib/commercial-system/packaging.json",
        "subscriptionPolicySource": "lib/commercial-system/subscription-policy.json"
      },
      "confirmed": [
        {
          "id": "CM01",
          "title": "מנוי חודשי או שנתי",
          "description": "המסלולים Personal, Family, Business ו־Enterprise ומכסות 1 / 3 / 10 / ללא מגבלה נשמרים. מנוי אישי בתשלום לאחר ניסיון Personal של 14 ימים ללא דמי מנוי. מחירי היעד החודשיים: Personal ₪9.90 כולל מע״מ, Family ₪19.90 כולל מע״מ, Business ₪129 לפני מע״מ, Enterprise החל מ־₪599 לפני מע״מ לפי הסכם. אושרה הנחה של 20% בתשלום שנתי מראש לשלושת המסלולים הראשונים: ₪95.04, ₪191.04 ו־₪1,238.40 לשנה בהתאמה; Enterprise אינו נכלל במבצע השנתי ומחירו לפי הצעה אישית. האתר מציג מחירון אך לא מפעיל גבייה.",
          "status": "confirmed"
        },
        {
          "id": "CM02",
          "title": "עמלה באחוזים על טעינה",
          "description": "עמלת שירות אחידה של 0.99% לפני מע״מ ממחיר ספק הטעינה כולל מסים, בכל המסלולים: Personal, Family, Business ו־Enterprise. העמלה חלה על טעינה שבוצעה דרך LinkNodes, ומע״מ נוסף על העמלה בלבד. מנגנון HYP מיועד לגביית עמלת LinkNodes והמע״מ עליה; הוא אינו מסדיר את מלוא מחיר הספק. הגבייה עדיין אינה פעילה.",
          "status": "confirmed"
        },
        {
          "id": "CM03",
          "title": "Enterprise ללקוחות עסקיים",
          "description": "מחיר המנוי ותנאי החיוב מותאמים בהסכם לקוח מאושר, בתחום המרחב העסקי. עמלת הטעינה נשארת אחידה: 0.99% לפני מע״מ, כמו בכל יתר המסלולים.",
          "status": "confirmed"
        }
      ],
      "domains": [
        {
          "id": "pricing",
          "name": "Pricing & Contracts",
          "owner": "Product & Commercial",
          "responsibility": "קטלוג מסלולים, גרסאות מחיר והסכמי Enterprise. כל חיוב קשור לתנאים שהלקוח אישר.",
          "status": "foundation",
          "dependency": "מחירים, שיעורי עמלה, בסיס חישוב ומדיניות מס"
        },
        {
          "id": "subscriptions",
          "name": "Subscriptions & Entitlements",
          "owner": "Billing Engineering",
          "responsibility": "מחזור חודשי/שנתי, חידוש, ביטול בסוף תקופה, כשל גבייה וזכאות. מצב מנוי אינו תפקיד משתמש.",
          "status": "planned",
          "dependency": "ספק סליקה, מדיניות חסד ושינוי מסלול"
        },
        {
          "id": "billing",
          "name": "Billing & Rating",
          "owner": "Billing Engineering",
          "responsibility": "חישוב התחייבויות ושורות נפרדות עבור מנוי, טעינה, עמלה ומסים; צילום תנאים בזמן הפעולה ומניעת כפילות.",
          "status": "foundation",
          "dependency": "תעריף/CDR מאומת וחוזה שאושר"
        },
        {
          "id": "payments",
          "name": "Payments & Collections",
          "owner": "Payments Engineering",
          "responsibility": "אמצעי תשלום אצל PSP, אישור, גבייה, החזר ומחלוקת. webhook מאומת קובע אם הכסף נגבה.",
          "status": "blocked",
          "dependency": "בחירת PSP, הגורם הגובה ומודל העברת כספים לספק"
        },
        {
          "id": "invoicing",
          "name": "Invoicing & Documents",
          "owner": "Finance Operations",
          "responsibility": "מסמכים רשמיים, מספרים, רכיבי מס, קישור לחיובים וזיכויים. אין להציג סיכום טעינה כחשבונית מס.",
          "status": "blocked",
          "dependency": "ספק מסמכים, זהות המנפיק ותהליך ביטול/זיכוי"
        },
        {
          "id": "bookkeeping",
          "name": "Bookkeeping & Ledger",
          "owner": "Finance & Engineering",
          "responsibility": "יומן תנועות מאוזן בספרי החברה, חובות לקוחות, יתרות ספקים, מסים, עמלות והחזרים. תיקון ברישום חדש.",
          "status": "planned",
          "dependency": "תוכנית חשבונות, כללי רישום ומודל principal/agent מאושרים"
        },
        {
          "id": "accounting",
          "name": "Accounting & Reconciliation",
          "owner": "Finance",
          "responsibility": "התאמת טעינות, גבייה, מסמכים והתחשבנות; סגירת תקופה וייצוא למערכת הנהלת החשבונות.",
          "status": "planned",
          "dependency": "בחירת מערכת חשבונאית, מדיניות הכרה בהכנסה ואישור רואה חשבון"
        }
      ],
      "flows": [
        {
          "id": "subscription",
          "title": "מנוי — מהצעה לחידוש",
          "steps": [
            "בחירת חודשי/שנתי או הסכם Enterprise",
            "הצגת סכום תקופתי ותנאים מלאים",
            "אישור גרסת תנאים וזהות המשלם",
            "יצירת התחייבות ייחודית לתקופת המנוי",
            "גבייה או תנאי אשראי שאושרו בהסכם",
            "עדכון זכאות לפי מדיניות מאושרת",
            "מסמך, רישום והתאמה",
            "חידוש או ביטול במועד הקבוע"
          ],
          "failure": "כשל גבייה אינו נעלם ואינו מוחק מידע. אין לעצור טעינה פעילה בשל שינוי מסלול."
        },
        {
          "id": "charging",
          "title": "טעינה — מחיר ספק בתוספת עמלה",
          "steps": [
            "בדיקת ספק שנבחר, הרשאות וזכאות",
            "שליפת תנאי מחיר ותעריף מאומת מהשרת",
            "הצגת אומדן: מחיר טעינה, עמלה ומסים",
            "שריון מסגרת לפי הסכום הכולל ללקוח",
            "קבלת CDR סופי מאומת",
            "חישוב שורות לפי צילום התנאים המקורי",
            "גבייה פעם אחת לכל התחייבות",
            "מסמך, רישום והתחשבנות עם הספק"
          ],
          "failure": "CDR מאוחר, סכום חריג או תוצאת גבייה לא ידועה עוברים לבירור. אין לחשב מחדש טעינה ישנה לפי מחירון חדש."
        },
        {
          "id": "enterprise",
          "title": "Enterprise — תנאים ייחודיים למרחב",
          "steps": [
            "אפיון לקוח עסקי וזהות משלם",
            "הצעת מחיר עם תוקף וגרסת תנאים",
            "אישור מסחרי וקבלת ההסכם מהלקוח",
            "שיוך למרחב עסקי מוגדר",
            "הפעלה בתאריך התחילה",
            "חיוב, חשבונית מרוכזת או אשראי לפי ההסכם",
            "מעקב צריכה וחובות",
            "חידוש בגרסה חדשה ללא שינוי ההיסטוריה"
          ],
          "failure": "הצעת מחיר לא מאושרת אינה מפעילה זכאות. עובד בעל תפקיד מנהל אינו רשאי לשנות בעצמו מחיר הסכם."
        }
      ],
      "entities": [
        {
          "name": "billing_accounts",
          "scope": "tenant + legal billing identity",
          "purpose": "פרטי המשלם, זהות משפטית ופרטי מס; אינם נלקחים אוטומטית מפרופיל הנהג.",
          "status": "proposed"
        },
        {
          "name": "plan_catalog + entitlement_revisions",
          "scope": "public plan identity; versioned server policy",
          "purpose": "Personal / Family / Business / Enterprise, סוג מרחב ותנאי זכאות בגרסאות. מכסות הרכבים נאכפות במסד הנתונים: Personal 1, Family 3, Business 10, Enterprise ללא מגבלה. חיוב מסחרי נפרד מבחירת מסלול החשבון.",
          "status": "proposed"
        },
        {
          "name": "account plan + membership boundary",
          "scope": "tenant; implemented plan_code",
          "purpose": "Personal לאדם אחד ורכב אחד; Family לחשבון אחד ועד שלושה רכבים. מגבלות חברים ורכבים נאכפות במסד הנתונים. Business עד עשרה רכבים ו־Enterprise ללא מגבלת רכבים.",
          "status": "proposed"
        },
        {
          "name": "plan_price_revisions",
          "scope": "public catalog / private enterprise",
          "purpose": "גרסה בלתי משתנה של מחיר לתקופה, עמלה, בסיס חישוב, מסים ותוקף. אין מחיר חסר שמתפרש כאפס.",
          "status": "proposed"
        },
        {
          "name": "customer_agreements",
          "scope": "tenant",
          "purpose": "קבלת תנאים וגרסת הסכם. הסכם Enterprise שייך רק למרחב העסקי המורשה.",
          "status": "proposed"
        },
        {
          "name": "subscriptions + subscription_cycles",
          "scope": "tenant",
          "purpose": "מחזור מנוי וטווח שירות; מפתח ייחודי (subscription_id, period_start, period_end, charge_type).",
          "status": "proposed"
        },
        {
          "name": "billing_obligations + billing_lines",
          "scope": "tenant",
          "purpose": "התחייבויות ושורות מנוי/טעינה/עמלה/מס עם מקור, גרסת מחיר, basis points וסכומים באגורות.",
          "status": "proposed"
        },
        {
          "name": "payment_attempts + payment_allocations",
          "scope": "tenant; provider tokens private",
          "purpose": "הפרדת ניסיון גבייה מהתחייבות; תשלום יכול לכסות שורות רבות, ומנוי אינו דורש session_id.",
          "status": "proposed"
        },
        {
          "name": "financial_documents + document_lines",
          "scope": "tenant; issuer legal entity",
          "purpose": "חשבונית/קבלה/זיכוי מאומתים אצל ספק מסמכים, עם קישור לשורות ולמקור וללא כתיבה מחדש.",
          "status": "proposed"
        },
        {
          "name": "refunds + refund_allocations",
          "scope": "tenant",
          "purpose": "החזר מקושר לחיוב; החזרי עמלה ומסים מפורשים, עם מניעת החזר עודף ועיגול מצטבר.",
          "status": "proposed"
        },
        {
          "name": "provider_settlements",
          "scope": "provider + platform legal entity; tenant allocations",
          "purpose": "סכום המגיע לספק לפי הסכם ומדידה, בנפרד מעמלת הלקוח ומהוצאות סליקה.",
          "status": "proposed"
        },
        {
          "name": "accounting_books + journal_entries + journal_lines",
          "scope": "company legal entity; server/staff only",
          "purpose": "רישום דו־צדדי מאוזן לפי ספר ומטבע; tenant הוא ממד שיוך. לקוח אינו מקבל גישה לספרי החברה.",
          "status": "proposed"
        },
        {
          "name": "reconciliation_cases + accounting_exports",
          "scope": "server/staff; tenant projection only",
          "purpose": "פערי התאמה, אישור סגירה, נעילת תקופות וקבלות ייצוא למערכת החשבונאית.",
          "status": "proposed"
        },
        {
          "name": "financial_outbox + provider_event_inbox",
          "scope": "server/staff; aggregate + tenant",
          "purpose": "תזמון חידוש ואירועי חיוב ללא session_id מדומה; idempotency, hash, lease, retries ו־dead letter. אירועי ספק מזוהים לפי חשבון וסביבה.",
          "status": "proposed"
        }
      ],
      "invariants": [
        "הסכום ללקוח הוא מחיר טעינה בתוספת עמלת LinkNodes והמס החל עליה; דמי המנוי הם התחייבות נפרדת.",
        "שיעור עמלה נשמר בנקודות בסיס: 100 נקודות בסיס = 1%. סכומי כסף נשמרים באגורות; חישוב ביניים מדויק.",
        "שיעור עמלה, מחיר, מס ובסיס חישוב אינם מגיעים מהלקוח בעת חיוב. השרת טוען הסכם ותעריף מאומתים.",
        "כל התחייבות, ניסיון גבייה, מסמך, החזר ופעולת התחשבנות מקבלים מפתח מניעת כפילות ותחום tenant/currency.",
        "חשבונית, גבייה, הכנסה מוכרת וסכום שמגיע לספק הם מושגים נפרדים. הצלחת API אינה אישור קבלת כסף.",
        "מנוי שנתי שנגבה מראש אינו הכנסה חודשית באותו סכום. MRR הוא מדד מנורמל; הכרה בהכנסה לפי מדיניות חשבונאית.",
        "הסכם מסחרי אינו עוקף הרשאות, בחירת ספקים או תנאי חיבור בפועל. מנוי בתוקף אינו מספיק לאישור טעינה.",
        "תיקון/זיכוי/החזר נשענים על צילום המחיר המקורי; שינוי מחירון אינו משנה חיובים היסטוריים.",
        "מחיר כולל וסכום העמלה מוצגים ללקוח לפני אישור. בסיס מס, עיגול והחזרים טעונים החלטה לפני הצעה מחייבת.",
        "זהות המסלול, תקופת החיוב, תפקיד המשתמש והמרחב הם ממדים נפרדים. Family אינו תפקיד חדש על חשבון אישי קיים.",
        "אדם יכול להשתייך למרחב אישי, משפחתי ועסקי; אין להעביר חיוב או היסטוריה ביניהם אוטומטית.",
        "הסכם מחיר, גרסת זכאות וזהות המשלם ננעלים בזמן אישור הטעינה. חידוש מנוי אינו משנה חיובים קודמים."
      ],
      "metrics": [
        {
          "name": "Subscription MRR / ARR",
          "definition": "מנויים פעילים לפי תנאים מאושרים, שנתי מנורמל ב־12; עמלת טעינה אינה נכללת ב־MRR."
        },
        {
          "name": "Commission revenue",
          "definition": "העמלה ללא מס, לאחר זיכויים; הכרה על פי מדיניות חשבונאית מאושרת."
        },
        {
          "name": "Charging GMV",
          "definition": "נפח עסקאות הטעינה בנפרד מהעמלה. אין להציג את כולו כהכנסות החברה בלי הכרעת principal/agent."
        },
        {
          "name": "Collection & reconciliation",
          "definition": "הצלחת גבייה, חוב פתוח, יתרת ספקים, החזרים ופערי התאמה שטרם נסגרו."
        }
      ],
      "openDecisions": [
        {
          "id": "PRICE",
          "title": "אישור הגבייה ותנאי Enterprise",
          "detail": "מחירי היעד החודשיים והשנתיים (20% הנחה ב־Personal, Family ו־Business בלבד) ושיעורי העמלה מוצגים באתר; נדרשים עדיין אישור תנאים ומס לפני חיוב, היערכות סליקה, חידוש ומעבר מסלולים. Enterprise נשאר בהצעת מחיר ללא הנחת 20% אוטומטית."
        },
        {
          "id": "FAMILY",
          "title": "שיתוף עתידי ב־Family",
          "detail": "Family הוגדר כחשבון אחד עם עד שלושה רכבים. אין הזמנת בני משפחה נפרדים; יכולת עתידית כזו תדרוש אפיון פרטיות והרשאות."
        },
        {
          "id": "TAX",
          "title": "בסיס העמלה ומדיניות מס",
          "detail": "בסיס העמלה המוצע הוא מחיר ספק הטעינה כולל מסים; מע״מ יתווסף על עמלת השירות בלבד, ומחירי המנוי יוצגו כולל/לפני מע״מ לפי הקהל. החבות, העיגול וזהות המנפיק דורשים אישור מס ומשפט לפני גבייה."
        },
        {
          "id": "PARTNERS",
          "title": "סליקה, מסמכים והנהלת חשבונות",
          "detail": "בחירת PSP, ספק חשבוניות ומערכת הנהלת חשבונות; merchant of record ואופן העברת כספי הספק."
        },
        {
          "id": "LIFECYCLE",
          "title": "חידושים, שדרוגים והחזרים",
          "detail": "קיימת מדיניות מומלצת ב־subscription-policy.json: שדרוג לאחר הצעה ותשלום, שנמוך ומעבר תקופה בסוף התקופה, ביטול, גבייה והחזרים. משך חסד, מועדי התראה, אופן החיוב היחסי והתנאים המשפטיים דורשים אישור לפני הפעלה."
        },
        {
          "id": "ACCOUNTING",
          "title": "מדיניות חשבונאית",
          "detail": "זהות מנפיק המסמך, תוכנית חשבונות, הכרה בהכנסה, ספרי חברה, principal/agent, נעילת תקופות ושימור."
        }
      ],
      "delivery": [
        {
          "title": "מודל וחוזים",
          "status": "foundation",
          "detail": "החלטות העסק מתועדות; חישוב עמלה, פירוק סכום וחוזה הסכם מיושמים ונבדקים בקוד. מחשבון עיוני אינו שירות גבייה."
        },
        {
          "title": "Family וזכאות לפי מסלול",
          "status": "planned",
          "detail": "מכסות 1/3/10/ללא מגבלה מיושמות בשרת. גרסאות זכאות מסחריות ותהליכי חיוב עדיין נדרשים; בחירת המסלול אינה אישור לתשלום או לטעינה."
        },
        {
          "title": "תמחור והסכמים",
          "status": "blocked",
          "detail": "לאשר מחירים, מסים, עיגול והחזרים; לממש גרסאות מחיר, קבלת הסכם וזכאות בשרת."
        },
        {
          "title": "סליקה וחשבוניות",
          "status": "blocked",
          "detail": "לחבר ספקים בסביבת בדיקות, לאמת webhook, כפילויות, כשל חלקי והחזרים ולהגדיר reconciliation."
        },
        {
          "title": "ספרים והתחשבנות",
          "status": "planned",
          "detail": "לממש רישום אטומי מאוזן, התאמה וייצוא חשבונאי. תהליך סגירת חודש מאושר לפני גבייה מסחרית."
        }
      ],
      "subscriptionModel": [
        {
          "title": "מנוי למרחב, משלם מזוהה",
          "steps": [
            "אדם מזוהה ב־Clerk; חברות במרחב נבדקת במסד הנתונים",
            "Personal ו־Family לחשבון אישי אחד עם plan_code נפרד; Business ו־Enterprise למרחב עסקי",
            "לכל מנוי פעיל יש חשבון חיוב, משלם וגרסאות מחיר וזכאות מאושרות",
            "בכל טעינה בוחרים מרחב ומשלם לפני הצעת המחיר; השיוך ננעל בצילום התנאים"
          ],
          "failure": "בחירת מסלול אינה מפעילה חיוב, הסכם מסחרי או טעינה. ירידה במכסה דורשת התאמה של הרכבים והחברים הפעילים, ללא מחיקת היסטוריה."
        },
        {
          "title": "מנוי ועמלה הם שני חיובים נפרדים",
          "steps": [
            "גרסת מחיר חודשית או שנתית מפורשת, בלי להכפיל מחיר חסר או להמציא הנחה",
            "עמלת טעינה אחידה של 99 נקודות בסיס (0.99%) לפני מע״מ בכל המסלולים, כולל Enterprise; גרסת התנאים המאושרת נשמרת ללא שינוי חיובים היסטוריים",
            "מחיר טעינה מאומת + עמלת לקוח באחוזים + מסים רלוונטיים",
            "הצגת אומדן ותנאים, נעילת הסכמה, שריון מסגרת וקבלת CDR סופי",
            "חיוב יחיד לכל מחזור מנוי ולכל טעינה; קישור לתשלום, מסמך, החזר והתאמה"
          ],
          "failure": "מחיר או שיעור חסרים חוסמים הפעלה. 0 הוא ערך מסחרי מפורש, לא ברירת מחדל לחוסר מידע."
        },
        {
          "title": "מחזור חיים ושינוי מסלול",
          "steps": [
            "הצעה מאושרת וקבלת תנאים לפני הפעלת זכאות",
            "אירוע גבייה מאומת או אשראי Enterprise מאושר מפעילים תקופת שירות",
            "כשל גבייה יוצר חוב ומדיניות חסד מוגדרת, לא ניסיון חיוב חדש ללא זהות",
            "שינוי מסלול מתוזמן לגרסה ולמועד מוגדרים; מדיניות חיוב יחסי טרם אושרה",
            "ביטול עתידי אינו מוחק מסמכים ואינו משנה מחיר טעינה שכבר אושרה"
          ],
          "failure": "דפדפן שחזר מסליקה אינו הוכחת גבייה. אירועים כפולים או מחוץ לסדר אינם יכולים להכפיל מנוי או לחזור למצב ישן."
        }
      ]
    }