Интеграция с сервисом ЛитРес

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

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

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

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

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

Настройки — в карточке модуля Интеграция с сервисом ЛитРес в разделе Модули → Управление модулями. Настройки разделены на вкладки Подключение, Общие и Информация по запуску.

Опция уведомления о продаже расположена в карточке статуса заказа в разделе Администрирование → Заказы → Статусы заказов.

Подключение

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

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

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

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

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

• Категория для дерева жанров ЛитРес — сюда модуль импортирует жанры;
• Автор — характеристика типа «Группа флажков»;
• Серия — характеристика типа «Текст или число»;
• Номер в серии — характеристика типа «Текст или число» с нужной ролью на карточке характеристики;
• 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:

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

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

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

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

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

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

Типовые проблемы

• Импорт ничего не загружает. Проверьте ID партнёра, секретный ключ и тестовый режим в настройках подключения.
• Жанры не создаются. Проверьте выбранную категорию для дерева жанров и права продавца, которому принадлежат товары.
• Уведомление о продаже не отправляется. Проверьте, что у нужного статуса заказа включена опция отправки запроса в ЛитРес.