Счета (новые)
Scope: crm Права на выполнение: для всех
Новые счета – это отдельный тип сущности, заменяющий собой существовавшие до этого счета.
Как смарт-процесс
Новые счета – это зафиксированный тип смарт-процесса, за исключением деталей. Поэтому те же самые методы, которые применяются при работе со смарт-процессами, используются и с новыми счетами. Отличие лишь в значениях входных параметров.
Многие методы требуют указать entityTypeId. В качестве значения для этого параметра необходимо передать entityTypeId
для новых счетов. Значение entityTypeId для новых счетов, а так же других специфичных для типа сущности констант, можно посмотреть
списке констант.
Так же значения entityTypeId, entityTypeName и ownerType можно получить через метод crm.enum.ownertype (см. поля ID,
SYMBOL_CODE, SYMBOL_CODE_SHORT).
crm.type.*
Через методы crm.type.* прочитать/изменить/удалить новые счета невозможно. При попытке это
сделать будет возвращена ошибка.
Управление элементами новых счетов – crm.item.*
Через методы crm.item.* можно читать/ изменять/ удалять/ добавлять элементы новых счетов. Работа с новыми
счетами через них ничем не отличается от того, что описано в документации. В качестве параметра entityTypeId
необходимо передать значение, актуальное для новых счетов.
Управление товарными позициями – crm.item.productrow.*
Через методы crm.item.productrow.* можно управлять товарными позициями, привязанными к счету.
Работа с ними аналогична таковой для элементов смарт-процесса. В качестве параметра ownerType необходимо передавать
краткий символьный код для новых счетов (SI).
Управление стадиями – crm.status.*
Через методы crm.status.* можно управлять стадиями новых счетов. Значение поля ENTITY_ID и
STATUS_ID формируется по тому же принципу, что и для смарт-процессов.
Чтобы получить значение готовое ENTITY_ID для новых счетов, можно воспользоваться методом
crm.status.entity.types и найти
там подмассив, у которого ENTITY_TYPE_ID совпадает с entityTypeId для новых счетов. Под ключом ID будет нужное
значение, которое можно подставлять как ENTITY_ID в другие методы.
crm.category.*
Так как новые счета основаны на смарт-процессах, то они имеют техническую возможность работать с направлениями. Однако
не рекомендуется использовать методы crm.category.* для изменения направлений новых счетов, так как
направления в них не используются. В интерфейсе любые изменения отображены не будут.
Настройки карточки счета – crm.item.details.configuration.*
Через методы crm.item.details.configuration.* можно управлять настройками
карточки нового счета. В качестве entityTypeId необходимо передавать актуальное для нового счета значение.
События над элементами нового счета
При добавлении/изменении/удалении элемента нового счета, будут выбрасываться события, идентичные таковым у
смарт-процесса. В качестве значения для ENTITY_TYPE_ID будет передаваться идентификатор CRM
нового счета (entityTypeId).
Встройки в интерфейс
Коды встроек генерируются таким же образом, как и для других сущностей, но в качестве строкового названия используется SMART_INVOICE
-
CRM_SMART_INVOICE_LIST_TOOLBAR– кнопка в тулбаре в списке счетов -
CRM_SMART_INVOICE_DETAIL_TOOLBAR– кнопка в тулбаре в карточке счета -
CRM_SMART_INVOICE_DOCUMENTGENERATOR_BUTTON– пункт меню в кнопке "Документ" в карточке счета
... и другие