Корректное удаление заказа на D7 в 1С-Битрикс

Николай Ковалёв
25 фев 2021
2 мин
Корректное удаление заказа на D7 в 1С-Битрикс

При работе с современным API 1С-Битрикс на базе ядра D7 удаление заказа требует соблюдения определенной бизнес-логики интернет-магазина. Чтобы процесс прошел успешно, у удаляемого заказа не должно быть связанных с ним активных оплат и отгрузок. Перед вызовом метода удаления скрипт должен предварительно отменить или удалить все созданные документы оплаты и отгрузки, иначе будет ошибка удаления.

Для удобства отладки и контроля за процессом скрипт будет последовательно записывать каждый свой шаг в лог-файл. Это позволит в любой момент открыть историю операций и детально изучить, на каком именно этапе возникли сложности, если какой-то из заказов не удалось удалить.

Готовый скрипт:

// подключаем модуль интернет-магазина
\Bitrix\Main\Loader::includeModule('sale');

// массив ID заказов, которые нужно удалить
$orders = [1, 2, 3];
$log_file = $_SERVER['DOCUMENT_ROOT'] . '/order_deletion.log';

foreach ($orders as $order_id) {
    $order = \Bitrix\Sale\Order::load($order_id);

    if (empty($order))
        continue;

    file_put_contents($log_file, 'Работаем с заказом ID: ' . $order_id . PHP_EOL, FILE_APPEND);

    // отменяем оплаты, если заказ оплачен
    $payment_collection = $order->getPaymentCollection();
    foreach ($payment_collection as $payment) {
        if ($payment->isPaid()) {
            $r = $payment->setReturn('Y');
            if (!$r->isSuccess()) {
                file_put_contents($log_file, 'Ошибка отмены оплаты' . PHP_EOL, FILE_APPEND);
                file_put_contents($log_file, print_r($r->getErrorMessages(), true) . PHP_EOL, FILE_APPEND);
            }
        }
    }

    // отменяем отгрузки
    $shipment_collection = $order->getShipmentCollection();
    foreach ($shipment_collection as $shipment) {
        $r = $shipment->setField('DEDUCTED', 'N');
        if (!$r->isSuccess()) {
            file_put_contents($log_file, 'Ошибка отмены отгрузки' . PHP_EOL, FILE_APPEND);
            file_put_contents($log_file, print_r($r->getErrorMessages(), true) . PHP_EOL, FILE_APPEND);
        } 
    }

    // сохраняем изменения
    $order->save();

    // удаляем заказ
    $r = \Bitrix\Sale\Order::delete(order_id);
    if (!$r->isSuccess()) {
        file_put_contents($log_file, 'Ошибка удаления заказа' . PHP_EOL, FILE_APPEND);
        file_put_contents($log_file, print_r($r->getErrorMessages(), true) . PHP_EOL, FILE_APPEND);
    } else {
        file_put_contents($log_file, 'Заказ успешно удален' . PHP_EOL, FILE_APPEND);
    }
}