אינטגרציה של 1C-Bitrix ו-Wildberries עבור בלארוס

ה-API של WB זמין בכתובת suppliers-api.wildberries.ru. האימות מתבצע באמצעות API key בכותרת Authorization: {token}. לכל מפתח יש סט הרשאות משלו. המפתחות נוצרים בחשבון האישי של המוכר, ומספרם אינו מוגבל.

שיטות מפתח לאינטגרציה עם Bitrix:

• POST /content/v2/cards/upload — העלאת כרטיסי מוצר
• POST /api/v3/warehouses/{warehouseId}/stocks — עדכון מלאי
• GET /api/v3/orders/new — הזמנות חדשות
• POST /api/v3/orders/status — עדכון סטטוסי הזמנות
• GET /api/v3/supplies/{supplyId}/barcode — ברקוד אספקה לתיוג

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

1. לקבל את סכמת המאפיינים באמצעות GET /content/v2/object/charcs/{subjectId}
2. למפות מאפייני WB למאפייני אינפובלוק של Bitrix
3. לנרמל ערכים: WB דורשת ערכים ממילון (למשל, צבעים אך ורק ממילון WB, ולא מחרוזות שרירותיות)

מיפוי מאפייני WB ↔ מאפייני Bitrix הוא החלק הקפדני ביותר. עבור קטלוג עם 10 פריטים (ג'ינס, חולצות, מעילים…) משמעות הדבר היא 10 טבלאות מיפוי. לפי המדידות שלנו, כל קטגוריה דורשת כ-8–12 שעות עבודת אנליסט. חיסכון בזמן לאחר אוטומציה מגיע עד 80%.

המלאי ב-WB מתעדכן באמצעות POST /api/v3/warehouses/{warehouseId}/stocks. עבור מוכרים מבלארוס, המחסן יכול להיות בבעלות עצמית (FBS — fulfillment by seller) או מחסן WB (FBO). עם FBS, אנו מעדכנים מלאי מ-Bitrix; עם FBO, המלאי כבר בצד של WB, וסנכרון נדרש רק לצורכי בקרה.

WB משתמשת בברקודים לזיהוי SKU בעת עדכון מלאי. הברקוד מוקצה בעת יצירת הכרטיס. אנו שומרים את המיפוי WB_barcode → Bitrix_offer_id בטבלה נפרדת. עדכון מלאי עבור כל ה-SKU כל 15–30 דקות הוא נוהג סטנדרטי. מגבלות WB: לא יותר מ-1000 פריטים לבקשה.

לכן, עבור קטלוגים מעל 10,000 SKU, נדרש פיצול לאצוות. זמן עיבוד ממוצע לבקשה הוא 2–3 שניות. הדבר מפחית שגיאות מלאי ב-95% בהשוואה להזנה ידנית.

כיצד מעובדות הזמנות מ-Wildberries?

GET /api/v3/orders/new מחזיר הזמנות חדשות בסטטוס "ממתין להרכבה". עבור כל הזמנה:

• למצוא את המוצר המתאים ב-Bitrix לפי ברקוד
• ליצור הזמנה ב-b_sale_order באמצעות \Bitrix\Sale\Order::create()
• לצרף מטא-נתוני WB להזמנה: מזהה הזמנה ב-WB, מזהה אספקה, תאריך אספקה

לאחר ההרכבה, אנו מעבירים את מזהה האספקה והתיוג ל-WB. WB מייצרת תוויות — אנו מדפיסים אותן. השיטה GET /api/v3/orders/{orderId}/label מחזירה תווית PDF. כל התהליך מקבלת ההזמנה ועד הדפסת התווית אורך לא יותר מ-5 דקות במצב אוטומטי — ידנית זה אורך עד 15 דקות.

השוואת FBS ו-FBO עבור בלארוס פרמטר FBS (מחסן עצמי) FBO (מחסן WB) אחריות על אחסון המוכר WB עדכוני מלאי מ-1C-Bitrix בזמן אמת אוטומטית בצד של WB לוגיסטיקה לקונה המוכר שולח למחסן WB WB מספקת באופן עצמאי שליטה על המוצר מלאה מוגבלת עבור עסקים קטנים, FBS לרוב רווחי יותר — אין צורך לשלוח אצווה למחסן WB.

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

מאפיינים ספציפיים של אינטגרציה עבור בלארוס

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

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

מאפיינים ספציפיים אלה אינם משפיעים על היישום הטכני אך דורשים תשומת לב בשלב התכנון.

מה כלול בשירות

פרויקט אינטגרציה טיפוסי כולל:

• ביקורת של הקטלוג הנוכחי והברקודים
• הכנת סכמת מיפוי מאפיינים
• פיתוח מודול סנכרון (לקוח REST וסוכנים)
• הגדרת עדכוני מלאי אוטומטיים וייבוא הזמנות
• בדיקות על נתונים חיים והדרכת צוות
• תיעוד על האלגוריתם
• תמיכה ל-30 יום לאחר ההשקה

אנו מתחייבים שהאינטגרציה לא תוביל לשכפול הזמנות או לאובדן מלאי. למהנדסים שלנו יש 10+ שנות ניסיון ב-Bitrix ויותר מ-50 אינטגרציות מרקטפלייס. בקשו ייעוץ וקבלו אומדן ראשוני של עלות האינטגרציה. צרו קשר – נציע תוכנית אופטימלית לפרויקט שלכם.

אומדני זמן

העלות מחושבת בנפרד. לצורך אומדן, אנו זקוקים ל: רשימת פריטי הקטלוג, מצב נוכחי של נתוני ברקוד ומאפיינים, סכמת לוגיסטיקה (FBS/FBO). קבלו אומדן אישי – השאירו בקשה.