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

from b24pysdk import BitrixWebhook, Client
from b24pysdk.errors import BitrixAPIError

client = Client(
    BitrixWebhook(
        domain="your-domain.bitrix24.com",
        webhook_token="user_id/webhook_key",
    )
)

// 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/');

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

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"])

// у 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'];

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 = 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("Поле с указанным названием не найдено")

$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('Поле с указанным названием не найдено');
}

// Без фильтра 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)
}

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"])

// у 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'];

// 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)
}

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)

<?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);

// Подготовка в пустом каталоге — 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)
	}
}