Блог Горошко Андрея 1C-Битрикс,Bitrix24 Добавить соответствие физическому или юридическому лицу sale.businessValuePer…

Добавить соответствие физическому или юридическому лицу sale.businessValuePer…

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

Добавить соответствие физическому или юридическому лицу sale.businessValuePersonDomain.add

> Scope: sale
>
> Кто может выполнять метод: администратор

Метод sale.businessValuePersonDomain.add добавляет для выбранного типа плательщика соответствие физическому или юридическому лицу. Это необходимо для работы механизма бизнес-смыслов.

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

Название
тип
Описание
fields
object
Значения полей для создания соответствия физическому или юридическому лицу

Параметр fields

Название
тип
Описание
personTypeId
sale_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
    }
}

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

Название
тип
Описание
result
object
Корневой элемент ответа
businessValuePersonDomain
sale_business_value_person_domain
Объект с информацией о добавленном соответствии типа плательщика физическому или юридическому лицу
time
time
Информация о времени выполнения запроса

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

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 и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Интеграция интернет-магазина с сервисом рассрочки Покупай со СберомИнтеграция интернет-магазина с сервисом рассрочки Покупай со Сбером

Бесшовная и отказоустойчивая интеграция сайта на 1С-Битрикс с внешними учетными системами, банками, службами доставки и маркетплейсами — основа масштабирования современного бизнеса. Услуга «Интеграция интернет-магазина с сервисом рассрочки Покупай со Сбером»

Создание своего модуля в Битрикс: Структура, install/index.php и version.phpСоздание своего модуля в Битрикс: Структура, install/index.php и version.php

Модуль — это основной способ расширения функциональности Битрикс. Создание собственного модуля позволяет инкапсулировать бизнес-логику, компоненты, классы и административные страницы в единый, легко устанавливаемый пакет. Шаг 1: Структура папок Все кастомные

Разработка закрытого B2B-каталога с индивидуальным доступом по логину и паролюРазработка закрытого B2B-каталога с индивидуальным доступом по логину и паролю

Разработка и внедрение профессионального B2B-портала и дилерского кабинета на 1С-Битрикс позволяет кардинально сократить издержки отдела оптовых продаж, перевести дилеров на самообслуживание 24/7 и исключить ошибки ручного ввода заказов. Услуга «Разработка