Версия 1.0.0 · OpenAPI 3.1
Справочник публичного API
Публичное REST API открывает учет Золотенков МРП другим системам: 1С, маркетплейсам, вашим сервисам и ИИ-агентам. У каждой ручки здесь своя страница с параметрами, примером запроса и примерами ответов.
С чего начать
- 1
Выпустите ключ
Раздел «Настройки → API-ключи» в Золотенков МРП. Значение показывается один раз — сохраните его в менеджере секретов на своем сервере.
- 2
Выдайте только нужные права
Право — это разрешение на одно действие. Интеграция получает ровно те, без которых ее сценарий не работает.
- 3
Сделайте первый запрос
Список товаров — самый безопасный первый вызов: он ничего не меняет и сразу показывает, что ключ принят.
curl --request GET \
--url 'https://mrp.zolotenkov.ru/api/external/v1/products?limit=5' \
--header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \
--header 'Accept: application/json' Разделы
Всего 56 ручек на 42 адресах.
Каталог
Каталог: карточки товаров и их варианты.
Склад
Склад: остатки, движения и корректировки.
Продажи
Продажи: покупатели и заказы покупателей.
- GET Список покупателей
- POST Создать покупателя
- GET Карточка покупателя
- PATCH Изменить карточку покупателя
- GET Список заказов покупателей
- POST Создать заказ покупателя
- GET Карточка заказа покупателя
- PATCH Изменить заказ покупателя
- POST Отменить заказ покупателя.
- POST Отгрузить остаток и закрыть заказ покупателя
- POST Отгрузить позиции заказа покупателя
- GET Справочник причин возврата
- GET Список возвратов покупателей
- POST Оформить возврат покупателя
- GET Карточка возврата покупателя
- POST Принять возврат покупателя на склад
Закупки
Закупки: поставщики, заказы поставщикам и приходы.
Производство
Производство: задания, операции и спецификации.
- GET Список производственных заданий
- POST Создать производственное задание
- GET Карточка производственного задания
- POST Завершить производственное задание
- POST Запустить производственное задание
- GET Операции производственного задания
- GET Список производственных операций
- GET Карточка производственной операции
- GET Список спецификаций
- GET Карточка спецификации
План
План: прогноз остатков, дефициты и рекомендации к пополнению.
Отчеты
Отчеты: сводные срезы за период — продажи и выпуск, сложенные по товару и периоду.
События
События: подписки на уведомления и состав полезной нагрузки каждого события (раздел `webhooks` этого документа).
Подключение ИИ-агента
Тот же учет доступен агенту напрямую, по протоколу MCP: агент сам выбирает нужное действие из этого справочника. Настройка занимает одну команду.
Как подключить агента →