Товары на сайте показывают неправильные остатки, менеджеры правят цены в МойСклад, а на сайте они не обновляются. Заказы приходится переносить вручную — это приводит к 20–30% ошибок отгрузки и потерям клиентов. Двусторонняя синхронизация решает проблему: товары, остатки, заказы и статусы обновляются автоматически. Результат — актуальные данные на сайте и в МойСклад без вашего участия. Экономия на ручном вводе данных достигает 200 000 руб. в год.
Какие проблемы решает двусторонняя синхронизация?
Расхождение остатков — самая частая боль. Клиент видит товар в наличии, а на складе его уже нет, или наоборот. Наша синхронизация обновляет остатки каждые 5 минут, снижая количество ошибок отгрузки на 80% по сравнению с ручным управлением. Вторая проблема — ручной перенос заказов. Сотрудники тратят до 2 часов в день на дублирование информации. Двусторонняя синхронизация автоматически создаёт заказ в МойСклад при оформлении на сайте и обновляет статус при отгрузке. Третья — конфликты данных. Если цену изменили одновременно в двух системах, мы используем чёткое правило источника истины: цены и остатки — из МойСклад, SEO и изображения — с сайта.
Как мы реализуем интеграцию
Архитектура и стек
Используем REST API МойСклад версии 1.2, PHP 8.3 с фреймворком Laravel 11 и очередями через Redis. Для аутентификации — Bearer-токен. Все запросы идут через HTTP-клиент с повторными попытками при ошибках. Webhook настроены на события изменения заказов, чтобы статусы обновлялись мгновенно. Архитектура учитывает N+1 запросы и использует чанкованную загрузку данных (пачки по 100 элементов).
Согласно официальной документации API МойСклад, это обеспечивает надёжную интеграцию.
Пример реализации клиента API
class MoiSkladClient { private string $baseUrl = 'https://api.moysklad.ru/api/remap/1.2'; private function headers(): array { return [ 'Authorization' => 'Bearer ' . config('services.moysklad.token'), 'Content-Type' => 'application/json;charset=utf-8', 'Accept-Encoding' => 'gzip', ]; } public function get(string $path, array $params = []): array { return Http::withHeaders($this->headers()) ->get("{$this->baseUrl}/{$path}", $params) ->throw() ->json(); } public function post(string $path, array $data): array { return Http::withHeaders($this->headers()) ->post("{$this->baseUrl}/{$path}", $data) ->throw() ->json(); } } | Сущность | Источник истины | Примечание |
|---|---|---|
| Товары (название, описание, цена) | МойСклад | Менеджеры правят там |
| Остатки | МойСклад | Обновляются при поступлении/продаже |
| Изображения товаров | Сайт | Загружаются через CMS |
| SEO-поля (meta, slug) | Сайт | Не существуют в МС |
| Заказы | Сайт → МС | Создаются на сайте, уходят в МС |
| Статусы заказов | МС → Сайт | Менеджер меняет в МС |
Получение товаров и остатков
class ProductSyncService { public function fetchProducts(int $offset = 0, int $limit = 100): array { return $this->ms->get('entity/product', [ 'offset' => $offset, 'limit' => $limit, 'expand' => 'productFolder,images', 'filter' => 'archived=false', ]); } public function fetchStocks(): array { return $this->ms->get('report/stock/all/current', [ 'stockType' => 'stock', 'includeRelated' => false, ]); } public function syncToSite(): void { $offset = 0; $limit = 100; do { $response = $this->fetchProducts($offset, $limit); $products = $response['rows']; foreach ($products as $msProduct) { $this->upsertProduct($msProduct); } $offset += $limit; } while ($offset < $response['meta']['size']); $stocks = $this->fetchStocks(); foreach ($stocks as $stock) { Product::whereExternalId($stock['assortmentId']) ->update(['stock' => max(0, (int)$stock['stock'])]); } } private function upsertProduct(array $msProduct): void { $msId = $msProduct['id']; $data = [ 'external_id' => $msId, 'name' => $msProduct['name'], 'article' => $msProduct['article'] ?? null, 'price' => $this->parsePrice($msProduct['salePrices'][0]['value'] ?? 0), 'description' => $msProduct['description'] ?? '', 'ms_updated_at'=> Carbon::parse($msProduct['updated']), ]; $product = Product::updateOrCreate(['external_id' => $msId], $data); } private function parsePrice(int $msPrice): float { return $msPrice / 100; } } Передача заказов и webhook
public function pushOrder(Order $order): string { $positions = []; foreach ($order->items as $item) { $positions[] = [ 'assortment' => [ 'meta' => [ 'href' => "{$this->baseUrl}/entity/product/{$item->product->external_id}", 'type' => 'product', ], ], 'quantity' => $item->quantity, 'price' => $item->price * 100, ]; } $msOrder = $this->ms->post('entity/customerorder', [ 'name' => "Заказ #{$order->id}", 'organization' => [ 'meta' => [ 'href' => "{$this->baseUrl}/entity/organization/" . config('services.moysklad.org_id'), 'type' => 'organization', ], ], 'agent' => $this->getOrCreateCounterparty($order->customer), 'positions' => $positions, 'description' => "Источник: сайт\nEmail: {$order->customer->email}", 'attributes' => [ [ 'meta' => ['href' => $this->orderIdAttributeHref()], 'value' => (string)$order->id, ], ], ]); $order->update(['ms_order_id' => $msOrder['id']]); return $msOrder['id']; } При изменении заказа в МойСклад webhook уведомляет наш сервер, и статус автоматически обновляется на сайте:
public function handleMsWebhook(Request $request): Response { $events = $request->json('events', []); foreach ($events as $event) { if ($event['meta']['type'] === 'customerorder') { $msOrderId = basename($event['meta']['href']); SyncOrderStatusJob::dispatch($msOrderId); } } return response()->noContent(); } class SyncOrderStatusJob implements ShouldQueue { public function handle(MoiSkladClient $ms): void { $msOrder = $ms->get("entity/customerorder/{$this->msOrderId}"); // маппинг статусов и обновление заказа } } Как часто обновляются данные и как разрешаются конфликты?
Остатки синхронизируются каждые 5 минут, товары и заказы — каждые 10 минут. Это обеспечивает актуальность без излишней нагрузки на API. При необходимости частоту можно настроить индивидуально.
При двусторонней синхронизации конфликты неизбежны. Наш подход: цена, остатки, артикул — приоритет МойСклад; SEO-поля и изображения — сайт; название — по дате последнего изменения. Мы гарантируем, что вы не потеряете важные изменения. Ошибки отгрузки обходятся в среднем в 50 000 руб. в месяц — синхронизация сводит их к минимуму.
Сравнение подходов
| Характеристика | Односторонняя | Двусторонняя |
|---|---|---|
| Товары, цены, остатки | ✅ | ✅ |
| Заказы (сайт→МС) | ❌ | ✅ |
| Статусы (МС→сайт) | ❌ | ✅ |
| Разрешение конфликтов | не требуется | ✅ |
| Ручной труд менеджеров | ~1 час/день | автоматически |
| Ошибки отгрузки | 20-30% | <5% |
Двусторонняя синхронизация в 10 раз сокращает время на обработку заказов и практически исключает ошибки отгрузки.
Почему стоит выбрать двустороннюю синхронизацию?
Более 5 лет мы интегрируем интернет-магазины с МойСклад. За это время реализовали 30+ проектов, включая сложные с тысячью SKU. Наши инженеры имеют подтверждённую экспертизу в Laravel и REST API. Мы даём гарантию на работоспособность интеграции и оперативно исправляем возможные нестыковки. Экономия на ручном вводе данных достигает 200 000 руб. в год, а затраты на исправление ошибок отгрузки снижаются до 50 000 руб. в месяц.
Процесс и сроки работы
- Аналитика — изучаем структуру каталога, определяем сущности и правила маппинга.
- Проектирование — проектируем интеграцию: какие поля, как часто, обработка ошибок.
- Реализация — пишем код, настраиваем webhook, очереди.
- Тестирование — запускаем тестовую синхронизацию на копии данных, сверяем результаты.
- Деплой — разворачиваем на боевом сервере, проводим мониторинг.
Ориентировочные сроки: односторонняя синхронизация (МойСклад → сайт) — 2–3 рабочих дня; двусторонняя (с заказами, статусами, webhook) — 6–8 рабочих дней. Срок может увеличиться при сложной структуре каталога (вариации, комплекты). Проведём бесплатный аудит вашей текущей системы и предложим оптимальное решение. Свяжитесь с нами, чтобы навсегда забыть о ручном переносе данных. Получите консультацию уже сегодня.