Загрузка каталога — это настройка на стороне RetailCRM, где вы указываете ссылку на ICML-файл сайта, расписание и правила сопоставления цен и складов. Сайт генерирует файл, а CRM его читает и превращает в свой справочник товаров.
Как RetailCRM забирает каталог
В RetailCRM каталог живёт отдельно от сайта. Система периодически скачивает ICML-файл по указанной ссылке, разбирает его и обновляет справочник товаров: добавляет новые позиции, меняет цены и остатки, деактивирует исчезнувшие.
Важно различать два понятия:
- Каталог — источник товаров (ссылка на ICML, расписание, правила);
- Магазин — торговая площадка в CRM, к которой привязан каталог и приходят заказы.
Добавление источника ICML
Источник настраивается в разделе Администрирование → Настройки каталога. Нажмите «Добавить каталог» и заполните основные поля.
| Поле | Что указать |
|---|---|
| Название | понятное имя каталога |
| Ссылка на файл | URL ICML на сайте |
| Магазин | к какой площадке привязать |
| Расписание | частота загрузки |
Ссылка должна отдавать файл без авторизации и по HTTPS, например https://shop.ru/retailcrm/icml. После сохранения можно запустить первую загрузку вручную, не дожидаясь расписания.
Расписание и объём загрузки
RetailCRM скачивает файл по расписанию — по умолчанию примерно раз в час. Частоту выбирают исходя из того, как часто меняются цены и остатки, и насколько тяжело сайту генерировать файл.
- Часто меняются остатки — имеет смысл более частая загрузка;
- Большой каталог — реже, чтобы не перегружать генерацию на сайте;
- Первая загрузка всегда полная, последующие обновляют изменившиеся позиции.
Типы цен и склады
Если магазин работает с несколькими ценами (розница, опт, акция) или несколькими складами, их нужно сопоставить в CRM. Дополнительные типы цен заранее заводятся в Администрирование → Типы цен, а склады — в настройках складов.
- Заведите в CRM нужные типы цен и склады;
- В ICML сайт выгружает цены и остатки с их кодами;
- RetailCRM сопоставляет коды из файла со своими справочниками.
Остаток по складу в ICML передаётся атрибутом quantity. Если мультискладской учёт не ведётся, достаточно единого остатка на основной склад.
Журнал загрузки и контроль
Результат каждой загрузки виден в журнале раздела «Настройки каталога». По нему проверяют, что файл скачался, распарсился и сколько позиций обновилось.
- Дата и время последней успешной загрузки;
- Число товаров и предложений, попавших в справочник;
- Ошибки разбора — если файл невалиден или недоступен.
Если журнал показывает старую дату, загрузка не проходит: чаще всего ссылка недоступна, файл отдаётся с ошибкой или превышен таймаут скачивания.
Частые ошибки загрузки
Большинство проблем на стороне CRM сводится к доступности и валидности файла.
| Симптом | Причина |
|---|---|
| Каталог не обновляется | ссылка недоступна или требует авторизации |
| Ошибка формата | невалидный XML, неэкранированные символы |
| Товары без остатков | не передан quantity или не сопоставлен склад |
| Дубли товаров | вариации без общего productId |
| Таймаут | файл строится слишком долго |
Итог
Загрузка каталога в RetailCRM — это связка «источник ICML → магазин» с расписанием и сопоставлением цен и складов. Настройка выполняется в разделе «Настройки каталога», а контроль идёт по журналу загрузки. Ключевые условия успеха — доступная HTTPS-ссылка, валидный XML и разумная частота обновления.
Мы подключаем и отлаживаем загрузку каталога под конкретный магазин: настраиваем источник, типы цен и склады, проверяем журнал и добиваемся стабильного обновления справочника без таймаутов.
Частые вопросы
Чем каталог отличается от магазина в RetailCRM?
Каталог — это источник товаров (ссылка на ICML и правила загрузки), а магазин — торговая площадка, к которой приходят заказы. Каталог привязывается к магазину в настройках.
Где в RetailCRM подключить каталог сайта?
В разделе Администрирование → Настройки каталога. Там добавляют источник, указывают ссылку на ICML, магазин и расписание загрузки.
Можно ли запустить загрузку вручную?
Да, после сохранения источника можно запустить первую загрузку сразу, не дожидаясь расписания. Это удобно для проверки настройки.
Как проверить, что каталог загрузился?
Откройте журнал загрузки в настройках каталога: там видны дата последней загрузки, число обновлённых позиций и ошибки разбора файла.
Почему товары загрузились без остатков?
В ICML не передан атрибут quantity или не сопоставлен склад. Проверьте выгрузку на сайте и настройки складов в RetailCRM.
Как настроить несколько типов цен?
Сначала заведите нужные типы цен в RetailCRM, затем выгружайте их в ICML с соответствующими кодами. CRM сопоставит коци из файла со своими типами цен.
Что делать при таймауте загрузки большого каталога?
Готовьте ICML заранее по cron и отдавайте статический файл, а не стройте его на каждый запрос. Тогда CRM успеет скачать каталог в отведённое время.
Поможем с настройкой и поддержкой RetailCRM
Поможем с настройкой, доработкой и поддержкой RetailCRM.