метод REST scope: documentgenerator

documentgenerator.document.getfields

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

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

Описание

Метод documentgenerator.document.getfields возвращает поля документа, их текущие и базовые значения.

Параметры

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

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

Получить идентификатор документа можно после создания документа или методом получения списка документов

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

Необязательный параметр.

Значения полей, которые метод временно подставляет перед формированием documentFields.

Используйте values, чтобы заранее проверить, как значения будут интерпретированы и отображены при создании или обновлении документа.

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

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"id":51,"values":{"DocumentNumber":"ДГ-2026-001","CurrentDate":"2026-03-18T00:00:00+03:00","ClientName":"ООО Ромашка","ClientPhone":"+7 999 123-45-67","Total":"51000","Comment":"Оплата в течение 5 рабочих дней после подписания","UserName":"Иван Петров"}}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/documentgenerator.document.getfields

Ответ

HTTP-статус: 200

{
    "result": {
        "documentFields": {
            "DocumentNumber": {
                "title": "Номер",
                "value": "ДГ-2026-001",
                "required": "Y",
                "group": [
                    "Документ"
                ],
                "chain": "this.DOCUMENT.DOCUMENT_NUMBER",
                "default": "ДГ-2026-001"
            },
            "CurrentDate": {
                "value": "2026-03-18T00:00:00+03:00",
                "default": ""
            },
            "ClientName": {
                "value": "ООО Ромашка",
                "default": ""
            },
            "ClientPhone": {
                "value": "+7 999 123-45-67",
                "default": ""
            },
            "Total": {
                "value": "51000",
                "default": ""
            },
            "Comment": {
                "value": "Оплата в течение 5 рабочих дней после подписания",
                "default": ""
            },
            "UserName": {
                "value": "Иван Петров",
                "default": ""
            },
            "DocumentTitle": {
                "title": "Название документа",
                "value": "SUPPLY_CONTRACT Template 1773843147554 ДГ-2026-001",
                "group": [
                    "Документ"
                ],
                "chain": [
                    {},
                    "getTitle"
                ],
                "required": "Y",
                "default": "SUPPLY_CONTRACT Template 1773843147554 ДГ-2026-001"
            }
        }
    },
    "time": {
        "start": 1773931419,
        "finish": 1773931419.57404,
        "duration": 0.5740399360656738,
        "processing": 0,
        "date_start": "2026-03-19T17:43:39+03:00",
        "date_finish": "2026-03-19T17:43:39+03:00",
        "operating_reset_at": 1773932019,
        "operating": 0
    }
}

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

result object

Корневой элемент ответа (подробное описание)

time time

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

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

HTTP-статус: 400

{
    "error": "0",
    "error_description": "You do not have permissions to view documents"
}
Код Описание Значение
400 100 Bitrix\DocumentGenerator\Document constructor must be is public
400 0 Документ не найден
400 0 You do not have permissions to view documents

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

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