метод REST scope: catalog

catalog.document.element.update

Обновить товар в документе складского учета

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

Описание

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

Параметры

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

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

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

Поля, которые нужно изменить (подробное описание ниже)

Параметр fields

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

Идентификатор склада-источника, можно получить методом catalog.store.list. Используйте для документов списания. Если параметр не передавать, сохранится текущее значение

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

Идентификатор склада-получателя, можно получить методом catalog.store.list. Подходит для документов поступления и перемещения. Если параметр не передавать, сохранится текущее значение

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

Количество товара в единицах учета документа. Если параметр не передавать, сохранится текущее значение

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

Закупочная цена в валюте документа. Если параметр не передавать, сохранится текущее значение

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"id":148,"fields":{"amount":12,"purchasingPrice":1180,"storeTo":2}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.document.element.update

Ответ

HTTP-статус: 200

{
    "result": {
        "documentElement": {
            "amount": 12,
            "docId": 64,
            "elementId": 312,
            "id": 148,
            "purchasingPrice": 1180,
            "storeFrom": null,
            "storeTo": 2
        }
    },
    "time": {
        "start": 1759482203.22173,
        "finish": 1759482203.33928,
        "duration": 0.11754989624023438,
        "processing": 0.02244114875793457,
        "date_start": "2025-11-02T12:23:23+03:00",
        "date_finish": "2025-11-02T12:23:23+03:00",
        "operating": 0
    }
}

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

result object

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

documentElement catalog_document_element

Обновленные данные товара документа.

time time

Служебная информация о времени обработки запроса.

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

HTTP-статус: 400

{
    "error": "ERROR_DOCUMENT_STATUS",
    "error_description": "Document not found"
}
Код Описание Значение
ERROR_DOCUMENT_RIGHTS Access denied Недостаточно прав на изменение документа или просмотр складов
ERROR_DOCUMENT_STATUS Document not found / Conducted document Позиция не найдена, документ удален, недоступен или уже проведен
0 Error of modifying new document Внутренняя ошибка при сохранении

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

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