OneCatalog Import — 1С-Битрикс

Модуль импорта каталога из OneCatalog (Wiki API) в 1С-Битрикс (инфоблоки iblock + торговый каталог catalog).

• Стандарт интеграции (канон): OneCatalog/onecatalog-standard — соответствует стандарту v1.0
• Эталонная реализация: OneCatalog/onecatalog-woocommerce
• План порта и ответы: docs/integration-plan.md · docs/integration-answers.md
• История изменений: CHANGELOG.md · текущая версия — 0.1.0 (в разработке)

⚠️ Статус: ранняя разработка. Готов фундамент (манифест, установка, слои Api/Units/Settings); импортёр товаров, медиа, очередь и UI — в работе.

Установка

Модуль — папка onecatalog.import/. Скопировать её в /bitrix/modules/ целевого сайта и установить через Marketplace → Установленные решения (или Настройки → Модули). Требуются установленные модули iblock и catalog — без них установка корректно сообщит об ошибке (не упадёт).

onecatalog.import/            ← копировать в /bitrix/modules/
├── install/                  манифест (CModule), version.php, таблицы oc_queue/oc_media
│   ├── admin/                обёртки → /bitrix/admin (копируются при установке)
│   └── js/onecatalog.import/ picker-loader.js + admin-import.js → /bitrix/js
├── include.php               автозагрузка классов (Loader::registerAutoLoadClasses)
├── lib/                      слои (namespace OneCatalog\Import)
│   ├── api.php               клиент Wiki API (HttpClient, base/token/lang, обёртка)
│   ├── units.php             конвертер единиц (вес→г, размеры→мм)
│   ├── settings.php          опции + валидация/кламп (Option), origin picker'а
│   ├── taxonomies.php        свойства/enum/разделы (find-or-create по label)  ✅
│   ├── productimporter.php   оркестратор импорта одного товара                ✅
│   ├── queue.php             AJAX-степпер (импорт порции + лог)               ✅
│   ├── media.php             изображения: размер/скачивание/дедуп/качество   ✅
│   └── {brand,country,collection}importer.php  справочные сущности (список)  ✅
├── admin/                    onecatalog_import.php (picker+список+степпер),
│                             onecatalog_settings.php, onecatalog_mapping.php,
│                             menu.php                                         ✅
└── lang/{ru,en}/             языковые файлы

Использование

1. Скопировать onecatalog.import/ в /bitrix/modules/, установить модуль.
2. OneCatalog → Настройки: указать токен Wiki API, целевой инфоблок, язык, шаг.
3. OneCatalog → Импорт товаров: либо «Выбрать товары» (виджет-пикер OneCatalog в iframe), либо вставить список public_id вручную. Импорт идёт порциями со прогрессом и логом.

Picker встраивается с origin, зафиксированным настройкой Origin виджета выбора (по умолчанию https://tools.onecatalog.net); сообщения postMessage принимаются только от этого origin. Если админка за жёстким CSP/X-Frame-Options — всегда работает fallback «импорт по списку public_id» (стандарт §2.4).

Ключевые решения (из плана и ответов)

Решение	Выбор	Почему
Module ID	onecatalog.import	vendor=onecatalog, в духе WP-namespace OneCatalog\Import
Ключ идемпотентности	свойство OC_PUBLIC_ID (не XML_ID)	страховка от обмена 1С (CommerceML перезаписывает XML_ID)
Артикул	свойство ARTICLE = article	≠ public_id (§5.2); пуст — не заполняем
Бренд по умолчанию	свойство-список (L)	HL требует модуль highloadblock → opt-in
Коллекции	отдельный инфоблок (дефолт) / раздел / свойство	«тип объекта + цель» (§7)
Очередь	AJAX-степпер (primary) + агент (фолбэк)	агенты без cron непредсказуемы
API	D7 (Bitrix\Main) + CIBlock*/CCatalog*	HTTP/ORM/настройки на D7, CRUD каталога — legacy
Цена	не задаётся	в Wiki API цен нет (§5.6); сайт через событие
Габариты	WEIGHT (г) / WIDTH·LENGTH·HEIGHT (мм)	внутренние единицы Битрикса = г/мм

Требования

• 1С-Битрикс с модулями iblock и catalog (редакция «Малый бизнес»+).
• PHP 8.0+ (конструкторные property promotion, типы).
• Для дерева категорий используется parent_category из /categories/.

Лицензия

GPLv2.