Документация
/ Документация
Руководство по интеграции

Что подготовить перед подключением

Проверьте доступы, публичность данных и совместимость магазина заранее, чтобы установка не остановилась на подтверждении сайта, выгрузке каталога или работе корзины.

На этой странице

Доступы и исходные данные

Нужна почта владельца, на которую приходят письма регистрации и восстановления доступа. Администратору магазина понадобятся права установки решения, изменения его настроек и просмотра источников каталога. Если настройкой занимается подрядчик, заранее определите, кто хранит секреты и кто сможет отозвать их после завершения работы.

Сайт должен быть доступен покупателям по своему настоящему адресу. Для автоматического подключения из Битрикса Anmarto проверяет владение сайтом; недоступный домен или закрытая проверочная страница могут остановить создание аккаунта. Серверу магазина нужен исходящий доступ по HTTPS к Anmarto, браузеру покупателя нужен доступ к загрузчику и публичным запросам виджета. Сертификат и правила защиты сайта должны разрешать эти обращения.

Что подготовить Для чего это нужно
Почта владельца и доступ в кабинет Подтверждение аккаунта, настройки, восстановление входа
Домен нужного магазина Привязка каталога и ключей к правильному сайту
Публичные карточки с названием и адресом Осмысленная выдача и переход покупателя на товар
Цена, валюта, наличие и варианты Корректные коммерческие сведения и выбор предложения
Фид YML/XML/JSON либо модуль Битрикса Передача каталога в Anmarto
Актуальные условия магазина Ответы консультанта о доставке, оплате и возврате
Резервная копия и тестовая копия, если есть Безопасная установка и проверка обновления

Особенности 1С-Битрикс

Для abr.search требуется PHP 8.1 или новее. Это минимальная проверка установщика, а не обещание совместимости любой редакции, сборки и стороннего шаблона. До установки попросите администратора проверить версии Битрикса и PHP, состояние обновлений и используемые доработки поиска.

Выгрузка инфоблоков предполагает работающий модуль инфоблоков. Коммерческие функции зависят от структуры каталога. Для штатного добавления в корзину нужны «Торговый каталог» и «Интернет-магазин». Если цена хранится обычным свойством инфоблока, её можно сопоставить отдельно, но это не создаёт отсутствующую корзину.

Anmarto показывает публичные данные, а не персональный каталог авторизованного покупателя. Не открывайте закрытый дилерский раздел всем посетителям ради выгрузки. Права анонимного посетителя проверяются при подготовке данных; доступ администратора к элементу не означает, что он должен попасть в поиск.

Проверка перед началом

  1. Войдите в почту владельца и убедитесь, что можете получить письмо подтверждения.
  2. Определите домен и магазин, который подключаете первым. При нескольких сайтах не используйте их ключи взаимозаменяемо.
  3. Проверьте возможность открыть обычную карточку без авторизации. Выберите несколько контрольных товаров, включая товар с предложениями и отсутствующий на складе вариант.
  4. Убедитесь, что у товаров стабильные идентификаторы, названия, ссылки, валюта и понятные характеристики. Обсудите источник истины для цен и остатков.
  5. Для Битрикса проверьте PHP и необходимые модули, сделайте копию сайта и настроек перед установкой или обновлением.
  6. Для фида проверьте, что ссылка возвращает данные, а не форму входа или страницу ошибки. Подготовьте полный ассортимент, не только небольшой фрагмент случайной выгрузки.
  7. В кабинете проверьте подключённые продукты и ограничения каталога. Галочка на стороне магазина не отменяет ограничения сайта в сервисе.
  8. Назначьте время проверки витрины и ответственного за исправление источника, если цены, ссылки или варианты расходятся.

Если проверка не проходит

Письмо не пришло: проверьте адрес и нежелательную почту. Домен закрыт защитой: попросите администратора проверить доступ к подтверждению владения, не отключая защиту всего сайта. Нет публичных карточек: сначала исправьте структуру и адреса в магазине. Не хватает модуля корзины: подключайте поиск отдельно и не обещайте покупателю добавление в корзину до реализации интеграции.

После подготовки переходите к ключам, установке Битрикса или фиду каталога. Полный список контрольных действий есть в проверке подключения.