Рефсейлс API
Справочники

Изменить склад

PATCH
/api/v1/references/warehouses/{id}

Меняет только переданные поля. isActive: false отключает склад и снимает с него отметку основного. Право: references:write.

Авторизация

bearerApiKey
headerАвторизацияBearer <ключ>

Ключ API в заголовке Authorization: Bearer rsk_live_…. Ключ создаёт владелец магазина: Настройки → Интеграции → API-ключи.

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

id*string

ID записи.

Тело запроса

application/json
  1. body
name?string

Название склада.

Length1 <= length <= 100
code?string

Код латиницей: строчные буквы, цифры и _, до 50 символов. Без кода его придумает Рефсейлс.

Match^[a-z0-9_]{1,50}$
description?|

Описание.

address?|

Адрес одной строкой.

city?|

Город.

workingHours?|

Часы работы.

contactPerson?|

Контактное лицо.

phone?|

Телефон.

email?|

Email.

isActive?boolean

false отключает склад и снимает с него отметку основного.

Ответ

Запись после изменения.

application/json
  1. response
data*
curl -X PATCH "https://example.com/api/v1/references/warehouses/string" \  -H "Content-Type: application/json" \  -d '{    "workingHours": "Пн–Пт 10:00–19:00"  }'
{  "data": {    "id": "e4b7a2d9-1c6f-4e3b-9a8d-5f2c7e1b4a96",    "code": "ligovsky",    "name": "Склад на Лиговском",    "address": "Лиговский пр., 50",    "city": "Санкт-Петербург",    "isActive": true  }}

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

Создаёт склад. Без code код получится из названия. Если код занят, к нему добавится номер. Право: references:write.

Категории товаров GET

Категории товаров магазина. id передавайте в categoryId товара, externalId в categoryExternalId. Список короткий, поэтому приходит одной страницей. Право: references:read.