Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

OneCatalog Integration Standard

Платформо-независимый стандарт интеграции для плагинов импорта каталога из OneCatalog (Wiki API) в товарные системы разных CMS/CRM. Это канонический источник истины для всех платформенных портов.

  • 📄 INTEGRATION-STANDARD.md — сам стандарт. Два сценария: импорт каталога из Wiki API (§1–§12: контракты, маппинг, слои, инварианты, очередь, настройки, точки расширения, i18n, жизненный цикл, чек-лист) и синхронизация цен и остатков из B2B-фида (§13: отдельный API/авторизация, стратегии цены × регионы, остатки по складам, change-detection против нагрузки).
  • 🗂 integration-reviews/ — планы портирования по платформам (<платформа>.md — план, <платформа>-answers.md — ответы на вопросы плана: факты живого API + рекомендации).
  • 🧪 fixtures/ — общие тестовые payload'ы с живого API (для всех портов).

Документация OneCatalog: https://docs.onecatalog.net/

Эталонная реализация

Стандарт абстрагирован от эталонной реализации на WordPress + WooCommerce: OneCatalog/onecatalog-woocommerce (namespace OneCatalog\Import). На любой новой платформе строится по этому стандарту (внешние контракты §2 и инварианты §5 неизменны; меняется только слой «как это лечь в конкретную CMS»).

Статус платформ

Платформа План Ответы Репозиторий
WooCommerce (эталон) onecatalog-woocommerce
1С:Управление Торговлей (УТ 11.5) onecatalog-1c (расширение в ERP, v1.1.3)
1С-Битрикс 📦 в репо 📦 в репо 🚧 onecatalog-bitrix (в разработке, ветка dev)
Bitrix24 (CRM, REST-приложение) 🔜 planned (отдельная цель от 1С-Битрикс: crm.product + REST/OAuth, не модуль /bitrix/modules/)
PrestaShop (8.x) 📦 в репо 📦 в репо 🚧 onecatalog-prestashop (в разработке, ветка dev)
OpenCart (3.0.3.x) 📦 в репо 📦 в репо 🚧 onecatalog-opencart (в разработке, ветка dev)
Magento 2.4.x 📦 в репо 📦 в репо 🚧 onecatalog-magento (в разработке, ветка dev)
Shopify (public app, Remix) 📦 в репо 📦 в репо 🚧 onecatalog-shopify (в разработке, ветка dev)
BigCommerce 🔜 planned
Drupal Commerce 🔜 planned
Joomla 🔜 planned
МойСклад 🔜 planned
RetailCRM 🔜 planned
Megaplan 🔜 planned
Moguta.CMS 🔜 planned
NetCat 🔜 planned
Shop-Script 🔜 planned
PHPShop 🔜 planned
UMI.CMS 🔜 planned
SAP 🔜 planned

При реализации платформы её план (<платформа>.md + -answers.md) переезжает в репозиторий платформы как docs/integration-plan.md, а здесь остаётся ссылка.

Версионирование

Стандарт версионируется отдельно (см. CHANGELOG.md). Каждый платформенный порт указывает, какой версии стандарта он соответствует.

Лицензия

MIT.

About

Platform-agnostic integration standard for OneCatalog catalog import plugins (canonical source of truth)

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors