Создает списание материалов и продуктов со склада.
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 | Неверный формат даты |