Налаштування синхронізації залишків постачальників Бітрікс

Покупець замовляє товар, якого немає у постачальника — класична проблема дропшипінгу. За статистикою, до 15% замовлень зривається через застарілі залишки, а в пікові сезони — до 30%. Ми стикалися з проектами, де магазин втрачав 20% виручки. Наприклад, один із клієнтів з п'ятьма постачальниками замовив налаштування синхронізації і через два тижні скоротив скасування замовлень на 90%. Щоб цього уникнути, залишки на сайті повинні синхронізуватися з реальною наявністю у постачальників. Бітрікс зберігає залишки на складах у таблиці b_catalog_store_product, наше завдання — тримати цю таблицю в актуальному стані.

Ми пропонуємо налаштувати синхронізацію залишків під ключ: від аналізу джерел даних до моніторингу та алертингу. Строк реалізації — від 5 до 14 робочих днів залежно від кількості постачальників та складності форматів. Замовте налаштування у нас — ваші клієнти перестануть стикатися з несподівано відсутніми товарами.

Як влаштована архітектура синхронізації?

Вибір схеми залежить від технічних можливостей постачальника та вимог до актуальності даних. Розглянемо три варіанти:

Push-вебхук від постачальника — постачальник сам повідомляє при зміні залишку. Це в 3 рази швидше pull-фідів, але вимагає від постачальника технічної можливості надсилати POST-запити на наш ендпоінт.

Pull-фід за розкладом — агент Бітрікс завантажує файл (XML/CSV/JSON) з FTP або HTTP постачальника кожні N хвилин. Це найпоширеніший варіант, підходить для 80% проектів.

Прямий доступ до API постачальника — ми запитуємо залишок у момент перегляду товару або додавання в кошик. Навантажує API постачальника, але дає дані в реальному часі.

Pull-синхронізація через фід

Агент Бітрікс запускається за розкладом і оновлює залишки. Нижче приклад класу, який ми використовуємо в продакшені:

// /local/lib/Dropshipping/StockSync/FeedProcessor.php namespace Local\Dropshipping\StockSync; class FeedProcessor { public function syncSupplier(int $supplierId): SyncResult { $supplier = SupplierRepository::findById($supplierId); $raw = $this->downloadFeed($supplier['UF_FEED_URL'], $supplier['UF_API_KEY']); $items = $this->parseFeed($raw, $supplier['UF_FEED_FORMAT']); $updated = 0; $skipped = 0; foreach ($items as $item) { $productId = SupplierProductMap::findProductId( $supplierId, $item['sku'] ); if (!$productId) { $skipped++; continue; } $this->updateStock($productId, $supplier['UF_STORE_ID'], (int)$item['quantity']); $updated++; } return new SyncResult($supplierId, $updated, $skipped); } private function updateStock(int $productId, int $storeId, int $quantity): void { $existing = \CCatalogStoreProduct::GetList( [], ['PRODUCT_ID' => $productId, 'STORE_ID' => $storeId] )->Fetch(); if ($existing) { \CCatalogStoreProduct::Update($existing['ID'], ['AMOUNT' => $quantity]); } else { \CCatalogStoreProduct::Add([ 'PRODUCT_ID' => $productId, 'STORE_ID' => $storeId, 'AMOUNT' => $quantity, ]); } // Оновлюємо загальний залишок у b_catalog_product $total = $this->getTotalStock($productId); \CCatalogProduct::Update($productId, ['QUANTITY' => $total]); } } 

Чому ми використовуємо інтерфейс парсерів?

Постачальники передають дані в різних форматах. Ми реалізуємо FeedParserInterface та конкретні парсери під кожен формат — це спрощує додавання нових постачальників, наприклад, CSV або XML. Інтерфейсний підхід скорочує час інтеграції нового постачальника на 40% порівняно з монолітним парсером.

interface FeedParserInterface { public function parse(string $raw): array; // повертає [{sku, quantity}, ...] } class CsvFeedParser implements FeedParserInterface { public function parse(string $raw): array { $lines = str_getcsv($raw, "\n"); $result = []; // Визначаємо роздільник: ; або , $delimiter = str_contains($lines[0], ';') ? ';' : ','; foreach (array_slice($lines, 1) as $line) { // пропускаємо заголовок [$sku, $qty] = str_getcsv($line, $delimiter); if ($sku && is_numeric($qty)) { $result[] = ['sku' => trim($sku), 'quantity' => (int)$qty]; } } return $result; } } class XmlFeedParser implements FeedParserInterface { public function parse(string $raw): array { $xml = simplexml_load_string($raw, 'SimpleXMLElement', LIBXML_NOCDATA); $result = []; foreach ($xml->offer as $offer) { $result[] = [ 'sku' => (string)$offer->vendorCode, 'quantity' => (int)$offer->stock, ]; } return $result; } } 

Push-синхронізація (вебхук від постачальника)

Якщо постачальник може надсилати POST-запити, ми реалізуємо ендпоінт з аутентифікацією за ключем:

// /local/ajax/supplier/stock-webhook.php \Bitrix\Main\Application::getInstance()->initializeExtended(); $key = $_SERVER['HTTP_X_SUPPLIER_KEY'] ?? ''; $supplierId = \Local\Dropshipping\SupplierAuth::validate($key); if (!$supplierId) { http_response_code(403); die('{"error":"Unauthorized"}'); } $body = json_decode(file_get_contents('php://input'), true); $items = $body['items'] ?? []; $processor = new \Local\Dropshipping\StockSync\FeedProcessor(); $result = $processor->syncItems($supplierId, $items); echo json_encode(['updated' => $result->updated, 'skipped' => $result->skipped]); 

Реєстрація агента синхронізації

// Агент запускається кожні 30 хвилин для кожного постачальника \CAgent::Add([ 'NAME' => '\Local\Dropshipping\StockSync\SyncAgent::run();', 'MODULE_ID' => 'local', 'PERIOD' => 1800, // 30 хвилин 'NEXT_EXEC' => date('d.m.Y H:i:s', time() + 1800), 'ACTIVE' => 'Y', ]); 

Як обробляти товари з нульовим залишком?

При обнуленні залишку ми не просто ставимо QUANTITY = 0, а знімаємо товар з продажу:

private function handleZeroStock(int $productId): void { // Встановлюємо статус «Немає в наявності» через b_catalog_product \CCatalogProduct::Update($productId, [ 'QUANTITY' => 0, 'QUANTITY_TRACE' => 'Y', 'CAN_BUY_ZERO' => 'N', 'NEGATIVE_AMOUNT_TRACE' => 'N', ]); // Скидаємо кеш картки товару \Bitrix\Main\Data\TaggedCache::clearByTag('iblock_id_' . CATALOG_IBLOCK_ID); } 

Логування та моніторинг

Кожна синхронізація логується в таблицю HL-блоку StockSyncLog:

Якщо за останні 2 години немає успішної синхронізації для активного постачальника — агент-монітор надсилає алерт на пошту технічного адміністратора.

Як додати нового постачальника? (покрокова інструкція)

1. Отримайте від постачальника зразок даних (XML/CSV/JSON) та домовтеся про розклад вивантаження.
2. Створіть картку постачальника в Бітрікс (Highload-блок Suppliers) із зазначенням типу синхронізації та параметрів підключення.
3. Реалізуйте парсер під формат постачальника, реалізувавши FeedParserInterface (наш шаблон скорочує час на 40%).
4. Зареєструйте агент з періодом 5–30 хвилин залежно від частоти оновлень.
5. Перевірте на тестових даних: співставлення артикулів, обробку нульових залишків, логування.
6. Увімкніть моніторинг — алерти при збоях.

Що входить у налаштування синхронізації?

Наша команда має 8+ років досвіду з 1С-Бітрікс та понад 50 успішних інтеграцій з постачальниками. Отримайте консультацію інженера — ми розрахуємо строки та вартість за один робочий день. Зв'яжіться з нами, щоб уникнути втрат через неактуальні залишки.