Блог Горошко Андрея 1C-Битрикс,Bitrix24 Удалить локализацию sale.statusLang.deleteByFilter

Удалить локализацию sale.statusLang.deleteByFilter

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Удалить локализацию sale.statusLang.deleteByFilter». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Удалить локализацию sale.statusLang.deleteByFilter

> Scope: sale
>
> Кто может выполнять метод: администратор

Метод удаляет записи локазации статуса заказа или доставки по идентификатору статуса и языку.

Параметры метода

Название
тип
Описание
fields
object
Значения полей фильтра (подробное описание приведено ниже) для удаления записи локализации в виде структуры:

fields: {
    statusId: 'значение',
    lid: 'значение'
    name: 'значение'
}

Параметр fields

Название
тип
Описание
statusId
sale_status.id
Символьный идентификатор статуса
lid
sale_lang.lid
Идентификатор языка. Текущие возможные значения приведены ниже:

— ar — арабский
— br — португальский
— de — немецкий
— en — английский
— fr — французский
— hi — хинди
— id — индонезийский
— in — английский (Индия)
— it — итальянский
— ja — японский
— la — испанский
— ms — малайский
— pl — польский
— ru — русский
— sc — китайский (упрощенный)
— tc — китайский (традиционный)
— th — тайский
— tr — турецкий
— ua — украинский
— vn — вьетнамский

Список актуальных языков можно получить методом sale.statuslang.getlistlangs

name
string

Для корректной работы метода передайте любое непустое значение в этот параметр

Примеры кода

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"fields":{"statusId":"RD","lid":"la","name":"-"}}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.statusLang.deleteByFilter
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"fields":{"statusId":"RD","lid":"la","name":"-"},"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/sale.statusLang.deleteByFilter
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'sale.statusLang.deleteByFilter',
    		{
    			fields: {
    				statusId: 'RD',
    				lid: 'la',
    				name: '-',
    			}
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info(result);
    }
    catch( error )
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'sale.statusLang.deleteByFilter',
                [
                    'fields' => [
                        'statusId' => 'RD',
                        'lid'     => 'la',
                        'name'    => '-',
                    ],
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        echo 'Success: ' . print_r($result, true);
        // Нужная вам логика обработки данных
        processData($result);
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error deleting status language: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'sale.statusLang.deleteByFilter',
        {
            fields: {
                statusId: 'RD',
                lid: 'la',
                name: '-',
            }
        },
        function(result) {
            if (result.error()) {
                console.error(result.error());
            } else {
                console.info(result.data());
            }
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'sale.statusLang.deleteByFilter',
        [
            'fields' =>
            [
                'statusId' => 'RD',
                'lid' => 'la',
                'name' => '-',
            ]
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';

Обработка ответа

HTTP-статус: 200

{
    "result":true,
    "time":{
        "start":1712223882.72792,
        "finish":1712223882.978806,
        "duration":0.2508859634399414,
        "processing":0.022897958755493164,
        "date_start":"2024-04-04T12:44:42+03:00",
        "date_finish":"2024-04-04T12:44:42+03:00"
    }
}

Возвращаемые данные

Название
тип
Описание
result
boolean
Результат удаления локализации статуса
time
time
Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":0,
    "error_description":"Required fields: name"
}

Возможные коды ошибок

КодОписание
201740400001Локализация для удаления по указанному фильтру не найдена
201750000004Передан неизвестный идентификатор языка локализации lid
200040300010Недостаточно прав для удаления локализации статуса
100Не указан или пустой параметр fields
0Не переданы обязательные поля структуры fields
0Другие ошибки (например, фатальные ошибки)
  • [](./index)
  • [](./sale-status-lang-get-list-langs)
  • [](./sale-status-lang-add)
  • [](./sale-status-lang-list)
  • [](./sale-status-lang-get-fields)

💡 Экспертное мнение и рекомендации

Практические рекомендации:

  • При написании кастомных компонентов для «Удалить локализацию sale.statusLang.deleteByFilter» всегда разделяйте бизнес-логику и представление (шаблон).
  • Используйте отладку SQL-запросов через конструкцию $wpdb->last_query или стандартный трекер Битрикса, чтобы контролировать нагрузку.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Событие на удаление рабочей группы onSonetGroupDeleteСобытие на удаление рабочей группы onSonetGroupDelete

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Событие на удаление рабочей группы onSonetGroupDelete», проанализируем лучшие практики

Получить массив элементов процесса rpa.item.listПолучить массив элементов процесса rpa.item.list

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Получить массив элементов процесса rpa.item.list». Вы узнаете экспертные методики работы с rpa.item.list и

Как использовать метод SDK crm.quote.userfield.delete в Битрикс24Как использовать метод SDK crm.quote.userfield.delete в Битрикс24

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Как использовать метод SDK crm.quote.userfield.delete в Битрикс24». Вы узнаете экспертные методики работы с