Документация для разработчиков
Темная тема

Товарные позиции

Описание

REST-методы из семейства crm.item.productrow.* позволяют работать с товарными позициями, привязанными к различным элементам CRM. Методы являются универсальными и поддерживают любой тип владельца, который может работать с новым API CRM.

ВАЖНО! На данный момент полностью поддерживается работа только с товарными позициями, привязанными к смарт-процессу или предложению, так как только эти типы сущностей сейчас работают в новом API. При попытке воспользоваться методами для других типов владельцев будет возвращена ошибка.


Права доступа

При обращении к методам REST учитываются права доступа пользователя, от которого осуществляется вызов методов. Товарные позиции не являются самостоятельной сущностью CRM и всегда привязаны к какому-либо элементу, выступающему как их владелец. Поэтому при всех операциях проверяются права пользователя на доступ и управление элементом-владельцем (предложением, смарт-процессом и т.п.). Например, если у пользователя нет доступа к чтению какого-либо элемента, то и прочитать его товарные позиции он не сможет.


Автоматические действия после любого изменения

После любого изменения, вносимого в товарные позиции, будут выполнены все стандартные проверки и процедуры, происходящие при изменении элемента CRM, в том числе пересчет суммы и запуск роботов после сохранения. Это относится ко всем методам, создающим/изменяющим товарные позиции: crm.item.productrow.add, crm.item.productrow.update, crm.item.productrow.set.


Булевы значения

Значения некоторых полей имеют булевый тип (например, поле taxIncluded). В этом случае для изменения значения надо передавать "Y" или "N". В ответах на запросы они будут отображаться аналогично.

Методы

Методы работы с товарными позициями crm.item.productrow.*.

Scope: crm Права на выполнение: для всех

Метод Описание С версии
crm.item.productrow.fields Получение информации о полях товарных позиций
crm.item.productrow.get Получение информацию о товарной позиции с идентификатором id.
crm.item.productrow.add Метод создает новую товарную позицию.
crm.item.productrow.update Метод обновит товарную позицию с идентификатором id
crm.item.productrow.set Метод привяжет товарные позиции к элементу CRM.
crm.item.productrow.delete Метод удалит товарную позицию.
crm.item.productrow.list Фильтрация списка товарных позиций.
crm.item.productrow.getAvailableForPayment Получает список товаров, по которым ещё не была выставлена оплата. 23.1400.100

© «Битрикс», 2001-2024, «1С-Битрикс», 2024