# Ejemplo base para la documentación

# ![](https://shalom-documentation.shalomcontrol.com/uploads/images/gallery/2025-12/embedded-image-xiwpgl7j.png)

#   


Módulo Procesos

10/12/2025

Versión 1.0

#   


Queda prohibido cualquier tipo de explotación y, en particular, la reproducción, distribución, comunicación pública y/o transformación, total o parcial, por cualquier medio, de este documento sin el previo consentimiento expreso y por escrito a overskull.

#### INDICE

1. **Portada**
2. **Índice**
3. **Introducción**  
    3.1 Objetivo  
    3.2 Alcance
4. **Roles y Permisos**
5. **Reglas del Sistema**  
    5.1 Asignación de Almacén Automático  
    5.2 Productos con Responsable  
    5.3 Restricción de Categorías
6. **Flujo de Solicitud**  
    6.1 Acceso al Formulario  
    6.2 Selección de Categoría  
    6.3 Adición de Ítem  
    6.4 Asignación de Responsable  
    6.5 Envío de la Solicitud
7. **Validaciones de Script**
8. **Glosario**
9. **Anexos**  
    9.1 Tablas de Configuración  
    9.2 Scripts de Servidor y Cliente  
    9.3 Manual de Usuario
10. **Estilo del Documento**

#   


# Solicitud de Materiales

## 1. Portada

Solicitud de Materiales  
Versión: 1.0 • Fecha: 2025-02-10 • Autor: Área de TI

## 2. Índice

1. Introducción
2. Roles y Permisos
3. Reglas de Sistema
4. Flujo de Solicitud
5. Validaciones de Script
6. Glosario
7. Anexos

## 3. Introducción

Objetivo:  
Definir el proceso de “Solicitud de Materiales” para garantizar que cada rol sólo acceda a sus categorías permitidas, que el almacén adecuado se asigne automáticamente y que los productos que requieran responsable incluyan el campo “Empleado receptor”.

Alcance:  
Módulo ERPNext → Doctype “Solicitud de Materiales”

## 4. Roles y Permisos

<div align="left" dir="ltr" id="bkmrk-rol-categor%C3%ADas-permi"><table><colgroup><col width="172"></col><col width="163"></col></colgroup><tbody><tr><td>Rol

</td><td>Categorías Permitidas

</td></tr><tr><td>Concesionario

</td><td>Tienda, Embalaje

</td></tr><tr><td>Administrador de Agencia

</td><td>Todas las categorías

</td></tr></tbody></table>

</div>## 5. Reglas del Sistema

1. Asignación de almacén automático

- Al elegir una categoría, el campo Almacén se llena desde la tabla “Agencia-Almacén”.
- Productos con responsable
- Si item.requiere\_responsable = true, aparece el campo Empleado receptor y es obligatorio.
- Restricción de categorías
- Se impide seleccionar categorías fuera del listado permitido para el rol actual.

## 6. Flujo de Solicitud

1. Acceso al formulario

- Menú: Logística → Solicitud de Materiales → Nuevo
- Campos obligatorios: Fecha, Categoría, Ítems
- Selección de categoría
- Elegir Embalaje → Almacén = “Lima-Centro\_Embalaje”
- Adición de ítem
- Clic en Agregar Ítem → seleccionar Caja de cartón grande (requiere responsable)
- Asignación de responsable
- Ingresar Juan Pérez en Empleado receptor
- Envío
- Clic en Enviar para Aprobación
- Mensaje: Solicitud SOL-2025-0001 enviada con éxito.

## 7. Validaciones de Script

javascript

frappe.ui.form.on('Solicitud de Materiales', {

 before\_save(frm) {

 if (!frm.doc.category) {

 frappe.msgprint('Debe seleccionar una Categoría.');

 frappe.validated = false;

 }

 frm.doc.items.forEach(item =&gt; {

 if (item.producto.requiere\_responsable &amp;&amp; !item.empleado\_receptor) {

 frappe.msgprint(`El producto ${item.producto} requiere Empleado receptor.`);

 frappe.validated = false;

 }

 });

 }

});

## 8. Glosario

- Categoría: Grupo de productos para control de acceso.
- Almacén: Ubicación vinculada a cada agencia y categoría.
- Empleado receptor: Persona designada para recibir el material.

## 9. Anexos

- Tablas de configuración: tabAgencyWarehouse
- Scripts de servidor y cliente
- Manual de usuario (link interno)

Estilo de documento

- Títulos: Arial Bold, 18 pt, #333333
- Subtítulos: Arial Bold, 14 pt, #333333
- Texto: Arial, 12 pt, #000000
- Código: Consolas, 10 pt, #333333
- Imágenes: /docs/images/ nombradas 01\_descripción.png, 800×450 px, alt=“…”

<div drawio-diagram="2457"><img src="https://shalom-documentation.shalomcontrol.com/uploads/images/drawio/2025-12/drawing-14-1767115866.png" alt=""/></div>