метод REST scope: sale

sale.persontype.update

Изменить тип плательщика

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

Описание

Метод sale.persontype.update изменяет поля типа плательщика.

Параметры

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

Номер типа плательщика

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 '{"id":12,"fields":{"name":"Юр. лицо"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.persontype.update

Ответ

HTTP-статус: 200

{
    "result": {
        "personType": {
        "active": "Y",
        "code": "MY_CRM_COMPANY",
        "id": 68,
        "name": "Юр. лицо",
        "sort": "100",
        "xmlId": "1234"
        }
    },
    "time": {
        "start": 1712327086.69665,
        "finish": 1712327086.95303,
        "duration": 0.256376028060913,
        "processing": 0.0112268924713135,
        "date_start": "2024-04-05T16:24:46+02:00",
        "date_finish": "2024-04-05T16:24:46+02:00",
        "operating": 0
    }
}

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

result object

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

personType sale_person_type

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

time time

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

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

HTTP-статус: 400

{
    "error":0,
    "error_description":"Required fields: name"
}
Код Описание Значение
200740400001 Тип плательщика с заданным полем id не существует
200750000007 200750000002 Ошибка при обнолении типа
200040300020 Нет доступа к редактированию
100 Не указан параметр id
100 Не указан или пустой параметр fields
0 Не переданы обязательные поля структуры fields
0 Другие ошибки (например, фатальные ошибки)

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

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