Рефсейлс API
ApiDiagnostics

Массово изменить цены и остатки

POST
/api/v1/inventory/bulk

Обновляет до 250 существующих товаров за один запрос. Каждая позиция содержит ровно один идентификатор productId, externalId или sku и хотя бы одно поле price или stockQuantity. Цена передаётся в копейках, остаток не может быть отрицательным. Товары не создаются и не удаляются. Позиции выполняются независимо: ответ 200 содержит data[] в исходном порядке со статусом updated, not_found или error и машиночитаемыми деталями ошибки. Повтор одной ссылки в запросе отклоняет все её позиции с error.code=conflict и error.details.reason=duplicate_reference. Право: products:write.

Авторизация

bearerApiKey
headerАвторизацияBearer <rsk_live_…>

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

Тело запроса

application/json
  1. body
items*array<|||||>
Items1 <= items <= 250

Ответ

Результат каждой позиции.

application/json
  1. response
data*array<|>
Example Request
curl -X POST 'https://refsales.ru/api/v1/inventory/bulk' \  -H 'Content-Type: application/json' \  -d '{  "items": [    {      "productId": "dcd53ddb-8104-4e48-8cc0-5df1c5a0d1e2",      "price": 115000,      "stockQuantity": 12    },    {      "externalId": "MS-00124-L",      "stockQuantity": 8    },    {      "sku": "CNDL-400-PINE",      "price": 185000    }  ]}'
Example Response
{  "data": [    {      "index": 0,      "status": "updated",      "productId": "dcd53ddb-8104-4e48-8cc0-5df1c5a0d1e2"    },    {      "index": 1,      "status": "not_found",      "error": {        "code": "not_found",        "message": "Товар не найден"      }    },    {      "index": 2,      "status": "updated",      "productId": "7f3a9c2e-1b5d-4e8a-9c0f-3e6b2d8a1c54"    }  ]}