Как получить реквизиты/адрес в CRM в Битрикс24 ⋆ Almat.su ⋆ Блог Алмата Жандаулетова

Сегодня я расскажу как работать с реквизитами компании в CRM Битрикс24.

В 16.х версии Битрикса24 в модуле CRM адреса компании и контактов начали храниться в реквизитах.

Предания гласят, что в ранних версиях Битрикса24 <16.х адреса хранились в карточке компании: фактический и юридические адреса. Их можно было легко вывести с помощью метода CCrmCompany::GetByID($companyId), который возвращал такой массив


array (size=57) 
// Много полей
'ADDRESS' => null 
'ADDRESS_2' => null 
'ADDRESS_CITY' => null 
'ADDRESS_POSTAL_CODE' => null 
'ADDRESS_REGION' => null 
'ADDRESS_PROVINCE' => null 
'ADDRESS_COUNTRY' => null 
'ADDRESS_COUNTRY_CODE' => null 
'ADDRESS_LEGAL' => null 
'REG_ADDRESS' => null 
'REG_ADDRESS_2' => null 
'REG_ADDRESS_CITY' => null 
'REG_ADDRESS_POSTAL_CODE' => null 
'REG_ADDRESS_REGION' => null 
'REG_ADDRESS_PROVINCE' => null 
'REG_ADDRESS_COUNTRY' => null 
'REG_ADDRESS_COUNTRY_CODE' => null

array (size=57)

// Много полей

'ADDRESS' => null

'ADDRESS_2' => null

'ADDRESS_CITY' => null

'ADDRESS_POSTAL_CODE' => null

'ADDRESS_REGION' => null

'ADDRESS_PROVINCE' => null

'ADDRESS_COUNTRY' => null

'ADDRESS_COUNTRY_CODE' => null

'ADDRESS_LEGAL' => null

'REG_ADDRESS' => null

'REG_ADDRESS_2' => null

'REG_ADDRESS_CITY' => null

'REG_ADDRESS_POSTAL_CODE' => null

'REG_ADDRESS_REGION' => null

'REG_ADDRESS_PROVINCE' => null

'REG_ADDRESS_COUNTRY' => null

'REG_ADDRESS_COUNTRY_CODE' => null

Сейчас адреса перенесены в реквизиты и методом CCrmCompany::GetByID($companyId) уже нельзя делать выборку адресов. Как видите в массиве все по нулям.

Как же получить реквизиты компании?

Для этого нужен класс \Bitrix\Crm\EntityRequisite().

Пример для компании:


$requisite = new \Bitrix\Crm\EntityRequisite();
$rs = $requisite->getList([
	"filter" => ["ENTITY_ID" => 1, "ENTITY_TYPE_ID" => 4,
	]
]);
$reqData = $rs->fetchAll();

$requisite = new \Bitrix\Crm\EntityRequisite();

$rs = $requisite->getList([

"filter" => ["ENTITY_ID" => 1, "ENTITY_TYPE_ID" => 4,

]

]);

$reqData = $rs->fetchAll();

Создаем экземпляр обьекта и через метод getList делаем выборку. Про фильтрацию поговорим подробнее.

«ENTITY_ID» — ид сущности. В нашем случае ид компании, который равен 1. Сущности могут быть разными. Какими?

За это отвечает ENTITY_TYPE_ID. Откуда взялась цифра 4? Это означает, что мы ищем тип «Компания». Со всеми типами можно познаскомиться в классе


class CCrmOwnerType
{
	const Undefined = 0;
	const Lead = 1;    // refresh FirstOwnerType and LastOwnerType constants
	const Deal = 2;
	const Contact = 3;
	const Company = 4;
	const Invoice = 5;
	const Activity = 6;
	const Quote = 7;
	const Requisite = 8;
	const DealCategory = 9;
	const System = 10; // refresh FirstOwnerType and LastOwnerType constants
	const FirstOwnerType = 1;
	const LastOwnerType = 10;

class CCrmOwnerType

{

const Undefined = 0;

const Lead = 1; // refresh FirstOwnerType and LastOwnerType constants

const Deal = 2;

const Contact = 3;

const Company = 4;

const Invoice = 5;

const Activity = 6;

const Quote = 7;

const Requisite = 8;

const DealCategory = 9;

const System = 10; // refresh FirstOwnerType and LastOwnerType constants

const FirstOwnerType = 1;

const LastOwnerType = 10;

То есть предыдущий пример мы могли записать как


$requisite = new \Bitrix\Crm\EntityRequisite();
$rs = $requisite->getList([
	"filter" => ["ENTITY_ID" => 1, "ENTITY_TYPE_ID" => CCrmOwnerType::Company,
	]
]);

$requisite = new \Bitrix\Crm\EntityRequisite();

$rs = $requisite->getList([

"filter" => ["ENTITY_ID" => 1, "ENTITY_TYPE_ID" => CCrmOwnerType::Company,

]

]);

Такая запись более читабельна и предпочтительней. Идем дальше…

Запись $reqData = $rs->fetchAll(); может вернуть не одну строку, так как в компанию могут быть добавлены разные виды реквизитов. Например, «Организация», «ИП», «Физ лицо» и свои собственные. Эти шаблоны вы можете редактировать в настройках→шаблоны реквизитов.

Например, вы хотите получить реквизиты «ИП» определенной компании. Для этот в фильтр нужно добавить параметр «PRESET_ID».


$req = new \Bitrix\Crm\EntityRequisite();
$rs = $req->getList([
	"filter" => [
		"ENTITY_ID" => 1, 
		"ENTITY_TYPE_ID" => CCrmOwnerType::Company, 
		'PRESET_ID' => 2
	]
]);
$row = $rs->fetch();

$req = new \Bitrix\Crm\EntityRequisite();

$rs = $req->getList([

"filter" => [

"ENTITY_ID" => 1,

"ENTITY_TYPE_ID" => CCrmOwnerType::Company,

'PRESET_ID' => 2

]

]);

$row = $rs->fetch();

«PRESET_ID» вы можете посмотреть при редактировании шаблонов реквизитов:

или в таблице b_crm_preset. Для «ИП» оно равно 2.

Так реквизиты мы получили, но массиве ($row) нет адреса(ов). Чтобы получить адрес:


$address = Bitrix\Crm\EntityRequisite::getAddresses($row['ID']);

$address = Bitrix\Crm\EntityRequisite::getAddresses($row['ID']);

Метод Bitrix\Crm\EntityRequisite::getAddresses принимает ИД реквизита, на выходе отдает массив с адресами.


Array
(
    [1] => Array
        (
            [ADDRESS_1] => Фактический адрес
            [ADDRESS_2] => Квартира
            [CITY] => Г
            [POSTAL_CODE] => П
            [REGION] => Р
            [PROVINCE] => О
            [COUNTRY] => С
            [COUNTRY_CODE] => 
        )

    [4] => Array
        (
            [ADDRESS_1] => Адрес регистрации
            [ADDRESS_2] => К
            [CITY] => Г
            [POSTAL_CODE] => П
            [REGION] => Р
            [PROVINCE] => О
            [COUNTRY] => С
            [COUNTRY_CODE] => 
        )

    [6] => Array
        (
            [ADDRESS_1] => Юридический 
            [ADDRESS_2] => К
            [CITY] => Г
            [POSTAL_CODE] => П
            [REGION] => Р
            [PROVINCE] => О
            [COUNTRY] => С
            [COUNTRY_CODE] => 
        )

    [9] => Array
        (
            [ADDRESS_1] => Адрес бенефициара
            [ADDRESS_2] => К
            [CITY] => Г
            [POSTAL_CODE] => П
            [REGION] => Р
            [PROVINCE] => О
            [COUNTRY] => С
            [COUNTRY_CODE] => 
        )

)

Array

(

[1] => Array

(

[ADDRESS_1] => Фактический адрес

[ADDRESS_2] => Квартира

[CITY] => Г

[POSTAL_CODE] => П

[REGION] => Р

[PROVINCE] => О

[COUNTRY] => С

[COUNTRY_CODE] =>

)

[4] => Array

(

[ADDRESS_1] => Адрес регистрации

[ADDRESS_2] => К

[CITY] => Г

[POSTAL_CODE] => П

[REGION] => Р

[PROVINCE] => О

[COUNTRY] => С

[COUNTRY_CODE] =>

)

[6] => Array

(

[ADDRESS_1] => Юридический

[ADDRESS_2] => К

[CITY] => Г

[POSTAL_CODE] => П

[REGION] => Р

[PROVINCE] => О

[COUNTRY] => С

[COUNTRY_CODE] =>

)

[9] => Array

(

[ADDRESS_1] => Адрес бенефициара

[ADDRESS_2] => К

[CITY] => Г

[POSTAL_CODE] => П

[REGION] => Р

[PROVINCE] => О

[COUNTRY] => С

[COUNTRY_CODE] =>

)

Как видите каждый тип адреса хранится под своим номером. 1 — Фактический, 4 — адрес регистрации 6 — юридический, 9 — Адрес бенефициара

Я пока не нашел почему фактическому адресу отдается цифра 1, а юридическому 6. Если у кого то есть информация по этому поводу, поделитесь в комментариях.

UPD: Посмотреть константы адресов можно в классе \Bitrix\Crm\EntityAddress


class EntityAddress
{
	const Undefined = 0;
	const Primary = 1;
	const Secondary = 2;
	const Third = 3;
	const Home = 4;
	const Work = 5;
	const Registered = 6;
	const Custom = 7;
	const Post = 8;
	const Beneficiary = 9;
	const Bank = 10;

class EntityAddress

{

const Undefined = 0;

const Primary = 1;

const Secondary = 2;

const Third = 3;

const Home = 4;

const Work = 5;

const Registered = 6;

const Custom = 7;

const Post = 8;

const Beneficiary = 9;

const Bank = 10;

Ну что ж, сегодня мы приоткрыли завесу в мир реквизитов Битрикс24. Пойду дальше копать ~~картошку~~ ядро…. 🙂

18 комментариев

Timur Sobolev
7 лет ago · Permalink

Крайне полезная статья. Спасибо. А как получить банковские данные — ИНН, КПП и пр.?

Ответить

Alma Z
7 лет ago · Permalink

Здравствуйте.
Спасибо большое.
Попробуйте код



$req = new BitrixCrmEntityRequisite();
$rs = $req->getList([
	"filter" => [
		"ENTITY_ID" => Ид компании сюда,
		"ENTITY_TYPE_ID" => CCrmOwnerType::Company,
		//'PRESET_ID' => 2
	]
]);
$row = $rs->fetch();
var_dump($row);

$req = new BitrixCrmEntityRequisite();

"ENTITY_ID" => Ид компании сюда,

//'PRESET_ID' => 2

var_dump($row);

Должно вывести, примерно



'RQ_INN' => string '77777777' (length=8)
  'RQ_KPP' => string '99999999' (length=8)
  'RQ_USRLE' => null
  'RQ_IFNS' => null
  'RQ_OGRN' => string '88888888' (length=8)
  'RQ_OGRNIP' => null
  'RQ_OKPO' => string '111111111' (length=9)
  'RQ_OKTMO' => string '22222222' (length=8)

'RQ_INN' => string '77777777' (length=8)

'RQ_KPP' => string '99999999' (length=8)

'RQ_USRLE' => null

'RQ_IFNS' => null

'RQ_OGRN' => string '88888888' (length=8)

'RQ_OGRNIP' => null

'RQ_OKPO' => string '111111111' (length=9)

'RQ_OKTMO' => string '22222222' (length=8)

Timur Sobolev
7 лет ago · Permalink

Да с этим разобрался. Спасибо. А как насчет БИК, Банк, к/c, р/c? Это отдельный объект?

Ответить
1. Alma Z
  7 лет ago · Permalink
  
  Пример растянулся на небольшую заметку https://almat.pro/kak-poluchit-bankovskie-rekvizity-v-bitriks24-chast-2/
  
  Ответить
Timur Sobolev
7 лет ago · Permalink

Нашел, кажется. EntityBankDetail::getList($params) — далее по аналогии)

UPD: По аналогии не вышло. Не могли бы вы привести пример? Заранее спасибо.

Ответить
1. sergey arkhipov
  6 лет ago · Permalink
  
  Если ещЁ надо , то EntityBankDetail::getList
  $bank = BitrixCrmEntityBankDetail::getList([«filter»=>[‘ENTITY_ID’=>’ID компании’]]);
  $bankData = $bank->fetchAll();
  var_dump($bankData);
  
  Ответить

Alma Z
7 лет ago · Permalink

https://uploads.disquscdn.com/images/c80a00a0081783d1f2bdce77260e81a74526f62f0d3ba9fb67b30fdd80fc0ccd.jpg
Вот пример заполнения реквизитов компании

Ответить

Zharkov Serguei
7 лет ago · Permalink

Здравствуйте!
Подскажите, если возможно, а как можно получить контакты компании?
Как добавить контакт к компании — сложности не представляет. А как получить массив контактов компании?

Ответить
1. Alma Z
  7 лет ago · Permalink
  
  Здравствуйте.
  
  Вам нужно получить все контакты определенной компании?
  
  $res = CCrmContact::GetList([], ['COMPANY_ID' => ИД компании]); while($row = $res->Fetch()) { var_dump($row); }
  
  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  
  $res = CCrmContact::GetList([], ['COMPANY_ID' => ИД компании]);
  
  while($row = $res->Fetch())
  {
  var_dump($row);
  }
  
  Нужно использовать класс CCrmContact. У него много методов, но для выборки есть GetList. Первый параметр это сортировка, второй — фильтр.
  
  Ответить
  1. Zharkov Serguei
    7 лет ago · Permalink
    
    Спасибо!
    
    Ответить
Timur Sobolev
7 лет ago · Permalink

Добрый день. У меня есть несколько отвлеченный вопрос.
Как получить доступ к комментариев в действиям БП. Например, комментарий к форме ввода доп. информации: http://prntscr.com/e0146k

Заранее спасибо.

Ответить
1. Alma Z
  7 лет ago · Permalink
  
  Немного удалось покопать в этом вопросе. Пока остановился на компоненте main.post.list. Похоже этот компонент выводить все сообщения в БП. Ему передается ИД БП. Все начинается с компонента bizproc.task — затем bitrix:forum.comments — который вызывает main.post.list
  К сожалению до конца еще не разобрался.
  
  Ответить
Katerina Laufer
7 лет ago · Permalink

Подскажите, может кому-то удавалось найти в какой таблице хранятся адреса из реквизитов? Сами реквизиты лежат в b_crm_bank_detail, а вот адреса никак найти не могу(

Ответить
Dmitriy Aslamov
7 лет ago · Permalink

https://uploads.disquscdn.com/images/3e082e1568d769d872f5b5699b34dff51394cbf13c6d65c8efe51012df0230d2.jpg А как получить доступ к реквизитам в редакторе бизнес процессов, в поле вставка значения?

Ответить
1. Alma Z
  7 лет ago · Permalink
  
  К сожалению, не знаю. Лучше написать в техподдержку Битрикса по этому вопросу.
  
  Ответить
xaam2
6 лет ago · Permalink

А как сохранить адрес?

Ответить
1. Timur Sobolev
  6 лет ago · Permalink
  
  Куда именно?
  
  Ответить
Роман Анищенко
2 года ago · Permalink

Подскажите, а как отфильтровать по дате реквизиты?
function findRequisiteDel() { $entityRequisite = new BitrixCrmEntityRequisite; $rsRequisite = $entityRequisite->getList([ "select" => array("*"), "filter" => array( "CREATED_BY_ID" => 394, '>=DATE_CREATE' => '2022-09-28', '<=DATE_CREATE' => '2022-09-30' ), "order" => array("SORT" => "asc", "ID" => "desc")
]); return $rsRequisite->fetchAll(); }

Ответить

18 комментариев

Добавить комментарий Отменить ответ