COS WP e-com

COS WP e-com (WP B2B Commerce) — production-ready полностью независимая e-commerce платформа для WordPress, которая заменяет WooCommerce для B2B- и B2B2C-операций. В отличие от расширений к WooCommerce, плагин владеет собственными 40+ таблицами БД с префиксом `b2b_*`, собственным REST API с 200+ эндпоинтами, собственной React-админкой и storefront-шаблонами. Создан специально для российского рынка — встроенный расчёт НДС (0%/10%/20%), счета-фактуры и ТОРГ-12, CommerceML-интеграция с 1С, нативная поддержка российских платёжных провайдеров (YooKassa, Sberbank, Tinkoff, Robokassa) и логистов (СДЭК, Почта России).

Проблема и контекст

WooCommerce — отличная платформа для B2C-розницы, но архитектурно проблемная для серьёзного B2B. Сложные тиры цен, многокомпанийные аккаунты, кредитные линии, договоры с auto-renewal, EDI-интеграция, маркетплейс с несколькими продавцами, прогрессивные комиссии — всё это собирается из десятков сторонних плагинов с конфликтами и накладными расходами. Российские реалии добавляют: НДС с тремя ставками и режимами включения, печатные формы счетов-фактур и ТОРГ-12, CommerceML 1C, отечественные платёжные шлюзы и логисты, локализация на 12 стран СНГ. WP B2B Commerce собран как ground-up платформа под именно этот сценарий, без поверхностной совместимости с WooCommerce.

Архитектура

Главный bootstrap (`b2b-commerce.php`): константы `B2B_VERSION = 1.1.0`, Singleton `B2B_Commerce` с `get_instance()`, ленивая инициализация на `plugins_loaded` (priority 20), создание 40+ таблиц на активации, регистрация трёх WordPress-ролей (b2b_vendor, b2b_sales_agent, b2b_company_employee). Тумблеры модулей в `b2b_commerce_settings`. PSR-4 автозагрузка `B2B` → `src/`. Три уровня архитектуры: Core (18 менеджеров — Products, Cart, Checkout, Orders, Inventory, Shipping, Coupons, Payments, Reviews, Search, Emails, Account, Settings, Templates, Security, Performance, Analytics, Localization), Modules (7 специализированных — Marketplace, SalesAgents, B2B Contracts & Credit, ProductOptions, CustomerExperience, Communications, Marketing), Integrations (4 домена — CommerceML, Payments, Shipping, CRM).

REST API и интеграции

Все 200+ эндпоинтов лежат под `/wp-json/b2b-commerce/v1/` и обёрнуты в единый `ResponseFormatter` envelope `{ data, meta: { timestamp, version }, errors }` с helpers `success()`, `created()`, `paginated()`, `error()`, `no_content()`. Rate limiting per user-type: admin 5000/час, authenticated 1000/час, guest 100/час с правильными заголовками X-RateLimit-Limit / Remaining / Reset. OpenAPI 3.0 спецификация генерируется автоматически и доступна по `/openapi.json`. Аутентификация: JWT для админки (OAuth-style refresh), X-API-Key для внешних интеграций. Интеграции: 1С через CommerceML в обе стороны (товары, категории, изображения, цены, обратная отправка заказов), Bitrix24 и AmoCRM (контакты, сделки, лиды, webhook).

B2B-возможности

• Customer groups с независимыми ценами и видимостью (Wholesale, Distributor, Partner, Retail)
• Tier pricing per-product и per-group, кастомные правила, индивидуальные цены клиентов
• Quote requests с переговорной механикой и конвертацией в заказ
• Корпоративные аккаунты с ИНН/КПП/ОГРН-валидацией и approval-workflow
• Контракты с auto-renewal и SLA, кредитные линии с tracking и auto-approval
• Partial shipments — отгрузка заказа частями с tracking каждой части
• Auto-orders и recurring orders по расписанию (daily/weekly/monthly) через WP Cron
• EDI интеграция (EDIFACT/XML) для документооборота с крупными клиентами
• Multi-currency (6 валют + курсы ЦБ РФ), WPML-интеграция, локализация под 12 стран СНГ

Marketplace и Sales Agents

Marketplace-модуль превращает магазин в B2B2C-площадку: неограниченное число продавцов с публичными витринами по адресу `/vendor/username/`, OrderSplitter автоматически разделяет мульти-vendor заказ на части, PaymentDistributor считает комиссии (процент / фикс / по категориям) и распределяет выплаты. VendorManager управляет регистрацией, модерацией, уровнями (tiers), управлением складами. Sales Agents — отдельный модуль для торговых агентов: Login-as-Customer (session-based impersonation с timeout), генератор купонов с квотой (50/месяц), журнал активности, email-уведомления клиентам о сгенерированных промокодах.

Аналитика

• RFM-анализ с 11 сегментами (Champions, Loyal, Potential, At Risk, Cant Lose Them, Promising, Needing Attention, About to Sleep, Hibernating, Lost, New)
• Cohort analysis с retention heat map и weekly/monthly когортами
• ABC/XYZ сегментация товаров: 9-сегментная матрица (ABC по Парето + XYZ по вариативности спроса)
• Demand forecasting: 5 алгоритмов (moving average, exponential smoothing, seasonal decomposition, ARIMA, Prophet) с обработкой трендов и сезонности
• Sales funnel с conversion rate per stage и drop-off analysis
• LTV — 3-летний предиктивный customer lifetime value
• Churn rate с identification at-risk клиентов и churn prediction

Безопасность и Localization для России

Rate limiting per endpoint и per user type, nonce-верификация форм, `$wpdb->prepare()` для SQL, обязательные ABSPATH-проверки во всех файлах, role-based permission callbacks. JWT-аутентификация для админки, X-API-Key для интеграций. Локализация под российские реалии: НДС с тремя ставками (0% / 10% / 20%) с режимами включён/исключён, генерация печатной формы счёта-фактуры с автонумерацией, ТОРГ-12 (товарная накладная), Sum-in-words конвертер для юридических документов, RequisitesManager для реквизитов компании (ИНН, КПП, расчётный счёт, БИК). 5 платёжных шлюзов (YooKassa 1-stage / 2-stage / instant refunds, Sberbank, Tinkoff, Robokassa, Bank Transfer, Cash on Delivery). 2 шиппинг-провайдера (СДЭК с rate calc / shipment creation / labels / PVZ directory / tracking, Почта России с rate calc / shipment / tracking).

Production и roadmap

Версия 1.1.0 (февраль 2026). Phase 1–3 roadmap выполнены полностью (Performance Optimization с Redis/Memcached/CDN/PWA, Advanced Analytics с RFM/cohorts/ABC-XYZ/forecasting, B2B Expansions с контрактами/EDI/multi-currency/CIS-локализацией). Текущие фазы 4–6: мобильное приложение на React Native с Apple Pay / Google Pay / СБП, marketing automation (email chains, SMS, browser push, A/B-тесты), marketplace extensions (Ozon, Wildberries, Yandex.Market, Avito, CDEK Marketplace) и интеграция аналитики (Яндекс.Метрика, GA4, пиксели VK/Facebook/TikTok). Repository — `cosinn/b2b-commerce`. URL — wp-plugin.cosinn.ru.

B2B-коммерция в России — это не WooCommerce с плагинами. Это собственный продукт, который понимает НДС, ТОРГ-12 и СДЭК с первого commit'a.