שלב את החנות המקוונת שלך עם Wildberries באמצעות API

אתם מתחילים למכור ב-Wildberries ונתקלים ב-API לא יציב. התיעוד מתיישן, שיטות משתנות ללא אזהרה. כל כשל לוקח בממוצע שעתיים לניפוי שגיאות. שגיאה במיפוי nmID מובילה לכרטיסים כפולים. הסטטיסטיקות מראות ש-60% מכשלי האינטגרציה נובעים מאימות שגוי או תיעוד מיושן. לפי המרקטפלייס, 80% מהמוכרים נתקלים בבעיות בחודש הראשון.

אנחנו מתחברים למרקטפלייסים כבר 5 שנים ופיתחנו גישה שממזערת סיכונים ביותר מ-20 פרויקטים. במקום לכתוב מחדש קוד לגרסאות API חדשות, יצרנו שכבת התאמה. היא מטפלת אוטומטית בשינויים, ומפחיתה שגיאות פי 3 בהשוואה לקריאות API ישירות. אנחנו מבטיחים פעולה יציבה לאחר ההשקה.

איך אנחנו עוקפים את חוסר היציבות של Wildberries API

שכבת ההתאמה מיירטת תגובות, בודקת את המבנה וממירה נתונים במידת הצורך. אם Wildberries משנה את השדה nmID ל-nmId, האינטגרציה לא נשברת—היא מתאימה את עצמה. זה מפחית עלויות תחזוקה בעד 30%.

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

class WildberriesClient {
    private string $apiToken;
    private string $statsToken;

    public function request(string $method, string $url, array $data = []): array {
        return Http::withHeaders([
            'Authorization' => $this->apiToken,
            'Content-Type' => 'application/json',
        ])->{strtolower($method)}($url, $data)->json();
    }
}

למה מיפוי nmID נכון חשוב

Wildberries משתמש במזהה מספרי פנימי nmID לכל מוצר. הוא שונה מ-vendorCode (SKU). שגיאות מיפוי מובילות לכרטיסים כפולים או לחוסר יכולת לעדכן. אנחנו מתאימים אוטומטית nmID ל-SKU שלכם במהלך ההעלאה הראשונה. לדוגמה, עבור SKU class WildberriesClient { private string $apiToken; private string $statsToken; public function request(string $method, string $url, array $data = []): array { return Http::withHeaders([ 'Authorization' => $this->apiToken, 'Content-Type' => 'application/json', ])->{strtolower($method)}($url, $data)->json(); } } , המערכת זוכרת nmID SKU-123 ומשתמשת בו בבקשות הבאות. זה מפחית זמן ניפוי שגיאות בממוצע שעתיים לכל שגיאה.

איך מוגדרת אינטגרציה: תוכנית שלב אחר שלב

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

מה כלול בעבודה

• תיעוד אינטגרציה: תיאור כל ה-endpoints והמיפויים.
• הגדרת הרשאות גישה וטוקנים לכל דומי�י ה-API.
• הטמעת שכבת התאמה לטיפול בשינויי API.
• הדרכת המנהל שלכם לעבודה עם סנכרון.
• חודש תמיכה חינם לאחר ההשקה.
• אחריות לפעולה יציבה: אם משהו נשבר, אנחנו מתקנים תוך יום.

השוואת דומיינים של Wildberries API

שגיאות נפוצות והפתרונות שלהן

העלאת מוצרים: איך להימנע משגיאות

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

public function createCard(Product $product): void {
    $payload = [[
        'subjectID' => $this->getSubjectId($product->category),
        'variants' => [[
            'vendorCode' => $product->sku,
            'title' => $product->name,
            'description'=> $product->description,
            'brand' => $product->brand,
            'dimensions' => [
                'length' => $product->length_cm,
                'width' => $product->width_cm,
                'height' => $product->height_cm,
                'isValid'=> true,
            ],
            'characteristics' => $this->mapCharacteristics($product),
        ]],
    ]];
    $this->request('POST', 'https://content-api.wildberries.ru/content/v2/cards/upload', $payload);
}

עדכון מחירים ומלאי

איך לעדכן במהירות מחירים והנחות?

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

public function setPriceAndDiscount(string $sku, int $basePrice, int $discountPercent): void {
    $this->request('POST', 'https://discounts-prices-api.wildberries.ru/api/v2/upload/task', [
        'data' => [
            [
                'nmID' => $this->getNmId($sku),
                'price' => $basePrice,
            ]
        ]
    ]);
    $this->request('POST', 'https://discounts-prices-api.wildberries.ru/api/v2/upload/task', [
        'data' => [
            [
                'nm' => $this->getNmId($sku),
                'discount' => $discountPercent,
            ]
        ]
    ]);
}

עדכון מלאי (FBS)

public function updateStocks(array $items): void
{
    $this->request('PUT', 'https://marketplace-api.wildberries.ru/api/v3/stocks/{warehouseId}', [
        'stocks' => array_map(fn($item) => [
            'sku' => $item['sku'],
            'amount' => $item['amount'],
        ], $items)
    ]);
}

קבלת הזמנות FBS

public function getOrders(string $since): array
{
    return $this->request('GET', 'https://marketplace-api.wildberries.ru/api/v3/orders', [
        'limit' => 1000,
        'next' => 0,
        'dateFrom' => strtotime($since),
    ])['orders'] ?? [];
}

תוצאות ולוחות זמנים

אינטגרציה עם Wildberries (מוצרים + מחירים + מלאי + הזמנות) אורכת 14–20 ימי עסקים. בזכות שכבת ההתאמה, אתם חוסכים עד 40% מזמן עיבוד ההזמנות בהשוואה לניהול ידני. ב-95% מהמקרים, האינטגרציה מסתיימת בזמן. צרו קשר לייעוץ—נעריך את היקף העבודה ונציע פתרון אופטימלי. הזמינו אינטגרציה וקבלו סנכרון יציב עם אחריות לביצועים לאחר ההשקה.