Расширение Обмена С 1С

Пакет расширения Brand Map для интеграции обмена с 1С.

Этот пакет определяет runtime-границу Brand Map. Развертываемые вспомогательные файлы для синхронизации на стороне 1С и приема CommerceML находятся в ../../integrations/one-c-exchange.

Модель Магазина

Одна установленная копия расширения принадлежит одному магазину Brand Map. Приемник CommerceML не моделирует несколько тенантов внутри одной установки.

Устойчивая конфигурация обмена хранится в SDK storage.db под ключом one-c.exchange-config. Старые sandbox-развертывания все еще могут задавать те же значения через exchange-config.json; расширение мигрирует этот файл в storage.db при первом чтении.

{
  "contextId": "store",
  "login": "1c",
  "password": "change-me"
}

Импортированные снимки каталога хранятся как артефакты SDK storage.files, а в storage.db остается небольшая ссылка на каждый контекст магазина. Сырые файлы сессий CommerceML остаются в локальной файловой системе для совместимости с текущими файловыми URL и отладочным повтором. Устаревшие partners.json и файловый catalog.json все еще принимаются при миграции, но используется только первый контекст магазина.

Разработка

bun install
bun test
bun run typecheck
bun run build

Входные Данные Синхронизации Коннектора

POST /api/extension/actions с оберткой действия расширения принимает нормализованные строки каталога от коннектора 1С:

{
  "source": "1c",
  "products": [
    {
      "title": "Tee",
      "slug": "tee",
      "externalSku": "TEE-S",
      "variantTitle": "Tee S",
      "priceAmount": 1200,
      "currencyCode": "RUB",
      "storeId": "store_1",
      "stockLocationId": "stock_location_1",
      "stockedQuantity": 5
    }
  ]
}

Расширение создает или обновляет товары по slug, создает или обновляет варианты по externalSku, задает базовые цены и синхронизирует остатки, когда присутствуют поля магазина и склада.

Лицензия

UNLICENSED. Этот пакет является проприетарным ПО Brand Map и публикуется только для авторизованного использования в runtime расширений Brand Map. Лицензия с открытым исходным кодом не предоставляется.