метод REST scope: sale

sale.businessValuePersonDomain.add

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

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

Описание

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

Параметры

fields object обязательный

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

Параметр fields

personTypeId sale_person_type.id обязательный

Идентификатор типа плательщика.

Получить идентификаторы типов плательщиков можно с помощью метода sale.persontype.list

domain string обязательный

Значение, которому соответствует тип плательщика: физическое или юридическое лицо.
- I — физическое лицо
- E — юридическое лицо

Примеры запроса

-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.add

Ответ

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 Другие ошибки (например, фатальные ошибки)

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.