Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Провести документ складского учета catalog.document.conduct», проанализируем лучшие практики и покажем, как правильно использовать catalog.document.conduct в реальных задачах.
Провести документ складского учета catalog.document.conduct
> Scope: catalog
>
> Кто может выполнять метод:
> — пользователь с правом «Проведение документа» на тип документа в запросе,
> — и «Просмотр и выбор склада» на склад прихода или списания.
Метод catalog.document.conduct проводит документ складского учета:
- статус документа изменяется на
Y— проведен, - складские остатки товаров обновляются согласно позициям документа.
Параметры метода
Названиетип | Описание |
|---|---|
id*catalog_document.id | Идентификатор документа, получить можно методом catalog.document.list |
Примеры кода
- cURL (Webhook)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":142}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/catalog.document.conduct- cURL (OAuth)
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":142,"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/catalog.document.conduct- JS
try
{
const response = await $b24.callMethod(
'catalog.document.conduct',
{ id: 142 }
);
const result = response.getData().result;
console.log(result);
}
catch (error)
{
console.error(error);
}- PHP
try {
$response = $b24Service
->core
->call(
'catalog.document.conduct',
[
'id' => 142,
]
);
$result = $response
->getResponseData()
->getResult();
if ($result === true) {
echo 'Document conducted';
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error conducting document: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
'catalog.document.conduct',
{ id: 142 },
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.conduct',
[
'id' => 142,
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Обработка ответа
HTTP-код: 200
{
"result": true,
"time": {
"start": 1762409135,
"finish": 1762409136.304248,
"duration": 1.3042480945587158,
"processing": 1,
"date_start": "2025-11-06T09:05:35+03:00",
"date_finish": "2025-11-06T09:05:36+03:00",
"operating_reset_at": 1762409735,
"operating": 0.3091859817504883
}
}Возвращаемые данные
Названиетип | Описание |
|---|---|
resultboolean | Корневой элемент ответа, содержит true, если документ проведен |
timetime | Информация о времени выполнения запроса |
Обработка ошибок
HTTP-код: 400
{
"error": "0",
"error_description": "Документ не найден"
}Возможные коды ошибок
| Код | Описание | Значение |
|---|---|---|
0 | Не удалось завершить действие, так как у вас недостаточно прав для просмотра и выбора складов | Нет прав на работу со складом товара из документа |
0 | Недостаточно прав для сохранения документа | Нет прав к каталогу товаров, складскому учету или нет права проведения документа |
0 | Документ не найден | Указан несуществующий идентификатор документа |
0 | Ошибка проведения документа: «текст ошибки» | Документ содержит некорректные данные, например «Не указан поставщик» |
0 | Складской учет недоступен на вашем тарифе | Складской учет недоступен на вашем тарифе |
0 | Для проведения документа необходимо включить складской учет | Для проведения документа необходимо включить складской учет |
- [](./catalog-document-conduct-list)
- [](./catalog-document-cancel)
- [](./document-element/catalog-document-element-add)
- [](../documentcontractor/catalog-documentcontractor-add)
💡 Экспертное мнение и рекомендации
Советы эксперта по интеграции:
- Всегда используйте кэширование при частых запросах к catalog.document.conduct, чтобы разгрузить базу данных.
- Соблюдайте стандарты PSR при написании обработчиков для «Провести документ складского учета catalog.document.conduct».
- Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru