метод REST scope: crm

crm.documentgenerator.document.getfields

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

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

Описание

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

Параметры

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

Идентификатор документа

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

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

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

где:
- field_n — код поля документа
- value_n — значение поля

values — это временные подстановки поверх текущих значений документа. Метод берет данные документа, накладывает values и пересчитывает поля.

Это позволяет проверить результат без изменения самого документа. Например, если передать values.DocumentNumber = "2026-001", в ответе поле DocumentNumber вернется со значением 2026-001. Если не передавать values, для того же поля вернется текущее значение документа, например 1.

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

Параметр values

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

Номер документа

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

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

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

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

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

Телефон клиента

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

Email клиента

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

Название товара

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

Количество

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

Общая сумма

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

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

Ответ

HTTP-статус: 200

{
    "result": {
        "documentFields": {
            "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": 1773909500,
        "finish": 1773909500.192341,
        "duration": 0.19234108924865723,
        "processing": 0,
        "date_start": "2026-03-19T11:38:20+03:00",
        "date_finish": "2026-03-19T11:38:20+03:00",
        "operating_reset_at": 1773910100,
        "operating": 0
    }
}

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

result object

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

time time

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

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

HTTP-статус: 400

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

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

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