#Обновить склад

PATCH /v1/warehouses/:id

Обновляет склад. Передавайте только изменяемые поля — плоско в корне JSON. Переданные поля заменяют текущие значения, остальные остаются прежними.

#Параметры пути

Параметр Тип Описание
id number Идентификатор склада

#Поля запроса (body)

Любое подмножество изменяемых полей склада — все необязательны.

Параметр Тип Описание
title string Название склада
address string Адрес склада
active string Активность: "Y" / "N"
issuingCenter string Пункт выдачи заказов: "Y" / "N"
description string Описание склада
phone string Контактный телефон
email string Контактная почта
schedule string Режим работы
sort number Порядок сортировки
code string Символьный код
xmlId string Внешний идентификатор
gpsN number Географическая широта
gpsS number Географическая долгота
userId number Ответственный сотрудник

#Примеры

#curl — личный ключ

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/warehouses/1" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Центральный склад",
    "sort": 50
  }'

#curl — OAuth-приложение

Terminal 
curl -X PATCH "https://vibecode.bitrix24.tech/v1/warehouses/1" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Центральный склад",
    "sort": 50
  }'

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/warehouses/1', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Центральный склад',
    sort: 50,
  }),
})

const { success, data } = await res.json()

#JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/warehouses/1', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Центральный склад',
    sort: 50,
  }),
})

const { success, data } = await res.json()

#Поля ответа

Возвращается объект обновлённого склада в поле data.

Поле Тип Описание
id number Идентификатор склада
title string Название склада
address string Адрес склада
active string Активность: "Y" / "N"
issuingCenter string Признак пункта выдачи заказов: "Y" / "N"
description string Описание склада
phone string Контактный телефон
email string Контактная почта
schedule string Режим работы
sort number Порядок сортировки
code string Символьный код
xmlId string Внешний идентификатор
gpsN number Географическая широта
gpsS number Географическая долгота
imageId object Изображение склада: { "id", "url" } или null
userId number Ответственный сотрудник
modifiedBy number Идентификатор пользователя, изменившего склад последним
dateCreate datetime Дата создания
dateModify datetime Дата последнего изменения

#Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": 1,
    "title": "Центральный склад",
    "address": "г. Москва, ул. Складская, 1",
    "active": "Y",
    "issuingCenter": "N",
    "description": "Центральный склад",
    "phone": "+7 495 000 00 00",
    "email": "warehouse@example.com",
    "schedule": "Пн–Пт 9:00–20:00",
    "sort": 50,
    "code": "main",
    "xmlId": null,
    "gpsN": 55.751244,
    "gpsS": 37.618423,
    "imageId": null,
    "userId": 1,
    "modifiedBy": 1,
    "dateCreate": "2024-01-15T09:00:00+03:00",
    "dateModify": "2026-06-02T12:04:25+03:00"
  }
}

#Пример ответа при ошибке

422 — склад с таким id не существует:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "store does not exist."
  }
}

#Ошибки

HTTP Код Описание
400 INVALID_PARAMS id не положительное целое
401 TOKEN_MISSING API-ключ не имеет настроенных токенов
403 SCOPE_DENIED API-ключ не имеет скоупа catalog
422 BITRIX_ERROR Склад с указанным id не существует

Полный список общих ошибок API — Ошибки.

#Известные особенности

Несуществующий склад — 422, не 404. Обновление склада по неизвестному id возвращает 422 с кодом BITRIX_ERROR. Перед обновлением проверяйте наличие склада в списке складов.

#Смотрите также