Блог Горошко Андрея 1C-Битрикс,Bitrix24 Провести несколько документов складского учета catalog.document.conductList

Провести несколько документов складского учета catalog.document.conductList

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

Провести несколько документов складского учета catalog.document.conductList

> Scope: catalog
>
> Кто может выполнять метод:
> — пользователь с правом «Проведение документа» на тип документа в запросе,
> — и «Просмотр и выбор склада» на склад прихода или списания.

Метод catalog.document.conductList проводит группу документов складского учета:

  • статус документов изменяется на Y — проведен,
  • складские остатки товаров обновляются согласно позициям документов.

Для каждого документа в запросе выполняется проверка прав доступа.

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

Название
тип
Описание
documentIds*
catalog_document.id[]
Список идентификаторов документов, получить можно методом catalog.document.list

Примеры кода

  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"documentIds":[142,143,144]}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/catalog.document.conductList
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"documentIds":[142,143,144],"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/catalog.document.conductList
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'catalog.document.conductList',
    		{
    			documentIds: [142, 143, 144]
    		}
    	);

    	const result = response.getData().result;
    	console.log(result);
    }
    catch (error)
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'catalog.document.conductList',
                [
                    'documentIds' => [142, 143, 144],
                ]
            );

        $result = $response
            ->getResponseData()
            ->getResult();

        if ($result === true) {
            echo 'Documents conducted';
        }
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error conducting documents: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'catalog.document.conductList',
        { documentIds: [142, 143, 144] },
        function(result)
        {
            if (result.error())
                console.error(result.error());
            else
                console.log(result.data());
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'catalog.document.conductList',
        [
            'documentIds' => [142, 143, 144],
        ]
    );

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

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

HTTP-код: 200

{
    "result": true,
    "time": {
        "start": 1762410455,
        "finish": 1762410455.743473,
        "duration": 0.7434730529785156,
        "processing": 0,
        "date_start": "2025-11-06T09:27:35+03:00",
        "date_finish": "2025-11-06T09:27:35+03:00",
        "operating_reset_at": 1762411055,
        "operating": 0.2910308837890625
    }
}

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

Название
тип
Описание
result
boolean
Корневой элемент ответа, содержит true, если все документы проведены без ошибок. Если хотя бы один документ не удалось провести, метод вернет ошибку в ответе error / error_description. Документы, которые удалось обработать, останутся в статусе «Проведен»
time
time
Информация о времени выполнения запроса

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

HTTP-код: 400

{
    "error": "0",
    "error_description": "При проведении документа "Поступление 33" произошла ошибка: Некорректное количество товара #6907 (Монст Энержи) в документе складского учета"
}

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

КодОписаниеЗначение
0При проведении документа «#название документа» произошла ошибка: «текст ошибки»Документ содержит некорректные данные, например «Не указан поставщик»
0Ошибка проведения документа: Недостаточно прав для сохранения документаНет прав к каталогу товаров, складскому учету или нет права проведения документа
0Складской учет недоступен на вашем тарифеСкладской учет недоступен на вашем тарифе
0Для проведения документа необходимо включить складской учетДля проведения документа необходимо включить складской учет
  • [](./catalog-document-conduct)
  • [](./catalog-document-cancel-list)
  • [](./catalog-document-list)
  • [](./document-element/catalog-document-element-add)
  • [](../documentcontractor/catalog-documentcontractor-add)

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

Советы эксперта по интеграции:

  • Всегда используйте кэширование при частых запросах к catalog.document.conductList, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «Провести несколько документов складского учета catalog.document.conductList».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

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

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

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

Related Post

Как использовать метод SDK voximplant.tts.voices.get в Битрикс24Как использовать метод SDK voximplant.tts.voices.get в Битрикс24

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

Верстка всплывающих подсказок (Tooltips) и инфо-блоков на БитриксВерстка всплывающих подсказок (Tooltips) и инфо-блоков на Битрикс

Качественная frontend-разработка и профессиональная натяжка макетов на 1С-Битрикс являются фундаментальным фактором конверсии сайта и его позиций в поисковых системах. Услуга «Верстка всплывающих подсказок (Tooltips) и инфо-блоков на Битрикс» гарантирует пояснения

Обновить направление сделок crm.dealcategory.updateОбновить направление сделок crm.dealcategory.update

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Обновить направление сделок crm.dealcategory.update», разберем архитектурные особенности и