метод REST scope: catalog

catalog.document.update

Изменить документ складского учета

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

Описание

Метод catalog.document.update изменяет поля существующего документа складского учета.

Параметры

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

Идентификатор документа, можно получить методом catalog.document.list

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

Поля документа (подробное описание)

Параметр fields

responsibleId user.id необязательный

Идентификатор ответственного

dateModify datetime необязательный

Можно передать собственную дату изменения. По умолчанию — текущая дата

dateDocument datetime необязательный

Дата проведения документа

total double необязательный

Общая сумма по товарам документа. Пересчитывается автоматически после изменения товарных позиций

commentary char необязательный

Комментарий к документу

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

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

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

Внутренний номер документа

modifiedBy user.id необязательный

Идентификатор пользователя, изменившего документ. Администратор может указать любое значение, по умолчанию заполняется текущим пользователем

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":142,"fields":{"title":"Поступление от Поставщик-1 (корректировка)","commentary":"Обновили ответсвенного","responsibleId":21}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.document.update

Ответ

{
    "result": {
        "document": {
            "commentary": "Обновили ответсвенного",
            "createdBy": 29,
            "currency": "RUB",
            "dateCreate": "2025-10-30T11:19:38+03:00",
            "dateDocument": null,
            "dateModify": "2025-10-30T11:33:42+03:00",
            "dateStatus": "2025-10-30T11:19:38+03:00",
            "docNumber": "IN-00042",
            "docType": "A",
            "id": 11,
            "modifiedBy": 29,
            "responsibleId": 21,
            "siteId": "s1",
            "status": "N",
            "statusBy": null,
            "title": "Поступление от Поставщик-1 (корректировка)",
            "total": null
        }
    },
    "time": {
        "start": 1761806022,
        "finish": 1761806022.36133,
        "duration": 0.3613300323486328,
        "processing": 0,
        "date_start": "2025-10-30T09:33:42+03:00",
        "date_finish": "2025-10-30T09:33:42+03:00",
        "operating_reset_at": 1761806622,
        "operating": 0.17665815353393555
    }
}

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

result object

Корневой элемент ответа

document catalog_document

Объект с обновленными данными документа

time time

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

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

{
    "error": "0",
    "error_description": "Документ не найден."
}
Код Описание Значение
0 Недостаточно прав для сохранения документа У пользователя нет права на редактирование документа нужного типа или документ с таким идентификатором не существует
0 Складской учет недоступен на вашем тарифе Складской учет недоступен на вашем тарифе

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

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