Документ "Возврат образцов"

Назначение

Документ "Возврат образцов" предназначен для фиксации процесса возврата образцов товаров из офиса обратно на склад. Данный документ используется в контексте работы АРМ ОТК и обеспечивает контроль перемещения образцов, которые ранее были отправлены в офис для демонстрации клиентам, партнерам или руководству компании.

Основные цели документа:

• Документирование факта возврата образцов из офиса на склад
• Учет возвращаемого количества товаров
• Контроль целостности и состояния возвращаемых образцов
• Фиксация ответственных лиц
• Обеспечение полного прослеживания цикла движения образцов

Место в системе

Документ "Возврат образцов" входит в систему документооборота складского учета и контроля качества товаров. Он связан со следующими документами и процессами:

• Создается на основании документа "Перемещение" (тип OFFICE), которым образцы были изначально направлены в офис
• Связан с контейнером OFFICE, из которого возвращаются образцы
• Может быть источником для создания документа "Списание" (если часть образцов не подлежит возврату)
• Интегрирован в процесс работы АРМ ОТК

Статусы документа

Статус	Описание
Создан	Документ создан, но не проведен. Информация о возврате образцов зафиксирована, но образцы фактически еще не приняты на склад
Выполнен	Документ проведен. Образцы приняты на склад, информация о них удалена из контейнера OFFICE
Отменен	Документ отменен. Возврат образцов не состоялся или был оформлен ошибочно

Атрибуты

Основные атрибуты

Атрибут	Тип	Обязательный	Описание
Номер документа	Строка	Да	Уникальный идентификатор документа в системе
Дата создания	Дата/время	Да	Дата и время создания документа
Статус	Перечисление	Да	Текущий статус документа
Документ-основание	Строка	Да	Ссылка на документ "Перемещение", по которому образцы были отправлены в офис
Сотрудник офиса	Строка	Да	ФИО сотрудника, возвращающего образцы
Оператор ОТК	Строка	Да	ФИО оператора ОТК, принимающего образцы
Дата возврата	Дата/время	Да	Фактическая дата и время возврата образцов
Примечание	Строка	Нет	Дополнительная информация о возврате

Табличная часть "Возвращаемые образцы"

Атрибут	Тип	Обязательный	Описание
Номенклатура	Строка	Да	Идентификатор товара
Наименование	Строка	Да	Название товара
Партия	Строка	Да	Идентификатор партии
Количество изначальное	Число	Да	Количество, первоначально отправленное в офис
Количество возвращаемое	Число	Да	Количество, фактически возвращаемое на склад
Единица измерения	Строка	Да	Единица измерения
Состояние	Перечисление	Да	Состояние образца (Без изменений/Частично поврежден/Не подлежит возврату)
Причина списания	Строка	Нет	Причина списания (если образец не возвращается или возвращается частично)

Создание документа

Условия создания

Документ "Возврат образцов" создается при следующих условиях:

1. Сотрудник офиса решает вернуть образцы на склад
2. В системе существует документ "Перемещение", по которому образцы были отправлены в офис
3. В контейнере OFFICE есть образцы, соответствующие этому документу "Перемещение"

Способы создания

Документ может быть создан следующими способами:

1. Автоматически - при сканировании QR-кода документа ТОРГ-13 офис в АРМ ОТК
2. Вручную - оператором ОТК через интерфейс АРМ ОТК при физическом получении образцов от сотрудника офиса
3. Из контейнера OFFICE - через интерфейс управления содержимым контейнера путем выбора образцов для возврата

Жизненный цикл

Создание

1. Сотрудник офиса информирует о намерении вернуть образцы
2. Оператор ОТК создает документ "Возврат образцов"
3. Документ получает статус "Создан"
4. Заполняется табличная часть с перечнем возвращаемых образцов
5. Для каждого образца указывается возвращаемое количество и состояние

Проведение

1. Оператор ОТК физически принимает образцы от сотрудника офиса
2. Проверяет соответствие фактически возвращаемых образцов данным в документе
3. При необходимости корректирует информацию в документе
4. Проводит документ, меняя его статус на "Выполнен"
5. Система автоматически:
   • Удаляет возвращенные образцы из контейнера OFFICE
   • Создает документ "Списание" для образцов, которые не возвращаются или возвращаются частично
   • Обновляет статус соответствующих записей в исходном документе "Перемещение"

Отмена

1. Если документ был создан ошибочно или возврат не состоялся
2. Оператор ОТК отменяет документ, меняя его статус на "Отменен"
3. Система возвращает образцы в контейнер OFFICE в их первоначальное состояние
4. Отменяются все связанные операции (например, создание документа "Списание")

Редактирование и отмена

Возможность редактирования

• В статусе "Создан": доступно полное редактирование всех полей документа
• В статусе "Выполнен": редактирование невозможно, доступна только отмена документа
• В статусе "Отменен": редактирование невозможно

Ограничения на отмену

• Отмена документа со статусом "Выполнен" возможна в течение 24 часов после проведения
• Отмена документа невозможна, если связанный документ "Списание" уже проведен
• Для отмены документа требуются права пользователя с ролью "Супервизор" или выше

Связанные печатные формы

При работе с документом "Возврат образцов" могут формироваться следующие печатные формы:

1. Акт возврата образцов - документ, подтверждающий факт возврата образцов на склад
2. Акт списания образцов - документ, фиксирующий списание невозвращенных или поврежденных образцов

Особенности и ограничения

1. Частичный возврат - документ поддерживает возможность частичного возврата образцов (например, если часть образцов была передана клиенту или повреждена)
2. Автоматическое списание - для невозвращенных образцов система автоматически создает документ "Списание"
3. Контроль сроков - система отслеживает сроки возврата образцов и отправляет уведомления при их нарушении
4. Требование подтверждения - проведение документа требует физического наличия образцов и их проверки оператором ОТК
5. Ограничение доступа - работа с документом доступна только пользователям с ролями "Оператор ОТК" и "Супервизор"

Примеры

Пример документа "Возврат образцов" в статусе "Создан"

{
  "documentNumber": "RET-2024-05-001",
  "creationDate": "2024-05-17T14:25:30",
  "status": "Создан",
  "baseDocument": "MOV-2024-05-022",
  "officeEmployee": "Иванов Сергей Павлович",
  "qcOperator": "Смирнова Анна Викторовна",
  "returnDate": "2024-05-17T14:25:30",
  "comment": "Возврат после демонстрации клиенту",
  "items": [
    {
      "sku": "12345",
      "name": "Масло подсолнечное 'Золотая капля'",
      "batch": "B001",
      "initialQuantity": 2,
      "returnQuantity": 1,
      "unit": "шт",
      "condition": "Без изменений",
      "writeOffReason": "Передано клиенту в качестве образца"
    },
    {
      "sku": "67890",
      "name": "Мука пшеничная высший сорт",
      "batch": "B003",
      "initialQuantity": 1,
      "returnQuantity": 1,
      "unit": "кг",
      "condition": "Без изменений",
      "writeOffReason": null
    }
  ]
}

Пример документа "Возврат образцов" в статусе "Выполнен"

{
  "documentNumber": "RET-2024-05-001",
  "creationDate": "2024-05-17T14:25:30",
  "status": "Выполнен",
  "baseDocument": "MOV-2024-05-022",
  "officeEmployee": "Иванов Сергей Павлович",
  "qcOperator": "Смирнова Анна Викторовна",
  "returnDate": "2024-05-17T14:40:15",
  "comment": "Возврат после демонстрации клиенту",
  "items": [
    {
      "sku": "12345",
      "name": "Масло подсолнечное 'Золотая капля'",
      "batch": "B001",
      "initialQuantity": 2,
      "returnQuantity": 1,
      "unit": "шт",
      "condition": "Без изменений",
      "writeOffReason": "Передано клиенту в качестве образца"
    },
    {
      "sku": "67890",
      "name": "Мука пшеничная высший сорт",
      "batch": "B003",
      "initialQuantity": 1,
      "returnQuantity": 1,
      "unit": "кг",
      "condition": "Без изменений",
      "writeOffReason": null
    }
  ],
  "completionInfo": {
    "completionDate": "2024-05-17T14:40:15",
    "completedBy": "Смирнова Анна Викторовна",
    "relatedWriteOffDocument": "WO-2024-05-010"
  }
}

API для работы с документом

Получение списка документов "Возврат образцов"

GET /api/v1/documents/sample-returns

Получение документа по номеру

GET /api/v1/documents/sample-returns/{documentNumber}

Создание документа

POST /api/v1/documents/sample-returns

Обновление документа

PUT /api/v1/documents/sample-returns/{documentNumber}

Проведение документа

POST /api/v1/documents/sample-returns/{documentNumber}/complete

Отмена документа

POST /api/v1/documents/sample-returns/{documentNumber}/cancel

Получение документа по связанному документу "Перемещение"

GET /api/v1/documents/sample-returns/by-movement/{movementDocumentNumber}

Связанные сущности и документы

• Документ "Перемещение"
• Документ "Списание"
• Контейнер OFFICE
• АРМ ОТК
• ТОРГ-13 офис

История изменений документации

Версия	Дата	Описание изменений
1.0	2024-05-17	Первоначальная версия документации