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

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

Описание

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