📑 Manual de Uso

1 Navegación general

Gestión MMSys es una SPA (Single Page Application). El menú lateral izquierdo agrupa los módulos por área. Al hacer clic en un ítem del menú, el contenido central cambia sin recargar la página.

Estructura del menú

El menú está organizado en secciones colapsables para mantenerlo compacto. Hacé clic en el nombre de la sección para expandir o contraer sus ítems:

• Manual de usuario: Disponible en el pie del menú lateral — abre esta documentación en una nueva pestaña.
• Vistas Kanban: Varios módulos tienen una vista alternativa en tablero Kanban que muestra solo los registros activos (sin estados terminales). Ver sección Vistas Kanban.
• Buscadores en selectores: Los selectores con muchas opciones tienen búsqueda integrada — escribí las primeras letras para filtrar.
• Toasts: Las operaciones exitosas o con error muestran un mensaje emergente breve en la esquina inferior derecha.
• Permisos: Los ítems del menú se muestran u ocultan según el rol del usuario. Si un módulo no aparece, el rol no tiene permiso módulo.ver.

2 Dashboard

Pantalla de inicio. Muestra contadores en tiempo real de los indicadores más importantes.

3 Configuración del sistema

3.1 Empresa

Cargar los datos fiscales del laboratorio: razón social, CUIT, domicilio, condición IVA, puntos de venta ARCA, datos bancarios y certificado digital para facturación electrónica.

La pantalla tiene 4 pestañas: Datos Generales, Datos Bancarios, ARCA / Certificados y Puntos de Venta.

Certificados digitales (ARCA / AFIP)

Proceso de alta del certificado en 3 pasos (se hace una vez por entorno):

1. Generar CSR: el botón Generar clave + CSR crea una clave privada RSA-2048 en el servidor y descarga el archivo .csr. No regenerar si ya hay un certificado activo — invalidaría el certificado anterior.
2. Subir a AFIP: ingresar al portal de AFIP (producción: auth.afip.gob.ar → Administración de Certificados Digitales / homologación: wsass.afip.gov.ar/wsass → Crear certificado), pegar el contenido del CSR y descargar el certificado firmado .crt.
3. Subir el certificado: usar el botón Subir Certificado (.crt) para cargar el archivo firmado por AFIP.

El estado del certificado (archivo de clave, archivo de certificado, fecha de vencimiento) se muestra en la pestaña ARCA. Verificar también el estado de los tokens TA/TT con el botón Ver tokens WSAA.

Puntos de Venta

Cada punto de venta tiene número, descripción y tipo (WebServices o Manual). Los PV usados en facturas electrónicas deben ser tipo WebServices y estar dados de alta en el portal ARCA con el mismo número.

3.2 Maestros

Tablas base usadas en todos los módulos:

• Unidades de medida — kg, g, ml, L, UN, etc.
• Líneas de producto / Áreas — agrupación de artículos y proyectos I+D (Cosmética Capilar, Corporal, Domisanitarios, etc.).
• Marcas — marcas comerciales de los productos terminados.
• Países y Provincias — para datos de clientes, proveedores y proyectos I+D.

3.3 Roles y Permisos

Cada rol tiene un conjunto de permisos granulares (módulo.acción). Ejemplos:

• produccion.ver — puede ver el módulo pero no crear
• id.crear — puede crear proyectos y fórmulas I+D
• id.aprobar — puede aprobar fórmulas I+D
• id.transferir — puede transferir fórmulas aprobadas a producción

3.4 Usuarios

Crear los usuarios del sistema. Cada usuario tiene usuario, contraseña, rol asignado y estado activo/inactivo.

4 Artículos

Catálogo unificado de todos los ítems: materias primas (MP), productos terminados (PT), envases, etiquetas, insumos de acondicionado.

Pestaña Parámetros de Calidad

Define qué parámetros se ensayan para cada artículo en el Control de Calidad (nombre, método, mín/máx, unidad, obligatorio).

Campos para facturación AFIP

Código AFIP/NCM, alícuota IVA (0%, 10.5%, 21%), unidad AFIP. Son obligatorios para emitir facturas electrónicas.

5 Proveedores

Registro de proveedores de materias primas e insumos: CUIT, razón social, dirección, condición IVA, país, provincia, contacto.

6 Órdenes de Compra

1. Clic en Nueva OC
2. Seleccionar proveedor y fecha estimada de entrega
3. Agregar ítems: artículo + cantidad + precio unitario
4. Guardar → queda en BORRADOR
5. Confirmar → pasa a CONFIRMADA y queda pendiente de recepción

7 Recepciones

1. Clic en Nueva Recepción
2. Seleccionar la OC confirmada correspondiente
3. Ingresar número de remito del proveedor
4. Por cada ítem: confirmar cantidad recibida y número de lote del proveedor
5. Guardar → se generan lotes internos en estado CUARENTENA

8 Muestras de Proveedores

Para evaluar nuevos proveedores o nuevas materias primas sin una OC previa.

1. Nueva Muestra → proveedor, artículo, cantidad, fecha de vencimiento
2. Se crea un lote en CUARENTENA igual que en una recepción normal
3. El lote puede pasar por Control de Calidad como cualquier otro

9 Control de Calidad (MP)

Flujo de 4 pasos para analizar un lote de materia prima en cuarentena.

Paso 1 — Muestreo

1. Seleccionar el lote en cuarentena a analizar
2. Elegir la especificación de calidad (define qué parámetros se van a ensayar)
3. Registrar la cantidad de muestra extraída y la unidad
4. Clic en Crear Muestra

Paso 2 — Ensayo

Ingresar número de ensayo, responsable y fecha. Clic en Registrar Ensayo.

Paso 3 — Resultados

Para cada parámetro: ingresar el valor obtenido. El sistema compara con los límites y marca CUMPLE / NO CUMPLE automáticamente.

Paso 4 — Validación

10 Stock y Lotes (MP)

Pestaña Stock

Stock consolidado por artículo: stock libre (lotes LIBERADOS), cuarentena (recibidos sin analizar), comprometido (reservado en OE activas).

Pestaña Lotes

Detalle de cada lote individual con código, artículo, proveedor, fechas de vencimiento, estado y cantidad disponible.

Ajuste de Stock

Desde Lotes → botón Ajuste en cada lote: permite registrar diferencias de inventario (mermas, rotura, reconteo).

11 Módulo I+D — Investigación y Desarrollo

El módulo I+D gestiona el ciclo completo de desarrollo de nuevos productos cosméticos y domisanitarios: desde el brief inicial hasta la transferencia de la fórmula aprobada al módulo de producción.

Permisos del módulo I+D

Flujo completo del módulo I+D

Nuevo Proyecto (BRIEF)
  └── Completar Brief técnico-comercial
        └── Cambiar estado → FORMULACION
              └── Crear Fórmula (BORRADOR)
                    ├── Agregar ingredientes INCI con concentraciones y costos
                    ├── Ensayos (Estabilidad, Eficacia, Microbiológico…)
                    ├── Evaluación Regulatoria (CE 1223, ANMAT, IFRA…)
                    └── Aprobar Fórmula (APROBADA)
                          ├── Generar documentos (Fórmula Maestra, Lista INCI…)
                          └── Transferir a Producción → Fórmula Granel creada
                                └── Proyecto → TRANSFERIDO

12 Formulación

Define las recetas que usa Producción. Hay dos tipos.

12.1 Fórmulas Granel (FP-GR)

Composición del semielaborado: artículo granel, tamaño de lote, rendimiento %, lista de MP con % y función.

12.2 Fórmulas PT (FP-PT)

Define cómo se envasa el PT: artículo PT, fórmula granel base (opcional), tamaño de lote en unidades, componentes (envase + tapa + etiqueta + insumos) con cantidad por unidad.

13 Producción

Pestaña Necesidades

Muestra artículos con pedidos activos sin stock suficiente. Columnas: Cant. Pedida, Stock Lib., En Prod., Déficit.

OE Granel (Elaboración)

OE Envasado PT

14 Clientes

Razón social, CUIT, dirección, condición IVA, contacto. El CUIT es requerido para facturas electrónicas. Los clientes registrados se pueden seleccionar al crear proyectos I+D.

15 Pedidos de Venta

16 Cotizaciones

Permite armar presupuestos detallados para servicios de maquila (difusores, velas, cremas, domisanitarios, textiles, etc.), desglosando cada componente de costo y calculando automáticamente el precio de venta con margen configurable.

Estados

Tipos de ítem

Flujo de trabajo

1. Nueva Cotización → completar cliente (del sistema o nombre libre), descripción del producto/servicio y cantidad de unidades.
2. Opcionalmente seleccionar una Plantilla de producto y presionar Cargar ítems para precargar los componentes típicos (reemplaza ítems actuales).
3. Agregar / editar ítems de costo: tipo, descripción, artículo del sistema (opcional — pre-rellena precio de costo), cantidad, unidad y precio unitario.
4. Activar el toggle Cliente provee en el ítem si el cliente aporta ese insumo (el subtotal de ese ítem se cuenta como $0).
5. Ajustar el margen de ganancia con el slider (0–300 %). El resumen lateral muestra el desglose por categoría, costo/u, precio de venta/u y totales en tiempo real.
6. Cambiar el estado y guardar. Se puede imprimir en cualquier momento con el botón Imprimir.

Plantillas de producto

Ventas → Cotizaciones → botón Plantillas. Permiten definir listas de ítems típicos por tipo de producto (Difusor, Vela, Crema, Shampoo, etc.) para agilizar la carga. Cada ítem de plantilla puede marcarse como Opcional (no siempre aplica) o Cliente (el cliente suele proveerlo).

• El sistema incluye 15 plantillas predefinidas al instalar la migración 056.
• Se pueden crear, editar y desactivar plantillas desde el ABM de Plantillas (rol ADMIN o VENTAS).
• Solo se puede eliminar una plantilla si no tiene cotizaciones asociadas.

Artículos y precio de costo

Al seleccionar un artículo del sistema en un ítem, si ese artículo tiene cargado el campo Precio de costo (pestaña Stock del ABM de Artículos), el precio unitario del ítem se pre-rellena automáticamente.

Permisos

17 Expedición

1. Nueva Expedición → seleccionar pedido (DISPONIBLE, PREPARADO o DESPACHO_PARCIAL)
2. El sistema pre-carga los ítems con cantidades pendientes
3. Seleccionar el lote PT a despachar y confirmar cantidad
4. Confirmar → estado del pedido: todo entregado → DESPACHADO; saldo pendiente → DESPACHO_PARCIAL

18 Facturación (ARCA / AFIP)

Facturas de Venta

Emitidas electrónicamente via WSFE (ARCA). Requieren empresa configurada con certificado digital, artículos con código AFIP y clientes con CUIT.

Tipos de comprobante disponibles:

Notas de Crédito y Débito

• Al seleccionar un tipo NC o ND, aparece el campo Factura Original Asociada (requerido por ARCA). Solo muestra facturas con CAE del cliente seleccionado.
• Una NC no puede superar el neto de la factura que anula. Si el neto de los ítems excede el neto original, el sistema muestra una alerta roja y deshabilita el botón Emitir hasta que se corrija.
• Percepciones IIBB en NC: solo se calculan si la NC anula totalmente la factura original (neto de la NC = neto de la factura). Para anulaciones parciales no se generan percepciones.

Facturas sin CAE — Anular

Las facturas en estado BORRADOR (sin CAE) pueden anularse directamente desde el listado usando el botón Anular que aparece en la fila. Los pedidos asociados vuelven a estado DESPACHADO.

Factura de Crédito Electrónica (FCE)

ARCA obliga FCE para ventas B2B por encima del mínimo vigente. El sistema detecta automáticamente si corresponde FCE y propone el cambio de tipo al presionar Verificar FCE. Los campos adicionales (fecha de vencimiento de pago, acepta cesión, CBU/alias) son obligatorios para FCE.

Facturas de Exportación (WSFEX)

Las ventas a clientes del exterior se emiten exclusivamente como Facturas de Exportación (módulo separado) via WSFEX. No pueden facturarse por Facturas de Venta estándar.

• Requieren datos adicionales: país destino, moneda, tipo de exportación (definitiva, servicios, etc.) y permiso de embarque cuando aplica.
• Las facturas EXPO se incluyen en el CM05 como No Computables (fila 1105 — Exportaciones) y quedan excluidas del cálculo de coeficientes provinciales.

Facturas de Compra

Registro de comprobantes de proveedores vinculados a recepciones de mercadería. Generan el asiento contable correspondiente y registran retenciones de Ganancias e IIBB si aplica.

Percepciones IIBB en Facturas de Venta

El sistema calcula automáticamente las percepciones de Ingresos Brutos (IIBB) según el padrón del cliente (ARBA, AGIP u otras jurisdicciones). La base imponible es el neto gravado y puede ajustarse manualmente por coeficiente CM.

• Los agentes de percepción se configuran en Impuestos → Percepción IIBB.
• Las percepciones se muestran en una sección separada bajo los ítems. Se pueden quitar o ajustar por fila antes de emitir.
• Para NC: solo se calculan percepciones si la NC anula totalmente la factura original (ver arriba).

18b Convenio Multilateral (CM05)

El módulo Convenio Multilateral calcula los coeficientes de distribución de Ingresos Brutos entre provincias conforme al Régimen General del Convenio Multilateral (Art. 2).

Coeficientes

Se calcula para un período (mes/año). El sistema toma:

• Ingresos: facturas de venta a clientes argentinos (excluye clientes del exterior y facturas EXPO).
• Gastos: facturas de compra del período, distribuidas por provincia del proveedor.
• Exportaciones (No Computables): facturas de exportación (WSFEX) que se informan en fila 1105 pero no integran la base de distribución provincial.

El resultado muestra una tabla de coeficientes por provincia (50% ingresos + 50% gastos) y los totales de cada columna.

Exportar CM05

El botón Exportar CM05 genera un archivo Excel con el formato oficial para presentar ante AGIP/ARBA. Incluye las filas 1000 (Ingresos), 1100 (Ventas), 1105 (Exportaciones NC), 1106 (Servicios), 2000 (Gastos) y el detalle por provincia.

Ver la sección 20b — Impuestos para la configuración de tipos impositivos y percepción IIBB.

19 Cobros y Pagos

• Pagos: pagos a proveedores vinculados a facturas de compra (transferencia, cheque, efectivo). Incluye cálculo automático de retenciones de Ganancias e IIBB según configuración del proveedor.
• Cobros: cobros de clientes vinculados a facturas de venta, con soporte de multi-moneda y cotización.
• Cheques: seguimiento de cheques propios y de terceros (emitidos, depositados, rechazados).

19b Conciliación Bancaria

Permite cotejar los movimientos del sistema contra el extracto bancario para detectar diferencias.

Flujo de trabajo

1. Seleccionar la cuenta bancaria y el período (desde/hasta).
2. Seleccionar un extracto bancario existente o subir un nuevo PDF de extracto (se parsea automáticamente).
3. Presionar Conciliar: el sistema cruza los movimientos del libro contra el extracto y muestra:
   • Conciliados: movimientos que coinciden en importe y fecha.
   • Solo en libro: movimientos registrados en el sistema pero que no aparecen en el banco.
   • Solo en extracto: movimientos del banco no registrados en el sistema.

20 Contabilidad

• Plan de Cuentas: árbol jerárquico de cuentas (1.1.1.01 — Activo, Pasivo, Patrimonio, Ingreso, Egreso).
• Ejercicios: períodos anuales. Debe haber un ejercicio ABIERTO para registrar asientos.
• Libro Diario: asientos manuales con débito y crédito que deben balancear. Pagos, cobros y facturas generan asientos automáticos.
• Ajustes Contables: asientos de ajuste por inflación y correcciones manuales.
• Tipos de Cambio: cotizaciones manuales o automáticas (BCRA) para conversión USD → ARS. Se usa el tipo vendedor (venta) para operaciones.
• Medios de Pago: configuración de cuentas bancarias, cajas y tarjetas usados en pagos y cobros.

20b Impuestos

El módulo Impuestos centraliza la configuración de todos los impuestos que aplica la empresa como agente de retención o percepción.

Tipos de impuesto

Cada impuesto tiene un código único, nombre, tipo, aplicación (VENTAS / COMPRAS / AMBOS) y estado activo/inactivo. Solo los impuestos activos aparecen disponibles en las operaciones.

Módulo Percepción IIBB

Gestión completa de la actuación como agente de percepción de Ingresos Brutos:

• Configuración por jurisdicción: alícuota general y umbral mínimo para cada provincia donde la empresa es agente.
• Padrón de clientes: alícuotas individuales por cliente importadas desde ARBA (sincronización automática via web service) o AGIP (importación de archivo TXT). Las alícuotas del padrón tienen prioridad sobre la alícuota general.
• Padrón de proveedores (retenciones): igual lógica para retenciones IIBB en compras.
• Coeficiente CM: factor de ajuste para clientes que tributan por Convenio Multilateral; se aplica sobre la base imponible antes de calcular el importe.

20c Exportaciones Impositivas

El menú Expo Impositivas agrupa los módulos de generación de archivos para presentaciones ante ARCA (AFIP) y AGIP.

AGIP — Agente Percepción/Retención IIBB (ARCIBA)

Genera el archivo ARCIBA de formato fijo para informar percepciones de IIBB en ventas (AGIP Buenos Aires). Seleccionar el período (desde/hasta) y presionar Previsualizar; luego Descargar TXT para obtener el archivo a importar en el aplicativo AGIP.

Libro IVA Digital (RG 3685)

Ver sección 20d — Libro IVA Digital.

SICORE (Percepciones IVA y Retenciones Ganancias)

Ver sección 20e — SICORE.

20d Libro IVA Digital (RG 3685)

Genera los 6 archivos de texto de ancho fijo requeridos por ARCA (AFIP) para la presentación del Libro IVA Digital según RG 3685.

Archivos generados

Uso

1. Seleccionar el período (Desde / Hasta).
2. Presionar Previsualizar para ver el conteo de registros por archivo.
3. Descargar cada archivo con el botón Descargar TXT correspondiente.
4. Importar los archivos en el aplicativo IVA — Módulo de Importación de ARCA.

20e SICORE — Percepciones IVA y Retenciones Ganancias

Genera los archivos de texto de ancho fijo (145 posiciones) para importar en el aplicativo SICORE ARCA (Versión 9.0 Estándar).

Archivos generados

Uso

1. Seleccionar el período (Desde / Hasta).
2. Presionar Previsualizar para ver la cantidad de registros por tipo.
3. Descargar cada archivo con el botón Descargar TXT.
4. En SICORE ARCA: ir a Importar datos → Desde archivo de texto e importar el archivo correspondiente.

21 Administración del sistema

• Auditoría: registro de todos los cambios (quién, qué, cuándo, IP).
• Lista de Precios: precios de venta por artículo y condición, aplicados automáticamente en pedidos.
• Vendedores: registro de vendedores para asignación en pedidos y cálculo de comisiones.

Vistas Kanban

Las vistas Kanban muestran los registros activos agrupados por estado en columnas. Los estados terminales (cerrado, despachado, aprobado, cancelado) quedan excluidos para evitar que el tablero se sature con historial.

Cada Kanban incluye un buscador y un botón Vista Lista para volver a la pantalla tabular completa.

Flujos principales resumidos

Flujo de Materia Prima

OC → Recepción → Lote CUARENTENA
  → Control de Calidad (4 pasos) → Lote LIBERADO
    → Disponible para Producción / Fórmulas I+D

Flujo I+D completo

Proyecto (BRIEF) → Brief → Fórmula (BORRADOR)
  → Ensayos → Regulatorio → Aprobar (APROBADA)
    → Documentos → Transferir → Fórmula Granel en Producción
      → Proyecto TRANSFERIDO

Flujo de Producción Granel

Necesidades → Nueva OE-GR → Iniciar (consume MP)
  → Completar → Lote Granel CUARENTENA
    → Control de Calidad → LIBERADO → Disponible para envasar

Flujo de Producción PT (desde pedido)

Pedido (INGRESADO) → Generar Producción → OE-PT (EN_PRODUCCION)
  → Completar → Lote PT CUARENTENA → Liberar → LIBERADO
    → Pedido pasa a DISPONIBLE automáticamente
      → Expedición → DESPACHADO → Factura → Cobro

Preguntas frecuentes

¿Por qué no puedo aprobar una fórmula I+D?

Solo se pueden aprobar fórmulas en estado BORRADOR o EN_REVISION. Verificar el permiso id.aprobar en el rol del usuario.

¿Por qué los campos cliente/marca/área aparecen vacíos en un proyecto viejo?

Los proyectos creados antes de la actualización de abril 2026 tienen estos campos como texto libre. Al editar el proyecto, seleccionar los valores correctos en los selectores y guardar.

¿Puedo tener un proyecto con múltiples países destino?

Sí. En el formulario del proyecto, el selector de Países Destino permite seleccionar varios países manteniendo presionada la tecla Ctrl (Windows) o Cmd (Mac) al hacer clic.

¿Cómo aparece el nombre INCI de un artículo en la fórmula automáticamente?

Completar el campo Nombre INCI en la ficha del artículo (módulo Artículos). Al agregar ese artículo a una fórmula I+D, el nombre INCI se pre-completa automáticamente.

¿Por qué el total de la Lista INCI no es 100%?

La norma INCI ordena los ingredientes de mayor a menor concentración, pero no requiere que las concentraciones sumen exactamente 100% en la etiqueta. Los ingredientes presentes en concentración < 1% pueden listarse en cualquier orden al final.

¿Por qué el pedido no pasa a DISPONIBLE automáticamente?

El sistema lo hace cuando se liberan los lotes PT vinculados y cubren toda la cantidad pendiente. Verificar en Producción → Lotes PT que los lotes estén en estado LIBERADO.

¿Por qué no puedo crear una factura electrónica?

Verificar: (1) empresa con certificado digital activo, (2) entorno correcto (homologación vs producción), (3) artículos con código AFIP y alícuota IVA, (4) cliente con CUIT cargado.

¿Por qué el cambio de estado de un proyecto no funciona?

El servidor debe estar actualizado a la versión de abril 2026 que corrige el procesamiento del estado en el endpoint PATCH. Si el error persiste, verificar los permisos del usuario: se requiere id.editar para cambiar el estado de un proyecto.