docs.modx.pro
ms3Remains
Остатки товаров MiniShop3 по комбинациям опций
  • MODX 3
  • PHP 8.2
  • miniShop3
  • Vue 3
Зависимости
  • miniShop3
  1. Компоненты
  2. ms3Remains
  3. Интеграции
  4. Обмен с внешними системами

Обмен с внешними системами ​

CSV-обмен ​

Раздел «Остатки» поддерживает экспорт и импорт CSV. Это контролируемый путь массового обновления остатков: выгрузка из учётной системы конвертируется в CSV и загружается через manager.

Экспорт ​

Кнопка Экспорт CSV отдаёт файл ms3remains-remains.csv с колонками:

КолонкаОписание
remain_idid строки остатка, ключ импорта
product_idid товара
product_nameназвание товара
variant_idid варианта ms3Variants или пусто
variant_skuартикул варианта или пусто
optionsJSON комбинации опций
quantityтекущее количество

Импорт ​

Диалог импорта CSV

Кнопка Импорт CSV открывает диалог из трёх шагов:

  1. Вставьте текст CSV и при необходимости комментарий (например «Сверка поставки №123»).
  2. Нажмите Проверить файл. Таблица покажет текущее количество, новое и дельту. Ошибки формата выводятся списком по номерам строк.
  3. Применить импорт активна только если проверка прошла без ошибок (canCommit). Ключ строки — remain_id из экспорта. Количество принимается дробным.

Импорт меняет количество через setQuantity, поэтому срабатывают события и проекция, как при ручной правке.

Сервисный API ​

Для интеграции из PHP (плагины, cron-скрипты, свои импортёры) возьмите сервис ms3remains:

php
/** @var \Ms3Remains\Ms3Remains $ms3remains */
$ms3remains = $modx->services->get('ms3remains');

Пример: поставить остаток по товару и опциям.

php
use Ms3Remains\Identity\OptionsCanonicalizer;
use Ms3Remains\Identity\StockIdentityResolver;

$resolver = new StockIdentityResolver(
    new OptionsCanonicalizer(),
    $modx->services->get('ms3remains.ms3variants'),
);

$identity = $resolver->resolve($productId, ['color' => 'красный', 'size' => 'M'], null);
$ms3remains->remains()->setQuantity($identity, 15.0, 'import 1c', $modx->user->get('id'));

setQuantity ставит абсолютное значение, changeBy сдвигает на дельту. Оба пишут проекцию и вызывают события.

CommerceBridge1C ​

CommerceBridge1C пишет остатки в msProductData.stock напрямую и не вызывает событий, которые ms3Remains мог бы перехватить. Поэтому совместная работа строится так:

  1. CB1C продолжает вести каталог и цены.
  2. Запись остатков из CB1C отключается или игнорируется: проекция ms3Remains всё равно перезапишет stock при следующем изменении остатка.
  3. Остатки из 1C попадают в ms3Remains через CSV-импорт или сервисный API выше.

Раздел «Настройки» показывает предупреждение, когда CommerceBridge1C обнаружен на сайте.