woocommerce-module/doc/FAQ/FAQ.md

FAQ

Ребрендинг модуля с RetailCRM на Simla.com

Ребрендинг модуля WooCommerce связан с тем, что данные он востребован на зарубежном направлении и название нашей системы в Испании и ЛатАм - Simla.com. Для клиентов, которые работают с данным модулем CMS в РФ, ничего не меняется, модули будут также поддерживаться и развиваться.

Прошу обратить внимание, что в связи с ребрендингом изменилось название ICML-файла названия каталога - simla.xml (ранее было retailcrm.xml).

Ребрендинг произошел в версии 4.3.0.

Работа с более чем одним магазином в Woo

В данный момент в модуле не предусмотрена работа с более чем 1 магазином в Woo.

Работа с одинаковыми позициями в заказе

Модуль поддерживает работу с одинаковыми товарными позициями в заказе начиная с версии 3.5.4

Изменения генерации ICML-файла В модуле возможно сделать необходимые кастомизация для генерации ICML-файла в желаемом формате

Выгрузка архивных данных
Ранее модуль (до версии 4.3.3) мог выгружать не более 700-800 архивных заказов (т.к. выгрузка происходила по web-хиту, работа скрипта была ограничена и не все данные успевали прогрузится в CRM), этот момент был доработан (#70113) и сейчас модуль загружает из Woo в CRM все присутствующие заказы пачками по 50 шт (сделано для того, чтобы у слабых серверов не возникало проблем с загрузкой). Также заказы архивные данные можно выгрузить с использованием консольного скрипта: нужно скачать этот скрипт, загрузить его в корень сайта на сервере upload_to_crm.php (название файла)

<?php
/** Load WordPress Bootstrap **/
require_once dirname( __FILE__ ) . '/wp-load.php';
do_action("wp_ajax_do_upload");

После чего в командной строке ввести команду

php upload_to_crm.php

тем самым запустить выполнение скрипта. Для последнего действия нужно использовать ssh. После выполнения данных действий дожидаемся завершение работы. При этом информация об ошибках при выгрузке заказов будет фиксироваться в разделе WooCommerce "Статус", "Журналы". Как скрипт завершит работу в командной строке появляется возможность ввести новую команду.

Работа с зонами доставки (WooCommerce - Настройки - Доставка - Зоны доставки)

С зонами доставки модуль не работает

https://github.com/retailcrm/woocommerce-module/blob/master/src/include/abstracts/class-wc-retailcrm-abstracts-settings.php#L256

Как только появляются новые методы доставки они автоматически добавляются в настройки CRM.

Выгрузка вариативных товаров

В модуле добавлен обработка всех типов товаров в WooCommerce. Раньше обрабатывались только variable/simple, теперь, если тип товара не является variation/variable + кастомные типы плагинов содержащие торговые предложения (variable-subscription и т.п.), то обрабатываются как simple. Стандартные типы товаров обрабатываются корректно, но любые кастомные типы с плагинов все равно необходимо исследовать.

Причины возникновения ошибок

Не пришел заказ из Woo в CRM
Причина может быть в Методе оплаты. Если в настройках CRM (Настройки - Справочники - Типы оплат) в конкретном типе оплаты не выбран статус оплаты, с которым пришел заказ из CMS, то заказ не будет выгружен в CRM. Данная проблема должна решиться после реализации задачи #73631.

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

В CRM не отображаются остатки по товару / При создании заказа в CRM, товар не списывается со склада в Woocomerce

Необходимо выключить редактирование остатков в настройках CRM (Настройки - Системные - Склад - Разрешить редактирование остатков). При включенной опции количество товаров из ICML-файла будет игнорироваться при загрузке. Также для магазина, привязанного к сайту Woo, должны быть разрешены все склады.

По решению проблемы должны немного помочь задачи #54708 и #74803.

В CRM приходит оплаченный заказ, хотя в Woo оплаты не было

Требуется проверить активность опции “Оплата произведена” (Настройки - Справочники - Статусы оплат) в статусе оплаты, с которым приходит заказ в CRM.

Когда заказ создается через Woocommerce, то ему на почту приходит вся информация по заказу, а если создается через CRM, то на почту приходит чаще всего приходит пустая карточка, но не всегда, от чего это может зависеть?

Это не проблема, а логика работы нашего модуля. Модуль не отправляет письма, то есть в Woo сохраняется заказ без суммы (она проставляется чуть позже), но как только заказ появляется в Woo, срабатывает хук и отправляется письмо на email, как раз без суммы.

Работоспособность модуля
На работоспособность модуля влияют:
1) Оплата модуля Онлайн-консультанта.
2) Для работы модуля требуются файлы generate_icml.php и retailcrm_history.php (не удалять их).

Ранее заказы могли не выгружаться из WooCommerce в CRM по причинам (сейчас заказы выгружаются, т.к. была убрана валидация):

• Отсутствовала страна в настройках.
  Если в настройках CRM в списке доступных стран (Настройки - Системные - Общие - Список доступных стран) не была выбрана страна, указанная в выгружаемом заказе, то заказ не появлялся в CRM. После внедрения задачи #74148, заказы с неразрешенной страной приходят в CRM. При открытии карточки заказа, появляется pop-up с информацией о том, что указанную в заказе страну нужно добавить в настройках.

• Неразрешенный способ оплаты в доставке.
  Если в настройках CRM в справочниках Типов доставок (Настройки - Справочники - Типы доставок - перейти в конкретный справочник - вкладка Способы оплаты) не был разрешен способ оплаты для доставки, указанной в выгружаемом заказе, то заказ не приходил в CRM. После внедрения задачи #71543, заказы с неразрешенной оплатой для доставки, выгружаются в CRM. При заходе в карточку данного заказа, появляется pop-up с информацией о том, что для доставки требуется разрешить указанный метод оплаты.

Не синхронизируется история изменений из Simla.com, не генерируется каталог или не синхронизируются остатки

Необходимо проверить, выполняет ли wp-cron задачи модуля. В разделе Debug настроек модуля должна быть указана текущая дата (+/- 4 часа). Далее требуется проверить, что все задачи wp-cron выполняются на сайте. Для этого нужно перейти в раздел WooCommerce -> Статус (Estado) -> Статус системы (Estado del sistema) -> WordPress Cron (Cron de WordPress).

Если wp-cron не выполняет задачи, то в первую очередь нужно восстановить его работу.

Для быстрого решения можно перезапустить задачи wp-cron в настройках модуля, нажав на кнопку "Очистить" в блоке "Отладочная информация".

В некоторых случаях задачи модуля можно перенести на cron сервера. Имейте ввиду, что остальные задачи wp-cron останутся в таком же состоянии (не будут выполняться). Действия для переноса:

• отключить wp-cron (см. инструкции по WooCommerce и WordPress),
• в зависимости от требуемых задач расположить в корневой директории сайта скрипты (в директории с файлом wp-config.php):

simla_history.php - для синхронизации истории

<?php

/** Load WordPress Bootstrap */
require_once dirname( __FILE__ ) . '/wp-load.php';

do_action("retailcrm_history");

simla_icml.php - для генерации каталога

<?php

/** Load WordPress Bootstrap */
require_once dirname( __FILE__ ) . '/wp-load.php';

do_action("retailcrm_icml");

simla_stocks.php - для синхронизации остатков

<?php

/** Load WordPress Bootstrap */
require_once dirname( __FILE__ ) . '/wp-load.php';

do_action("retailcrm_inventories");

• добавить нужные задачи в расписание cron сервера:

*/5 * * * *	{path to php} {wp dir}/simla_history.php
* */3 * * *	{path to php} {wp dir}/simla_icml.php
*/15 * * * *	{path to php} {wp dir}/simla_stocks.php

Пример:

*/5 * * * *	/usr/local/bin/php /home/conquero/public_html/simla_history.php
* */3 * * *	/usr/local/bin/php /home/my_site/public_html/simla_icml.php
*/15 * * * *	/usr/local/bin/php /home/conquero/public_html/simla_stocks.php