Инструкция к модулю Интеграция с сервисом ЛитРес

Что делает модуль

Модуль работает с книжным каталогом ЛитРес и позволяет:

- импортировать жанры и книги в CS-Cart;
- создавать и обновлять цифровые товары по данным ЛитРес;
- сопоставлять жанры, автора, серию, номер в серии и ISBN с характеристиками магазина;
- передавать файлы покупателю после оплаты;
- отправлять в ЛитРес уведомление о продаже через статус заказа;
- запускать обновление свежих книг по типам и по периоду.

Где находится модуль

В панели администратора откройте Модули → Управление модулями → Интеграция с сервисом ЛитРес.

В настройках доступны разделы:

- Подключение,
- Общие,
- Информация по запуску.

Отдельная настройка для уведомления о продаже есть в Администрирование → Заказы → Статусы заказов. Для нужного статуса нужно включить опцию Отправлять запрос в ЛитРес о продаже.

Перед первым использованием включите в CS-Cart продажу цифровых товаров. Без этого модуль не проходит установку.

Подключение

Во вкладке Подключение укажите:

- ID партнера;
- Секретный ключ;
- Секретный ключ для уведомлений;
- Домен для скачивания;
- Статус для перевода заказа при получении отказа продажи от ЛитРес;
- Тестовый режим.

В тестовом режиме модуль использует тестовые запросы LitRes и помогает проверить сценарий без боевой отправки уведомлений.

Общие настройки

Во вкладке Общие задаются связи с каталогом ЛитРес:

- Категория для дерева жанров ЛитРес. Сюда модуль будет импортировать жанры.
- Автор. Выберите характеристику типа Группа флажков.
- Серия. Выберите характеристику типа Текст или число.
- Номер в серии. Выберите характеристику типа Текст или число с нужной ролью на карточке характеристики.
- ISBN. Выберите характеристику типа Текст или число с нужной ролью на карточке характеристики.
- Продавец. Выберите продавца, которому будут принадлежать импортированные товары.

Информация по запуску

В этом блоке есть отдельные страницы для работы с данными ЛитРес.

Обновление списка жанров

Для загрузки жанров откройте страницу:

admin.php?dispatch=ms_litres_integration.get_genres_list

Что делает эта страница:

- загружает дерево жанров из ЛитРес;
- создаёт или обновляет категории в выбранной родительской категории;
- использует выбранного продавца из настроек.

Обновление товаров

Для загрузки свежих книг откройте страницу:

admin.php?dispatch=ms_litres_integration.get_fresh_book

Допустимые параметры:

- product_type, тип произведений;
- from, дата в формате YYYY-MM-DD;
- days, интервал в днях;
- minutes, интервал в минутах.

Если product_type не передан, модуль обновляет типы 0, 1 и 11.
Если указан from, модуль разбивает период на интервалы и запрашивает обновления по частям.

Работа с товаром

После импорта книга становится обычным цифровым товаром CS-Cart:

- у товара заполняются данные ЛитРес;
- создаются или обновляются файлы книги;
- на витрине ссылка на файл подменяется на адрес скачивания LitRes;
- количество скачиваний ограничивается настройкой файла.

Уведомление о продаже

Чтобы ЛитРес получил сигнал о продаже:

1. Откройте нужный статус заказа.
2. Включите опцию Отправлять запрос в ЛитРес о продаже.
3. Переведите заказ в этот статус после оплаты.

Если ЛитРес вернёт ошибку, модуль переведёт заказ в статус из настройки Статус для перевода заказа при получении отказа продажи от ЛитРес.

Как проверить работу

1. Включите продажу цифровых товаров.
2. Заполните подключение к ЛитРес.
3. Выберите категорию жанров, характеристики и продавца.
4. Запустите обновление жанров.
5. Запустите обновление товаров.
6. Проверьте карточку импортированной книги и файл для скачивания.
7. Переведите тестовый заказ в статус с включённой отправкой запроса в ЛитРес.
8. Убедитесь, что покупатель видит файл, а заказ проходит нужный сценарий уведомления.