WooCommerce: автоматическое изменение статуса возврата после просрочки

Диагностика проблемы: почему важен автоматический контроль статусов возвратов

В WooCommerce возвраты товаров — это отдельный процесс, который требует контроля. Часто возвраты остаются в статусе ожидания слишком долго, что мешает аналитике и логистике. Автоматическое изменение статуса возврата после просрочки позволяет поддерживать базу заказов в актуальном состоянии и ускоряет обработку возвратов.

Типичная ситуация: возврат продукта был инициирован, но клиент не отправил товар обратно в течение установленного срока (например, 14 дней). В этом случае статус возврата должен автоматически измениться на «Отменён» или «Истёк», чтобы не мешать дальнейшей работе.

Пошаговое решение: как реализовать автоматическое изменение статуса возврата

1. Определяем срок просрочки

Для примера возьмём 14 дней с момента создания возврата.

2. Создаём CRON-задачу для проверки просроченных возвратов

WooCommerce не имеет встроенного типа «возврат» в базе, но возвраты обычно реализуются через статусы заказов или специальные мета-поля. Предположим, что возврат — это заказ со статусом refund-pending.

Добавим в functions.php темы или в собственный плагин следующий код для регистрации CRON-задачи:

function wpse_schedule_refund_status_check() {
    if ( ! wp_next_scheduled( 'wpse_check_expired_refunds' ) ) {
        wp_schedule_event( time(), 'daily', 'wpse_check_expired_refunds' );
    }
}
add_action( 'wp', 'wpse_schedule_refund_status_check' );

3. Обработчик задачи: меняем статус просроченных возвратов

Добавим функцию, которая проверит возвраты и изменит статус:

add_action( 'wpse_check_expired_refunds', 'wpse_update_expired_refund_status' );
function wpse_update_expired_refund_status() {
    $days_limit = 14;
    $date_threshold = date( 'Y-m-d H:i:s', strtotime( "-{$days_limit} days" ) );

    $args = [
        'limit' => -1,
        'status' => 'refund-pending',
        'date_created' => '<' . $date_threshold,
    ];

    $orders = wc_get_orders( $args );

    foreach ( $orders as $order ) {
        // Изменяем статус на 'cancelled' (отменён)
        $order->update_status( 'cancelled', 'Автоматическое изменение статуса возврата после просрочки.' );
    }
}

Проверка результата после внедрения

• Создайте тестовый заказ со статусом refund-pending с датой старше 14 дней (можно вручную в базе или через API).
• Запустите CRON-задачу вручную, вызвав функцию wpse_update_expired_refund_status() или дождитесь автоматического запуска (один раз в сутки).
• Проверьте, что статус заказа изменился на cancelled.
• Проверьте логи или комментарии к заказу, чтобы убедиться, что изменение было автоматическим.

Частые ошибки и как их исправить

• CRON-задача не запускается: Проверьте, активна ли WP-Cron и нет ли конфликтов с плагинами, влияющими на CRON. Используйте плагин WP Crontrol для диагностики и управления задачами.
• Неправильный статус возврата: Убедитесь, что статус refund-pending корректно используется в вашем магазине для возвратов. В разных магазинах может быть своя логика, поэтому подстройте фильтры и статусы под вашу реализацию.
• Заказы не выбираются в запросе: Проверьте параметры wc_get_orders, возможно, нужно использовать фильтр по метаполям или другой статус. Логируйте запросы и результаты.

Практические советы по безопасности и производительности

• Ограничьте выборку заказов в CRON-задании партиями по 50-100, если база большая, чтобы избежать таймаутов.
• Используйте transient API для кэширования последних проверенных ID заказов, чтобы не проверять одни и те же записи несколько раз подряд.
• Всегда проверяйте права доступа и используйте nonce, если добавляете админские кнопки для управления возвратами.
• Логируйте изменения статусов в отдельный файл или в системный лог WordPress для последующего аудита.

Сравнение вариантов реализации: плагин vs код