Списания: расход материалов и продуктов со склада вне заказов и производства, например брак, порча или материалы на собственные нужды. Через API списания можно создавать, редактировать и удалять, менять их статус, получать список и данные списания.
Пути методов указаны относительно базового адреса API, а общие для всех методов правила (авторизация, формат запросов, частичное редактирование, строки операций, постраничная выдача) описаны в статьях Обзор API и Общие правила.
Методы
| Метод | Что делает |
|---|---|
| v1/writeoffs/add | Создает списание |
| v1/writeoffs/edit | Изменяет списание |
| v1/writeoffs/delete | Удаляет списание |
| v1/writeoffs/update_status | Меняет статус списания |
| v1/writeoffs/get_list | Возвращает список списаний |
| v1/writeoffs/get_entry | Возвращает списание со строками |
Поля списания
| Поле | Тип | Описание |
|---|---|---|
| id | int | ID списания |
| num | string | Номер |
| date | string | Дата списания, YYYY-MM-DD |
| status | int | Статус: 0 План, 1 Списано |
| production_id | int | ID производства, к которому привязано списание. 0, если не привязано |
| materials_storage_id | int | Склад, с которого списываются материалы |
| materials_storage_name | string | Название склада материалов |
| products_storage_id | int | Склад, с которого списываются продукты |
| products_storage_name | string | Название склада продуктов |
| cost | float | Себестоимость списанного по FIFO |
| amount | float | Общее количество. null, если у позиций разные единицы измерения |
| lines | int | Количество строк |
| notes | string | Заметки |
В одном списании могут быть и материалы, и продукты: материалы списываются со склада materials_storage_id, продукты со склада products_storage_id.
Статусы
| Код | Статус | Остатки |
|---|---|---|
| 0 | План | Списание только запланировано: остаток не меняется, количество учитывается в поле planned остатков |
| 1 | Списано | Материалы и продукты списаны со склада |
Новое списание создается в статусе из настройки Статус нового списания по умолчанию. Сменить статус можно методом v1/writeoffs/update_status.
Номер
Номер списания строковый и задается свободно. Если не передать его при создании, Controlata присвоит следующий по порядку: наибольший числовой номер плюс 1. Уникальность номера не проверяется.
Привязка к производству
Списание можно привязать к производству полем production_id. Тогда его себестоимость добавляется к себестоимости производства и распределяется между произведенными продуктами. Так учитывают, например, брак материалов при производстве.
- Стоимость добавляется сразу при привязке, независимо от статуса списания.
- При изменении списания стоимость производства пересчитывается, при удалении списания или передаче production_id, равного 0, вычитается.
- При удалении производства списание остается, но отвязывается от него.
Подробнее о производстве в статье Производство.