מחברים

מחברים מסנכרנים נתונים מהכלים שהמיזמים שלכם כבר רצים עליהם — מעבדי תשלומים, בנקים, ספקי ענן, פלטפורמות פרסום, ממשקי API של AI — כך שהכנסות ועלויות זורמות ל‑Kordox אוטומטית והופכות לרווח אמיתי, פר‑מיזם.

כל מה שמחבר מושך הוא לקריאה בלבד. Kordox אף פעם לא מזיז כסף, לא משנה הגדרות ולא כותב שום דבר בחזרה לחשבון המחובר.

איך מחברים עובדים

הזרימה זהה עבור כל ספק:

1. הוספה — פתחו מיזם → לשונית מחברים (או פיננסים → מקורות נתונים), לחצו על חבר מקור ובחרו ספק.
2. הרשאה — או OAuth בקליק אחד (אתם מאשרים גישת קריאה במסך של הספק עצמו) או הדבקת מפתח / אסימון API שאתם יוצרים בלוח הבקרה של הספק. הפאנל מציג את הצעדים המדויקים ומקשר ישירות לעמוד הנכון.
3. בדיקה — Kordox בודק את האישור מיד ומודיע לכם אם חסרים היקף (scope) או הרשאה.
4. סנכרון ראשוני — המשיכה הראשונה רצה אוטומטית וממלאת היסטוריה אחרונה.
5. שמירה על עדכניות — Kordox מסנכרן מחדש לפי לוח זמנים (כל ~6 שעות); אפשר גם לסנכרן ידנית בכל עת.
6. שיוך — עסקאות מסונכרנות מנותבות למיזם שאליו הן שייכות (ראו שיוך כסף למיזמים).

משויך למיזם

מחברים משויכים למיזם, כך שכל מיזם רואה רק את החשבונות והנתונים המחוברים שלו. עלויות תשתית ו‑AI ניתנות לאחר מכן לחלוקה בין מיזמים באמצעות שיוך.

אבטחה — איך מטופלים אישורים

• קריאה בלבד מעצם התכנון. כל מחבר מבקש רק היקפי קריאה (חיוב, חיובים, הזמנות, דוחות עלות). שום דבר ש‑Kordox מחזיק לא יכול להוציא כסף, לזכות או להגדיר מחדש את החשבון שלכם.
• מוצפן במנוחה. מפתחות API ואסימוני OAuth מוצפנים לפני האחסון ולעולם לא מוחזרים לדפדפן לאחר השמירה.
• הרשאה מינימלית. במקום שספק תומך באישורים מוגבלי‑היקף (מפתחות מוגבלים של Stripe, אסימונים מוגבלים של Cloudflare, מדיניויות IAM של AWS), המדריך מבקש את ההרשאה הצרה ביותר שעובדת — מפורטת לכל מחבר למטה.
• ביטול בכל עת. ניתוק מסיר את הגישה של Kordox ועוצר את הסנכרון. נתונים שכבר סונכרנו נשארים בספר החשבונות שלכם.

מחברים זמינים

קטגוריה	ספקים	חיבור באמצעות
הכנסות	Stripe, Shopify, PayPal, Square	OAuth (Stripe/Shopify) או מפתח API
מזומן / בנק	Plaid (יתרות מזינות את מסלול המזומן)	מפתח API + אסימון Link
עלות תשתית	Cloudflare, AWS Billing, GCP Billing	מפתח API או OAuth (GCP)
הוצאות פרסום	Meta Ads, Google Ads	OAuth
AI וטוקנים	Anthropic (Claude), OpenAI	מפתח Admin API
אימייל	העברה/BCC + מענה מרשומה	לא מחבר — ראו אימייל

סנכרון, סטטוס ועדכניות

• לוח זמנים. Kordox מסנכרן מחדש מחברים פעילים אוטומטית כל ~6 שעות.
• סנכרון ידני. הפעילו רענון בכל עת משורת המחבר (או סנכרן הכול לקטגוריה). סנכרון ידני פשוט מריץ את אותה משיכה מוקדם יותר.
• סטטוס. כל מחבר מציג את מועד הסנכרון האחרון שלו, את הסכום ומספר העסקאות ב‑30 הימים האחרונים, ואת אחוז השיוך.
• דורש טיפול. מחבר שנכשל צף לראש הרשימה עם השגיאה המדויקת וקיצור דרך בדיקה / סנכרון / הגדרה. שגיאות זמניות במקור מנסות שוב אוטומטית ומתאוששות בסנכרון המתוזמן הבא.
• היסטוריה. כפתור היסטוריה מציג ריצות סנכרון אחרונות ואת תוצאותיהן.

מה כל מחבר צריך

Stripe — תשלומים

מסנכרן תשלומים, העברות, החזרים ועמלות לדוח רווח והפסד פר‑מיזם. קריאה בלבד.

• הרשאות: מפתח API מוגבל עם קריאה על Balance, Charges, Refunds, Subscriptions. (הוסיפו כתיבה על Checkout Sessions רק אם אתם מפעילים חיוב לקוחות — זה כבוי כברירת מחדל ואינו נחוץ לסנכרון.)
• צעדים: Stripe → Developers → API keys → צרו מפתח מוגבל עם ההיקפים למעלה → הדביקו אותו → הוסף חשבון. הכסף מתיישב ב‑Stripe שלכם; המפתח לא יכול להזיז אותו.

Shopify — הזמנות

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

• הרשאות (OAuth): read_orders, read_products.
• צעדים: הזינו את דומיין ה‑mystore.myshopify.com שלכם → התחברות דרך Shopify → אשרו גישת קריאה → תוחזרו לכאן וההזמנות מסונכרנות כהכנסה.
• תצטרכו: חשבון צוות עם הרשאה להתקין אפליקציות.

PayPal — תשלומים

מסנכרן עסקאות PayPal כהכנסה.

• הרשאות: אפליקציית REST של PayPal — ה‑Client ID + Secret שלה (Transaction Search היא לקריאה בלבד).
• צעדים: developer.paypal.com → Apps & Credentials → פתחו/צרו אפליקציית REST → העתיקו Client ID + Secret → הדביקו את שניהם → בחרו Live (או Sandbox) → שמרו.

Square — תשלומים

מסנכרן תשלומים והחזרים של Square כהכנסה.

• הרשאות: אסימון גישה של Square (PAYMENTS_READ).
• צעדים: developer.squareup.com → האפליקציה שלכם → Credentials → העתיקו את אסימון הגישה → הדביקו אותו, אופציונלית הוסיפו Location ID כדי להגביל למיקום אחד → בחרו את הסביבה → שמרו.

Plaid — יתרות בנק

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

• הרשאות: Client ID + Secret של Plaid ואסימון גישת item מ‑Plaid Link (מוצר Balance).
• צעדים: העתיקו Client ID + Secret מלוח Plaid → השתמשו ב‑Plaid Link כדי לחבר את הבנק ולקבל אסימון גישה → הדביקו את שלושתם → בחרו את הסביבה (production/sandbox) → שמרו.

Cloudflare — עלות תשתית

עוקב אחר השימוש ועלויות החיוב של Cloudflare.

• הרשאות: אסימון API מותאם עם הרשאה אחת בלבד — Account → Billing → Read, מוגבל לחשבון שלכם.
• צעדים: לוח בקרה → My Profile → API Tokens → Create Token (Billing Read) → העתיקו אותו → הדביקו אותו, בתוספת Account ID שלכם (בסרגל הימני של ה‑Overview של כל דומיין) → שמרו. Kordox מאמת מיד.

AWS Billing — עלות תשתית

מושך עלות ושימוש של AWS לרווח וההפסד של המיזם הנכון.

• הרשאות: משתמש/מפתח IAM עם הרשאה לקרוא ל‑ce:GetCostAndUsage (AWS Cost Explorer). המדיניות המנוהלת AWSBillingReadOnlyAccess מכסה זאת.
• צעדים: IAM → צרפו את המדיניות למשתמש → צרו access key → הדביקו את ה‑access key ID + secret → אופציונלית הגדירו אזור (ברירת מחדל us-east-1) → שמרו.

GCP Billing — עלות תשתית

מושך את הוצאות Google Cloud כך שעלויות התשתית ינחתו ברווח וההפסד של המיזם הנכון — לפי פרויקט GCP, לפי שירות, לפי יום.

• חיבור (בקליק אחד): בחרו התחברות עם חשבון Google והיכנסו עם הזהות שבבעלותה ה‑GCP שלכם. Kordox מזהה אוטומטית את חשבון החיוב שלכם ואת ייצוא החיוב ל‑BigQuery — רוב ההגדרות לא דורשות הקלדה בכלל.
• הרשאות (OAuth): cloud-billing.readonly + bigquery.readonly.
• הצעד הידני היחיד ב‑GCP: נתוני העלות מגיעים מייצוא ה‑BigQuery של Cloud Billing, שאפשר להפעיל רק בקונסולה — Billing → Billing export → Standard usage cost → בחרו פרויקט + מערך נתונים. אם זה עדיין לא מופעל, רשימת הבדיקות של המחבר מקשרת אתכם ישירות לשם. הנתונים הראשונים נוחתים כ‑24 שעות אחרי ההפעלה (ללא טעינה רטרואקטיבית של היסטוריה).
• מתקדם (ללא OAuth): הדביקו במקום זאת מפתח JSON של חשבון שירות עם Billing Account Viewer + קריאת BigQuery — שימושי לחשבונות מכונה.
• שיניתם משהו ב‑GCP? השתמשו ב‑זיהוי מחדש מ‑Google בכרטיס כדי להריץ מחדש את הזיהוי האוטומטי ולבחור את חשבון החיוב הנכון.

Meta Ads — הוצאות פרסום

מייבא הוצאות פרסום של Meta (Facebook/Instagram) כעלות כך שהמרווחים ו‑CAC יהיו אמיתיים.

• הרשאות (OAuth): ads_read.
• צעדים: התחברות דרך OAuth → אשרו גישת קריאה → בחרו את חשבון המודעות לסנכרון → ההוצאה מיובאת כהוצאות.

Google Ads — הוצאות פרסום

מייבא הוצאות Google Ads כעלות למרווח ו‑CAC אמיתיים.

• הרשאות (OAuth): גישת קריאה לנתוני Google Ads שלכם; תאשרו את מזהה הלקוח (customer ID).
• צעדים: התחברות דרך OAuth → אשרו גישת קריאה → בחרו את החשבון / אשרו את מזהה הלקוח → ההוצאה מיובאת כהוצאות.

Anthropic (Claude) — AI וטוקנים

עוקב אחר הוצאות ה‑API של Claude וסביבת העבודה כעלויות AI, לפי סביבת עבודה — כך שחשבון ה‑AI של כל מיזם יהיה אמיתי.

• הרשאות: תפקיד מנהל ארגון ומפתח Admin API (sk-ant-admin…). מפתח API רגיל אינו יכול לקרוא את השימוש הארגוני. Kordox קורא רק את דוח העלויות היומי.
• צעדים: console.anthropic.com → Settings → Admin keys (לא עמוד מפתחות ה‑API הרגיל) → צרו מפתח Admin → הדביקו אותו כאן.
• שיוך: כל סביבת עבודה של Claude ממופה למיזם, בדיוק כמו פרויקטים של GCP.

OpenAI — AI וטוקנים

עוקב אחר הוצאות ה‑API של OpenAI כעלויות AI, לפי פרויקט.

• הרשאות: תפקיד בעלים/מנהל בארגון ומפתח Admin API (sk-admin…). Kordox קורא רק עלויות יומיות.
• צעדים: platform.openai.com → Settings → Organization → Admin keys → צרו מפתח מנהל → הדביקו אותו כאן.
• שיוך: כל פרויקט OpenAI ממופה למיזם.

שיוך כסף למיזמים

Kordox מנתב כל עסקה מסונכרנת למיזם שאליו היא שייכת, כך שדוח רווח והפסד פר‑מיזם הוא אמיתי במקום "מאיזה חשבון שזה הגיע". שני המנגנונים רטרואקטיביים — Kordox משייך מחדש היסטוריה קיימת כשאתם שומרים ומסנכרנים מחדש.

מיפוי מקור — לספקים עם תת‑ישויות נקיות. עלויות GCP ממופות לפי פרויקט ענן, Cloudflare לפי חשבון, Claude/OpenAI לפי סביבת עבודה/פרויקט. ערכו בפיננסים → עלויות ענן → שיוך.

כללי שיוך — לספקים ללא תת‑ישויות נקיות (מתארי Stripe, הערות בנק). כלל אומר "התיאור מכיל X → מיזם Y": כל עסקה שהתיאור שלה מכיל את הטקסט הזה (ללא הבחנה בין אותיות גדולות לקטנות) נופלת על אותו מיזם; הכלל הראשון שמתאים מנצח. ערכו בפיננסים → חוקר הכסף → כללי שיוך, ואז שמרו וסנכרנו מחדש.

חוקר הכסף

פיננסים → חוקר הכסף פורס את כל הכסף המסונכרן — הכנסות, תשתית, פרסום, AI, עמלות — לפי קטגוריה, ספק, מקור, שירות, מיזם או סוג, על פני כל תקופה. עברו בין כסף נכנס, כסף יוצא ונטו, וייצאו את התצוגה הנוכחית כחוברת Excel, כדוח PDF ממותג או כ‑CSV.

פתרון תקלות

• "דורש טיפול" עם שגיאת סנכרון. פתחו את טקסט השגיאה — הוא כולל כעת את סטטוס ה‑HTTP של המקור. 401/403 פירושו שלמפתח/אסימון חסר היקף נדרש (צרו אותו מחדש עם ההרשאות המפורטות למעלה). שגיאות זמניות מסוג 5xx/הגבלת קצב מנסות שוב אוטומטית ומתנקות בסנכרון המתוזמן הבא.
• מחובר אבל אין נתונים. חלק מהספקים בפיגור: ייצוא ה‑BigQuery של GCP מביא את הנתונים הראשונים כ‑24 שעות אחרי ההפעלה; דוחות עלות AI בפיגור של ~1–2 ימים. תנו לזה מחזור, ואז סנכרנו.
• עלויות על המיזם הלא נכון. הגדירו שיוך ושמרו וסנכרנו מחדש — זה משייך מחדש היסטוריה, לא רק נתונים חדשים.
• בדיקה נכשלת מיד. האישור שגוי או חסר לו היקף; הפאנל מציין מה חסר. צרו את המפתח מחדש והדביקו אותו שוב.