20.02.2026 11:35

Add

[POST] …/v1/returnstopartneroperation/add

Создает новую операцию возврата контрагенту.

Входные параметры - массив

Метод принимает массив элементов. У каждого элемента массива должно быть одинаковое значение document_id. Каждый элемент массива имеет следующие параметры:

Название Тип данных Обязательность Описание
document_id Int64 Обязательный ID документа возврата контрагенту
item_id Int64 Обязательный ID номенклатуры
quantity Decimal Обязательный Количество номенклатуры
cost Decimal Обязательный Цена номенклатуры
order Int64 Необязательный Порядок операции (NULL = не задано, для версий БД ниже 363 игнорируется)
vat_value Decimal Необязательгый Значение ставки НДС
description String Необязательгый Примечание

Ограничения, требования и проверки

  1. Перед вызовом метода необходимо вызвать метод Lock соответствующего документа;
  2. После вызова метода необходимо вызвать метод Unlock соответствующего документа;
  3. Метод принимает массив данных.
  4. Поле order учитывается только для версий БД 363+.

Пример запроса - массив

[
    {
        "document_id": 2,
        "item_id": 2,
        "quantity": 1.1,
        "cost": 1.1,
        "order": 1,
        "vat_value": 12.1,
        "description": "example"
    }
]

Выходные параметры

Название Тип данных Описание
row_affected Int64 Количество созданных операций возврата контрагенту
ids Array of Int64 Массив id обработанных операций

Пример ответа

{
    "ok": true,
    "result": {
        "row_affected": 1,
        "ids": [
            1
        ]
    }
}

Входные параметры

Название Тип данных Обязательность Описание
request_data Object Необязательный Параметры запроса.

Пример запроса

{}

Выходные параметры

Название Тип данных Описание
result Object Результат выполнения метода.

Пример ответа

{
  "ok": true,
  "result": {}
}