crm.address.list

Scope: crm Права на выполнение: для всех

crm.address.list

Возвращает список адресов по фильтру. Является реализацией списочного метода для адресов.

Адреса перемещены в реквизиты (но в карточке CRM они имеют отображение в виде отдельного поля) - см. описание полей реквизитов. К сущности CRM могут быть привязаны несколько реквизитов. Внутри реквизита может быть несколько Общих реквизитов по шаблонам, Банковских реквизитов и Адресов.

Параметры

Cм. описание списочных методов.

Пример

//Поиск адресов по привязке к типу - Реквизит
BX24.callMethod(
	"crm.address.list",
	{
		order: { "TYPE_ID": "ASC" },
		filter: { "ENTITY_ID": 8},
		select: [ "TYPE_ID", "ADDRESS_1", "ADDRESS_2" ]
	},
	function(result) 
	{
		if(result.error())
			console.error(result.error());
		else
		{
			console.dir(result.data());
			if(result.more())
				result.next();
		}
	}
);

Примеры ответов

• Если адрес привязан к сущности без реквизита (обычно создаётся при конвертации из Лида, у которого заполнен Адрес в карточке):

  [result] => Array
  (
  	[1] => Array
  	(
  		[TYPE_ID] => 1
  		[ENTITY_TYPE_ID] => 3
  		[ENTITY_ID] => 17192
  		[ADDRESS_1] =>
  		[ADDRESS_2] =>
  		[CITY] =>
  		[POSTAL_CODE] =>
  		[REGION] =>
  		[PROVINCE] =>
  		[COUNTRY] =>
  		[COUNTRY_CODE] =>
  		[LOC_ADDR_ID] => 0
  		[ANCHOR_TYPE_ID] => 3
  		[ANCHOR_ID] => 17192
  	)
  )
  

• Если у контакта 2 разных реквизита, к которым привязаны адреса:

  [result] => Array
  (
  	[2] => Array
  	(
  		[TYPE_ID] => 1
  		[ENTITY_TYPE_ID] => 8
  		[ENTITY_ID] => 7335
  		[ADDRESS_1] => Ленина 2
  		[ADDRESS_2] => 701
  		[CITY] => Тюмень
  		[POSTAL_CODE] => 625003
  		[REGION] => Тюменская обл
  		[PROVINCE] => Тюменская обл
  		[COUNTRY] => Россия
  		[COUNTRY_CODE] =>
  		[LOC_ADDR_ID] => 479
  		[ANCHOR_TYPE_ID] => 3
  		[ANCHOR_ID] => 17192
  	)
  )
  

  [result] => Array
  (
  	[3] => Array
  	(
  		[TYPE_ID] => 1
  		[ENTITY_TYPE_ID] => 8
  		[ENTITY_ID] => 8191
  		[ADDRESS_1] => Ленина
  		[ADDRESS_2] => 2
  		[CITY] => Тюмень
  		[POSTAL_CODE] => 666000
  		[REGION] => Тюменская область рег
  		[PROVINCE] => Тюменская область
  		[COUNTRY] => Россия
  		[COUNTRY_CODE] =>
  		[LOC_ADDR_ID] => 129
  		[ANCHOR_TYPE_ID] => 3
  		[ANCHOR_ID] => 17192
  	)
  )
  

  Поле ANCHOR_TYPE_ID заполнено значением из crm.enum.ownertype (в примере это Контакты), а поле ANCHOR_ID содержит ID сущности (в данном случае Контакта). Поля ANCHOR_TYPE_ID и ANCHOR_ID в двух вышеуказанных примерах одинаковы, следовательно, оба адреса относятся к одному Контакту.