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

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

PATCH /v1/warehouses/:id

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

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

Параметр Тип Описание
Параметрid Типnumber ОписаниеИдентификатор склада. Список: GET /v1/warehouses

Поля запроса (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 ОписаниеОтветственный сотрудник. Список: GET /v1/users

Примеры

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.

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

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

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

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

Ошибки

HTTP Код Описание
HTTP400 КодINVALID_PARAMS Описаниеid не каноническое положительное целое: 12.5, 12abc, 1e2, 007 отвергаются до обращения к Битрикс24
HTTP401 КодTOKEN_MISSING ОписаниеAPI-ключ не имеет настроенных токенов
HTTP403 КодSCOPE_DENIED ОписаниеAPI-ключ не имеет скоупа catalog
HTTP404 КодENTITY_NOT_FOUND ОписаниеСклад с указанным id не существует

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

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

Несуществующий склад — 404. Обновление склада по неизвестному id возвращает 404 с кодом ENTITY_NOT_FOUND. В поле message остаётся текст портала store does not exist..

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