Инструкция к модулю ms_webasyst_api_integration

Модуль связывает CS-Cart с Webasyst через API. Он передает в Webasyst товары и заказы из CS-Cart, получает из Webasyst обновленные данные, а также помогает сопоставлять локальные и удаленные статусы заказов.

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

• отправляет в Webasyst товары и их изменения по SKU;
• создает и обновляет заказы в Webasyst;
• получает из Webasyst обновленные товары и заказы по cron;
• сопоставляет статусы заказов CS-Cart со статусами Webasyst;
• ведет лог запросов и ответов;
• хранит служебные соответствия пользователей и статусов.

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

• Модули → API интеграция с webasyst → Общие — URL аккаунта, токен, включение обновления товаров, интервалы обновления, скидки в заказах, категория по умолчанию, компания по умолчанию, логирование и размер файла логов;
• Модули → API интеграция с webasyst → Дополнительная информация — подсказки по cron;
• Модули → API интеграция с webasyst → Сопоставление статусов — настройка соответствия локальных и удаленных статусов;
• кнопка Получить токен отображается в настройках модуля, если он активен.

Как настроить

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

Сопоставление статусов

В разделе Сопоставление статусов для каждого локального статуса заказа укажите удаленный статус Webasyst. Поддерживаются значения shipped, processed и completed. Когда в CS-Cart меняется статус заказа, модуль отправляет его в Webasyst по выбранному соответствию.

Что синхронизируется

• Товары — обновляются по SKU. Если товара с таким SKU нет, модуль может создать новый товар с названием, описанием, SEO-полями, ценой, остатком, изображениями и значениями по умолчанию из настроек;
• Заказы — при создании и обновлении заказа в CS-Cart модуль передает в Webasyst состав заказа, данные клиента, адрес доставки, способ доставки, комментарий и стоимость доставки;
• Статусы заказов — при изменении статуса заказа в CS-Cart модуль может перевести заказ в Webasyst в состояние shipped, processed или completed.

Дополнительные замечания

• Для обмена данными используйте cron-задачи из раздела Дополнительная информация:

Для обновления товаров: php path_to_site_folder/example.ru/index.php?dispatch=ms_webasyst_api_integration.update_products

Для обновления заказов: php path_to_site_folder/example.ru/index.php?dispatch=ms_webasyst_api_integration.update_orders

• Если не указаны URL аккаунта или токен, синхронизация не выполнится;
• Логирование помогает отследить запросы и ошибки обмена.

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

1. Сохраните настройки модуля и проверьте, что токен заполнен.
2. Измените товар в Webasyst и запустите cron для обновления товаров, затем проверьте изменения в CS-Cart.
3. Создайте или обновите заказ в CS-Cart и проверьте, что он появился или обновился в Webasyst.
4. Измените статус заказа в CS-Cart и убедитесь, что в Webasyst сработало сопоставление статуса.