catalog-measure-add.md

Добавить единицу измерения catalog.measure.add

Scope: catalog

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

Метод добавляет новую единицу измерения.

Параметры метода

{% include Сноска об обязательных параметрах %}

#| || Название тип | Описание || || fields* object | Значения полей для создания новой единицы измерения || |#

Параметр fields

{% include Сноска об обязательных параметрах %}

#| || Название тип | Описание || || code* integer | Уникальный код единицы измерения || || isDefault string | Используется ли текущая единица измерения в качестве единицы измерения по умолчанию для новых товаров. Возможные значения:

• Y — да
• N — нет

Если значение поля не указано, то автоматически устанавливается значение N.

Только одна единица измерения из всего справочника может принимать значение Y || || measureTitle* string | Название единицы измерения || || symbol string | Условное обозначение || || symbolIntl string | Международное условное обозначение || || symbolLetterIntl string | Международное кодовое буквенное обозначение || |#

Примеры кода

{% include Сноска о примерах %}

{% list tabs %}

• cURL (Webhook)

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"fields":{"code":715,"measureTitle":"Пара","symbol":"пар","symbolLetterIntl":"NPR","symbolIntl":"pr; 2","isDefault":"N"}}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/catalog.measure.add

• cURL (OAuth)

  curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"fields":{"code":715,"measureTitle":"Пара","symbol":"пар","symbolLetterIntl":"NPR","symbolIntl":"pr; 2","isDefault":"N"},"auth":"**put_access_token_here**"}' \
  https://**put_your_bitrix24_address**/rest/catalog.measure.add

• JS

  BX24.callMethod(
      'catalog.measure.add', 
      {
          fields: {
              code: 715,
              measureTitle: "Пара",
              symbol: 'пар',
              symbolLetterIntl: 'NPR',
              symbolIntl: 'pr; 2',
              isDefault: 'N'
          }
      },
      function(result) {
          if (result.error())
              console.error(result.error());
          else
              console.log(result.data());
      }
  );

• PHP

  require_once('crest.php');
  
  $result = CRest::call(
      'catalog.measure.add',
      [
          'fields' => [
              'code' => 715,
              'measureTitle' => "Пара",
              'symbol' => 'пар',
              'symbolLetterIntl' => 'NPR',
              'symbolIntl' => 'pr; 2',
              'isDefault' => 'N'
          ]
      ]
  );
  
  echo '<PRE>';
  print_r($result);
  echo '</PRE>';

{% endlist %}

Обработка ответа

HTTP-статус: 200

{
    "result": {
        "measure": {
            "code": 715,
            "id": 6,
            "isDefault": "N",
            "measureTitle": "Пара",
            "symbol": "пар",
            "symbolIntl": "pr; 2",
            "symbolLetterIntl": "NPR"
        }
    },
    "time": {
        "start": 1716552521.40908,
        "finish": 1716552521.69852,
        "duration": 0.289434909820557,
        "processing": 0.011207103729248,
        "date_start": "2024-05-24T14:08:41+02:00",
        "date_finish": "2024-05-24T14:08:41+02:00",
        "operating": 0
    }
}

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

#| || Название тип | Описание || || result object | Корневой элемент ответа || || measure catalog_measure | Объект с информацией о созданной единице измерения || || time time | Информация о времени выполнения запроса || |#

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

HTTP-статус: 400

{
    "error": 200040300020,
    "error_description": "Access Denied"
}

{% include notitle обработка ошибок %}

Возможные коды ошибок

#| || Код | Описание || || 200040300020 | Нет доступа к редактированию || || 200600000000 | Единица измерения с заданным параметром code уже существует || || 200600000010 | Единица измерения, у которой параметр isDefault равен Y, уже существует || || 100 | Не передан обязательный параметр fields || || 0 | Не установлены обязательные поля || || 0 | Другие ошибки (например, фатальные ошибки) || |#

{% include системные ошибки %}

Продолжите изучение

• {#T}
• {#T}
• {#T}
• {#T}
• {#T}