Зачем отдельный микросервис «Поставщики»
В интернет-магазине автозапчастей «наличие и цена» — не поле в карточке товара. Это поток: кто отдаёт позицию, сколько реально лежит, по какой цене сегодня, как быстро собрать и отгрузить. Микросервис поставщиков держит этот контур отдельно от каталога 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», а в ежедневных минутах поиска, пересчёта и разруливания ошибок. Автоматизация окупается, когда адресный учёт становится источником правды для оффера.
Инвентаризации: как это выглядит в зрелом контуре
Экспертиза склада — это не только «знаем, что есть ячейки». Это процесс:
- план инвентаризации: склад → секция/зона → набор ячеек;
- заморозка или мягкая блокировка ячеек на время счёта;
- сканирование факта (пусто / расхождение / OK);
- акты расхождений и корректировки остатка;
- выгрузка актуального наличия в слой офферов витрины.
┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐
│ План инвент. │───▶│ Задание на │───▶│ Сканирование │───▶│ Акт / 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
Резерв на своём складе обязан быть ячеистым (или хотя бы документным). Иначе два менеджера продадут одну и ту же деталь с одной полки.
Что внедрять по этапам
- Единый реестр поставщиков + нормализация артикулов.
- Адаптеры фидов и единый store офферов.
- Свой склад как поставщик: адресация + штрихкоды + приход/отбор.
- Инвентаризации по секциям и мониторинг расхождений.
- Приоритеты офферов и резервы, завязанные на реальный остаток.
Прыгать сразу в «полный WMS на 20 экранов» без адресного учёта — частая ошибка. Сначала правда остатка, потом красота интерфейса.
Чем могу помочь (оффер)
Если вы строите или уже ведёте aftermarket-магазин, могу закрыть конкретные задачи:
- аудит за 1 созвон — что выносить из OpenCart/PrestaShop первым, где теряется маржа и время на складе/контенте;
- архитектура и внедрение — микросервисы каталога, поставщиков/WMS, поиска, применяемости;
- AI/MCP-контур — ускорение ввода применяемости, категорий и аналогов с human-in-the-loop.
Формат: платная консультация или поэтапная разработка с измеримым результатом (очередь карточек, достоверность остатка, time-to-shelf). Пишите через форму контактов или на info@prybytkow.ru — кратко опишите стек и узкое место.
