מודול לוח בקרה לשותפים ב-1С-Bitrix: ייחוס ועמלות

תארו לעצמכם חנות מקוונת עם 5000 הזמנות בחודש, 30% מהמכירות מגיעות משותפים. כל מנהל משקיע 10 שעות בשבוע בחישוב ידני של עמלות ובאיחוד נתונים. שגיאות ייחוס גורמות למחלוקות ולנטישת שותפים. המודול שלנו ל-1С-Bitrix הופך את הייחוס והעמלות לאוטומטיים. שותפים נכנסים לחשבון האישי שלהם, רואים סטטיסטיקות, יוצרים קישורים ועוקבים אחר תשלומים—ללא מעורבות מנהל. תוך 4–5 שבועות אתם מקבלים מודול שמחזיר את ההשקעה כבר בחודש הראשון. דיוק הייחוס הוא 98%, וחישוב העמלות אוטומטי לחלוטין. יש לנו ניסיון של 5+ שנים בפיתוח מודולי שותפים ל-Bitrix, עם 30+ פרויקטים שהושלמו. חיסכון בזמן מנהל: עד 40 שעות בחודש.

איך עובד הייחוס

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

ייחוס באמצעות Cookie

כאשר משתמש לוחץ על קישור הפניה (?ref=PARTNER_CODE), נכתב cookie בשם partner_ref בדפדפן עם TTL של 30–90 ימים (ניתן להגדרה). ה-cookie הוא HttpOnly כך ש-JavaScript לא יכול לשנות אותו.

ייחוס באמצעות UTM

במקביל, קוד השותף נשמר ב-session. כאשר מתבצעת הזמנה, האירוע OnSaleOrderAdd קורא את שני המקורות, קובע את הייחוס וכותב שדה מותאם אישית b_sale_order_props לתוך PARTNER_CODE. בנוסף, נעשה שימוש בפרמטרי UTM למעקב אחר קמפיינים שיווקיים.

// Пример обработчика атрибуции \Bitrix\Main\EventManager::getInstance()->addEventHandler('sale', 'OnSaleOrderAdd', function(\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); $partnerCode = $_COOKIE['partner_ref'] ?? $_SESSION['partner_ref']; if ($partnerCode) { $order->setField('PARTNER_CODE', $partnerCode); } }); 

כל קודי השותפים, העמלות וסטטוסי התשלומים נשמרים בטבלאות המודול:

• // Пример обработчика атрибуции \Bitrix\Main\EventManager::getInstance()->addEventHandler('sale', 'OnSaleOrderAdd', function(\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); $partnerCode = $_COOKIE['partner_ref'] ?? $_SESSION['partner_ref']; if ($partnerCode) { $order->setField('PARTNER_CODE', $partnerCode); } }); – פרופילי שותפים
• myvendor_partner – קישור הזמנה-שותף, סכום עמלה
• myvendor_partner_order – היסטוריית תשלומים

למה חישוב עמלות גמיש הוא קריטי

זו הלוגיקה העסקית עם הכי הרבה וריאציות, והיא חייבת להיות גמישה מההתחלה. העמלה יכולה להיות תלויה ב:

• קטגוריות מוצרים בהזמנה (אחוזים שונים לקטלוגים שונים)
• סכום ההזמנה (סקאלה פרוגרסיבית)
• רמת השותף (Silver / Gold / Platinum)
• הזמנה של לקוח חדש או חוזר

חישוב העמלות האוטומטי שלנו מהיר פי 5 מאיחוד ידני—ללא שגיאות. לדוגמה, עבור לקוח עם 1000 הזמנות בחודש, המודול מעבד תשלומים בשעה אחת, בעוד שבעבר זה לקח 3 ימים.

class CommissionCalculator { public function calculate(\Bitrix\Sale\Order $order, Partner $partner): float { $rules = CommissionRuleTable::getActiveRules($partner->getLevel()); $commission = 0.0; foreach ($order->getBasket() as $item) { $rule = $this->matchRule($rules, $item->getProductId()); $commission += $item->getPrice() * $rule->getRate() / 100; } return round($commission, 2); } } 

החישוב מופעל ב-handler myvendor_partner_payout—העמלה נצברת רק על הזמנות ששולמו. במקרה של החזרה (class CommissionCalculator { public function calculate(\Bitrix\Sale\Order $order, Partner $partner): float { $rules = CommissionRuleTable::getActiveRules($partner->getLevel()); $commission = 0.0; foreach ($order->getBasket() as $item) { $rule = $this->matchRule($rules, $item->getProductId()); $commission += $item->getPrice() * $rule->getRate() / 100; } return round($commission, 2); } } ), העמלה מתבטלת אוטומטית. גישה זו מבטלת שגיאות ואיחוד ידני. שיעורי העמלה יכולים לנוע בין 5% ל-30% בהתאם לכללים.

החשבון האישי של השותף

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

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

קישורי הפניה. השותף מזין כל כתובת אתר, המודול מוסיף את b_user ומציג את הקישור המוכן. בנוסף, זמינה יצירת קישורי UTM עם פרמטרים מולאוים מראש.

חומרים שיווקיים. בלוק מידע עם באנרים בגדלים שונים. השותף בוחר באנר, מקבל את קוד ה-HTML להטמעה—הקישור בבאנר כבר מכיל את קוד ההפניה שלו.

מודול ניהול

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

תהליך הפיתוח

1. אנליזה – הבהרת דרישות, תוכניות ייחוס ועמלות, אב טיפוס לחשבון.
2. עיצוב – ארכיטקטורת מסד נתונים, ממשקי API, אינטגרציה עם האתר הנוכחי.
3. יישום – פיתוח המודול, הגדרת מטמון, תיוג.
4. בדיקות – בדיקות יחידה לעמלות, בדיקות עומס לייחוס.
5. פריסה – התקנה על השרת, הגדרת סוכנים, מסירת תיעוד.
6. תיעוד והדרכה – מסירת מסמכים, הדרכת מנהלים.

מה כלול

לאחר סיום, אנו מספקים:

• תיעוד API וארכיטקטורה
• גישה לשרת ולפאנל הניהול
• הדרכת מנהלים
• חודש אחד של תמיכה באחריות

הניסיון והערבויות שלנו

יש לנו 5+ שנות ניסיון בפיתוח 1С-Bitrix, עם 30+ מודולי שותפים שיושמו במגוון נישות—מחנויות מקוונות ועד פלטפורמות B2B. אנו מבטיחים שהמודול עובד ביציבות תחת עומס, מטפל נכון בייחוס ואינו מאט את האתר. כל הקוד עובר בדיקת קוד ועומד בתקני Bitrix. דוגמה: עבור לקוח עם 1000 הזמנות בחודש, המודול מעבד תשלומים בשעה אחת, וחוסך 40 שעות מנהל בחודש.

לוחות זמנים לפיתוח

השאלה המרכזית לפני התחלה: האם יש צורך במבנה רב-רמתי (שותף מגייס תת-שותפים)? אם כן, סכימת הנתונים משתנה מהותית.

תיעוד רשמי של OnSaleOrderPaid

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