Блог Горошко Андрея Bitrix24,PHP Удалить компанию из указанного контакта crm.contact.company.delete

Удалить компанию из указанного контакта crm.contact.company.delete

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Удалить компанию из указанного контакта crm.contact.company.delete». Вы узнаете экспертные методики работы с crm.contact.company.delete и научитесь избегать типичных ошибок начинающих разработчиков.

Удалить компанию из указанного контакта crm.contact.company.delete

> Scope: crm
>
> Кто может выполнять метод: любой пользователь с правом «изменения» контактов

Метод crm.contact.company.delete удаляет компанию из указанного контакта.

Параметры метода

Название
тип
Описание
id
[integer][1]
Идентификатор контакта.

Идентификатор можно получить с помощью методов crm.contact.list или crm.contact.add

fields
[object][1]
Объект с информацией о том, какую компанию необходимо удалить из привязок.

Содержит единственный ключ COMPANY_ID

fields.COMPANY_ID*
[integer][1]
Идентификатор компании, которую необходимо удалить из привязок

Если удалить первичную привязку, то новой первичной привязкой станет первая доступная привязка.

Примеры кода

Пример удаления связи контакт-компания, где:

  • идентификатор контакта — 54
  • идентификатор компании — 32
  • cURL (Webhook)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"id":54,"fields":{"COMPANY_ID":32}}' \
    https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webbhook_here**/crm.contact.company.delete
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"id":54,"fields":{"COMPANY_ID":32},"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/crm.contact.company.delete
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'crm.contact.company.delete',
    		{
    			id: 54,
    			fields: {
    				COMPANY_ID: 32,
    			},
    		}
    	);
    	
    	const result = response.getData().result;
    	result.error()
    		? console.error(result.error())
    		: console.info(result)
    	;
    }
    catch( error )
    {
    	console.error('Error:', error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'crm.contact.company.delete',
                [
                    'id'     => 54,
                    'fields' => [
                        'COMPANY_ID' => 32,
                    ],
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            echo 'Error: ' . $result->error();
        } else {
            echo 'Success: ' . print_r($result->data(), true);
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error deleting company from contact: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'crm.contact.company.delete',
        {
            id: 54,
            fields: {
                COMPANY_ID: 32,
            },
        },
        (result) => {
            result.error()
                ? console.error(result.error())
                : console.info(result.data())
            ;
        },
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'crm.contact.company.delete',
        [
            'id' => 54,
            'fields' => [
                'COMPANY_ID' => 32,
            ]
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';

Обработка ответа

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1724072653.79827,
        "finish": 1724072717.749956,
        "duration": 63.95168590545654,
        "processing": 63.63148093223572,
        "date_start": "2024-08-19T15:04:13+02:00",
        "date_finish": "2024-08-19T15:05:17+02:00"
    }
}

Возвращаемые данные

Название
тип
Описание
result
[boolean][1]
Корневой элемент ответа. Содержит:
— true — в случае успеха
— false — в случае неудачи (скорее всего компания, которую вы пытаетесь удалить, не привязана к контакту)
time
[time][1]
Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "",
    "error_description": "The parameter 'ownerEntityID' is invalid or not defined."
}

Возможные коды ошибок

КодОписаниеЗначение
-The parameter 'ownerEntityID' is invalid or not definedПередан id меньше 0
-The parameter 'fields' must be arrayВ fields передан не объект
ACCESS_DENIEDAccess denied!У пользователя нет прав на изменения контактов
-Not foundКонтакт с переданным id не найден
-The parameter 'fields' is not validМожет возникать из-за нескольких причин:
— если не передан обязательный параметр fields.COMPANY_ID
— если переданный параметр fields.COMPANY_ID меньше или равен 0
  • [](./crm-contact-company-add)
  • [](./crm-contact-company-fields)
  • [](./crm-contact-company-items-get)
  • [](./crm-contact-company-items-set)
  • [](./crm-contact-company-items-delete)

[1]: ../../../data-types.md

💡 Экспертное мнение и рекомендации

Советы эксперта по интеграции:

  • Всегда используйте кэширование при частых запросах к crm.contact.company.delete, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «Удалить компанию из указанного контакта crm.contact.company.delete».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Создать процесс rpa.type.addСоздать процесс rpa.type.add

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Создать процесс rpa.type.add», разберем архитектурные особенности и предоставим

Получить информацию о ревизиях API imopenlines.revision.getПолучить информацию о ревизиях API imopenlines.revision.get

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Получить информацию о ревизиях API imopenlines.revision.get», проанализируем лучшие

Настройка автоматического распределения лидов между менеджерами по правиламНастройка автоматического распределения лидов между менеджерами по правилам

Профессиональная настройка и внедрение Битрикс24 CRM позволяет систематизировать работу отдела продаж, исключить потерю лидов и автоматизировать ключевые бизнес-процессы компании. Услуга «Настройка автоматического распределения лидов между менеджерами по правилам» обеспечивает равномерное