метод REST scope: sale

sale.persontype.add

Добавить тип плательщика

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

Описание

Метод sale.persontype.add добавляет новый тип плательщика.

Параметры

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

Значения полей (подробное описание приведено ниже) для создания нового типа плательщика в виде структуры:

fields: {
    name: 'значение',
    code: 'значение',
    sort: 'значение',
    active: 'значение',
    xmlId: 'значение'
}

Параметр fields

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

Название типа плательщика

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

Код типа плательщика. Должен быть уникальным

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

Сортировка. По умолчанию значение равно 150

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

Флаг активности. Может принимать значения Y / N. По умолчанию установлено Y

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

Внешний идентификатор.

Можно использовать для синхронизации текущего типа плательщика с аналогичной позицией во внешней системе

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"name":"Физическое лицо","sort":"100","active":"Y","code":"MY_CRM_COMPANY","xmlId":"myXmlId"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.persontype.add

Ответ

HTTP-статус: 200

{
    "result": {
        "personType": {
            "active": "Y",
            "code": "MY_CRM_COMPANY",
            "id": 68,
            "name": "Физическое лицо",
            "sort": "100",
            "xmlId": "myXmlId"
        }
    },
    "time": {
        "start": 1712325812.35051,
        "finish": 1712325812.58676,
        "duration": 0.236255884170532,
        "processing": 0.011207103729248,
        "date_start": "2024-04-05T16:03:32+02:00",
        "date_finish": "2024-04-05T16:03:32+02:00",
        "operating": 0
    }
}

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

result object

Корневой элемент ответа

personType sale_person_type

Объект с информацией о добавленном типе плательщика

time time

Информация о времени выполнения запроса

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

HTTP-статус: 400

{
    "error": 200750000005,
    "error_description": "person type code exists"
}
Код Описание Значение
200750000005 Тип плательщика с таким символьным кодом уже существует
200750000001 200750000006 Не удалось создать новый тип плательщика
200040300020 Нет доступа к редактированию
100 Не передан обязательный параметр fields
0 Не установлены обязательные поля

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

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