Максим

Максим

Обновлено Nov 3, 2026

Создает списание материалов и продуктов со склада.

v1/writeoffs/add.php

Параметры

Поле Тип Обязательное Описание
num string Да Номер
materials array materials или products Списываемые материалы: id или sku и amount
products array materials или products Списываемые продукты: id или sku и amount
date string Нет Дата списания, YYYY-MM-DD. По умолчанию сегодня
materials_storage_id int Нет Склад, с которого списываются материалы. По умолчанию склад для списаний из настроек компании
products_storage_id int Нет Склад, с которого списываются продукты. По умолчанию склад для списаний из настроек компании
notes string Нет Заметки

Строка materials и products:

Поле Тип Обязательное Описание
id int id или sku ID материала или продукта
sku string id или sku Артикул
amount float Да Количество, больше 0
notes string Нет Комментарий к строке

Материал или продукт указывается по id или sku. Нужна хотя бы одна строка в одном из массивов.

Новое списание создается в статусе из настройки Статус нового списания по умолчанию.

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

{
    "num": "48",
    "date": "2026-10-06",
    "materials": [
        {
            "id": 2051,
            "amount": 0.15,
            "notes": "Брак: трещина"
        }
    ],
    "products": [
        {
            "sku": "P-TABLE-01",
            "amount": 1
        }
    ],
    "materials_storage_id": 3998,
    "products_storage_id": 4001,
    "notes": "Брак при распиле"
}

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

{
    "success": true,
    "writeoff_id": 19291,
    "num": "48",
    "status": 1
}

В ответе приходят ID, номер и код статуса нового списания.

Ошибки

Ошибка Причина
No num in input Не передан num или он пустой
No products or materials in input Не передано ни одной строки
Materials is not an array materials не массив (так же для products)
Line 0 of materials must be an object Строка не объект (вместо 0 будет номер строки)
SKU or id not set for material 0 В строке нет ни id, ни sku
Material with id 2051 not found Материал не найден или удален (для продукта: Product with SKU "P-TABLE-01" not found)
Amount must be greater than 0 for material with id 2051 Количество не число или не больше 0 после округления
Invalid notes value for material with id 2051. Must be a string notes в строке не строка
Notes for material with id 2051 are too long: maximum 10000 characters Комментарий строки длиннее 10 000 символов
Storage ID not found Склад не найден или удален
Date is not a valid date in format YYYY-MM-DD Неверный формат даты