метод REST scope: sale

sale.statusLang.add

Добавить локализацию

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

Описание

Метод sale.statusLang.add добавляет локализацию статуса заказа или доставки.

Параметры

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

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

fields: {
    statusId: 'значение',
    lid: 'значение',
    name: 'значение',
    description: 'значение'
}

Параметр fields

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

Символьный идентификатор статуса

lid sale_lang.lid обязательный

Идентификатор языка. Текущие возможные значения приведены ниже:

  • ar — арабский
  • br — португальский
  • de — немецкий
  • en — английский
  • fr — французский
  • hi — хинди
  • id — индонезийский
  • in — английский (Индия)
  • it — итальянский
  • ja — японский
  • la — испанский
  • ms — малайский
  • pl — польский
  • ru — русский
  • sc — китайский (упрощенный)
  • tc — китайский (традиционный)
  • th — тайский
  • tr — турецкий
  • ua — украинский
  • vn — вьетнамский

Список актуальных языков можно получить методом sale.statusLang.getListLangs

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

Название статуса для создаваемой локализации

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

Описание статуса для создаваемой локализации

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

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"fields":{"statusId":"RD","lid":"ru","name":"Возвращен покупателем","description":"Покупатель вернул товар по причине наличия дефекта"}}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/sale.statusLang.add

Ответ

HTTP-статус: 200

{
    "result":{
        "statusLang":{
            "description":"Покупатель вернул товар по причине наличия дефекта",
            "lid":"ru",
            "name":"Возвращен покупателем",
            "statusId":"RD"
        }
    },
    "time":{
        "start":1712218058.514339,
        "finish":1712218060.34603,
        "duration":1.831691026687622,
        "processing":0.042268991470336914,
        "date_start":"2024-04-04T11:07:38+03:00",
        "date_finish":"2024-04-04T11:07:40+03:00"
    }
}

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

result object

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

statusLang sale_status_lang

Объект с информацией о добавленной локализации статуса

time time

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

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

HTTP-статус: 400

{
    "error":201750000003,
    "error_description":"Duplicate entry for key [statusId, lid]"
}
Код Описание Значение
201750000003 Локализация для переданного статуса уже существует
201750000004 Передан неизвестный идентификатор языка локализации lid
200040300020 Недостаточно прав для добавления локализации статуса
100 Не указан или пустой параметр fields
0 Не переданы обязательные поля структуры fields
0 Другие ошибки (например, фатальные ошибки)

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

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