Товарные позиции
Описание
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 |