Назад к блогу
Архитектура 11 мин чтения

Микросервис поставщиков: свой склад, ячейки, баркоды и автозагрузка наличия

Поставщик в интернет-магазине — источник исполнения, а не только чужой прайс. Как устроить свой склад с секциями и инвентаризациями и забирать остатки у внешних поставщиков разными каналами.

Микросервис поставщиков: свой склад, ячейки, баркоды и автозагрузка наличия

Зачем отдельный микросервис «Поставщики»

В интернет-магазине автозапчастей «наличие и цена» — не поле в карточке товара. Это поток: кто отдаёт позицию, сколько реально лежит, по какой цене сегодня, как быстро собрать и отгрузить. Микросервис поставщиков держит этот контур отдельно от каталога TecDoc, поиска и checkout.

Его зона ответственности обычно такая:

  • реестр поставщиков и их контрактных условий (срок, минималка, возвраты);
  • офферы: артикул ↔ цена ↔ остаток ↔ срок поставки;
  • правила приоритета (свой склад → локальный партнёр → удалённый);
  • загрузка наличия по разным каналам;
  • для собственного склада — адресация ячеек, штрихкоды, инвентаризации.

Поставщик ≠ только «чужой прайс»

Под поставщиком в доменной модели удобно понимать источник исполнения. Это может быть:

  • внешний оптовик с API/FTP;
  • локальный партнёр с ручным или полуавтоматическим фидом;
  • собственный склад — тот же тип сущности, но с полноценным WMS внутри.

С точки зрения витрины и корзины свой склад — тоже поставщик: у него есть офферы, SLA отгрузки и приоритет. С точки зрения операций — это уже складское хозяйство: секции, уровни, этажи, баркоды, инвентаризации.

                    ┌─────────────────────────┐
                    │     Витрина / BFF       │
                    └───────────┬─────────────┘
                                │ офферы, наличие
                    ┌───────────▼─────────────┐
                    │  Микросервис поставщиков │
                    └─┬──────────┬──────────┬─┘
          ┌───────────┘          │          └───────────┐
          ▼                      ▼                      ▼
 ┌────────────────┐   ┌──────────────────┐   ┌────────────────────┐
 │ Внешний API    │   │ Файлы / FTP/SFTP │   │ Собственный склад  │
 │ поставщика     │   │ прайсы, остатки  │   │ (WMS + barcodes)   │
 └────────────────┘   └──────────────────┘   └────────────────────┘

Собственный склад работает как «настоящий» склад

Если завести свой склад как «просто остаток в одной колонке Excel», вы экономите неделю на старте и теряете месяцы на операционке. Нормальная модель адресации:

  • склад / филиал → этаж → зона/секция → ряд → стеллаж → уровень → ячейка;
  • каждая ячейка и каждая единица (или партия) — со штрихкодом;
  • движение только через документы: приход, перемещение, резерв, отбор, отгрузка, списание;
  • остаток в витрине = сумма по ячейкам минус резервы, а не «цифра из головы кладовщика».
  Склад «Минск-1»
  └── Этаж 1
      └── Секция A (быстроизнашиваемые)
          └── Ряд A-03
              └── Стеллаж 02
                  └── Уровень 3
                      └── Ячейка A-03-02-3-07  [barcode]
                          └── партия / единица  [barcode]

Без баркодирования инвентаризация превращается в «пройтись глазами». Со штрихкодами — это сканер + задание + сверка плана/факта по ячейке.

Почему «не вести склад» убивает время

Типичная цена хаоса, которую я вижу на внедрениях:

  • менеджер продаёт «есть», кладовщик ищет 15–40 минут;
  • дубли и пересорт: один артикул в трёх местах без адреса;
  • инвентаризация раз в квартал «всем складом» вместо циклической по секциям;
  • возвраты и претензии из‑за отгрузки не той партии/не того кросса;
  • невозможно честно приоритизировать «свой склад» в поиске — цифра недостоверна.

Время теряется не в «написании WMS», а в ежедневных минутах поиска, пересчёта и разруливания ошибок. Автоматизация окупается, когда адресный учёт становится источником правды для оффера.

Инвентаризации: как это выглядит в зрелом контуре

Экспертиза склада — это не только «знаем, что есть ячейки». Это процесс:

  1. план инвентаризации: склад → секция/зона → набор ячеек;
  2. заморозка или мягкая блокировка ячеек на время счёта;
  3. сканирование факта (пусто / расхождение / OK);
  4. акты расхождений и корректировки остатка;
  5. выгрузка актуального наличия в слой офферов витрины.
┌──────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
│ План инвент. │───▶│ Задание на   │───▶│ Сканирование │───▶│ Акт / corr.  │
│ по секциям   │    │ ТСД/сканер   │    │ ячейка+товар │    │ остатка      │
└──────────────┘    └──────────────┘    └──────┬───────┘    └──────┬───────┘
                                               │                   │
                                               ▼                   ▼
                                        расхождение?         оффер витрины
                                        повторный счёт       обновлён

Циклическая инвентаризация горячих секций (быстрый оборот) даёт больше точности, чем «большая ночная» раз в полгода.

Автозагрузка наличия от поставщиков: разные пути, разная специфика

Внешние поставщики почти никогда не отдают данные одинаково. В одном сервисе приходится держать адаптеры:

  • REST/SOAP API — online-остаток и цена, лимиты, токены, идемпотентность запросов;
  • FTP/SFTP + файлы (CSV/XML/XLSX) — расписание, кодировки, «плывущие» колонки, частичные выгрузки;
  • email-вложения — парсинг писем, карантин вложений, дедуп;
  • личный кабинет / scraping как крайний случай — хрупко, нужен мониторинг ломки вёрстки;
  • ручной импорт менеджером — тот же пайплайн валидации, что и у автофида.

Общий конвейер при этом один: ingest → normalize (артикул/бренд) → validate → apply pricing rules → publish offers. Специфика живёт в адаптере, а не в витрине.

  Источник                  Адаптер              Ядро поставщиков
 ─────────                 ────────             ─────────────────
  API  ──────┐
  FTP  ──────┼──▶ decode ──▶ map SKU ──▶ rules ──▶ offers store ──▶ search/cart
  Mail ──────┤              │
  Manual ────┘              └── dead-letter / retry / alert

Отдельно — семантика «наличия»: у кого-то это точный qty, у кого-то «>10 / мало / нет», у кого-то остаток с задержкой 6–24 часа. Сервис должен хранить тип достоверности, иначе UI врёт клиенту одинаково уверенно.

Свой склад и внешние фиды в одном приоритете

Когда собственный склад смоделирован как поставщик, правила выбора оффера становятся прозрачными:

Запрос: артикул + регион клиента
        │
        ▼
 Собрать офферы: [OWN_WH] [LOCAL_1] [API_A] [FTP_B]
        │
        ▼
 Фильтры: qty>0 или допустимый backorder, география, стоп-лист
        │
        ▼
 Сортировка: приоритет источника → срок → цена → достоверность остатка
        │
        ▼
 В корзину: резерв на OWN_WH сразу; у внешних — soft-hold / recheck

Резерв на своём складе обязан быть ячеистым (или хотя бы документным). Иначе два менеджера продадут одну и ту же деталь с одной полки.

Что внедрять по этапам

  1. Единый реестр поставщиков + нормализация артикулов.
  2. Адаптеры фидов и единый store офферов.
  3. Свой склад как поставщик: адресация + штрихкоды + приход/отбор.
  4. Инвентаризации по секциям и мониторинг расхождений.
  5. Приоритеты офферов и резервы, завязанные на реальный остаток.

Прыгать сразу в «полный WMS на 20 экранов» без адресного учёта — частая ошибка. Сначала правда остатка, потом красота интерфейса.

Чем могу помочь (оффер)

Если вы строите или уже ведёте aftermarket-магазин, могу закрыть конкретные задачи:

  • аудит за 1 созвон — что выносить из OpenCart/PrestaShop первым, где теряется маржа и время на складе/контенте;
  • архитектура и внедрение — микросервисы каталога, поставщиков/WMS, поиска, применяемости;
  • AI/MCP-контур — ускорение ввода применяемости, категорий и аналогов с human-in-the-loop.

Формат: платная консультация или поэтапная разработка с измеримым результатом (очередь карточек, достоверность остатка, time-to-shelf). Пишите через форму контактов или на info@prybytkow.ru — кратко опишите стек и узкое место.

Читайте также