Товарные позиции
Описание
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 |
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.