Ir al contenido principal

Ejemplo base para la documentación


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.



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

Rol

Categorías Permitidas

Concesionario

Tienda, Embalaje

Administrador de Agencia

Todas las categorías

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 => {

      if (item.producto.requiere_responsable && !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=“…”

 

Volver arriba