Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Изменить значения пользовательских полей документов складского учета catalog….». Вы узнаете экспертные методики работы с catalog.userfield.document.update и научитесь избегать типичных ошибок начинающих разработчиков.

Изменить значения пользовательских полей документов складского учета catalog.userfield.document.update

Тут может не хватать некоторых данных — дополним в ближайшее время

• не указана обязательность параметров
• отсутствует ответ в случае ошибки
• нет примеров на др. языках
• добавить ссылку на userfieldconfig.list

> Scope: catalog
>
> Кто может выполнять метод: любой пользователь

catalog.userfield.document.update(documentId, fields)

Метод обновляет значения пользовательских полей документов складского учёта.

Входящие параметры и конфигурация метода

Пример

В API используются названия полей в виде field[ID поля в базе] – например, field287. ID поля можно узнать с помощью метода userfieldconfig.list.

• JS

    try
    {
    	const response = await $b24.callMethod(
    		'catalog.userfield.document.update',
    		{
    			documentId: 64,
    			fields: {
    				'documentType': 'S',
    				'field287': 'new value'
    			}
    		}
    	);
    	
    	const result = response.getData().result;
    	console.log(result);
    }
    catch( error )
    {
    	console.error(error.ex);
    }

• PHP

    try {
        $response = $b24Service
            ->core
            ->call(
                'catalog.userfield.document.update',
                [
                    'documentId' => 64,
                    'fields'     => [
                        'documentType' => 'S',
                        'field287'     => 'new value'
                    ]
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error()->ex);
        } else {
            echo 'Success: ' . print_r($result->data(), true);
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error updating document user field: ' . $e->getMessage();
    }

• BX24.js

    BX24.callMethod(
        'catalog.userfield.document.update',
        {
            documentId: 64,
            fields: {
                'documentType': 'S',
                'field287': 'new value'
            }
        },
        function(result)
        {
            if(result.error())
                console.error(result.error().ex);
            else
                console.log(result.data());
        }
    );