Как настроить округление для пользовательского поля типа «Число»

// composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Symfony\Component\EventDispatcher\EventDispatcher;
        use Psr\Log\NullLogger;
        
        $sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
            ->initFromWebhook('https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/');
        

from b24pysdk import BitrixWebhook, Client
        from b24pysdk.errors import BitrixAPIError
        
        client = Client(
            BitrixWebhook(
                domain="your-domain.bitrix24.com",
                webhook_token="user_id/webhook_key",
            )
        )
        

// Путь вебхука — это секрет, поэтому он приходит из окружения, а не из кода.
        // Клиент строится один раз на портал: он держит HTTP-клиент и состояние
        // авторизации.
        core := b24.NewClient(os.Getenv("B24_WEBHOOK_URL")).Core()
        

// у userfieldconfig.add нет типизированной обертки в SDK — вызываем метод через ядро
        $createdField = $sb->core->call(
            'userfieldconfig.add',
            [
                'moduleId' => 'crm', // Идентификатор модуля
                'field' => [
                    'entityId' => 'CRM_DEAL', // Идентификатор объекта
                    'fieldName' => 'UF_CRM_DEAL_NEW_DOUBLE_FIELD', // Код поля
                    'userTypeId' => 'double', // Идентификатор типа поля
                    'editFormLabel' => [
                        'ru' => 'Число с округлением', // Название поля на русском
                        'en' => 'PRECISION double' // Название поля на английском
                    ],
                    'settings' => [ // Дополнительные настройки поля
                        'PRECISION' => 3 // Количество знаков после запятой
                    ]
                ]
            ]
        )->getResponseData()->getResult()['field'];
        
        echo $createdField['id'] . ': ' . $createdField['settings']['PRECISION'];
        

try:
            created_field = client.userfieldconfig.add(
                module_id="crm",
                field={
                    "entityId": "CRM_DEAL",
                    "fieldName": "UF_CRM_DEAL_NEW_DOUBLE_FIELD",
                    "userTypeId": "double",
                    "editFormLabel": {
                        "ru": "Число с округлением",
                        "en": "PRECISION double",
                    },
                    "settings": {
                        "PRECISION": 3,
                    },
                },
            ).response.result["field"]
        except BitrixAPIError as error:
            print(f"Ошибка: {error}")
        else:
            print(created_field["id"], created_field["settings"]["PRECISION"])
        

res, err := core.Call(ctx, "userfieldconfig.add", b24.Params{
        	"moduleId": "crm",
        	"field": b24.Params{
        		"entityId":   "CRM_DEAL",
        		"fieldName":  fieldName,
        		"userTypeId": "double",
        		"editFormLabel": b24.Params{
        			"ru": fieldLabel,
        			"en": "PRECISION double",
        		},
        		// Параметр необязательный, но для типа «Число» его лучше
        		// передавать: без него точность будет 0 и значения округлятся
        		// до целых.
        		"settings": b24.Params{"PRECISION": 3},
        	},
        })
        if err != nil {
        	// Код ошибки сравнивается через errors.Is, а не строкой: опечатка в
        	// литерале скомпилируется и молча уведёт в другую ветку.
        	if errors.Is(err, b24.ErrAccessDenied) {
        		return fmt.Errorf("нужно право «Разрешить изменять настройки» в CRM: %w", err)
        	}
        	return fmt.Errorf("userfieldconfig.add: %w", err)
        }
        
        // Метод заворачивает ответ в объект с ключом field и отвечает в camelCase:
        // точность лежит в settings.PRECISION, а не в SETTINGS.PRECISION.
        var added struct {
        	Field struct {
        		ID       b24.ID         `json:"id"`
        		Settings map[string]any `json:"settings"`
        	} `json:"field"`
        }
        if err := json.Unmarshal(res.Result, &added); err != nil {
        	return fmt.Errorf("разбор созданного поля: %w", err)
        }
        

$fields = $sb->getCRMScope()->dealUserfield()->list(
            order: [],
            filter: [
                'LANG' => 'ru', // Фильтр по языку для вывода названия поля
                'USER_TYPE_ID' => 'double' // Фильтр по типу поля
            ]
        )->getUserfields();
        
        // Выбираем нужное поле по названию — замените на название своего поля
        $targetField = null;
        foreach ($fields as $field) {
            if ($field->EDIT_FORM_LABEL === 'Сумма к возврату') {
                $targetField = $field;
                break;
            }
        }
        
        if ($targetField === null) {
            throw new \RuntimeException('Поле с указанным названием не найдено');
        }
        

fields = client.crm.deal.userfield.list(
            filter={
                "LANG": "ru",
                "USER_TYPE_ID": "double",
            }
        ).response.result
        
        # Выбираем нужное поле по названию — замените на название своего поля
        target_field = next(
            (field for field in fields if field["EDIT_FORM_LABEL"] == "Сумма к возврату"),
            None,
        )
        
        if target_field is None:
            raise RuntimeError("Поле с указанным названием не найдено")
        

// Без фильтра LANG названия не возвращаются вовсе, и найти поле по названию
        // не получится.
        res, err = core.Call(ctx, "crm.deal.userfield.list", b24.Params{
        	"filter": b24.Params{"LANG": "ru", "USER_TYPE_ID": "double"},
        }, b24.WithIdempotent())
        if err != nil {
        	return fmt.Errorf("crm.deal.userfield.list: %w", err)
        }
        
        // А этот метод отвечает в UPPER_SNAKE — те же данные, другой регистр.
        // Ключи внутри самих настроек в обоих случаях в верхнем регистре.
        var fields []struct {
        	ID            b24.ID         `json:"ID"`
        	FieldName     string         `json:"FIELD_NAME"`
        	EditFormLabel string         `json:"EDIT_FORM_LABEL"`
        	Settings      map[string]any `json:"SETTINGS"`
        }
        if err := json.Unmarshal(res.Result, &fields); err != nil {
        	return fmt.Errorf("разбор пользовательских полей: %w", err)
        }
        
        target := -1
        for i, f := range fields {
        	if f.EditFormLabel == fieldLabel {
        		target = i
        		break
        	}
        }
        if target < 0 {
        	return fmt.Errorf("поле %q не найдено", fieldLabel)
        }
        

// у userfieldconfig.update нет типизированной обертки в SDK — вызываем метод через ядро
        $updatedField = $sb->core->call(
            'userfieldconfig.update',
            [
                'moduleId' => 'crm', // Идентификатор модуля
                'id' => (int)$targetField->ID, // ID поля из шага 1
                'field' => [
                    'settings' => array_merge(
                        (array)$targetField->SETTINGS, // Переносим текущие настройки из шага 1
                        ['PRECISION' => 3] // Количество знаков после запятой
                    )
                ]
            ]
        )->getResponseData()->getResult()['field'];
        
        echo $updatedField['id'] . ': ' . $updatedField['settings']['PRECISION'];
        

updated_field = client.userfieldconfig.update(
            module_id="crm",
            bitrix_id=int(target_field["ID"]),
            field={
                "settings": {
                    **target_field["SETTINGS"],  # Переносим текущие настройки из шага 1
                    "PRECISION": 3,
                }
            },
        ).response.result["field"]
        
        print(updated_field["id"], updated_field["settings"]["PRECISION"])
        

// settings ЗАМЕНЯЮТСЯ целиком, а не дописываются. Если передать один
        // PRECISION, остальные настройки типа «Число» сбросятся на значения по
        // умолчанию — поэтому берём настройки из шага 1 и правим в них одну.
        settings := fields[target].Settings
        settings["PRECISION"] = 5
        
        res, err = core.Call(ctx, "userfieldconfig.update", b24.Params{
        	"moduleId": "crm",
        	"id":       fields[target].ID,
        	"field":    b24.Params{"settings": settings},
        })
        if err != nil {
        	return fmt.Errorf("userfieldconfig.update: %w", err)
        }
        
        var updated struct {
        	Field struct {
        		ID       b24.ID         `json:"id"`
        		Settings map[string]any `json:"settings"`
        	} `json:"field"`
        }
        if err := json.Unmarshal(res.Result, &updated); err != nil {
        	return fmt.Errorf("разбор изменённого поля: %w", err)
        }
        

<?php
        // composer require bitrix24/b24phpsdk:"^3.0"
        require_once 'vendor/autoload.php';
        
        use Bitrix24\SDK\Services\ServiceBuilderFactory;
        use Bitrix24\SDK\Services\ServiceBuilder;
        use Symfony\Component\EventDispatcher\EventDispatcher;
        use Psr\Log\NullLogger;
        
        $sb = (new ServiceBuilderFactory(new EventDispatcher(), new NullLogger()))
            ->initFromWebhook('https://your-domain.bitrix24.ru/rest/USER_ID/TOKEN/');
        
        const FIELD_LABEL = 'Сумма к возврату'; // Название поля, которое нужно изменить
        const PRECISION = 3; // Количество знаков после запятой
        
        function updateUserField(ServiceBuilder $sb, string $fieldLabel, int $precision): void {
            try {
                // Шаг 1: получаем пользовательские поля сделок типа double
                $fields = $sb->getCRMScope()->dealUserfield()->list(
                    order: [],
                    filter: [
                        'LANG' => 'ru', // Фильтр по языку для вывода названия поля
                        'USER_TYPE_ID' => 'double' // Фильтр по типу поля
                    ]
                )->getUserfields();
        
                // Ответ crm.deal.userfield.list приходит в UPPER_SNAKE
                $targetField = null;
                foreach ($fields as $field) {
                    if ($field->EDIT_FORM_LABEL === $fieldLabel) {
                        $targetField = $field;
                        break;
                    }
                }
        
                if ($targetField === null) {
                    throw new \RuntimeException('Поле с указанным названием не найдено');
                }
        
                // Шаг 2: обновляем настройки найденного поля
                // у userfieldconfig.update нет типизированной обертки в SDK — вызываем метод через ядро
                $updatedField = $sb->core->call(
                    'userfieldconfig.update',
                    [
                        'moduleId' => 'crm', // Идентификатор модуля
                        'id' => (int)$targetField->ID, // ID найденного пользовательского поля
                        'field' => [
                            'settings' => array_merge(
                                (array)$targetField->SETTINGS, // Переносим текущие настройки поля
                                ['PRECISION' => $precision] // Количество знаков после запятой
                            )
                        ]
                    ]
                )->getResponseData()->getResult()['field'];
        
                // Ответ userfieldconfig.update приходит в camelCase
                echo 'Точность поля: ' . $updatedField['settings']['PRECISION'];
            } catch (\Throwable $e) {
                echo 'Ошибка: ' . $e->getMessage();
            }
        }
        
        updateUserField($sb, FIELD_LABEL, PRECISION);
        

from b24pysdk import BitrixWebhook, Client
        from b24pysdk.errors import BitrixAPIError
        
        
        FIELD_LABEL = "Сумма к возврату"  # Название поля, которое нужно изменить
        PRECISION = 3  # Количество знаков после запятой
        
        
        def update_user_field(client, field_label: str, precision: int) -> None:
            try:
                # Шаг 1: получаем пользовательские поля сделок типа double
                fields = client.crm.deal.userfield.list(
                    filter={
                        "LANG": "ru",
                        "USER_TYPE_ID": "double",
                    }
                ).response.result
        
                # Ответ crm.deal.userfield.list приходит в UPPER_SNAKE
                target_field = next(
                    (field for field in fields if field["EDIT_FORM_LABEL"] == field_label),
                    None,
                )
        
                if target_field is None:
                    raise RuntimeError("Поле с указанным названием не найдено")
        
                # Шаг 2: обновляем настройки найденного поля
                updated_field = client.userfieldconfig.update(
                    module_id="crm",
                    bitrix_id=int(target_field["ID"]),
                    field={
                        "settings": {
                            **target_field["SETTINGS"],  # Переносим текущие настройки поля
                            "PRECISION": precision,
                        }
                    },
                ).response.result["field"]
            except (BitrixAPIError, RuntimeError) as error:
                print(f"Ошибка: {error}")
            else:
                # Ответ userfieldconfig.update приходит в camelCase
                print("Точность поля:", updated_field["settings"]["PRECISION"])
        
        
        client = Client(
            BitrixWebhook(
                domain="your-domain.bitrix24.com",
                webhook_token="user_id/webhook_key",
            )
        )
        
        update_user_field(client, FIELD_LABEL, PRECISION)
        

// Подготовка в пустом каталоге — go get без go mod init не сработает:
        //
        //	go mod init example && go get github.com/bitrix24/b24gosdk
        //
        // Запуск:
        //
        //	export B24_WEBHOOK_URL='https://ваш-портал.bitrix24.ru/rest/1/токен/' && go run .
        //
        // Пример самодостаточный: он создаёт поле сделки с точностью 2, находит его по
        // названию, меняет точность на 3 и удаляет поле за собой. Второй сценарий
        // страницы требует уже существующего поля — пример готовит его первым
        // сценарием, поэтому запускается на любом портале, ничего править не нужно.
        package main
        
        import (
        	"context"
        	"encoding/json"
        	"errors"
        	"fmt"
        	"log"
        	"os"
        
        	b24 "github.com/bitrix24/b24gosdk"
        )
        
        const (
        	fieldName  = "UF_CRM_DEAL_NEW_DOUBLE_FIELD"
        	fieldLabel = "Число с округлением"
        )
        
        func main() {
        	if err := run(context.Background()); err != nil {
        		log.Fatal(err)
        	}
        }
        
        func run(ctx context.Context) error {
        	// Путь вебхука — это секрет, поэтому он приходит из окружения, а не из кода.
        	// Клиент строится один раз на портал: он держит HTTP-клиент и состояние
        	// авторизации.
        	core := b24.NewClient(os.Getenv("B24_WEBHOOK_URL")).Core()
        	// --- сценарий 1: создаём поле сразу с точностью
        	res, err := core.Call(ctx, "userfieldconfig.add", b24.Params{
        		"moduleId": "crm",
        		"field": b24.Params{
        			"entityId":   "CRM_DEAL",
        			"fieldName":  fieldName,
        			"userTypeId": "double",
        			"editFormLabel": b24.Params{
        				"ru": fieldLabel,
        				"en": "PRECISION double",
        			},
        			// Параметр необязательный, но для типа «Число» его лучше
        			// передавать: без него точность будет 0 и значения округлятся
        			// до целых.
        			"settings": b24.Params{"PRECISION": 3},
        		},
        	})
        	if err != nil {
        		// Код ошибки сравнивается через errors.Is, а не строкой: опечатка в
        		// литерале скомпилируется и молча уведёт в другую ветку.
        		if errors.Is(err, b24.ErrAccessDenied) {
        			return fmt.Errorf("нужно право «Разрешить изменять настройки» в CRM: %w", err)
        		}
        		return fmt.Errorf("userfieldconfig.add: %w", err)
        	}
        
        	// Метод заворачивает ответ в объект с ключом field и отвечает в camelCase:
        	// точность лежит в settings.PRECISION, а не в SETTINGS.PRECISION.
        	var added struct {
        		Field struct {
        			ID       b24.ID         `json:"id"`
        			Settings map[string]any `json:"settings"`
        		} `json:"field"`
        	}
        	if err := json.Unmarshal(res.Result, &added); err != nil {
        		return fmt.Errorf("разбор созданного поля: %w", err)
        	}
        	defer del(ctx, core, "userfieldconfig.delete", b24.Params{
        		"moduleId": "crm", "id": added.Field.ID,
        	})
        	fmt.Printf("поле %d создано, PRECISION=%v\n", added.Field.ID, added.Field.Settings["PRECISION"])
        
        	// --- сценарий 2, шаг 1: находим поле по названию
        	// Без фильтра LANG названия не возвращаются вовсе, и найти поле по названию
        	// не получится.
        	res, err = core.Call(ctx, "crm.deal.userfield.list", b24.Params{
        		"filter": b24.Params{"LANG": "ru", "USER_TYPE_ID": "double"},
        	}, b24.WithIdempotent())
        	if err != nil {
        		return fmt.Errorf("crm.deal.userfield.list: %w", err)
        	}
        
        	// А этот метод отвечает в UPPER_SNAKE — те же данные, другой регистр.
        	// Ключи внутри самих настроек в обоих случаях в верхнем регистре.
        	var fields []struct {
        		ID            b24.ID         `json:"ID"`
        		FieldName     string         `json:"FIELD_NAME"`
        		EditFormLabel string         `json:"EDIT_FORM_LABEL"`
        		Settings      map[string]any `json:"SETTINGS"`
        	}
        	if err := json.Unmarshal(res.Result, &fields); err != nil {
        		return fmt.Errorf("разбор пользовательских полей: %w", err)
        	}
        
        	target := -1
        	for i, f := range fields {
        		if f.EditFormLabel == fieldLabel {
        			target = i
        			break
        		}
        	}
        	if target < 0 {
        		return fmt.Errorf("поле %q не найдено", fieldLabel)
        	}
        	fmt.Printf("нашли поле %d (%s), сейчас PRECISION=%v\n",
        		fields[target].ID, fields[target].FieldName, fields[target].Settings["PRECISION"])
        
        	// --- сценарий 2, шаг 2: меняем точность
        	// settings ЗАМЕНЯЮТСЯ целиком, а не дописываются. Если передать один
        	// PRECISION, остальные настройки типа «Число» сбросятся на значения по
        	// умолчанию — поэтому берём настройки из шага 1 и правим в них одну.
        	settings := fields[target].Settings
        	settings["PRECISION"] = 5
        
        	res, err = core.Call(ctx, "userfieldconfig.update", b24.Params{
        		"moduleId": "crm",
        		"id":       fields[target].ID,
        		"field":    b24.Params{"settings": settings},
        	})
        	if err != nil {
        		return fmt.Errorf("userfieldconfig.update: %w", err)
        	}
        
        	var updated struct {
        		Field struct {
        			ID       b24.ID         `json:"id"`
        			Settings map[string]any `json:"settings"`
        		} `json:"field"`
        	}
        	if err := json.Unmarshal(res.Result, &updated); err != nil {
        		return fmt.Errorf("разбор изменённого поля: %w", err)
        	}
        	fmt.Printf("поле %d: PRECISION=%v, остальные настройки сохранены: %v\n",
        		updated.Field.ID, updated.Field.Settings["PRECISION"], updated.Field.Settings)
        	return nil
        }
        
        // del убирает созданное. Ошибку уборки печатаем, но не возвращаем: она не
        // должна подменить собой настоящую ошибку сценария.
        func del(ctx context.Context, core *b24.Core, method string, params b24.Params) {
        	if _, err := core.Call(ctx, method, params); err != nil {
        		fmt.Fprintf(os.Stderr, "уборка, %s: %v\n", method, err)
        	}
        }