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

Склады

Склады портала и товарные остатки на них. Склад — это точка хранения или выдачи товаров каталога: физический склад, магазин или пункт выдачи. Склады можно создавать, изменять и удалять. Остатки товаров доступны только для чтения — по отдельному складу или сводно по всем складам.

Битрикс24 API: catalog.store.*, catalog.storeproduct.* Скоуп: catalog

Создать склад

POST /v1/warehouses

Создаёт новый склад. Поля передаются плоско в корне JSON — без обёртки fields.

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

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

Примеры

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/warehouses" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Основной склад",
    "address": "г. Москва, ул. Складская, 1",
    "active": "Y"
  }'

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

Terminal 
curl -X POST "https://vibecode.bitrix24.tech/v1/warehouses" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Основной склад",
    "address": "г. Москва, ул. Складская, 1",
    "active": "Y"
  }'

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/warehouses', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Основной склад',
    address: 'г. Москва, ул. Складская, 1',
    active: 'Y',
  }),
})

const { success, data } = await res.json()
console.log('ID склада:', data.id)

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

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/warehouses', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    title: 'Основной склад',
    address: 'г. Москва, ул. Складская, 1',
    active: 'Y',
  }),
})

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 ОписаниеОтветственный сотрудник
ПолеmodifiedBy Типnumber ОписаниеИдентификатор пользователя, изменившего склад последним
ПолеdateCreate Типdatetime ОписаниеДата создания
ПолеdateModify Типdatetime ОписаниеДата последнего изменения

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

JSON 
{
  "success": true,
  "data": {
    "id": 25,
    "title": "Основной склад",
    "address": "г. Москва, ул. Складская, 1",
    "active": "Y",
    "issuingCenter": "N",
    "description": null,
    "phone": null,
    "email": null,
    "schedule": null,
    "sort": 100,
    "code": null,
    "xmlId": null,
    "gpsN": null,
    "gpsS": null,
    "imageId": null,
    "userId": 1,
    "modifiedBy": 1,
    "dateCreate": "2026-06-02T12:04:24+03:00",
    "dateModify": "2026-06-02T12:04:24+03:00"
  }
}

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

400 — не передано обязательное поле:

JSON 
{
  "success": false,
  "error": {
    "code": "MISSING_PARAMS",
    "message": "Required: title (string), address (string)"
  }
}

Ошибки

HTTP Код Описание
HTTP400 КодMISSING_PARAMS ОписаниеНе передано title либо address
HTTP400 КодINVALID_PARAMS Описаниеtitle или address не строка
HTTP401 КодTOKEN_MISSING ОписаниеAPI-ключ не имеет настроенных токенов
HTTP403 КодSCOPE_DENIED ОписаниеAPI-ключ не имеет скоупа catalog
HTTP422 КодBITRIX_ERROR ОписаниеБитрикс24 отклонил создание (например, недопустимое значение поля)

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

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

Значения по умолчанию. Если не передать active, sort и issuingCenter, склад создаётся со значениями active: "Y", sort: 100, issuingCenter: "N". Поля userId и modifiedBy в ответе заполняются текущим пользователем, под которым выпущен ключ.

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