Оформить корректировку остатка

POST https://mrp.zolotenkov.ru/api/external/v1/stock-adjustments

Требуемое право ключа: write:inventory.adjustment.create

Приводит остаток к фактическому и записывает движение с причиной. Обязателен Idempotency-Key: повтор с тем же ключом остаток второй раз не двигает.

Заголовки

Idempotency-Key строка обязателен

Обязателен. Повтор с тем же ключом возвращает прежний ответ и остаток второй раз не двигает. Ответ на повтор помечен заголовком Idempotency-Replayed: true — по коду ответа повтор от первичного вызова не отличается.

Тело запроса

Формат — application/json.

date дата и время необязателен может быть пустым

Дата документа. Не указана — текущий момент. Дата в закрытом учетном периоде и дата в будущем отвергаются с 422.
items массив объектов обязателен
items.item_variant_id целое число обязателен
items.quantity_delta десятичная дробь обязателен

Знаковая величина: недостача отрицательна, излишек положителен. Ноль отвергается — корректировка на ноль ничего не корректирует.
items.storage_place_id целое число необязателен может быть пустым

Не указано — берется место хранения клиента по умолчанию, ровно как у прихода по заказу поставщику без явного склада.
reason строка необязателен может быть пустым
title строка обязателен

Ответы

201 Корректировка оформлена
400 Некорректное тело, ссылка на строку другого клиента либо уход остатка в минус
401 Ключ не передан, недействителен или отозван
403 У ключа нет права write:inventory.adjustment.create
409 Idempotency-Key повторен с другим телом
422 Дата документа в закрытом учетном периоде или в будущем
429 Исчерпан суточный предел документов ключа (document_quota_exceeded) либо частота обращений

curl --request POST \ --url 'https://mrp.zolotenkov.ru/api/external/v1/stock-adjustments' \ --header 'Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ' \ --header 'Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21' \ --header 'Content-Type: application/json' \ --data '{ "date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "quantity_delta": 5, "storage_place_id": 42 } ], "reason": "Комментарий", "title": "Название" }'

const response = await fetch("https://mrp.zolotenkov.ru/api/external/v1/stock-adjustments", { method: "POST", headers: { "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type": "application/json", }, body: JSON.stringify({ "date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "quantity_delta": 5, "storage_place_id": 42 } ], "reason": "Комментарий", "title": "Название" }), }); const data = await response.json();

import requests response = requests.post( "https://mrp.zolotenkov.ru/api/external/v1/stock-adjustments", headers={ "Authorization": "Bearer zol_pat_live_ВАШ_КЛЮЧ", "Idempotency-Key": "6f1c4c1b-9a2f-3f7d1c9b8a21", }, json={ "date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "quantity_delta": 5, "storage_place_id": 42 } ], "reason": "Комментарий", "title": "Название" }, timeout=30, ) response.raise_for_status() print(response.json())

<?php $curl = curl_init('https://mrp.zolotenkov.ru/api/external/v1/stock-adjustments'); curl_setopt_array($curl, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer zol_pat_live_ВАШ_КЛЮЧ", "Accept: application/json", "Idempotency-Key: 6f1c4c1b-9a2f-3f7d1c9b8a21", "Content-Type: application/json", ], CURLOPT_POSTFIELDS => <<<'JSON' { "date": "2026-08-01T09:00:00Z", "items": [ { "item_variant_id": 42, "quantity_delta": 5, "storage_place_id": 42 } ], "reason": "Комментарий", "title": "Название" } JSON, ]); $response = curl_exec($curl); var_dump(json_decode($response, true));

{ "adjustment": { "date": "2026-08-01T09:00:00Z", "id": "42", "reason": "Комментарий", "title": "Название" }, "items": [ { "amount_after": 30, "item_variant_id": "42", "quantity_delta": 5, "storage_place_id": "42" } ] }

{ "error": "document_quota_exceeded", "message": "Daily document quota of 500 documents per key is exhausted. The tenant owner has been notified by email.", "request_id": "req_cyX5W3UaT8KsYDN7GUEkdW" }