метод REST scope: catalog

catalog.priceType.add

Создать тип цены

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

Описание

Метод добавляет новый тип цены.

Параметры

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

Значения полей для создания нового типа цены (подробное описание)

Параметр fields

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

Код типа цены.

Чтобы обеспечить стабильную работу внутренних сервисов, код типа цены необходимо указывать только английскими символами

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

Является ли тип цены базовым. Возможные значения:
- Y — да
- N — нет

По умолчанию N.

Одновременно может существовать только один базовый тип цены. При добавлении нового базового типа предыдущий потеряет это свойство и перестанет быть базовым

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

Сортировка.

По умолчанию 100

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

Внешний код.

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

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"name":"Wholesale price","base":"N","sort":10,"xmlId":"wholesale"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.priceType.add

Ответ

HTTP-статус: 200

{
    "result": {
        "priceType": {
            "base": "N",
            "createdBy": 1,
            "dateCreate": "2024-10-02T17:49:44+02:00",
            "id": 2,
            "modifiedBy": 1,
            "name": "Wholesale price",
            "sort": 10,
            "timestampX": "2024-10-02T17:49:44+02:00",
            "xmlId": "wholesale"
        }
    },
    "time": {
        "start": 1716552521.40908,
        "finish": 1716552521.69852,
        "duration": 0.289434909820557,
        "processing": 0.011207103729248,
        "date_start": "2024-10-02T17:49:44+02:00",
        "date_finish": "2024-10-02T17:49:44+02:00",
        "operating": 0
    }
}

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

result object

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

priceType catalog_price_type

Объект с информацией о созданном типе цены

time time

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

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

HTTP-статус: 400

{
    "error": 200040300020,
    "error_description": "Access Denied"
}
Код Описание Значение
200040300020 Недостаточно прав для редактирования
100 Не передан обязательный параметр fields
0 Не установлены обязательные поля
0 Другие ошибки (например, фатальные ошибки)

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

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