При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Удалить соответствие физическому или юридическому лицу sale.businessValuePers…», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.
Удалить соответствие физическому или юридическому лицу sale.businessValuePersonDomain.deleteByFilter
> Scope: sale
>
> Кто может выполнять метод: администратор
Метод sale.businessValuePersonDomain.deleteByFilter удаляет соответствие физическому или юридическому лицу.
Параметры метода
Названиетип | Описание |
|---|---|
fieldsobject | Значения полей для удаления соответствия физическому или юридическому лицу |
Параметр fields
Параметртип | Описание |
|---|---|
personTypeIdsale_person_type.id | ID типа плательщика. Уникальный параметр. Получить идентификаторы типов плательщиков можно с помощью метода sale.persontype.list |
domain*string | Значение, которому соответствует тип плательщика: физическое лицо или юридическое лицо. — I — физическое лицо— E — юридическое лицо |
Примеры кода
- cURL (Webhook)
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"personTypeId":3,"domain":"I"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.businessValuePersonDomain.deleteByFilter- cURL (OAuth)
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"personTypeId":3,"domain":"I"},"auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/sale.businessValuePersonDomain.deleteByFilter- JS
try
{
const response = await $b24.callMethod(
'sale.businessValuePersonDomain.deleteByFilter',
{
fields: {
personTypeId: 3,
domain: "I"
}
}
);
const result = response.getData().result;
console.log(result);
}
catch(error)
{
console.error(error);
}- PHP
try {
$response = $b24Service
->core
->call(
'sale.businessValuePersonDomain.deleteByFilter',
[
'fields' => [
'personTypeId' => 3,
'domain' => "I",
],
]
);
$result = $response
->getResponseData()
->getResult();
if ($result->error()) {
error_log($result->error());
} else {
echo 'Success: ' . print_r($result->data(), true);
}
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error deleting business value person domain: ' . $e->getMessage();
}- BX24.js
BX24.callMethod(
'sale.businessValuePersonDomain.deleteByFilter',
{
fields: {
personTypeId: 3,
domain: "I"
}
},
function(result)
{
if(result.error())
console.error(result.error());
else
console.log(result.data());
}
);- PHP CRest
require_once('crest.php');
$result = CRest::call(
'sale.businessValuePersonDomain.deleteByFilter',
[
'fields' =>
[
'personTypeId' => 3,
'domain' => 'I'
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Обработка ответа
HTTP-статус: 200
{
"result":true,
"time":{
"start":1712571751.487018,
"finish":1712571752.329445,
"duration":0.8424267768859863,
"processing":0.6462001800537109,
"date_start":"2024-04-08T13:22:31+03:00",
"date_finish":"2024-04-08T13:22:32+03:00"
}
}Возвращаемые данные
Названиетип | Описание |
|---|---|
resultboolean | Результат удаления соответствия физическому или юридическому лицу |
timetime | Информация о времени выполнения запроса |
Обработка ошибок
HTTP-статус: 400
{
"error": 201440400003,
"error_description": "business value person domain is not exists"
}Возможные коды ошибок
| Код | Описание |
|---|---|
201450000002 | Не передан параметр personTypeId |
201450000003 | Не передан параметр domian |
201440400003 | Для указанного personTypeId указанный domain не существует |
200040300020 | Ошибка доступа к удалению |
100 | Не указан или пустой параметр fields |
0 | Не указан обязательный параметр |
0 | Другие ошибки (например, фатальные ошибки) |
- [](./sale-business-value-person-domain-add)
- [](./sale-business-value-person-domain-list)
- [](./sale-business-value-person-domain-get-fields)
💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Удалить соответствие физическому или юридическому лицу sale.businessValuePers…» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru