1C-Bitrix אינטגרציה עם Kufar (בלארוס)
נתקלנו במצבים: חנות מבזבזת שעות על הוספת מודעות ידנית ב-Kufar, בעוד מתחרים כבר אוטומטו את הייצוא. כתוצאה מכך, מוצרים מופיעים באיחור, חלקם אף פעם לא מתפרסמים בגלל שגיאות בתיאור. אנחנו לוקחים על עצמנו אינטגרציה מלאה במפתח — מהזנת XML ועד מיפוי קטגוריות ועדכון אוטומטי.
Kufar הוא אתר מודעות בלארוסי עם מדור לחנויות מקוונות. קטגוריות כמו 'אלקטרוניקה', 'רכב', 'ביגוד' ו'מוצרים לבית' מביאות תנועה אמיתית. האינטגרציה שלנו עם 1C-Bitrix מאפשרת לפרסם ולעדכן מודעות אוטומטית, ללא עבודה ידנית.
למה Kufar לא משתמש ב-REST API לפרסום?
בניגוד ל-Avito, Kufar לא מספק REST API ישיר לפרסום מיידי. כל ההעלאות ההמוניות עוברות דרך הזנת XML — לוח הבקרה של השותף סוקר את ההזנה שלך מעת לעת (בדרך כלל כל כמה שעות). זה מטיל מגבלות: מודעות לא מופיעות מיד, אבל זה מספק יציבות לנפחים גדולים.
פורמט ההזנה הוא ניב XML מותאם. דוגמה לערך:
<ad> <id>12345</id> <title>Смартфон Samsung Galaxy A54 8/256GB</title> <description>Описание товара без HTML</description> <price>1299</price> <currency>BYR</currency> <category_id>1113</category_id> <condition>new</condition> <images> <image>https://yourshop.by/img/samsung-a54-1.jpg</image> </images> <params> <param name="Бренд">Samsung</param> </params> </ad> פרט חשוב: Kufar משתמש במזהי קטגוריות משלו (<ad> <id>12345</id> <title>Смартфон Samsung Galaxy A54 8/256GB</title> <description>Описание товара без HTML</description> <price>1299</price> <currency>BYR</currency> <category_id>1113</category_id> <condition>new</condition> <images> <image>https://yourshop.by/img/samsung-a54-1.jpg</image> </images> <params> <param name="Бренд">Samsung</param> </params> </ad> ). רשימת הקטגוריות העדכנית זמינה בתיעוד השותף. category_id שגוי פירושו שהמודעה מגיעה לקטגוריה הלא נכונה.
יצירת ההזנה ב-1C-Bitrix
אנחנו יוצרים סוכן שבונה את הזנת ה-XML מבלוק המידע של הקטלוג. מודול הייצוא הסטנדרטי של Bitrix (category_id) לא עובד עבור Kufar — הפורמט ספציפי מדי. אנחנו כותבים גנרטור משלנו.
סינון מוצרים להזנה:
-
catalog.export— רק מוצרים פעילים -
ACTIVE = Yב-QUANTITY > 0— רק במלאי - החרגה מפורשת של קטגוריות מוצרים ש-Kufar לא מקבל או שאינן רלוונטיות
ניואנס: Kufar מגביל את מספר המודעות הפעילות לחשבון עסקי (תלוי בתעריף). אם הקטלוג חורג מהמגבלה, יש צורך בתעדוף: אנחנו מייצאים מוצרים מובילים לפי רווחיות או מחזור. קריטריוני הבחירה מסוכמים עם הלקוח.
תמונות. Kufar דורש כתובות URL ישירות לתמונות. אם Bitrix משתמש בשינוי גודל תמונות דרך b_catalog_product עם פרמטרים זמניים בכתובת ה-URL, הקישורים האלה לא יציבים. עדיף לציין כתובות URL מקוריות מ-CFile::ResizeImageGet().
תיאורים ללא HTML
Kufar לא מקבל סימון HTML בתיאורי מודעות. שדה /upload/ חייב להיות טקסט פשוט. ב-Bitrix, תיאורי מוצרים מאוחסנים לעתים קרובות ב-<description> בשדות b_iblock_element או DETAIL_TEXT עם PREVIEW_TEXT. נדרש עיבוד: *_TYPE = html בתוספת פענוח ישויות HTML (strip_tags()).
פרמטרי מודעה: מיפוי מאפיינים
לכל קטגוריית Kufar יש סט של פרמטרים חובה ומומלצים. לדוגמה, לסמארטפונים: קיבולת אחסון, אלכסון מסך, סוג SIM. אנחנו לוקחים את הפרמטרים האלה ממאפייני בלוק המידע וממפים אותם לשדות html_entity_decode() בהזנה.
מיפוי מאפיינים: טבלת <param>. מאוחסנת בהגדרות מודול האינטגרציה או בבלוק מידע נפרד. בלי מילוי פרמטרים, המודעה נכנסת למודעה 'בסיסית' ללא פילטרים — המרה נמוכה יותר.
עדכון הזנה ורוטציית מודעות
Kufar דוחף מודעות ישנות יותר למטה ברשימה. כדי לשמור על נראות, יש 'לדחוף' חלק מהמודעות מעת לעת (לעדכן). במסגרת אינטגרציית ההזנה, הדחיפה מדומה על ידי שינוי שדה свойство_инфоблока_ID → название_параметра_Kufar או <price> — כשההזנה משתנה, המודעה נחשבת מעודכנת. זה לא ניצול לרעה: מחירים באמת משתנים, ועדכונים לגיטימיים.
מה כלול בעבודה
| שלב | תוצאה |
|---|---|
| ניתוח קטלוג | קביעת נפח, מגבלות Kufar, קטגוריות עדיפות |
| פיתוח גנרטור הזנה | סוכן Bitrix, פילטרים, עיבוד תמונות ותיאורים |
| מיפוי קטגוריות ופרמטרים | התאמת מזהי Kufar למאפייני בלוק המידע |
| בדיקות | פרסום מודעות בדיקה, התאמות |
| תיעוד והדרכה | הוראות למנהלים, נוהל עדכון |
| תמיכה | חודש תמיכה לאחר ההשקה |
איך להימנע מטעויות אינטגרציה טיפוסיות?
<description>שגוי — יש להתייעץ עם מסמך ההתייחסות של Kufar.- תמונות עם כתובות URL זמניות — יש להשתמש בנתיבי קבצים מקוריים.
- HTML בתיאורים — תמיד להסיר סימון.
- חריגה ממגבלת מודעות — יש להגדיר תעדוף.
מידע נוסף על מגבלות Kufar
מגבלת המודעות הפעילות תלויה בתעריף החשבון העסקי. יש לבדוק בחשבון האישי או מול מנהל הפלטפורמה. אם המגבלה נחצית, מודעות חדשות לא מתפרסמות, וישנות לא מתעדכנות.לוחות זמנים
| משימה | לוח זמנים |
|---|---|
| הגדרת הזנת XML עבור Kufar | 3–7 ימים |
| + מיפוי פרמטרים ל-3–5 קטגוריות | 1–2 שבועות |
| הגדרה מלאה עם תעדוף ועדכון אוטומטי | 2–3 שבועות |
העלות מחושבת באופן אישי לאחר ניתוח הקטלוג ומגבלות התעריף של חשבון Kufar. נבחן את הפרויקט שלך בחינם — פשוט צור קשר, ונכין פתרון למשימות שלך. מומחי 1C-Bitrix מוסמכים, ניסיון של 10+ שנים, למעלה מ-100 אינטגרציות מוצלחות עם אתרי מודעות. אנחנו מבטיחים פעילות יציבה של ההזנה ותמיכה בזמן.