Shop-Script на платформе Webasyst — коробочное решение с собственным API и плагином обмена с 1С. Это даёт свободу размещения и доработок, но требует аккуратной настройки: OAuth-доступ, плагин CommerceML, сопоставление номенклатуры. Разберём, как связать Shop-Script с 1С и CRM и как перейти на 1С-Битрикс.
Webasyst и Shop-Script: как устроено
Webasyst — это фреймворк и набор приложений, устанавливаемых на ваш сервер. Магазин — приложение Shop-Script. Такая коробочная архитектура означает полный доступ к файлам, базе и возможность ставить плагины, включая обмен с 1С.
Для интеграции важны три вещи:
- API Webasyst с OAuth-авторизацией через единый аккаунт Webasyst ID;
- плагин обмена с 1С в Shop-Script, работающий по CommerceML;
- импорт/экспорт в CSV, XML и YML для разовых операций.
API и авторизация
Webasyst предоставляет REST-подобное API с авторизацией по OAuth 2.0: приложение получает токен через Webasyst ID и обращается к методам магазина. Вызовы строятся вокруг сущностей товара, заказа, категории — например, получение списка товаров и заказов, создание и обновление позиций.
Схема обращения выглядит так:
GET /api.php?app=shop&method=shop.product.getList&access_token=...
API удобно для сценариев, которые не покрывает штатный обмен: выгрузка заказов в стороннюю CRM, кастомная синхронизация цен по группам, интеграция с маркетплейсами. Для регулярного обмена каталогом и заказами с 1С правильнее использовать специализированный плагин, а не «крутить» всё вручную через API.
Обмен с 1С по CommerceML
Для Shop-Script есть плагин обмена с 1С, реализующий стандартный протокол CommerceML 2. Настройка сводится к тому, что в 1С прописывается точка обмена, а Shop-Script принимает и отдаёт пакеты:
- 1С выгружает
import.xml(номенклатура, свойства, категории); offers.xmlнесёт цены и остатки по складам;- Shop-Script раскладывает данные по товарам и характеристикам;
- оформленные заказы отдаются обратно в 1С этим же протоколом.
Как и везде в связках с 1С, критичен стабильный идентификатор товара (внешний код/артикул). Отдельно проверьте маппинг характеристик Shop-Script на свойства номенклатуры 1С — именно на нём чаще всего рассыпаются вариации товаров.
Каталог, цены и остатки
Shop-Script гибко работает с типами товаров и характеристиками, поэтому сопоставление с 1С нужно продумать заранее.
| Сущность Shop-Script | Источник в 1С | Ключ |
|---|---|---|
| Товар | Номенклатура | Внешний код / артикул |
| Артикул/вариант | Характеристика | Код характеристики |
| Цена (розница/опт) | Тип цен | Соответствие типов |
| Остаток | Склад | ID склада |
| Категория | Группа номенклатуры | Внешний код группы |
Для B2B полезно, что Shop-Script умеет несколько типов цен и складов — это ложится на многоскладской учёт и опт из 1С. Остатки лучше отдавать пообъектно (по складам), если на витрине нужно показывать наличие в конкретных точках.
Заказы и статусы
Заказы Shop-Script уходят в 1С через плагин CommerceML, а в CRM — через API. Правильная схема:
- новый заказ фиксируется в Shop-Script и передаётся в 1С/CRM;
- из 1С возвращаются статусы оплаты и отгрузки, номер и трек;
- прослойка держит карту соответствия статусов между системами.
Если основная CRM внешняя (Битрикс24, retailCRM), заказы удобнее забирать через API Shop-Script событийно и заводить сделки на стороне CRM, а плагин 1С оставить только под товароучёт. Так не возникает конкуренции двух каналов за один заказ.
Миграция на 1С-Битрикс
Причины переезда с Shop-Script на 1С-Битрикс обычно связаны с масштабом B2B: сложные фильтры и характеристики, персональные и дилерские цены, интеграции с маркетплейсами и логистикой, требования к производительности каталога.
Миграция проходит проще, чем из облака, потому что есть прямой доступ к БД Shop-Script:
- Каталог — переносится из 1С в Битрикс по CommerceML;
- Характеристики — раскладываются в свойства инфоблока и SKU;
- Клиенты и заказы — экспорт из БД/через API Shop-Script;
- URL — карта 301-редиректов со старых ЧПУ Shop-Script.
Так как обе системы работают с CommerceML, первоисточником каталога остаётся 1С — это снимает риск потери данных при переносе.
Итог
Shop-Script на Webasyst — коробка со штатным плагином обмена с 1С по CommerceML и OAuth-API для всего остального. Ключ к стабильной связке — постоянные внешние коды товаров, аккуратный маппинг характеристик и складов на 1С и чёткое разделение, кто владелец заказа: плагин или API-канал в CRM.
Мы настраиваем обмен Shop-Script с 1С и внешними CRM, а при росте B2B-требований переносим магазин на 1С-Битрикс с сохранением каталога, характеристик и SEO. Если Shop-Script перестаёт справляться с ассортиментом и ценами — поможем связать системы или спланировать переезд.
Частые вопросы
Как Shop-Script обменивается с 1С?
Через плагин обмена с 1С, работающий по протоколу CommerceML 2. 1С выгружает номенклатуру, цены и остатки, а заказы забираются обратно тем же протоколом.
Какая авторизация в API Webasyst?
OAuth 2.0 через единый аккаунт Webasyst ID: приложение получает access-токен и вызывает методы магазина — списки товаров, заказов, создание и обновление позиций.
Когда использовать API, а когда плагин 1С?
Регулярный обмен каталогом и заказами с 1С ведут плагином CommerceML. API берут для того, чего плагин не покрывает: выгрузка в стороннюю CRM, кастомные цены по группам, интеграции с маркетплейсами.
Поддерживает ли Shop-Script опт и несколько складов?
Да, Shop-Script умеет несколько типов цен и складов, что хорошо ложится на многоскладской и оптовый учёт 1С. При настройке важно сопоставить типы цен и ID складов.
Почему после обмена появляются дубли товаров?
Как правило, из-за нестабильных внешних кодов в 1С. Если при выгрузке коды меняются, плагин не находит совпадение и создаёт новую карточку. Генерацию кодов нужно зафиксировать.
Как не задублировать заказы при внешней CRM?
Определите единственного владельца заказа. Не отправляйте один заказ одновременно и через плагин 1С, и через API в ту же систему — иначе получите дубли и рассинхрон статусов.
Сложно ли перейти с Shop-Script на 1С-Битрикс?
Проще, чем из облака: есть прямой доступ к базе. Каталог переносится из 1С по CommerceML, характеристики раскладываются в SKU, а старые URL закрываются 301-редиректами.
Поможем с настройкой и поддержкой Интеграции и связки систем
Поможем с настройкой, доработкой и поддержкой Интеграции и связки систем.