Справочник документов

Документооборот в Narmak ERP построен на унифицированной модели документов. Все операции — закупки, продажи, производство, склад, финансы — оформляются через документы единой структуры.

Архитектура документооборота

Дерево документов (MPTT)

Документы организованы в иерархическое дерево (Django MPTT):

• Каждый документ может быть основанием для других документов
• Цепочка: Заказ покупателя → Расходная накладная → Счёт-фактура
• Иерархия отображается в виде дерева связей на карточке документа

Типы документов (TypeDocPos)

Тип	Назначение	Движение склада
Заказ поставщику	Закупка у поставщика	—
Приходная накладная	Поступление на склад	↑ Приход
Заказ покупателя	Продажа покупателю	—
Расходная накладная	Отгрузка со склада	↓ Расход
Возврат поставщику	Возврат бракованного	↓ Расход
Возврат от покупателя	Возврат от клиента	↑ Приход
Перемещение	Перемещение между складами	—
Инвентаризация	Пересчёт остатков	± Корректировка
Списание	Списание материалов	↓ Расход
Счёт	Счёт на оплату	—
Счёт-фактура	НДС-документ	—
Заказ на производство	Производственное задание	—
Реестр платежей	Фиксация оплаты	—
Транспортная карта	Документ ТМС	—
Акт о браке	Фиксация дефектов	↓ Расход
План закупок	Плановая потребность	—

Структура документа

Шапка документа

Каждый документ содержит:

• Номер — автоматически генерируется
• Дата — дата документа
• Контрагент — поставщик или покупатель
• Организация — от имени нашей юридической организации
• Склад — место хранения
• Статус — текущее состояние
• Комментарий — свободное поле
• Файлы — прикреплённые документы

Позиции документа

Табличная часть документа (позиции):

• Ассортимент — товар / материал
• Количество — в базовых единицах измерения
• Цена — за единицу
• НДС — ставка и сумма
• Сумма — итого по строке
• Примечание — комментарий к позиции

Жизненный цикл документа

Статус	Описание	Изменение
Черновик	Документ создан	Можно редактировать
Подтверждён	Проверен и утверждён	Ограниченное редактирование
Проведён	Изменил остатки / финансы	Нельзя редактировать
Закрыт	Полностью завершён	Только просмотр
Отменён	Аннулирован	Только просмотр

Матрица создания документов

Некоторые документы создаются только на основании других:

Исходный документ	Создаёт
Заказ поставщику	Приходная накладная
Заказ покупателя	Расходная накладная, Счёт
Расходная накладная	Счёт-фактура
Заказ на производство	Списание материалов, Акт о браке

Подробная матрица: Матрица создания документов

Поиск по документам

Глобальный поиск

Через иконку поиска в шапке приложения (или /api/v2/g-search/):

• Поиск по номеру документа
• По контрагенту
• По сумме
• По дате

Фильтры в списке

• По типу документа
• По контрагенту
• По статусу
• По периоду (дата документа)
• По организации
• По складу

Печатные формы

Большинство документов имеют печатные формы:

• Товарная накладная (ТОРГ-12)
• Счёт на оплату
• Счёт-фактура
• УПД (Универсальный передаточный документ)
• Акт выполненных работ

Формирование: кнопка Печать на документе → выбор формы → PDF.

API документов

Endpoint	Метод	Описание
GET /api/v2/documents/	GET	Список документов
GET /api/v2/documents/{id}/	GET	Детали документа
POST /api/v2/documents/	POST	Создать документ
PATCH /api/v2/documents/{id}/	PATCH	Обновить документ
GET /api/v2/documents/{id}/positions/	GET	Позиции документа

Связанные разделы

• Матрица создания — какие документы из каких создаются
• Заказы поставщикам — детальное руководство по закупкам
• Продажи — заказы покупателей
• TMC / Склад — складские документы