Для AI-агентов: markdown этой страницы — /docs-content/entities/warehouses/update.md индекс документации — /llms.txt

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

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 | null Описание склада. null, если не задано
phone string | null Контактный телефон. null, если не задан
email string | null Контактная почта. null, если не задана
schedule string | null Режим работы. null, если не задан
sort number Порядок сортировки
code string | null Символьный код. null, если не задан
xmlId string | null Внешний идентификатор. null, если не задан
gpsN number | null Географическая широта. null, если не задана
gpsS number | null Географическая долгота. null, если не задана
imageId object | null Изображение склада: { "id", "url" } или null
userId number | null Ответственный сотрудник. null у системных складов
modifiedBy number Идентификатор пользователя, изменившего склад последним. После обновления — тот, под кем выпущен ключ
dateCreate datetime | null Дата создания. null у части системных складов, например маркетплейсов
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. Перед обновлением проверяйте наличие склада в списке складов.

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