метод REST scope: crm

crm.documentgenerator.template.getfields

Получить поля шаблона документа

Кто может выполнять: пользователь с правом "изменения" шаблонов генератора документов

Описание

Метод crm.documentgenerator.template.getfields возвращает карточку полей шаблона: какие поля доступны, их текущие значения, значения по умолчанию и служебные признаки.

Параметры

id integer необязательный

Идентификатор шаблона

entityTypeId integer необязательный

Идентификатор типа CRM-элемента. Нужен для выбора провайдера данных

entityId integer необязательный

Идентификатор CRM-элемента, данные которого будут использованы для вычисления значений полей

values object необязательный

Объект формата:

{
    field_1: value_1,
    field_2: value_2,
    ...,
    field_n: value_n,
}

где:
- field_n — название поля
- value_n — значение поля

values — это временные подстановки поверх данных CRM. Метод берет данные по entityTypeId и entityId, затем накладывает значения из values и пересчитывает поля шаблона.

Это позволяет проверить результат без изменения данных в CRM. Например, если передать values.DocumentNumber = "2026-001", в ответе поле DocumentNumber вернется уже с этим значением.

Если values не передавать, метод вернет карточку полей на основе исходных данных CRM и логики шаблона

Параметр values

MyCompanyRequisiteRqCompanyName string необязательный

Сокращенное наименование организации

MyCompanyRequisiteRegisteredAddressText string необязательный

Полный адрес

MyCompanyPhone string необязательный

Телефон

MyCompanyEmail string необязательный

E-mail

MyCompanyWeb string необязательный

Сайт

MyCompanyUfLogo string необязательный

Логотип

RequisiteRqCompanyName string необязательный

Сокращенное наименование организации

RequisiteRegisteredAddressText string необязательный

Полный адрес

ClientPhone string необязательный

Телефон

ClientEmail string необязательный

Email

ClientWeb string необязательный

Сайт

DocumentNumber string необязательный

Номер

DocumentCreateTime string необязательный

Дата генерации

ProductsIndex string необязательный

Текущий номер

ProductsProductName array необязательный

Название

ProductsProductQuantity array необязательный

Количество

ProductsProductMeasureName array необязательный

Единицы измерения

ProductsProductPriceRaw array необязательный

Исходная цена

ProductsProductPriceRawSum array необязательный

Сумма исходной цены

TotalRaw string необязательный

Сумма исходных цен

TaxesTaxTitle array необязательный

Заголовок

TaxesTaxRate array необязательный

Ставка

TaxesTaxValue array необязательный

Сумма

TotalSum string необязательный

Общая сумма

MyCompanyAssignedName string необязательный

Имя

MyCompanyAssignedLastName string необязательный

Фамилия

MyCompanyAssignedPersonalPhone string необязательный

Телефон

MyCompanyAssignedEmail string необязательный

E-Mail

DocumentTitle string необязательный

Название документа

MY_COMPANY array необязательный

Моя компания

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":1,"entityTypeId":2,"entityId":123,"values":{"DocumentNumber":"2026-001"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.documentgenerator.template.getfields

Ответ

HTTP-статус: 200

{
    "result": {
        "templateFields": {
            "DocumentNumber": {
                "title": "Номер",
                "value": "2026-001",
                "required": "Y",
                "group": [
                    "Документ"
                ],
                "chain": "this.DOCUMENT.DOCUMENT_NUMBER",
                "default": "2026-001"
            },
            "MyCompanyUfLogo": {
                "title": "Логотип",
                "value": null,
                "type": "IMAGE",
                "group": [
                    "Документ",
                    "Моя компания"
                ],
                "chain": "this.SOURCE.MY_COMPANY.UF_LOGO",
                "default": null
            },
            "MY_COMPANY": {
                "title": "Моя компания",
                "value": [
                    {
                        "value": "340",
                        "title": "Колесо Фортуны",
                        "selected": true
                    },
                    {
                        "value": "358",
                        "title": "Битрикс-Разработка",
                        "selected": false
                    }
                ],
                "group": [
                    "Документ",
                    "Моя компания"
                ]
            }
        }
    },
    "time": {
        "start": 1773821944,
        "finish": 1773821944.196063,
        "duration": 0.19606304168701172,
        "processing": 0,
        "date_start": "2026-03-18T11:19:04+03:00",
        "date_finish": "2026-03-18T11:19:04+03:00",
        "operating_reset_at": 1773822544,
        "operating": 0
    }
}

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

result object

Корневой элемент ответа. Содержит объект templateFields

time time

Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": "DOCGEN_ACCESS_ERROR",
    "error_description": "Access denied"
}
Код Описание Значение
DOCGEN_ACCESS_ERROR Access denied Нет доступа к шаблону или недостаточно прав для работы с шаблонами генератора документов
0 Шаблон не найден Шаблон с указанным id не найден или недоступен
100 Bitrix\\DocumentGenerator\\Template constructor must be is public Не передан обязательный параметр
Cannot get fields from deleted template Нельзя получить поля удаленного шаблона
You do not have permissions to modify templates Недостаточно прав для изменения шаблонов генератора документов
Module documentgenerator is not installed Модуль documentgenerator недоступен

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.