При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Добавить соответствие физическому или юридическому лицу sale.businessValuePer…», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.
Добавить соответствие физическому или юридическому лицу sale.businessValuePersonDomain.add
> Scope: sale
>
> Кто может выполнять метод: администратор
Метод sale.businessValuePersonDomain.add добавляет для выбранного типа плательщика соответствие физическому или юридическому лицу. Это необходимо для работы механизма бизнес-смыслов.
Параметры метода
Названиетип | Описание |
|---|---|
fieldsobject | Значения полей для создания соответствия физическому или юридическому лицу |
Параметр fields
Названиетип | Описание |
|---|---|
personTypeIdsale_person_type.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_webbhook_here**/sale.businessValuePersonDomain.add- 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.add- JS
B24.callMethod(
'sale.businessValuePersonDomain.add',
{
fields: {
personTypeId: 3,
domain: 'I'
}
},
function(result)
{
if(result.error())
console.error(result.error());
else
console.log(result.data());
}
);- PHP
require_once('crest.php');
$result = CRest::call(
'sale.businessValuePersonDomain.add',
[
'fields' =>
[
'personTypeId' => 3,
'domain' => 'I'
]
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';Обработка ответа
HTTP-статус: 200
{
"businessValuePersonDomain": {
"domain": "I",
"personTypeId": 3
},
"time": {
"start": 1712325642.686926,
"finish": 1712325642.949075,
"duration": 0.2621490955352783,
"processing": 0.004400968551635742,
"date_start": "2024-04-05T16:00:42+02:00",
"date_finish": "2024-04-05T16:00:42+02:00",
"operating": 0
}
}Возвращаемые данные
Названиетип | Описание |
|---|---|
resultobject | Корневой элемент ответа |
businessValuePersonDomainsale_business_value_person_domain | Объект с информацией о добавленном соответствии типа плательщика физическому или юридическому лицу |
timetime | Информация о времени выполнения запроса |
Обработка ошибок
HTTP-статус: 400
{
"error": 201450000001,
"error_description": "Duplicate entry for key [personTypeId]"
}Возможные коды ошибок
| Код | Описание |
|---|---|
201250000001 | Соответствие для указанного идентификатора типа плательщика уже существует |
201240400002 | Тип плательщика с указанным идентификатором не существует |
200040300020 | Ошибка доступа к записи |
100 | Не указан или пустой параметр fields |
0 | Не переданы обязательные поля |
0 | Другие ошибки (например, фатальные ошибки) |
- [](./sale-business-value-person-domain-list)
- [](./sale-business-value-person-domain-delete-by-filter)
- [](./sale-business-value-person-domain-get-fields)
💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «Добавить соответствие физическому или юридическому лицу sale.businessValuePer…» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru