метод REST scope: delivery

sale.delivery.extra.service.add

Добавить услугу службы доставки

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

Описание

Метод sale.delivery.extra.service.add добавляет услугу службы доставки.

Параметры

DELIVERY_ID sale_delivery_service.ID обязательный

Идентификатор службы доставки, к которой будет привязана создаваемая услуга.

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

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

Тип услуги. Возможные значения:
- enum — список (выбор опции из заранее сформированного списка)
- checkbox — единичная услуга (например, доставка до двери)
- quantity — количественная услуга (например, требуемое количество грузчиков)

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

Название услуги

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

Индикатор активности услуги. Возможные значения:
- Y — да
- N — нет

Если значение не передано, то по умолчанию используется N

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

Символьный код услуги

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

Сортировка

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

Описание услуги

PRICE double необязательный

Стоимость услуги в валюте службы доставки.

Поле актуально только для услуг типа единичная услуга (checkbox) и количественная услуга (quantity)

ITEMS object[] обязательный

Список доступных для выбора опций (подробное описание приведено ниже).

Поле актуально только для услуг типа список (enum)

Параметр ITEMS

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

Название опции списка

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

Символьный код опции списка

PRICE double необязательный

Стоимость услуги при выборе данной опции в валюте службы доставки

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"DELIVERY_ID":197,"ACTIVE":"Y","CODE":"door_delivery","NAME":"Door Delivery","DESCRIPTION":"Door Delivery Description","TYPE":"checkbox","SORT":100,"PRICE":99.99}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.delivery.extra.service.add

Ответ

HTTP-статус: 200

{
    "result": 128,
    "time": {
        "start": 1714204589.717545,
        "finish": 1714204589.95374,
        "duration": 0.23619484901428223,
        "processing": 0.031846046447753906,
        "date_start": "2024-04-27T10:56:29+03:00",
        "date_finish": "2024-04-27T10:56:29+03:00"
    }
}

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

result sale_delivery_extra_service.ID

Идентификатор добавленной услуги

time time

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

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

HTTP-статус: 400

{
    "error":"ERROR_CHECK_FAILURE",
    "error_description":"Parameter DELIVERY_ID is not defined"
}
Код Описание Значение
ERROR_CHECK_FAILURE Ошибка валидации входящих параметров (детали в описании ошибки) 400
ERROR_EXTRA_SERVICE_ADD Ошибка при попытке добавления услуги 400
ERROR_DELIVERY_NOT_FOUND Служба доставки с указанным идентификатором не найдена 400
ACCESS_DENIED Недостаточно прав для добавления службы доставки 403

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

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