Merchant API

API для внешних систем и интеграторов. Позволяет мерчантам управлять заказами, поставками, товарами и получать информацию о складских операциях.

Префикс: /merchant-api/ Аутентификация: фиксированный API-ключ мерчанта (Bearer token) OpenAPI: /doc/merchant-api/index.html

Endpoint'ы

Склады

Endpoint	Метод	Описание
/warehouses	GET	Список складов мерчанта

Контрагенты

Endpoint	Метод	Описание
/counterparties	GET	Список контрагентов
/counterparties	POST	Создание контрагента

Службы доставки

Endpoint	Метод	Описание
/delivery-companies	GET	Список курьерских и транспортных компаний

Договоры доставки

Endpoint	Метод	Описание
/delivery-contracts	GET	Список договоров
/delivery-contracts	POST	Создание договора (неизменяем после создания заказов)

Товары (SKU)

Endpoint	Метод	Описание
/skus	GET	Каталог товаров
/skus	POST	Создание/обновление товара (уникальный штрихкод)
/skus/serial-number-types	GET	Типы серийных номеров

Поставки

Endpoint	Метод	Описание
/supplies	GET	Список поставок
/supplies	POST	Создание поставки

Статусы: NEW → AWAITING_RECEIPT → RECEIVING → RECEIVED → DONE

Заказы

Endpoint	Метод	Описание
/orders	GET	Список заказов
/orders	POST	Создание заказа (неизменяем после статуса IN_BATCH)

Возвраты

Endpoint	Метод	Описание
/returning	GET	Список возвратов
/returning	POST	Создание возврата

Перемещения

Endpoint	Метод	Описание
/movement	GET	Движения товаров

Доставка

Endpoint	Метод	Описание
/delivery	GET	Информация о доставке

Наборы

Endpoint	Метод	Описание
/bundle	GET	Информация о наборах/комплектах

Изоляция данных

Каждый мерчант видит только свои данные. Изоляция обеспечивается через:

• Merchant-токен идентифицирует организацию
• Hibernate @Filter автоматически фильтрует запросы
• Все создаваемые сущности привязываются к мерчанту