# Ответственное хранение

`responsible-storage` управляет товарами клиента на хранении: остатками и маркировками, инвентаризациями, выкупом, возвратами и документами. Заказы обслуживает отдельный сервис — [b2b-orders](/api/services/b2b-orders).

## Основные сущности

- **Остатки** — товары и коды маркировки на складах клиента.
- **Инвентаризация** — зафиксированный результат пересчёта товаров.
- **Заказ на выкуп** — выкуп конкретных единиц товара с хранения.
- **Заявка на возврат** — возврат товара с хранения; это не отмена выкупа.
- **Документы** — МХ-1 о приёме на хранение, МХ-3 о возврате с хранения и УПД.

Выкуп, возврат и инвентаризация имеют отдельные идентификаторы и статусы. Связанные документы могут появиться позже самой заявки.

## С чего начать

<div class="stepper">

1. Согласуйте доступ, свой идентификатор клиента, склад и окружение.
2. Получите [склады клиента](/api/инвентаризация#получение-списка-складов-из-балансов-cis) и [остатки](/api/инвентаризация#получение-остатков).
3. Выберите сценарий ниже и создайте соответствующую заявку.
4. Отслеживайте её обработку и готовность документов отдельно.

</div>

## Сценарии

### Инвентаризация

[Создайте инвентаризацию](/api/инвентаризация#создание-инвентаризации) по результатам пересчёта. До подтверждения её можно [проверить](/api/инвентаризация#получение-инвентаризации-по-идентификатору) и [исправить](/api/инвентаризация#обновление-инвентаризации), затем [подтвердить или отменить](/api/инвентаризация#обновление-статуса-инвентаризации). История доступна в [списке инвентаризаций](/api/инвентаризация#получение-списка-инвентаризации).

### Выкуп с хранения

[Создайте заказ на выкуп](/api/заказы-на-выкуп-с-отх#создать-заказ-3) и [следите за обработкой](/api/заказы-на-выкуп-с-отх#получить-заказ-по-идентификатору-2). Для уведомлений можно [настроить вебхук](/api/webhook#добавить-вебхук); он не заменяет проверку состояния заказа. Вебхук можно [отключить](/api/webhook#удалить-вебхук).

Все выкупы доступны в [списке заказов](/api/заказы-на-выкуп-с-отх#получить-список-заказов-для-клиента). Для прекращения обработки используйте [отмену выкупа](/api/заказы-на-выкуп-с-отх#отменить-заказ-по-идентификатору).

### Возврат с хранения

[Создайте заявку на возврат](/api/возвраты#создать-заявку-на-возврат-товара-с-хранения) и [проверяйте результат](/api/возвраты#получить-детальную-информацию-по-заявке-на-возврат). При необходимости [измените](/api/возвраты#изменить-заявку-на-возврат) и [подтвердите её состав](/api/возвраты#подтвердить-заявку-на-возврат). Подтверждённые товары можно [выкупить полностью или частично](/api/возвраты#выкупить-заявку-на-возврат); ненужную заявку — [отменить](/api/возвраты#отменить-заявку-на-возврат). История доступна в [списке возвратов](/api/возвраты#получить-список-заявок-на-возврат).

## Документы

Данные документов доступны через API:

- МХ-1: [список](/api/документы#получить-список-mx1-для-клиента) и [состав акта](/api/документы#получить-детальную-информацию-об-мх1).
- МХ-3: [список](/api/документы#получить-список-mx3-для-клиента) и [состав акта](/api/документы#получить-детальную-информацию-об-мх3).
- УПД: [список](/api/документы#получить-список-upd-для-клиента) и [строки документа](/api/документы#получить-детальную-информацию-об-upd).

## Окружения

На общем сервере из [API Reference](/api):

- `/responsible-storage/v1-sandbox` — testing, выбран по умолчанию в спецификации.
- `/responsible-storage/v1` — основное окружение.

:::note{title="Testing"}

Для responsible-storage опубликован адрес тестового окружения. Доступ, тестовые данные, их сброс и ограничения внешних интеграций согласуйте отдельно. Успешный вызов в testing не подтверждает права и поведение в основном окружении; проверяйте авторизацию и готовность документов отдельно.

:::

## Авторизация и идентификатор клиента

Создайте авторизационный токен на странице [Токены интеграций](https://new.rimeks.ru/settings/integrations/tokens). Передавайте его в `Authorization: Bearer <API_TOKEN>`, а ERP ID клиента — в заголовке `X-Client-ID`.
Например: `GET /orders` с `X-Client-ID: 00-00002323` относительно префикса сервиса.
Токен должен предоставлять доступ к указанному клиенту.

См. [общие правила авторизации и идентификации клиента](/api).

Параметры, примеры запросов, статусы и ограничения находятся на страницах соответствующих методов.
