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

Счета (новые)

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 – пункт меню в кнопке "Документ" в карточке счета

... и другие



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
0
tichO
Сообщение не промодерировано, возможны ошибки и неточности.
каким образом я могу получить список полей новых счетов, как например в лидах с помощью crm.lead.fields
© «Битрикс», 2001-2024, «1С-Битрикс», 2024