Cómo usar este manual

Este manual describe cómo se usa el Gestor de Stock de Moyco SRL, módulo por módulo, y qué pasa con los datos por detrás de cada acción. Está pensado para dos perfiles a la vez: el operador que necesita el paso a paso, y gerencia/soporte que necesita entender el flujo de información.

Acceso al sistema

El sistema se abre en el navegador. La pantalla de ingreso pide usuario y contraseña. El usuario puede escribirse solo (por ejemplo hernan) y el sistema completa el resto del correo automáticamente.

Según el rol del usuario, el menú lateral muestra más o menos módulos:

La pantalla principal

Una vez dentro, la barra lateral izquierda agrupa los módulos por área (Comercial, Operaciones, Logística, Administración). Arriba a la derecha está el selector Azúcar / División Polvos (cambia todo el sistema al otro negocio), el botón Actualizar (refresca datos cacheados) y Salir.

Inicio (Tablero)

Inicio es la pantalla de aterrizaje (también el ícono «Inicio» de la barra lateral). Es un tablero de indicadores (KPIs) de solo lectura: no se cargan datos acá; se consultan y se navega. Cada tarjeta es además un acceso directo al módulo relacionado. Roles 1, 2, 3 y 5 (el rol 4 es redirigido automáticamente a «Mi Stock»).

Fila 1 — KPIs operativos

Fila 2 — Stock, proyección y RRHH

Stock Contable

Bolsas por tipo (Consignación / Propia / AZEF) y total, más un acceso a compras/recepciones pendientes (abrirModalComprasPendientes) para ver qué está por ingresar.

Proyección de Demanda (15 días)

Gráfico de stock proyectado vs. demanda en firme de los próximos 15 días. Botones para alternar la base de cálculo: Consignación, Propia u Otros. Muestra además la demanda sin fecha definida (pedidos sin fecha de entrega, que no entran en la curva diaria pero sí en el total). Se calcula cruzando movimientos con pedidosVenta y sus órdenes de carga.

RRHH Hoy

Resumen de asistencia del día. Si hay alertas de RRHH de hoy/ayer aparece un botón rojo que abre el modal de alertas de RRHH.

Fila 3 — Tendencias

• Evolución de Producción: gráfico histórico de producción (con selector de desglose).
• Tendencia Eficiencia: eficiencia de los últimos partes.

Flujo de datos

El tablero es 100% lectura. Fuentes: dashboard_kpis (KPIs materializados), movimientos, pedidosVenta, ordenesCarga, compras_azucar, stock_balance / stock_snapshots, partesDiarios y datos de RRHH (rrhh_asistencia_consolidada, avisos_rrhh, alertas_rrhh). Ningún número se edita acá: todos son consecuencia de lo que se carga en los demás módulos.

Pedidos & Ventas

El módulo Pedidos & Ventas cubre todo el circuito comercial del azúcar: carga del pedido (manual o importado), preparación logística, despacho con baja de stock, cierre y devoluciones. Es uno de los módulos más densos del sistema; este capítulo cubre cada acción y cada escenario.

Acceso, roles y navegación interna

Se entra desde la barra lateral, área Comercial. El módulo cambia de nombre y de solapas según el rol:

La barra lateral propia del módulo (izquierda) tiene los botones de cada solapa, más «Actualizar Datos» (refresca catálogos cacheados) y «Salir del Módulo» (vuelve al Inicio). Si un rol logístico intenta entrar a «Nuevo», el sistema lo redirige automáticamente a «Pendientes».

Ciclo de vida y estados de un pedido

Cada pedido es un documento en pedidosVenta con un campo estado. Entender los estados explica todo el módulo:

Solapa «Nuevo Pedido» (carga manual)

El formulario tiene tres secciones y un acordeón opcional de logística.

Modos: Nuevo, Editar y Copiar

El mismo formulario funciona en tres modos, según cómo se llegue:

• Nuevo (badge «Borrador Inicial»): genera un pedido nuevo con número correlativo PV000001.
• Editar (desde Pendientes → «Editar»): pide confirmación, reusa el documento; no genera número nuevo y recalcula el saldo pendiente respetando lo ya entregado.
• Copiar (desde Pendientes → «Copiar»): precarga los datos de un pedido previo como base para uno nuevo.

Sección 1 y 2 — Cliente, destino y referencia

1. Cliente (buscador inteligente): se escribe nombre de fantasía o razón social. Al elegirlo se cargan sus sucursales y se autocompleta el Ejecutivo de Ventas (no editable).
2. Fecha de Documento: por defecto hoy.
3. Sucursal / Destino: el selector se habilita recién al elegir cliente; al elegir sucursal se autocompletan Provincia y Localidad (solo lectura).
4. Orden de Compra Cliente: campo fiscal en dos partes — 5 dígitos + 8 dígitos (formato NNNNN-NNNNNNNN). Es la referencia del cliente; opcional.
5. Plazo Pago (en días): obligatorio (marcado con asterisco).

Acordeón «Pre-Asignación de Logística» (opcional)

Permite programar el despacho desde la carga del pedido. Campos: Fecha de Carga, Fecha y Hora de Descarga, Turno/Cupo N°, Transporte y Chofer (buscadores inteligentes). Si se completa al menos uno, el pedido guarda un bloque logistica con tarifaPendiente: true (la tarifa exacta se define después, en Pendientes). Si se deja vacío, logística lo completa más adelante.

Sección 3 — Mercadería (multi-ítem)

Un pedido puede tener varios artículos. Por cada renglón:

1. Se busca el Artículo (buscador inteligente sobre el panel oscuro).
2. Se cargan Cantidad (kg), Precio Unitario y, opcionalmente, Descuento ($).
3. Palletizado (por ítem, opcional): radio Sí/No. Si es «Sí», se elige formato 1000 kg, 1200 kg u «Otro» (campo libre). El formato queda guardado en ese ítem puntual.
4. «Agregar» suma el renglón a la tabla. Se repite por cada artículo. Los totales (subtotal, IVA 21%, total) se recalculan automáticamente con cada alta o baja de renglón.
5. Cada renglón de la tabla se puede quitar individualmente.

Artículo genérico (bolsa 50 kg sin marca)

En las bolsas de 50 kg, al tomar el pedido casi nunca se sabe qué marca se va a cargar (depende del stock y la conveniencia de carga del día). Para no forzar una marca falsa, existe un artículo genérico («AZÚCAR BOLSA 50KG (GENÉRICO)»):

• Se elige como cualquier otro artículo en el renglón de mercadería. El renglón muestra el badge Genérico · marca a definir.
• El genérico solo vive en el pedido y en la cotización previa. No tiene stock propio y está bloqueado en movimientos, pases, cesiones y compras.
• La marca real se elige obligatoriamente al generar la Orden de Carga (ver «Generar orden de carga»). Hasta ese momento el pedido queda legítimamente «sin marca».

Solapa «Importar OC» (desde Excel del cliente)

Carga órdenes de compra que llegan en Excel desde sistemas de clientes. Soporta varios formatos (Krikos / Planexware, La Anónima, Dorinka, etc.), detectando las columnas automáticamente.

1. Soltar archivos en la zona de arrastre, o seleccionarlos (acepta varios .xls/.xlsx a la vez). Si se suelta otro tipo de archivo, lo rechaza con aviso.
2. Procesar la cola. El sistema lee cada planilla y resuelve entidades:
   • Cliente y sucursal por GLN (13 dígitos). Si no encuentra por GLN, intenta por nombre del comprador; si falla, queda para asignar manualmente.
   • Artículos por EAN (8–14 dígitos). Si el formato no trae EAN (ej. La Anónima), usa Código de Proveedor o descripción como respaldo.
3. Cada OC queda en la bandeja con un estado: Pendiente revisión, Incompleto (faltó resolver algo), Confirmado o Rechazado.
4. Ver detalle: muestra exactamente qué interpretó (cliente, sucursal, renglones, cantidades) para revisar antes de confirmar.
5. Confirmar: convierte la OC en un pedido real.
6. Rechazar: pide un motivo y descarta la OC.

Solapa «Pendientes» (bandeja de logística)

Lista los pedidos AUTORIZADO. Tiene filtros (cliente, tipo de azúcar) y filtros inteligentes, ordena por fecha de carga/descarga, y permite exportar. Acciones disponibles por pedido:

Generar orden de carga (el corazón del módulo)

1. Se abre el Generador, se elige el cliente y se tildan los renglones a despachar. La cantidad se ingresa en bultos; el sistema la convierte a kg con el factor del artículo.
2. Se completan los datos del viaje: Fecha de Carga (obligatoria), fecha/hora de descarga, turno, Transporte (obligatorio), Chofer (obligatorio), patente tractor/acoplado, observaciones y Tarifa.
3. Al confirmar, el sistema pide el correlativo NP-00000001 y, en una transacción atómica (batch), procesa cada pedido seleccionado en uno de dos escenarios:
   • Escenario A — Despacho total (se despacha ≥ el saldo, tolerancia 0,5 kg): el pedido pasa a EN_CARGA con su numeroOrdenCarga y el bloque de logística.
   • Escenario B — Despacho parcial (split): el pedido original conserva el saldo restante y vuelve recalculado; se crea un pedido hijo (con padreId) que representa exactamente lo que va en este camión, en estado EN_CARGA.
4. Al terminar, notifica al chofer por WhatsApp el nuevo viaje y redirige a En Carga.

Resto de acciones de Pendientes

Solapa «En Carga» (despacho)

Lista las órdenes de carga (ordenesCarga) con pedidos en EN_CARGA. Acciones:

Despachar (la baja de stock real)

Desde En Carga, el botón «Despachar» sobre una orden lleva al formulario «Confirmar Despacho» (es el módulo Nuevo Movimiento en modo despacho). El sistema precarga todo desde la orden y, antes de mostrar el formulario, exige dos decisiones en cadena: Tipo de Azúcar y origen de los datos (Flexxus o manual).

Paso 0 — Selección de Tipo de Azúcar (obligatorio)

Apenas se toca «Despachar» aparece el modal «Tipo de Azúcar» («Indique el origen del stock afectado»). En el despacho hay tres opciones (no cuatro: la pantalla de despacho no ofrece «Orgánica» — ver la nota más abajo). La elección determina de qué stock se descuenta y qué controles se aplican después:

El botón «Cancelar» aborta todo el despacho y regresa a Ventas (no se descuenta nada). Cancelar acá es seguro: no deja basura.

Sub-paso Consignación — Imputar OCAs (obligatorio si elegiste Consignación)

Si la venta es en consignación hay que decir de qué OCA (de qué comitente) sale cada bolsa. El modal muestra arriba el Total a imputar (bolsas y kg del despacho) y, debajo, una tarjeta por cada compra de consignación con saldo disponible:

1. Cada tarjeta muestra el comitente, la OCA (o «Pendiente OCA» si todavía no tiene número) y el saldo en bolsas y kg. Las OCAs sin saldo no aparecen.
2. Se escribe, en cada OCA, cuántas bolsas imputar (tope = el saldo de esa OCA).
3. Una barra de progreso abajo muestra «Imputado X / Total — Faltante Y». El botón «Confirmar» se habilita solo cuando el faltante es 0 (lo imputado tiene que ser exactamente el total del despacho).
4. Si hace falta despachar más de lo que hay en saldo (venta «en descubierto»), el botón «Cargar negativo» abre un mini-modal: se elige el comitente (buscador) y las bolsas en descubierto; eso queda como una imputación negativa que también suma al total.
5. «Confirmar» cierra el modal y recién ahí sigue el Paso 0.5. «Volver» regresa al selector de Tipo de Azúcar.

Paso 0.5 — ¿De dónde vienen los datos? Flexxus o Manual

Después del tipo (y de la imputación/lote si correspondía) aparece el modal «¿De dónde vienen los datos?». Mientras se abre, el sistema hace un chequeo de salud del Bridge Flexxus en segundo plano y pinta el estado del botón «Vincular venta de Flexxus»:

• Vincular venta de Flexxus: abre el cruce contra la factura del ERP (ver abajo). Es el camino recomendado siempre que el Bridge esté disponible.
• Carga manual: sigue al formulario sin Flexxus (igual que siempre). Se usa cuando el Bridge está caído o la venta no está facturada todavía. Se puede vincular después (posthoc).
• ← Volver al listado: cancela el despacho.

Cruce Flexxus (1/2) — Elegir la factura

Si elegiste «Vincular Flexxus» se abre la lista de facturas recientes de Flexxus, ya filtrada por el CUIT del cliente de la orden:

1. Rango de fechas: botones 3 / 7 / 30 días (default 3). Si no aparece la factura, se amplía el rango.
2. Sugerencia por chofer: si el transporte de una factura Flexxus coincide con el chofer del despacho, esa fila se resalta en verde con una ★ y un cartel «Sugerimos FA-… — el transporte coincide con el chofer del despacho». Es solo una ayuda, no obliga.
3. Cada fila muestra comprobante, fecha, cliente, transporte (Flexxus) y total c/IVA, con dos botones:
   • 👁 Ver: abre el detalle en solo lectura (inspeccionar sin vincular).
   • Vincular →: abre el detalle con el botón de confirmar (el que realmente ata la factura).
4. ← Seguir con carga manual: descarta Flexxus y va al formulario manual.

Cruce Flexxus (2/2) — Los 4 controles cruzados

Al elegir una factura, el sistema trae su detalle de Flexxus y arma el cruce N×M (varias líneas GS contra varias líneas Flexxus, agrupando por artículo). Arriba se ve la cabecera de la factura (comprobante, fecha, cliente + CUIT, total c/IVA, transporte y remitos vinculados) y luego cuatro controles:

La tabla de líneas (Controles 2+3) muestra, por cada línea Flexxus: código Flexxus, descripción, cantidad Flex, kg Flex, kg GS, Δ kg, $ Flex/kg, $ GS/kg, Δ $ y a qué artículo GS matcheó. El match se hace por los códigos Flexxus cargados en el artículo (ABM → Artículos → Códigos Flexxus). El precio Flexxus se normaliza dividiendo por kg por unidad (ej. un artículo de 500g facturado a $435/unidad = $870/kg).

Al «Confirmar y cargar», el sistema:

1. Autocompleta y bloquea los campos Factura (punto de venta 5 dígitos + número 8 dígitos) en el formulario; quedan en ámbar, de solo lectura, con el aviso «Cargado desde Flexxus». Para cambiarlos hay que cancelar el despacho y volver a vincular.
2. Si la factura tiene un único remito vinculado, también autocompleta y bloquea los campos de Remito.
3. Guarda en memoria un snapshot completo de la factura + el resultado de los 4 controles, que se grabará junto al movimiento.

El formulario «Confirmar Despacho» precargado

El formulario llega con casi todo cargado y bloqueado para evitar errores:

• Título «Confirmar Despacho: NP-…» y banner índigo «MODO DESPACHO ACTIVO».
• Fecha = hoy (el día real del despacho). Servicio = «salida», bloqueado.
• Propietario = MOYCO (el sistema busca el ID real, incluso en la nube si hace falta), bloqueado. Cliente = el de la orden, bloqueado.
• Provincia/Localidad sincronizadas desde el cliente. Cantidad fiel al pedido (no editable desde Mov Web).
• Tarifa = la pactada en la logística de la orden (modo manual para que no se recalcule). Pallets de egreso sugeridos (≈ total kg / 1400, redondeado para arriba).
• Factura/Remito: bloqueados y en ámbar si se vinculó Flexxus; editables si fue manual.

Se verifican las cantidades finales y se confirma. Aparece el modal de confirmación con el resumen (tipo de azúcar, artículos, cantidades, servicio SALIDA) para una última revisión.

1. Al confirmar, en una transacción atómica se crea el/los movimiento(s) de egreso (tipo VENTA, remitoConformado:false), con el tipoAzucar, las imputaciones[] de consignación (prorrateadas por camión si hay varios ítems) y el flexxusFactura si se vinculó.
2. El stock lo baja el servidor (un proceso recalcula los stock_snapshots): el formulario nunca escribe el stock a mano.
3. El pedido pasa a CUMPLIDO y la orden se cierra.

Vincular Flexxus después (posthoc)

Si el despacho se hizo manual (Bridge caído, o la factura todavía no estaba emitida), la factura se puede asociar más tarde desde el listado de Movimientos: el flujo es idéntico (salud del Bridge → facturas → detalle → los 4 controles → confirmar), reconstruyendo el contexto N×M a partir de los movimientos «hermanos» del mismo viaje. El detalle completo está en el capítulo «Integración Flexxus (Bridge)».

Escenarios frecuentes (y qué hacer)

Editar logística, ajustar, imprimir, anular y forzar

Solapa «Cumplidos» (historial y devoluciones)

Historial de pedidos cerrados, con filtros, detalle por pedido y exportación a Excel.

Devolución de cliente (proceso completo)

Dónde está el botón y quién puede

La devolución se inicia desde la solapa «Cumplidos». En la fila de un pedido cerrado aparece el botón ↩️ («Registrar devolución del cliente»), pero solo si se cumplen las dos condiciones:

• El pedido tiene movimientos de stock vinculados (hubo despacho real: historialCargas no vacío). Un pedido cerrado por «Anular saldo» o «Forzar cierre» no muestra el botón porque nunca salió mercadería.
• El rol puede devolver (Gerente / Comercial y los roles logísticos habilitados). Un rol de solo consulta no ve el botón.

El proceso, paso a paso

1. Se toca ↩️ en el pedido. Si ese pedido se despachó en un solo camión, el sistema toma ese movimiento directamente. Si tuvo varios despachos parciales (varios camiones / varios MW), aparece una lista numerada con cada movimiento (ID, fecha y kg) y se elige cuál corresponde a la devolución. Cada camión se devuelve por separado.
2. El sistema calcula el «máximo a devolver» de ese movimiento:
   Fórmula del tope

   máximo = cantidad despachada − cantidadDevueltaAcum
   Es decir: lo que salió en ese camión, menos lo que ya se devolvió antes de ese mismo camión. Si ese movimiento ya fue devuelto en su totalidad (máximo ≤ 0), el sistema avisa «Este movimiento ya tiene devolución total registrada» con el despachado y el devuelto, y no deja continuar.

3. Aparece un cartel de confirmación con los números concretos para revisar antes de seguir: movimiento de origen, NP, cantidad despachada y máximo a devolver (y, si hubo devoluciones previas, cuántos kg ya se devolvieron). «Aceptar» continúa; «Cancelar» aborta sin tocar nada.
4. Se abre el formulario en MODO DEVOLUCIÓN DE CLIENTE (banner y título en rosa). El formulario llega precargado y bloqueado con los datos del despacho original para que no se pueda equivocar el cliente, el artículo ni el tipo de azúcar:

   

   • Servicio = «ingreso», bloqueado (la devolución siempre suma stock).
   • Fecha = hoy (la devolución impacta a la fecha de registro, no a la del despacho original).
   • Propietario (MOYCO), Cliente/Destino, Artículo y Provincia/Localidad: heredados del movimiento original y bloqueados.
   • Tipo de azúcar: el mismo del despacho original (no se vuelve a elegir).
   • Las etiquetas cambian: «Factura» → «Nota de Crédito» y «Remito» → «Remito Devolución» (son referencias, opcionales).
   • Cantidad: editable, con tope = el máximo a devolver (el campo muestra «Máx: …» como ayuda). Acá se decide si la devolución es total o parcial.
   • Depósito de ingreso: se sugiere el de origen, pero es editable (la mercadería devuelta puede entrar a otro depósito).
   • Ref. interna queda en DEV.CLIENTE y las observaciones ya traen «Devolución de <MW> / NP <número>».
5. Se confirma. Aparece el modal de confirmación final con el resumen (ingreso, artículo, cantidad, depósito). Es la última revisión antes de reponer stock.

   

6. Al confirmar, en una transacción atómica (crearDevolucionTransaccional) el sistema: (a) crea el movimiento de ingreso (esDevolucionCliente: true, ligado al MW de venta por mwVentaOrigenId); (b) incrementa cantidadDevueltaAcum en el movimiento de venta original (solo metadato de trazabilidad: no cambia su cantidad ni su fecha); (c) escribe un documento en devoluciones_ventas; (d) el servidor recalcula los stock_snapshots y suma la mercadería de vuelta.

Ejemplos: devolución TOTAL y devolución PARCIAL

Reparar vínculo pedido ↔ movimiento

Herramienta de saneamiento (repairOrderLink): si un pedido quedó desincronizado de sus movimientos de stock, busca los MW y los vincula. Si cubren el total, deja el pedido CUMPLIDO; si es parcial, lo deja EN_CARGA con el saldo pendiente informado. También permite generar el F3000 a partir del movimiento.

Flujo de datos (resumen por acción)

Cotizaciones

Cotizaciones arma ofertas comerciales de azúcar (con anexo opcional de productos de Especialidad de la División Polvos). Es un módulo de cálculo: parte del costo real (PPP de compras) y de los fletes del Tarifario, aplica financiación por plazo y muestra el margen con un semáforo. No mueve stock ni crea pedidos — es el paso previo a un pedido. Solo rol 1 (Gerente). Cuatro solapas: Cotizador, Parámetros, Historial y Cot. Especialidades.

Conceptos base (leer antes de cotizar)

Solapa «Parámetros»

Define las variables con las que el cotizador calcula. Se cargan una vez (botón «Guardar Todos los Parámetros») y quedan en cotizaciones_parametros:

• TNA por defecto — tasa de financiación sugerida para los plazos.
• Días de vigencia — cuántos días vale la oferta por defecto.
• IVA en compra de azúcar — para reconstruir el costo neto real.
• Kg promedio por camión — para prorratear el flete largo por kg.
• Umbrales del semáforo — margen mínimo (debajo = alerta) y margen objetivo (la meta comercial).

Solapa «Cotizador» — wizard de 3 pasos

El wizard guía la cotización de principio a fin. El cálculo base se fija siempre a contado (plazo 0); los demás plazos se derivan en el paso 2 con una tasa única.

Paso 1 — Setup

1. Cliente (buscador inteligente) y sucursales de destino.
2. Artículos: multi-selección. Se pueden cotizar varios productos en una misma oferta (incluido el artículo genérico de bolsa 50 kg — ver más abajo).
3. Datos de compra: precio de compra y flete de ingreso. El botón «PPP 30d» trae automáticamente el precio promedio ponderado de los últimos 30 días desde las compras; el ícono de lupa muestra la composición de ese PPP (de qué compras salió y con qué peso).
4. Distribución: flete de salida al cliente (del Tarifario) y deducciones comerciales.
5. Plazo de cotización: chips con presets 0 / 30 / 60 / 90 o un valor custom (0–365 días).
6. Vigencia de la oferta (desde / hasta) y modo de cálculo.
7. Checkbox «Incluir Especialidades»: agrega el anexo de productos de Endulzantes a la oferta (ver solapa Especialidades).

Paso 2 — Artículo (iterativo)

El wizard procesa un artículo a la vez. Por cada uno muestra:

• El precio sugerido para el plazo elegido.
• La matriz de plazos de referencia (0 / 30 / 60 / 90 días) derivada de una tasa única: el cliente ve cuánto cuesta el mismo producto a cada plazo.
• El margen resultante con el semáforo: rojo = debajo del mínimo (revisar precio o costo), amarillo = entre el mínimo y el objetivo, verde = en o sobre el objetivo.

Cada artículo procesado queda como un chip. Se repite el paso por todos los artículos seleccionados antes de pasar al resumen.

Paso 3 — Resumen y PDF

Vista consolidada de todos los artículos y todos los plazos. Desde acá se genera el PDF y se guarda la cotización en el historial (cotizaciones_historial).

Cotizar el artículo genérico (bolsa 50 kg)

En las bolsas de 50 kg, al cotizar todavía no se sabe qué marca se va a entregar. Como la cotización es el paso previo al pedido, se permite usar el artículo genérico («AZÚCAR BOLSA 50KG (GENÉRICO)») igual que cualquier otro:

• Aparece normalmente en el buscador de artículos del paso 1 (es categoría PT).
• Se cotiza por precio y plazo, que no dependen de la marca: la oferta sale correcta sin comprometer una marca específica.
• La marca real recién se define al generar la Orden de Carga, ya en Pedidos & Ventas (no en Cotizaciones). Ver el capítulo de Ventas, sección «Artículo genérico».

Solapa «Cot. Especialidades»

Carga precios FOB por producto de Endulzantes con vigencia y edad. Estos productos se incluyen como anexo opcional de la oferta de azúcar cuando se tilda «Incluir Especialidades» en el paso 1. Colección cotizaciones_especialidades; los productos y sus imágenes se leen de endulzantes_articulos.

Solapa «Historial»

Lista las cotizaciones guardadas (cotizaciones_historial). Permite reabrir una cotización, reimprimir su PDF y usarla como base de una nueva (precarga todos los datos para ajustar precio/plazo y reemitir rápido).

Escenarios típicos

Errores y validaciones comunes

Flujo de datos

Compras & Consignación

Compras & Consignación administra todo el ingreso de azúcar al sistema: compras propias con factura, mercadería en consignación de comitentes y operaciones AZEF/otros. Es la fuente del stock contable y del costo que después consume Cotizaciones. Acá viven las OCAs, los descubiertos, las imputaciones y la integración con el ERP Flexxus vía Bridge. Roles 1, 2, 3 y 5 (algunas acciones son solo Gerente, ver cada sección). Este capítulo no omite nada: cada botón, cada validación, cada mensaje y cada escenario.

La pantalla principal

Cabecera «Compras & Consignación» / «Stock contable de azúcar propio y en consignación», con tres botones:

Todo se actualiza en tiempo real (tres listeners): las compras vivas (hasta 500, descartando canceladas/liquidadas), los KPIs de stock contable y el balance neto de movimientos. Las tres tarjetas KPI muestran el stock contable por tipo:

Tarjeta «Stock en Consignación» — las tres solapas

Panel de totales: DISPONIBLE (Σ saldo de OCAs activas con saldo > 0, menos los descubiertos) y VENDIDO S/LIQ. (lo vendido sin liquidar, solo si > 0). Tres solapas, cada una pagina de a 20 con «Mostrar 20 más»:

Al pie: «Liquidos Productos — Liquidación del Período» (va al módulo Líquidos Productos) y «Exportar Excel — Ventas / Imputaciones OCA» (ver «Exportar Excel»).

Nueva Compra — Asistente de 3 pasos

Paso 1 — Tipo de compra

El selector de OC de Flexxus (con imágenes)

El modal «Importar desde Orden de Compra» (con el logo de Flexxus) lista las OCs recientes:

1. Rango: botones 7 d / 30 d / 60 d (default 30).
2. Filtrado automático: solo OCs que contengan artículos cuyos códigos Flexxus estén cargados en ABM → Artículos (categoría MP). El cartel «Filtrando: …» muestra qué códigos se están usando. Si no hay ningún MP con código Flexxus, avisa: «No hay artículos MP con códigos Flexxus cargados. Cargá los códigos en ABM Artículos antes de usar el bridge.»
3. Cada OC muestra N° OC, fecha, razón social, CUIT y el match con GS:
   • ✓ Nombre del propietario si el CUIT coincide con un propietario de GS;
   • ⚠ sin match GS si no hay propietario con ese CUIT.
   A la derecha, kg, bolsas y monto. Badges posibles: YA RECIBIDA, PARCIAL n/n kg, ANULADA.
4. El contador arriba dice cuántas OCs hay y cuántas se ocultaron por estar ya vinculadas a otra compra.
5. Clic en una OC → trae su detalle de Flexxus y pre-rellena el Paso 2. «← Cargar manualmente (sin bridge)» sigue sin Flexxus.

Paso 2 — Datos de la compra

1. Afectación del Stock Contable obligatorio — dos tarjetas:
   • «Azúcar ya en planta» (inmediato): «Actualiza stock contable al confirmar».
   • «Azúcar a recibir» (con recepción): «Requiere Orden de Recepción» — el stock se va sumando a medida que llegan los camiones.
2. Proveedor / Comitente (buscador inteligente). La etiqueta es «Comitente» en consignación, «Proveedor» en propia/AZEF.
3. Fecha (default hoy) y N° OCA (ej.: 1234).
4. Artículo (Materia Prima) (buscador, solo categoría MP).
5. Cantidad: bolsas y kg con recálculo bidireccional (1 bolsa = 50 kg).
6. Precio Final por Bolsa — con IVA; muestra el total en vivo.
7. Observaciones (opcional).
8. «Revisar →».

Paso 3 — Confirmar

Tabla resumen (tipo, afectación, comitente/proveedor, fecha, OCA, artículo, cantidad, precio/bolsa, observaciones, OC Flexxus si hay, Total Operación) y un cuadro que explica qué pasará según el modo. Al «Confirmar y Continuar»:

1. Crea el documento en compras_azucar (tipo, modoAfectacion, propietario, OCA, bolsas/kg, precios, saldoConsumidoKg: 0, estado activo, y flexxusOC si vino de Flexxus).
2. Cesión programática: crea dos movimientos (salida del cedente + ingreso a MOYCO SRL), guardados en la compra como cesionSalidaId / cesionIngresoId. El stock lo recalcula el servidor.
3. Si el modo es «a recibir», obliga a generar la Orden de Recepción. Si cancelás la OR, el sistema hace rollback completo (anula la cesión y borra/restaura la compra) y avisa: «↩️ Operación cancelada. La compra y la cesión fueron revertidas.»
4. Mensaje de éxito: «✅ Compra OCA <oca> y cesión registradas exitosamente. Salida: … · Ingreso: …».

Aviso: se envía un mail con la confirmación de la operación

El correo (asunto Mov. Web - <propietario> - OC N° <oca>, remitente «Gestor Stock Moyco») incluye:

• Badge «Compra Registrada», título OCA <oca> · <propietario> y «Se registró exitosamente la operación.»
• Cantidad operada (kg + bolsas + artículo), datos de la operación (cañero, fecha, OCA, tipo, artículo, precio/bolsa, total, OC Flexxus si aplica) y observaciones.
• Pases de stock: tabla con los dos movimientos de cesión (N° MW, propietario, kg).
• Pie: «Operación registrada por <nombre del usuario>».
• Cada envío queda registrado en compras_notificaciones (auditoría: quién, cuándo, a quién, cuántos llegaron).

F3000 de Recepción

«Generar F3000 de Recepción» abre un selector de PDF y lee un Remito Electrónico AFIP (Código 997): extrae titular (nombre/CUIT/domicilio), transporte (CUIT, chofer, DNI, dominios tractor/acoplado) y detalle (bolsones, peso). Arma el payload de recepción con destino MOYCO S.R.L. (CUIT 30712115013, Arcadia – Tucumán, km 15) y dispara el flujo de recepción tipo «propia». No escribe en Firestore: alimenta el alta de la recepción. Si el PDF no es un remito 997 válido: «No se pudo identificar el remito. Verificá que sea un Remito Electrónico AFIP (Código 997).»

Detalle de una OCA — todas las acciones

Muestra resumen (fecha, original, consumido, saldo, precio, badge «🔗 OC Flexxus #N» si está vinculada) y los movimientos imputados. Hay un botón «Copiar» que copia la liquidación tabulada al portapapeles. La barra de acciones depende del estado y varias son solo Gerente (rol 1):

Vincular / Desvincular una OC Flexxus a posteriori (con cruce)

• Vincular OC Flexxus: si ya está vinculada avisa y no sigue. Hace pingHealth (si offline: «El bridge Flexxus no está disponible. Revisá que esté corriendo en esta PC.»). Abre el selector en modo cruce: cada OC se colorea por compatibilidad contra esta compra y se abre un modal «Confirmar vinculación» con la tabla GS Moyco vs Flexxus (Proveedor, OCA, Cantidad kg, Cantidad bolsas, Precio bolsa c/IVA) y las líneas de la OC.
• Desvincular Flexxus: confirma «¿Desvincular la OC Flexxus #N de esta compra? Los datos de la compra GS no se modifican.» y deja flexxusOC: null.

Histórico

«Histórico» abre una consulta paginada (25 por página, «Cargar 25 más») de compras_azucar con filtros de servidor: Tipo (Consignación / Propia / AZEF), Modo (Ya en planta / A recibir), Estado (Activa / Anulada / Finalizada parcial), Desde / Hasta, más un buscador de texto (OCA / cañero) que filtra lo ya cargado. Si falta un índice de Firestore, avisa: «No se pudo cargar el histórico… Puede faltar un índice compuesto en Firestore.»

Exportar Excel — Ventas / Imputaciones OCA

Desde la tarjeta de consignación. Pide Desde / Hasta (default últimos 7 días, máximo 45 días). Genera un CSV con una fila por imputación de venta de consignación: ID MW, fecha, cliente, depósito, artículo, OCA, comitente, kg (capeados al peso real del MW), bolsas, flags (⚠ CAP / ANULADO / AJUSTE), factura, remito, transporte, etc., con fila TOTAL y un bloque «AUDITORÍA POR OCA» que compara lo reportado contra saldoConsumidoKg (OK / Reporte > consumido / Reporte < consumido / OCA no encontrada). Sirve para detectar descuadres de imputación.

Flujo de datos

Stock General

Stock General es la foto del stock contable de azúcar consolidado por propietario y por depósito. Es una pantalla de pura consulta: acá no se edita nada. El saldo es el resultado de compras, producción, movimientos, cesiones y despachos; lo calcula y materializa el servidor. Roles 1, 2, 3 y 5. Tiene versión de escritorio y versión móvil.

100 % lectura — el stock no se corrige acá

Vista de escritorio

Dos columnas:

«Por Propietario» (columna izquierda)

1. Buscador «Buscar cliente o empresa...»: filtra en vivo por nombre.
2. Casilla «Ver Ceros»: por defecto oculta las cuentas con saldo ≈ 0; al tildarla las muestra.
3. Tabla con Propietario · Existencia (Kg) · Bolsas (Est.) · Acción. «Bolsas (Est.)» = kilos ÷ 50 redondeado para abajo.
4. Si una cuenta tiene saldo negativo, la fila se pinta de rojo (señal de revisar ese propietario).
5. Clic en cualquier fila (o en la flecha ›) → abre el detalle de ese propietario.

«Por Depósito» (columna derecha)

Tabla Depósito · Total (Kg) · Bolsas (50kg), ordenada de mayor a menor. Solo muestra depósitos con saldo > 0 (salvo que «Ver Ceros» esté activo). Es la lectura física: en qué depósito está la mercadería.

Detalle de un propietario

1. Encabezado con el nombre del propietario y botón «Volver».
2. Buscador local «Filtrar movimientos...»: filtra la lista ya cargada por ID, fecha o remito.
3. Tabla ID · Fecha · Tipo · Destino/Proc · Artículo · Kg · Documentos. «Tipo» es un badge INGRESO (verde) o SALIDA (rojo).
4. Paginación: trae los 30 movimientos más recientes; el botón «Cargar historial antiguo» / «Cargar más antiguos» trae 30 más.
5. Botón verde «Descargar Excel»: exporta solo lo que está cargado en pantalla a un .xlsx (hoja «Movimientos») con columnas ID · Fecha · Tipo · Destino/Procedencia · Artículo · KG · Remito · Factura. Archivo Stock_<Titular>_<fecha>.xlsx. Si no hay nada cargado avisa «No hay movimientos cargados para exportar.».

Vista móvil

En el celular se ve como tarjetas por cliente (nombre, badge de bolsas estimadas y el saldo grande en kg; negativo en rojo), con buscador «Buscar por cliente...» y casilla «Ver Cuentas en Cero». Tocar una tarjeta abre la «Auditoría» del cliente: las tarjetas de movimientos paginadas de a 10 con «Cargar movimientos anteriores».

Botón «Actualizar»

«Actualizar» (arriba a la derecha) vuelve a leer los saldos (reintenta el resumen del servidor y, si falla, la lectura en vivo). No recalcula el stock — recalcular es responsabilidad del servidor; este botón solo refresca lo que se muestra.

Flujo de datos

Stock Pallet

Stock Pallet controla la mercadería palletizada en forma separada del stock contable a granel, e incluye la gestión de vales de pallets. Roles 1, 2, 3 y 5. Tiene dos solapas: Stock Físico y Gestión Vales.

Solapa «Stock Físico»

1. La grilla lista los pallets a partir de los snapshots de pallet, con su artículo, formato y cantidad.
2. Filtros por artículo/ubicación; botón para reiniciar el filtro.
3. Al abrir un renglón (detalle) se ve la composición de ese pallet y su trazabilidad.

Solapa «Gestión Vales»

Administra los vales de pallets (entrega/devolución de pallets al cliente o transportista). Permite registrar y dar seguimiento a los vales, y conciliarlos contra lo facturado.

Flujo de datos

Movimientos de Stock

Movimientos de Stock es el corazón del stock de azúcar: acá se registran y consultan todos los movimientos que mueven existencias — recepciones, egresos, ajustes, mermas, pases internos entre depósitos, cesiones de titularidad y el pase intersectorial Azúcar ↔ División Polvos. Es también la pantalla a la que llega el despacho desde una Orden de Carga. Es uno de los módulos más grandes del sistema; este capítulo explica cada botón y cada escenario, con ejemplos. Roles 1, 2, 3 y 5.

El listado

Trae los 50 movimientos más recientes (orden por número descendente) y resuelve los nombres de propietario y destino. El botón «Cargar más antiguos» trae 50 más. Banners que pueden aparecer arriba:

• «Atención: Facturación Pendiente» (amarillo): hay N movimientos de salida sin N° de factura. El enlace «Revisar» abre el modal de pendientes. (Los anulados de 0 kg no cuentan; el sistema los limpia solo.)
• Cierre de período: aviso del período contable.
• Histórico global: «Mostrando Histórico Global. Borre la búsqueda para volver a la vista optimizada.»

La barra superior

Fila de botones de acción

En la tabla, cada fila muestra ID · Fecha · Tipo · Propietario · Destino/Proc. · Cantidad · Referencia · Acción. Los anulados salen en gris itálica (no se editan ni anulan). Los de salida sin factura salen en amarillo pulsante con badge «SIN FACTURA» y son clickeables para cargar la factura.

Acciones por fila

Nuevo Movimiento (formulario manual)

El formulario es por pasos y cambia según el tipo.

Paso 0 — Tipo de azúcar

En el alta manual (botón «NUEVO»), el primer paso es elegir el tipo: Consignación, Azúcar Propia (AZPR), AZEF / Otros u Orgánica. «← Volver al listado» cancela sin tocar nada.

Paso 0.5 — Vinculación Flexxus (opcional)

Si corresponde, se puede vincular el movimiento con una factura de Flexxus (cruce N×M, los 4 controles). Es el mismo flujo que en el despacho — ver el capítulo «Integración Flexxus (Bridge)».

Datos del movimiento

1. Propietario y Destino / Procedencia (obligatorios, buscadores inteligentes).
2. Artículo y Cantidad. En Carga Múltiple (interruptor arriba) se cargan varios renglones artículo/cantidad/lote en un mismo movimiento; el total se recalcula solo.
3. Tarifa: el sistema busca la tarifa vigente según transporte y geografía (cascada localidad → zona). Si no hay, se puede activar tarifa manual. Las etiquetas de vigencia van de «✔ Vigente» a «🔴 Nd — revisar» según antigüedad.
4. Transporte, chofer y provincia/localidad cuando aplica.

Al guardar se crea el documento en movimientos con correlativo MW00000001. Hay opción «guardar con factura pendiente» para registrarlo aunque falte el N° de factura (queda en la bandeja de pendientes).

Botón «Recepción» — Wizard de Recepción (paso a paso)

Recibe la mercadería de Órdenes que están en tránsito (estado «GESTIÓN»).

1. Paso 1: el sistema busca las órdenes en camino. Se elige el «Titular de la mercadería (Propietario)» y «BUSCAR ÓRDENES». Si no hay órdenes: «No hay órdenes en estado 'GESTIÓN' para recibir.».
2. Paso 2: tabla con las órdenes de ese titular (N° Orden, Procedencia/Ingenio, Artículo, Saldo). Se tilda cada orden a recibir y se ingresa la cantidad recibida en kg (precarga el saldo pendiente como sugerido; el tope es el pendiente).
3. Paso 3: el sistema valida y arma la recepción:
   • No se puede mezclar órdenes vinculadas a compras con órdenes de almacenamiento 3ros: «🚨 No se puede mezclar en una misma recepción…».
   • No se pueden mezclar compras de distinto tipo contable (Consignación/Propia/AZEF): «🚨 Las órdenes seleccionadas están vinculadas a compras con distinto tipo contable… Procesá cada tipo por separado.».
4. Lleva al formulario de movimiento ya precargado como ingreso de recepción; al confirmar se crea el MW, baja el saldo pendiente de cada Orden (pasa a «CARGADA» cuando se completa, si no queda en «GESTION») y agrega la entrada al historial de cargas. Éxito: «✅ Recepción registrada con éxito. Movimiento: MW…».

Botón «Despacho OC» — Despacho desde Orden de Carga

Abre el modal «Seleccionar Orden de Carga» con las OC activas (pedidos en «EN_CARGA», agrupados por NP). Se elige una con «Confirmar» y el sistema lleva al formulario en modo despacho (egreso) con todo precargado. El paso a paso completo del despacho —tipo de azúcar, imputación de consignación, cruce Flexxus, confirmación— está en el capítulo «Pedidos & Ventas» → Despacho.

Botón «Pase Dep.» — Pase Interno entre depósitos

Mueve mercadería entre depósitos sin cambiar el dueño (sigue siendo MOYCO).

1. Fecha, Artículo (excluye los genéricos), Origen (Sale), Destino (Entra), Cantidad (Kg), Costo Mov Bolsa (No Aplica / Propio / 3ro-Pallet / 3ro-Estiba / 3ro-Trasbordo / 3ro-Otros) y Observaciones.
2. Valida: campos obligatorios completos y «Origen y Destino deben ser diferentes.».
3. Vista previa «Confirmar Pase» (Sale de / Entra a / cantidad / costo) → «Confirmar».
4. Genera dos movimientos vinculados (una salida y un ingreso, docAzucel: PASE INTERNO). Por eso un pase no se «edita»: se anula y se rehace. Éxito: «✅ Pase registrado.».

Botón «Cesión Stock» — Cambio de titularidad

Transfiere stock de un propietario a otro (cambio de titularidad en AZUCEL 4).

1. Fecha, Orden (opcional), Artículo, Cedente (Sale), Receptor (Entra), Cantidad, Observaciones.
2. Valida campos y «Cedente y Receptor deben ser distintos.».
3. Reglas de negocio según quién es Moyco:
   • Receptor = MOYCO: bloqueado — «Para registrar un ingreso a Moyco SRL debe utilizar el módulo "Compras".».
   • Cedente = MOYCO: confirma que es una salida AZEF/Otras (para otro tipo de venta usar Ventas).
   • Ambos terceros → «Almacenamiento 3ros».
4. Vista previa «Confirmar Operación» → «Confirmar Cesión». Genera dos movimientos vinculados (docAzucel: TRASPASO). El alta de compra usa este mismo motor por debajo (cesión programática). Éxito: «✅ Cesión registrada.».

Botón «Pase Polvos» — intersectorial Azúcar ↔ División Polvos

Conecta el sector Azúcar con la División Polvos. Dos operaciones, con código de color para no confundirlas: Pase a Div. Polvos en ámbar y Devolución a Azúcar en teal.

Pase a Div. Polvos (desde Azúcar)

1. Fecha, Depósito Origen, Artículo de Azúcar (con marca) — al elegirlo el sistema auto-mapea el insumo de Polvos (CTA / Refinada según el nombre; si no, «sin mapeo automático» y se elige a mano), Insumo en Div. Polvos, Cantidad (kg), Lote (para Div. Polvos) (default S/L), Observaciones.
2. «Ver resumen»: panel rojo «Sale de Azúcar» + panel verde «Entra a Div. Polvos» → «Confirmar Pase».
3. Valida stock en el depósito de azúcar («Stock insuficiente en depósito… Disponible / Solicitado»).
4. En una única transacción atómica registra: la salida de azúcar (PASE DIV.POLVOS) + el descuento del snapshot de azúcar + el ingreso del insumo en Polvos + el doc de trazabilidad en pases_polvos. Éxito: «✅ Pase registrado correctamente. Azúcar: MW… (Salida) · Div. Polvos: MED… (Ingreso) · Pase ID: PASE…».

Devolución a Azúcar (desde Polvos)

1. Fecha, Insumo a Devolver, Lote a Devolver (lista los lotes con stock > 0, mostrando los kg), Cantidad (kg), Artículo en Azúcar (destino), Depósito Destino, Motivo.
2. Valida el saldo del lote («Stock insuficiente en lote… Disponible»).
3. «Ver resumen» → «Confirmar Devolución». Transacción atómica: egreso del insumo en Polvos (DEV.A AZUCAR) + ingreso de azúcar + suma al snapshot de azúcar + doc en pases_polvos. Éxito: «✅ Devolución registrada correctamente…».

Anular un movimiento

El botón Anular revierte el movimiento, pero primero chequea reglas de bloqueo (mensajes que vas a ver, todos empiezan con «⛔ ACCIÓN DENEGADA»):

Ver / Vincular factura Flexxus (posterior)

Solo para MW de salida tipo VENTA sin factura, y solo roles Gerencia (1) y Ventas (5). Si el despacho se hizo sin Bridge, acá se asocia la factura después: detecta los MW «hermanos» del mismo viaje (mismo propietario/destino/remito/ fecha) y aplica la vinculación a todos. Requiere que el destino tenga CUIT cargado. Es el mismo cruce N×M con los 4 controles del despacho — ver el capítulo «Integración Flexxus (Bridge)». Al confirmar, escribe la factura en los MW y deja registro en el historial de vinculaciones.

Detalle — Ficha Técnica del movimiento

El botón Ver abre la «Ficha Técnica de Movimiento», de solo lectura:

• Encabezado: badge ingreso/salida, cantidad en kg, artículo, referencia interna (MW) y fecha.
• Participantes: propietario, destino/procedencia, ubicación física (depósito).
• Logística y costos: transporte, chofer, zona/ciudad, costo mov. bolsa, tarifa, movimiento de envases (pallets ±).
• Tarjetas de Remito, Orden de Carga y Factura.
• Auditoría: quién y cuándo lo registró/editó, las vinculaciones Flexxus (vinculación / re-vinculación con comprobante anterior → nuevo) y un botón «Ver historial» con el log de auditoría.
• Si es salida: sección «Documentación F3000 (DGR Tucumán)» con «Generar carga F3000» (arma los datos y los pasa a la extensión de Chrome «GS Moyco → F3000»; no escribe en la base; si la extensión no está activa avisa). En consignación con imputaciones, prorratea por comitente para no sobre-contabilizar.

El detalle no edita ni anula: esas acciones están en el listado.

Exportar histórico (CSV)

El botón «Excel» pide Desde / Hasta (default últimos 7 días, máximo 31 días: «🚨 ACCESO DENEGADO (Rango Excedido)…» si te pasás). Baja un CSV con todas las columnas del movimiento (propietario, destino, depósito, artículo, kg, documentos, transporte, chofer, tarifa, pallets, etc.).

Flujo de datos

Producción

Producción (Centro de Producción) registra la actividad de la planta de azúcar. Es un hub con cuatro solapas: Parte Diario, Planificación, Insumos y Parte Semanal. El botón «Actualizar» recarga los datos. Roles 1, 2, 3, 4 y 5, con restricciones:

Parte Diario — paso a paso

El parte diario no carga stock a mano: consolida los movimientos del día y cierra el balance de la jornada (consumo de MP vs producción de PT), generando los ajustes automáticos de merma/ganancia. Es un asistente de 5 pasos.

Crear un Parte Diario

1. Botón «Nuevo Parte Diario». El sistema calcula el correlativo siguiente (PD000001, PD000002… — el máximo conocido + 1).
2. Fecha: aparece el pedido «📅 Fecha del Parte Diario (YYYY-MM-DD):» con la fecha de hoy precargada. Si se cancela, no se abre el asistente; si se deja vacío, usa hoy.
3. Se abre el asistente con la barra de pasos: 1. Ingresos · 2. Egresos · 3. Stock MP · 4. Stock PT · 5. Confirmar, y un panel lateral «Resumen en Vivo».

Paso 1 — Ingresos

El sistema busca en el Depósito de Producción (el que en ABM se llame «AZUCEL 1» o contenga «PRODUCCION»; si no existe avisa «Error: Depósito de Producción no configurado en ABM») los movimientos de ingreso de los últimos 7 días que todavía no estén imputados a otro parte (o que ya pertenezcan a este, si se está editando).

• Tabla Sel · Ref/Fecha · Artículo · Kilos · Ver. Los movimientos de días anteriores llevan un badge ámbar con la fecha. El ojo abre el detalle del movimiento.
• Se tildan los movimientos de producto que ingresaron. Al tildar, el sistema acumula kgPorArticulo (la base de los pasos 3 y 4) y actualiza el «Resumen en Vivo».
• Si no hay movimientos: «Sin movimientos de ingresos pendientes de imputación en Planta (últimos 7 días).».

Paso 2 — Egresos



Idéntico al paso 1 pero con los movimientos de salida (consumos / devoluciones) del depósito de producción. Se tildan los que correspondan; alimentan los egresos por artículo.

Paso 3 — Stock MP (Materias Primas)



Tabla por artículo de MP con: S. Inicial, Ing (+), Egr (−), Stock Final Físico (editable) y Consumo.

De dónde sale el Stock Inicial

El sistema lee el último Parte Diario anterior y toma su Stock Final por artículo como Stock Inicial de hoy. Por eso solo se edita el último parte: tocar uno viejo descuadraría toda la cadena.

Fórmula del Consumo (MP)

Consumo = (Stock Inicial + Ingresos) − Egresos − Stock Final

El Stock Final viene precargado con el teórico (SI + Ing − Egr); se ajusta al conteo físico real. Si el resultado da negativo se pinta en rojo.

Paso 4 — Stock PT (Productos Terminados)



Misma tabla para los artículos PT, pero acá el cálculo es de Producción:

Fórmula de la Producción (PT)

Producción = (Stock Final + Egresos) − Stock Inicial − Ingresos

Paso 5 — Confirmar



El sistema clasifica cada artículo por tipo de azúcar (Común tipo "A", Refinada, Orgánica, Otros) y arma el análisis por tipo (consumo MP vs producción PT). Muestra:

• 3 KPI: Producción (PT), Consumo (MP) y Desvío Neto (− merma rojo / + ganancia verde).
• 3 gráficos: Nivel de Desvío (hoy) (gauge: verde ≤0,04 % · amarillo ≤0,8 % · rojo más), Tendencia de Desvío (7 días) y Producción vs. Promedio (30 días).
• Tabla «Análisis por Tipo de Azúcar» (Consumo · Prod. · Dif. kg · % Desvío) y los detalles completos de Stock MP y Stock PT.
• Botones «← Volver al Menú» y «Descargar PDF Oficial».
Qué pasa al «Confirmar y Guardar»

Se guarda el documento en partesDiarios (id, fecha, ingresos/egresos con sus movimientos, stockMP, stockPT, analisisDetallado, totales, rendimiento). Se vinculan los movimientos tildados (parteDiarioId) para que no se imputen dos veces. Y se generan los ajustes automáticos: por cada tipo con diferencia > 100 g se crea un movimiento de stock (docAzucel: AJUSTE PD) de salida si hubo merma o ingreso si hubo sobrante, contra el artículo «Perdida/Ganancia Azúcar …» que corresponda. Eso sí impacta el stock.

Eliminar un Parte Diario revierte todo

Confirmación: «⚠️ ¿Está seguro de eliminar el Parte Diario {id}? Se liberarán remitos, se neutralizarán ajustes y se borrará el reporte.». En una transacción: desvincula los movimientos (parteDiarioId: null), neutraliza los ajustes (cantidad 0, ANULADO (PD)) restituyendo el stock, y borra el parte. Mensaje: «✅ Proceso completado…».

Lista y PDF

Acción	Qué hace
Ver Detalle Técnico	Abre el parte en solo lectura, directo al resumen (paso 5)
Descargar PDF Oficial	Genera el PDF «PARTE DIARIO DE PRODUCCIÓN» (KPIs, análisis por tipo, detalle MP y PT, firmas)
Editar	Reabre el asistente (solo el último parte)
Eliminar	Borra y revierte (solo el último parte)
Cargar registros anteriores	Paginación: 30 más, orden por fecha desc.

---

Parte Semanal — paso a paso



El parte semanal consolida varios partes diarios en un cierre con correlativo PS000001 (contador atómico) y calcula el rendimiento de cada insumo con semáforo contra su histórico. Asistente de 7 pasos.

Un parte diario vive en un solo cierre

El paso 2 solo lista partes diarios libres (sin parteSemanalId) o los de este mismo cierre. Así nunca se cuenta dos veces la misma producción. Al eliminar un Parte Semanal, los diarios quedan libres de nuevo. Las semanas PS000001 y PS000002 se excluyen siempre de los cálculos de rendimiento histórico (son de calibración).

Los 7 pasos

1. Paso 1 — Fechas: «Fecha Desde» y «Fecha Hasta» del período a cerrar.
2. Paso 2 — Partes Diarios: lista los partes diarios libres en ese rango (ID, Fecha, Prod. PT). Se tildan los que entran al cierre. Hay que elegir al menos uno («Debe seleccionar al menos un Parte Diario para continuar.»). Al tildar, el sistema acumula la producción total, por artículo, por tipo, los paquetes (1kg/500g) y las pérdidas por tipo.
3. Pasos 3 a 6 — Insumos (Primarios · Secundarios · Generales · Mecánicos): tabla por insumo con S. Inicial (= stock final del último parte semanal anterior), Ingresos, Egresos, S. Final, Consumo, Rend. Hist. y Rend. Actual.
4. Paso 7 — Resumen: KPIs (Producción total, Prod. paquetes, Balance/Desvío, desglose por tipo) y las tablas de insumos por categoría con su semáforo. Botón «Confirmar Cierre».

Las pantallas de los 7 pasos, en orden:















Fórmulas del Parte Semanal

Consumo insumo = (S.Inicial + Ingresos) − Egresos − S.Final
Rend. Actual = Consumo / Base de producción
  • Base: insumo mecánico → kg de paquetes; general → producción total;
    vinculado a un artículo → producción de ese artículo
Rend. Histórico = Σ consumos / Σ producciones de semanas previas (ponderado)

Semáforo comparando Rend. Actual vs Histórico: rojo si el desvío supera +10 % (alto consumo), amarillo si baja más de −10 % (consumo inusualmente bajo), verde en rango. Esto es lo que detecta robos/fugas o cargas mal hechas.

Indicadores que alimentan el Inicio

El cierre guarda en partesSemanales: produccionTotalKg, produccionPackKg, perdidasTotalKg (el balance/desvío de la semana), produccionPorTipo, perdidasPorTipo, el detalle de insumos con su rendimiento, y rendimientoGlobal. Esos valores son los que nutren la tendencia de eficiencia del Tablero de Inicio. Al confirmar también se genera el PDF automáticamente y se vinculan los partes diarios.

Ver abre el cierre en solo lectura (paso 7). Editar/Eliminar solo el último (eliminar libera los partes diarios: «Los Partes Diarios contenidos quedarán libres para un nuevo cierre.»). Exportar PDF regenera el reporte cuando se necesite.

---

Planificación (Rolling Forecast)



Arma un plan rodante: Ayer (real, fijo) + 7 días proyectados (omite domingos). Cruza la demanda de pedidos con la producción planificada.

• Toma los pedidos en estado AUTORIZADO, CARTERA y EN_CARGA y los separa en demanda diaria (con fecha de carga, entran al día) y demanda flexible (sin fecha, columna «Pendiente S/Fecha»).
• El punto de partida real sale del Parte Diario de ayer (si falta, avisa «ATENCIÓN: No se encontró el Parte Diario de AYER. El stock inicial es una estimación.»).
• Por artículo PT hay 4 filas: Stock Inicio · Producción (+) · Despachos (−) · Saldo Final. La fila Producción es editable en los días futuros; el saldo final se recalcula en cascada y se pinta rojo si queda negativo.
• «Guardar Plan» (estado «✅ Plan guardado») escribe el doc PLAN_<año>_W<semana> en planificacion_produccion. «PDF» exporta el rolling forecast con el total por día y de la semana.

Insumos



Muestra el stock actual de insumos tomado del último Parte Semanal cerrado (no de movimientos). Es de solo lectura.

• Buscador por nombre, filtro por tipo (Primario/Secundario/General/Mecánico) y casilla «Solo Alertas» (stock ≤ mínimo).
• Tabla Insumo · Tipo · Stock Actual · Stock Mínimo · Estado (badges SIN STOCK / STOCK BAJO / STOCK OK).
• Clic en una fila abre el análisis del insumo: rendimiento histórico ponderado (un/Tn), autonomía de producción (cuántas toneladas aguanta el stock) y un gráfico de consumo vs rendimiento por semana.
• «Excel» exporta el inventario con rendimiento, capacidad en Tn y valorización (USD).
• Si nunca se cerró un Parte Semanal: «Sin existencias registradas — Debe generar un Parte Semanal para inicializar los saldos de insumos.».

Flujo de datos

Colección	Rol
partesDiarios	Escribe — parte del día; lee el anterior para el stock inicial
partesSemanales	Escribe — cierre semanal (correlativo atómico counters)
movimientos / stock_snapshots	Lee ingresos/egresos del día; escribe los ajustes automáticos de merma/ganancia
planificacion_produccion	Escribe — plan rodante por semana ISO
pedidosVenta	Lee — demanda (AUTORIZADO / CARTERA / EN_CARGA)
articulos, insumos	Lee — catálogos (tipo, presentación, artículo vinculado, stock mínimo, valor)

Regla de oro

El Parte Diario referencia movimientos existentes (no inventa stock), salvo los ajustes automáticos de merma/ganancia que sí mueven stock. El Parte Semanal consolida diarios y mide eficiencia por insumo. Un diario solo puede estar en un cierre; eliminar un cierre o un diario revierte limpiamente sus efectos.

Calidad & Trazabilidad

Calidad & Trazabilidad administra la biblioteca de protocolos / estándares de calidad de los productos y permite seguir la trazabilidad de un lote. Disponible para roles 1, 2 y 5.

Estándares (biblioteca de protocolos)

1. Botón «Nuevo Estándar» abre el Editor de Estándar: se define el parámetro de calidad (nombre/protocolo, valores de referencia — mínimo, máximo, unidad, rango y criterio de aprobación).
2. Cada estándar de la lista se puede Editar (reabre el editor con los datos) o Eliminar (pide confirmación «¿Eliminar este estándar?»).
3. Al guardar, si es nuevo se agrega a quality_standards; si es edición, se actualiza el documento. La lista en memoria se sincroniza al instante.

Trazabilidad de lote

Permite buscar un lote o producto y reconstruir su recorrido: de qué compra/producción salió, qué lo compone y a qué ventas fue. Es una vista de análisis; no genera movimientos de stock.

Flujo de datos

Órdenes de Azúcar

Órdenes de Azúcar administra las Órdenes de Carga (colección ordenesCarga): documentos que dan derecho a retirar / recibir una cantidad de azúcar de un Emisor (un ingenio u origen) a favor de un Propietario / Titular. No mueven stock por sí mismas: son el respaldo documental de mercadería que está por entrar a planta y se va consumiendo a medida que llega. Roles 1, 2, 3 y 5 (el rol 4 ve solo las suyas, ver «Mis Órdenes»).

Conceptos base (leer antes de operar)

Los tres estados (las tarjetas de arriba)

Las tarjetas superiores son a la vez filtro y tablero: muestran el conteo por estado y al hacer clic filtran el listado. El listado se carga paginado desde ordenesCarga (50 por página, botón «Cargar más»).

Ingresar una Orden (de cañero) — paso a paso

Botón «Ingresar Orden» (azul, arriba a la izquierda). Se completa:

1. N° de Orden — el número del documento que emitió el ingenio (ej. 004599). Es la identificación del «cheque».
2. Cantidad (Kg) — el monto total amparado por la orden.
3. Emisor (Ingenio / Origen) — buscador inteligente sobre destinos: el ingenio que emite.
4. Propietario (Titular) — buscador sobre propietarios: el cañero a cuyo nombre está la orden.
5. Artículo / Producto — qué azúcar ampara.
6. Notas internas — calidad, envío, observaciones.

Al guardar, la orden nace en CARTERA con cantidadPendiente = cantidadOriginal e historial vacío. Los tres selectores (Emisor, Propietario, Artículo) son obligatorios y se eligen con el buscador — no se acepta texto libre.

Caso especial: Orden de Recepción desde una Compra

Cuando se registra una compra de azúcar, el sistema puede generar automáticamente una Orden de Recepción para que la mercadería entre con respaldo. Estas órdenes:

• Nacen directamente en GESTION (no pasan por Cartera: la mercadería ya está en tránsito por contrato).
• Quedan con origenCreacion: 'compra' y compraId vinculado (back-ref en compras_azucar.ordenRecepcionId).
• Arrastran el tipo contable de la compra (tipoAzucarCompra: Consignación / Propia / AZEF).

Acciones sobre las órdenes

Detalle de la orden y su «historial de cargas»

El detalle muestra el «cheque» completo: Emisor, Propietario, Artículo, Total Solicitado, barra de progreso (% cargado) y Pendiente. La tabla Historial de Cargas lista cada recepción parcial con fecha, remito, ID de movimiento vinculado y kg. Si la orden vino de Cartera con instrucción de logística, se ve también esa nota.

Wizard de Recepción — cómo se «cobra» la orden

Es el flujo por el que la mercadería entra físicamente y se descuenta el saldo. Solo trabaja sobre órdenes en GESTION.

1. Paso 1 — Titular: el sistema trae todas las órdenes en tránsito y se elige el Propietario para agrupar.
2. Paso 2 — Selección: se tildan las órdenes que están ingresando y se escribe cuántos kg se reciben de cada una (no puede superar el saldo). Se puede recibir parcial.
3. Paso 3 — Movimiento: el wizard arma un paquete (propietario, emisor, artículo, total, órdenes y tipo contable) y abre el formulario de Movimiento de ingreso precargado. Al confirmar el movimiento, el stock entra y baja el saldo de cada orden, agregando una entrada al historial. Si una orden llega a saldo 0, pasa a CARGADA.

Anulación: restitución del saldo

Si se anula un movimiento de recepción, el sistema devuelve el saldo a las órdenes que ese movimiento había consumido (función revertirSaldoOrden): suma los kg de vuelta a cantidadPendiente (sin pasar el total), saca la entrada correspondiente del historial y, si vuelve a quedar pendiente, la orden regresa a GESTION. El vínculo se resuelve por recepcionOCs del movimiento o, como respaldo, parseando las observaciones.

«Mis Órdenes» — la vista del cliente / cañero (rol 4)

El mismo dato visto desde el Portal del Cliente: el cañero ve solo las órdenes de sus cuentas (stockRelacionado), con pestañas Solicitadas / En Tránsito / Finalizadas y una barra de avance de carga por orden. Es de solo lectura: sirve para que el titular siga cuánto le queda por retirar de cada «cheque».

Escenarios típicos

Errores y validaciones comunes

Flujo de datos

Centro de Tráfico

El Centro de Tráfico es el radar logístico en tiempo casi real. Muestra el estado de los viajes en dos vistas: Salidas (outbound, despachos saliendo) y Cargas (inbound, recepciones entrando). Es el detalle de la tarjeta «Tráfico» del Inicio. Roles 1, 2, 3 y 5.

Vista «Salidas» (outbound)

Tablero por columnas con los despachos clasificados por estado temporal. Cada columna tiene su contador:

Cada tarjeta de viaje se abre para ver chofer, transporte, cliente, fechas y estado.

Vista «Cargas» (inbound)

La misma idea para las recepciones: columnas según si no llegaron (atrasadas), llegan hoy o están programadas. Permite controlar lo que está por entrar a planta.

Operación

1. Se alterna entre Salidas y Cargas con las pestañas superiores.
2. Botón «Actualizar Radar»: recarga los datos (también se refresca solo al entrar).
3. Clic en una tarjeta → detalle del viaje.

Flujo de datos

Es 100% lectura: cruza ordenesCarga, pedidosVenta, compras_azucar y movimientos para ubicar cada viaje en el tiempo y clasificarlo. No se cargan datos acá; el estado de cada viaje se gestiona en Órdenes y la liquidación en Fletes.

Fletes y Liquidaciones

Fletes y Liquidaciones (Centro de Logística) es el módulo donde se controla la documentación de cada viaje y se liquida (paga) a los transportistas. Es uno de los módulos más extensos del sistema. Roles 1, 2, 3 y 5. Este capítulo desarma cada flujo en pasos pensados para alguien que nunca usó el sistema. Se accede desde la barra lateral, área Logística → Fletes y Liquidaciones.

El hub: cuatro caminos

Al entrar se ve el hub con cuatro tarjetas y, debajo, el Historial de Liquidaciones. El botón «Volver a Logística» de cualquier pantalla siempre regresa acá.

A · Conformar Remitos (paso a paso)

«Conformar» un remito es dar fe de que el viaje se entregó y la documentación está correcta. Hasta que un remito no está conformado, su viaje arrastra una alerta en el resto de los procesos. La conformación es un embudo de 3 estados:

Conformar un lote de remitos

1. Hub → tarjeta «Conformar Remitos».
2. Pestaña «PENDIENTES» (la otra es «HISTORIAL» = ya conformados). Opcionalmente filtrá por cliente (buscador inteligente) o buscá un remito exacto por N° (formato 00001-00012345, Enter o lupa).
3. Se tildan las casillas de la izquierda de los viajes a procesar.
4. Botón verde «Confirmar». El sistema explica qué va a pasar y pide confirmación:
   • Un viaje EN TRÁNSITO avanza a A REVISAR.
   • Un viaje A REVISAR avanza a CONFORMADO FINAL (y se le sella la fecha de conformación).
   Es decir: para llevar un viaje desde cero hasta «Conformado Final» hay que pulsar «Confirmar» dos veces (una por cada salto del embudo).
5. Si en ese lote algún viaje llegó a Conformado Final, se abre automáticamente el modal «Ingreso de Vales de Pallets» (ver abajo). Si no, termina con un aviso de éxito.

El modal de Vales de Pallets

Aparece solo después de conformar definitivamente. Lista los viajes recién conformados; se tilda únicamente el viaje que repuso pallets con vale y se cargan N° de Vale y Cantidad de Pallets. Al «Registrar Vales»:

• Se crea un vale en estado CARTERA (queda disponible como crédito de pallets para futuras liquidaciones).
• Se actualiza la cuenta corriente de pallets: + pallets a la cuenta del transporte y − pallets a la cuenta interna «NO APLICA» (Moyco), todo en una transacción atómica.
• Si ningún viaje repuso pallets, se usa «Omitir» y listo.

B · Flete Corto — Ingreso (paso a paso)

Liquida los viajes de ingreso (entrada de materia prima / cosecha). No requiere conformidad de remito y no pasa por «factura»: del listado de viajes se va directo a la liquidación.

1. Hub → tarjeta «Flete Corto».
2. Paso 1 — Transportista: buscador inteligente; se elige la empresa a liquidar y «Iniciar Proceso». Si no se elige, avisa y no avanza.
3. Paso 2 — Selección de viajes: tabla de viajes de ingreso de ese transporte (ID, Fecha, Origen, Remito, Kilos, Tarifa, Subtotal). Los ya liquidados no aparecen. Se tildan los viajes; arriba se ve el «Total Seleccionado» recalculándose en vivo.
   • Si un viaje tiene tarifa en 0, la casilla queda deshabilitada con el badge rojo Sin Precio. Hay que corregir la tarifa antes (ver «Modificar tarifa de un viaje»).
   • El subtotal de cada viaje = (kilos / 1000) × tarifa por tonelada.
4. «Vista Previa» (opcional): genera un PDF de pre-liquidación para conciliar con el transportista antes de cerrar. Aclara que todos los valores son SIN IVA y es un documento informativo sujeto a verificación.
5. «Finalizar y Liquidar» → pantalla de Resumen: lista los viajes, el Total a Pagar, un campo de Observaciones y el N° de Factura del Transporte. La factura es obligatoria con formato 00000-00000000 (4-5 dígitos − 8 dígitos), salvo que se tilde «Cargar Factura Luego».
6. «Finalizar y Guardar». Se crea la liquidación con ID secuencial tipo LF000123 y cada viaje queda marcado con ese ID (liquidacionFleteId), por lo que desaparece de la bandeja y no se puede volver a liquidar.

C · Flete Largo — Salida

Para los viajes de salida (entregas a clientes). Tiene un hub propio con dos procesos — primero se Factura, después se Liquida/Paga — y, debajo, un bloque con pestañas «Sin Facturar» y «Facturados» para visualizar el estado de los viajes (con filtro por transportista y exportación a Excel/CSV).

C.1 · Facturación de Fletes (paso a paso)

Imputar uno o varios remitos conformados a una factura del proveedor de transporte.

1. Hub Flete Largo → «Facturación de Fletes».
2. Transporte (buscador) → «Buscar Remitos Sin Facturar».
3. Paso 2 — Remitos: se listan los viajes de salida sin facturar desde el 01/03/2026. Se tildan los remitos a meter en una misma factura. El badge informa Conformado / Sin conformar / Sin tarifa. Solo bloquea la selección la falta de tarifa; un remito sin conformar igual se puede facturar (la conformación acá es informativa). «Total Seleccionado (Neto)» en vivo. Confirmar selección.
4. Paso 3 — Control de la factura: por cada viaje hay dos botones: «Correcto» (verde, por defecto) o «Dif. de Precio» (ámbar). Si la tarifa del sistema no coincide con lo que el transporte facturó, se marca «Dif. de Precio» y se carga el excedente sin IVA; el sistema lo acumula como Nota de Crédito a solicitar y muestra la advertencia de que la factura quedará en «NO PAGAR» hasta regularizar.
5. Cargos adicionales (opcional): «Agregar cargo adicional» con tipo Costo de Descarga · Pago de abasto por el Transporte · Tasa Municipal · Otros (con descripción) e importe sin IVA. Se suman al neto.
6. N° Factura del Proveedor obligatorio, formato 00000-00000000. El sistema calcula IVA 21% fijo sobre el neto.
7. Guardar: se crea la factura con ID secuencial tipo FF000045 en estado «Pendiente de Pago» (o «NC Pendiente / NO PAGAR» si hubo diferencias). Cada remito queda marcado con esa factura y sale del listado «Sin Facturar».

C.2 · Pestaña «Facturados»: editar o anular una factura

• Consultar factura: detalle económico, remitos imputados, diferencias y auditoría.
• Editar header: cambia solo N° factura, fecha e importes (Total = Neto + IVA, verificado con tolerancia). Pide doble confirmación. No cambia los remitos imputados: para eso hay que anular y rehacer. Bloqueado si la factura ya fue pagada.
• Anular factura: soft-delete con motivo obligatorio y doble confirmación. La factura queda ANULADA y libera los remitos (vuelven a estar disponibles para facturar). No se puede anular una factura ya pagada (primero hay que anular la liquidación).

C.3 · Liquidación / Pago (paso a paso)

Pagar una o varias facturas pendientes, con control de pallets.

1. Hub Flete Largo → «Liquidación / Pago».
2. Transporte (buscador) → «Ver Facturas Pendientes».
3. Paso 2 — Facturas: se listan las facturas en estado pagable de ese transporte. Badges:
   • OK: lista para pagar.
   • NO PAGAR: tiene NC pendiente — hay que regularizar primero.
   • BLOQUEADA (N sin conf.): tiene remitos sin conformar — se puede desbloquear (pago excepcional) con doble confirmación y motivo obligatorio.
   Se pueden exportar todas a Excel. Se tildan las facturas a pagar → «Siguiente: Control de Pallets».
4. Control de Pallets (ver «El balance de pallets»).
5. Resumen: total, observaciones y N° de Orden de Pago (formato libre, ej. OP-2026-123) o tilde «Cargar OP Luego». «Finalizar y Guardar»: se crea la liquidación LF…, las facturas pasan a PAGADA y quedan atadas a esa liquidación.

El balance de pallets (paso de «Control de Pallets»)

Antes de cerrar una liquidación de Flete Largo se concilia la cuenta corriente de pallets con el transporte:

• Debe (rojo): pallets que salieron de planta en esos viajes (lo que el transporte se llevó).
• Haber (verde): créditos disponibles para compensar — los Vales en cartera (tienen prioridad) y los recuperos físicos (ingresos de pallets), ordenados del más viejo al más nuevo (FIFO). Se tildan los créditos a usar.
• Balance final: el sistema calcula el saldo y muestra el escenario:

Al finalizar, los vales usados pasan a LIQUIDADO, los recuperos físicos quedan atados a la liquidación y se ajustan los snapshots de pallets. En Flete Corto este paso se saltea (va directo del listado al resumen).

D · Movimiento de Bolsas a 3ros (paso a paso)

Liquidación a terceros por el trabajo físico sobre bolsas: estiba, paletizado, trasbordo. Tiene su propio tarifario histórico y tres pestañas.

D.1 · Cuadro Tarifario (línea de tiempo de precios)

Los conceptos base son «3ro - Pallet», «3ro - Estiba» y «3ro - Trasbordo». Cada concepto tiene una línea de tiempo de precios (modelo histórico): se «Administra» el concepto y se agregan variaciones de tarifa con fecha de vigencia; el sistema recalcula automáticamente hasta cuándo rigió cada precio. Así, una liquidación de marzo aplica el precio que regía en marzo, aunque hoy el precio sea otro.

D.2 · Nueva Liquidación

1. Pestaña «Nueva Liquidación». Elegí Desde / Hasta (máximo 30 días de rango) y «Buscar Movimientos».
2. Se listan los movimientos con su concepto de gasto, bolsas (50 kg) y la tarifa histórica que aplicó automáticamente según la fecha del movimiento. La columna «Tarifa» se puede editar manualmente; los conceptos «Otros» exigen cargar una tarifa > 0.
3. Se tildan los movimientos (o «seleccionar todo»). Abajo se ven Seleccionados, Total Bolsas y Total a Liquidar en vivo.
4. «Confirmar» → resumen con el total. Se ingresa el N° de Factura o se tilda «Pendiente».
5. Confirmar liquidación: se genera el ID tipo LIQB-000005 en estado CERRADA y cada movimiento queda atado (liquidacionBolsaId) con su tarifa y subtotal congelados; ya no se puede volver a liquidar.

D.3 · Historial y Facturas

• Imprimir la liquidación.
• Cargar Factura: para las que quedaron «Pendiente Factura», se carga el N° después.
• Anular: confirma, marca la liquidación como ANULADA (queda visible para trazabilidad) y libera todos los movimientos asociados (vuelven a estar disponibles para liquidar; se les borra la tarifa y el subtotal aplicados).

Modificar la tarifa de un viaje («Sin Precio»)

En Flete Corto y Largo, un viaje sin tarifa no se puede seleccionar (badge Sin Precio / Sin tarifa). El botón «Modificar Tarifa» de la fila abre un cuadro con la tarifa actual (solo lectura) y un campo «Nueva Tarifa ($ / tonelada)» que muestra un subtotal estimado en vivo. Al guardar, la nueva tarifa queda escrita en ese movimiento (con quién y cuándo la editó) y el viaje ya se puede liquidar. Es un ajuste manual sobre el viaje puntual; no toca el Tarifario general.

Historial de Liquidaciones

En el hub, debajo de las tarjetas, está el historial de todas las liquidaciones (Corto y Largo), con filtro por transportista (buscador inteligente). Cada fila muestra ID, fecha, tipo (Corto / Largo), transportista, monto y estado del documento.

• Ver Detalle: viajes incluidos, kilos/bolsas, subtotales y observaciones (solo consulta).
• Imprimir PDF de la liquidación.
• Cargar OP / Cargar Factura: si quedó pendiente el documento, se completa desde acá (la fila lo muestra como «Pendiente» hasta cargarlo).
• Eliminar / Anular: revierte la liquidación.

Flujo de datos (resumen por acción)

Tarifario de Fletes

El Tarifario de Fletes es la base de precios de transporte de todo el sistema. Cada tarifa es un precio $/Tn para una combinación de transportista + destino + tipo de operación (VENTA/salida o COMPRA/ingreso). De acá salen los fletes que se autocompletan en pedidos, órdenes de carga y movimientos de stock. Tiene cuatro solapas: Consulta, Análisis Tarifario, Mapa y Cotización. Roles 1, 2, 3 y 5.

Conceptos base (imprescindible)

Cómo se calcula la vigencia (el badge de colores)

Toda la app usa la misma regla de vigencia. Sobre la edad efectiva (mínimo entre modificación y uso):

Solapa «Consulta» — buscar y mantener tarifas

Es una búsqueda on-demand (no carga todo de entrada, para no gastar lecturas): hay que filtrar por al menos un criterio — Transporte, Provincia o Localidad (la localidad se cascada por provincia) — más opcionalmente el Tipo (VENTA/COMPRA). Resultados paginados de a 20, ordenados por valor.

La «cascada de tarifa efectiva»

Si la búsqueda exacta no encuentra nada, el sistema no devuelve vacío: cae por una cascada y marca el origen con un badge para que se sepa qué tan confiable es el número:

1. EXACTA — tarifa puntual de esa localidad + transporte. Sin badge: es la buena.
2. Otros transportistas — misma localidad, otra empresa (badge REFERENCIA).
3. ZONAL — tarifa cargada sobre la zona de esa localidad para ese transporte.
4. REFERENCIA de zona — tarifas de localidades hermanas de la misma zona.
5. ESTIMADA — no hay nada cargado: se calcula con el modelo km·$/Tn (ver Análisis). Solo para tipo salida.

Alta / edición de una tarifa

Botón flotante + (abajo a la derecha, solo en Consulta) o el lápiz de una fila EXACTA. Se elige Transporte, Provincia → Localidad (cascada), Tipo de servicio (VENTA/COMPRA) y Valor $/Tn.

Solapa «Análisis Tarifario» — inteligencia y control

Es el panel de control de salud del tarifario. Cruza cada localidad con su distancia al origen logístico (Depósito Arcadia, Tucumán), su zona, su última tarifa y su vigencia. Sirve para encontrar huecos (sin tarifa, sin zona, sin km), precios viejos y valores fuera de norma.

• Enriquecer (lat/lng/km) — geocodifica las localidades faltantes (OpenStreetMap, 1 req/seg) y calcula los km desde Arcadia. Es el insumo de todo lo demás: sin km no hay análisis ni estimación.
• Auto-asignar Zonas — sugiere y aplica una zona tarifaria según la distancia, usando bandas estándar: Z1 Local (≤50 km), Z2 NOA (≤300), Z3 Centro (≤800), Z4 AMBA (≤1300), Z5 Patagonia (resto).
• Tabla por localidad — km, zona actual, zona sugerida (botón para aplicarla), última $/Tn, edad, $/Tn·Km y estado de vigencia. Filtros rápidos: sin zona, sin km, sin tarifa, pronto a vencer, vencidas, outliers.
• Dispersión $/Tn vs Km — gráfico con una recta de regresión y = a + b·km ajustada sobre todas las tarifas vivas. Los puntos a más de 2σ de la recta se marcan outliers (naranja): son tarifas anómalas para su distancia — demasiado caras o demasiado baratas. Se puede hacer zoom arrastrando un rectángulo.

Solapa «Mapa» — cobertura geográfica

Mapa interactivo (Leaflet/OpenStreetMap) centrado en Arcadia. Cada localidad con coordenadas es un pin de color por vigencia (verde / amarillo / rojo / gris sin tarifa); los outliers se ven más grandes. Líneas opcionales hacia Arcadia y filtros por estado (vigentes, pronto a vencer, vencidas, sin tarifa, sin zona). Al tocar un pin se ve la localidad, su última tarifa, edad, zona y km. Es la forma rápida de ver dónde tenemos huecos de tarifa en el país.

Solapa «Cotización» — tarifa comercial

Tarifas comerciales de flete largo, separadas de la operativa (tarifas_cotizacion). Cada documento agrupa una o varias localidades con un precio por tonelada plano. Las usa el Cotizador como costo de distribución al cliente.

• Carga por localidad (flujo natural): el modal arranca pidiendo una sola localidad + precio; el nombre es opcional (se autocompleta). «Agrupar más localidades» despliega el multi-selector para cubrir varias con un precio plano único.
• Referencia de precios: al elegir una localidad puntual se muestran las últimas 3 tarifas operativas reales de esa localidad, con un botón para usar el promedio como precio sugerido.
• Bootstrap AMBA: las localidades de AMBA (≤80 km de CABA) se precargan automáticamente con un solo botón.
• La actualización es 100% manual: ningún despacho la mueve (a diferencia de la operativa).

El uso de la Tarifa en el proceso (con ejemplos)

Una tarifa cargada acá no se queda quieta: el sistema la busca y autocompleta sola en cada etapa donde hay un flete. Estos son los tres puntos donde aparece, en orden del circuito comercial.

1) En un Pedido de venta

Al cargar el pedido todavía no se sabe el transporte ni la tarifa: el pedido nace con valorTarifa: 0 y tarifaPendiente: true. El Tarifario no interviene en esta etapa — es esperado que el flete esté en cero en el pedido recién creado. La tarifa se resolverá cuando ese pedido se convierta en Orden de Carga.

2) En la Orden de Carga (asignación de logística)

Cuando el pedido pasa a Pendientes y se le asigna transporte, el sistema busca automáticamente la tarifa de VENTA para transporte + provincia + localidad del cliente:

1. Si existe: autocompleta el valor y muestra un badge de vigencia (✔ Vigente / ⚠ Nd sin actualizar / 🔴 revisar).
2. Si no existe: avisa «⚠ Sin Tarifa» y ofrece un panel con las tarifas de otros transportistas de esa misma localidad como referencia (clic para usar ese valor).
3. Al guardar la logística, según el checkbox «Actualizar Tarifario Maestro»:
   • Tildado → guarda el valor + updatedAt (el usuario corrigió el precio); si no existía, la crea.
   • Sin tildar → solo sella lastUsedAt = ahora: no cambia el precio, pero la tarifa vuelve a contar como vigente por uso.

3) En un Movimiento de Stock

En el formulario de un movimiento (despacho o recepción), al completar transporte + provincia + localidad el campo Tarifa $/Tn se llena solo según el tipo de servicio del movimiento (salida = VENTA, ingreso = COMPRA), con un fallback de 2 niveles:

1. Nivel 1 — Localidad exacta: «✔ Vigente (Loc)».
2. Nivel 2 — Zona: si la localidad tiene zona y hay tarifa zonal para ese transporte → «🔗 Zona X».
3. Nivel 3 — Sin tarifa: «⚠ Sin tarifa», el valor queda en 0.

El campo arranca bloqueado (candado) para no pisar el valor del tarifario por error. El botón candado activa modo manual (vale solo para ese viaje); si se cambia el número, aparece el botón guardar 💾 para impactar el cambio en el Tarifario Maestro (actualiza la tarifa existente o crea una nueva para esa combinación). Si el movimiento está atado a una liquidación de flete, el campo queda bloqueado para no descuadrarla.

El estimador inteligente (cuando no hay tarifa)

Para tipo VENTA, cuando no hay tarifa cargada el sistema puede estimar un valor con una cascada de 7 prioridades (PPP ponderado por recencia — lo reciente pesa más):

Escenarios típicos

Errores y validaciones comunes

Flujo de datos

ABM Maestros

ABM Maestros es el alta, baja y modificación de los catálogos base del sistema. Todo lo que se carga acá alimenta los buscadores inteligentes (smart selectors) y los desplegables del resto de los módulos: un cliente que no existe en ABM no se puede elegir en un pedido; un transporte que no está cargado no aparece en una orden de carga. Es, literalmente, la base de datos sobre la que se apoya todo lo demás. Roles 1, 2, 3 y 5. Se accede desde la barra lateral, área Administración → ABM Maestros.

El panel principal y cómo se navega

Al entrar se ve un tablero con 7 tarjetas, una por catálogo. Se hace clic en una tarjeta para entrar a su pantalla propia; cada pantalla tiene su botón «Volver» que regresa al tablero. Arriba a la derecha, el botón «Recargar» recarga la página completa (útil si otra persona cargó datos y no los ves).

1 · Propietarios

Un propietario es un dueño de stock: incluye clientes con mercadería propia en planta, cañeros (productores que entregan caña/azúcar) y comitentes (consignación). Es distinto de «Destinos/Clientes» (ver más abajo): acá se modela de quién es la mercadería, no a dónde se entrega.

Alta / edición paso a paso

1. Botón «Nuevo» (o clic en el lápiz de una fila para editar). Se abre el formulario.
2. Nombre / Razón Social obligatorio: se guarda siempre en MAYÚSCULAS automáticamente. Ej.: INGENIO SAN JUAN S.A.
3. CUIT: formato sugerido 30-12345678-9. Es la llave del cruce Flexxus, conviene cargarlo bien.
4. Correo Electrónico: opcional.
5. Domicilio Fiscal (tarjeta azul): Calle/Ruta, Nro, Provincia (buscador inteligente) y Localidad (buscador inteligente que se habilita recién al elegir provincia y queda filtrado por ella), y C.P.
6. «Guardar». El registro aparece ordenado alfabéticamente en la tabla al instante.

2 · Depósitos

Ubicaciones físicas donde se almacena mercadería (planta, depósito externo, cámara). Es el catálogo más simple: solo el Nombre (obligatorio, en mayúsculas). Mismo esquema de tabla con buscador, «Nuevo», editar (lápiz) y eliminar (tacho), con confirmación. Alimenta el desplegable de depósito en Movimientos y Stock.

3 · Artículos

El catálogo de productos de azúcar. Es el más rico en campos porque de acá salen el EAN para importar OC, los códigos para cruzar con Flexxus y la presentación para convertir bultos ↔ kilos.

La pantalla tiene buscador (por nombre, tipo o categoría) y tres filtros: Tipo, Presentación y Categoría, más un botón para limpiarlos. Cada fila muestra miniatura, nombre, EAN, tipo, presentación y categoría. Un clic en cualquier parte de la fila (fuera de los botones) abre el detalle de solo lectura; desde ahí hay un botón «Editar».

Formulario de artículo paso a paso

1. Imagen del producto (opcional): JPG/PNG/WebP, hasta 5 MB. Se redimensiona a 400 px y se comprime al subir. Botón «Cargar imagen» / «Reemplazar» y «Quitar imagen».
2. Nombre obligatorio. Ej.: Azúcar Ledesma Refinada 1kg.
3. EAN13 (unidad): exactamente 13 dígitos numéricos. DUM14 (caja): exactamente 14 dígitos. Si se carga algo y no cumple el largo exacto, el sistema rechaza el guardado con aviso.
4. Códigos Flexxus (tarjeta ámbar): uno o varios. Se escribe el código y se hace «+ Añadir» (o Enter); aparece como chip que se puede quitar con la ×. Solo letras, números, _ y -, hasta 15 caracteres, se guardan en mayúsculas. Sirven para vincular las ventas que llegan desde Flexxus.
5. Kg por unidad Flexxus: por defecto 1. Solo se cambia si Flexxus factura por una unidad sub-kilo (ej. presentación 500g → 0.5; 1kg o bolsas → 1).
6. Tipo de Azúcar: Común tipo "A" · Refinada · Orgánica.
7. Presentación: bolsa 25 kg · bolsa 50kg · big bag · 1kg · 500g · N/A.
8. Categoría: MP (Materia Prima) o PT (Producto Terminado).
9. Artículo genérico (comodity) (casilla ámbar): marcar solo para el caso de la bolsa 50 kg sin marca. Un genérico se usa en el pedido cuando todavía no se sabe la marca; no tiene stock propio, queda excluido de los reportes de stock y la marca real se elige obligatoriamente al armar la Orden de Carga (ver el módulo Pedidos & Ventas).
10. «Guardar». Si subiste imagen, primero crea el artículo y después sube/reemplaza la foto.

4 · Destinos (Clientes)

Acá se administran los clientes a los que se les vende y entrega: razón social, CUIT, equipo comercial asignado y, lo más importante, sus sucursales de entrega. Es el catálogo que alimenta el buscador de cliente en Pedidos, Cotizaciones y la importación de OC.

Filtros de la pantalla: buscador (por nombre, CUIT o nombre de fantasía) y casilla «Ver Inactivos». El botón «group_add» (👥+) permite dar de alta un comercial nuevo al vuelo (pide nombre y % de comisión, default 2 — lo usa Líquidos Productos). Por cada cliente hay tres acciones: Ver detalle (👁), Editar (✏️) y Eliminar/Inactivar (🗑) o Reactivar si está inactivo.

Formulario de cliente paso a paso

1. Razón Social obligatorio (en mayúsculas). Ej.: SUPERMERCADOS LA ANÓNIMA S.A.
2. CUIT y Nombre Fantasía (alias comercial; se usa también para buscar el cliente, ej. «El Super del Centro»).
3. Email Notificaciones y Comerciales Asignados (uno o varios — casillas; el primero queda como comercial principal).
4. Domicilio Fiscal: Calle/Ruta, N°, Provincia (desplegable), Localidad (desplegable dependiente de la provincia) y CP.
5. Sucursales de Entrega — al menos una obligatoria. Por cada sucursal, con «+ Agregar»:
   • Nombre Sucursal, Provincia y Localidad (obligatorios para que la fila se guarde).
   • GLN (13 dígitos): el Global Location Number GS1 que identifica esa sucursal en las órdenes de compra electrónicas (Planexware). Es la llave del match automático de Importar OC.
   • Datos F3000: Dirección de entrega, Nro, C.P. y KM viaje (kilómetros usados para tarifas/fletes).
6. «Guardar Cliente».

5 · Geografía (Provincias · Zonas · Localidades)

Pantalla de tres columnas. La geografía es la base de los domicilios y, sobre todo, de las zonas tarifarias que usa el Tarifario de Fletes.

Cada columna tiene su propio buscador. Las localidades muestran su provincia y, si tiene, un badge con la zona. Localidades se puede editar (lápiz) y todo se puede eliminar con confirmación. Asociar la Zona Tarifaria a la localidad es lo que permite que el cotizador y el flete encuentren la tarifa por zona.

6 · Logística (Transportes y Choferes)

Pantalla de dos paneles: a la izquierda las Empresas de transporte, a la derecha los Choferes & Patentes. De acá salen el transporte y el chofer que se eligen en una orden de carga, y el WhatsApp al que el sistema avisa el viaje.

Empresa de transporte

1. Botón + del panel «Empresas».
2. Razón Social obligatorio (en mayúsculas), CUIT, Localidad, C.P. y Provincia.
3. «Guardar». Se actualiza también el desplegable de transportes del resto del sistema.

Chofer paso a paso

1. Botón + del panel «Choferes».
2. Empresa de Transporte obligatorio (buscador inteligente).
3. Nombre y Apellido obligatorio (mayúsculas) y DNI.
4. Celular (WhatsApp): se escribe solo código de área + número, sin 0 ni 15 (ej. 381 4123456). El sistema agrega solo el prefijo internacional de Argentina y guarda 549381..., listo para enviar el aviso por WhatsApp.
5. Patente Tractor/Camión y Patente Acoplado/Semi (se guardan en mayúsculas).
6. «Guardar Datos».

7 · Insumos

Materiales y envases que consume la producción de azúcar (hilo, bolsas, etiquetas, repuestos). No son los insumos de la División Polvos: esos tienen su propio ABM (ver «ABM (Polvos)»).

1. Botón «Nuevo Insumo».
2. Nombre obligatorio (ej. Hilo de coser).
3. Tipo: Primario (MP) · Secundario (Envases) · General · Mecánico.
4. Unidad (U.M.): un · kg · lt · mts.
5. Stock Mínimo: dispara las alertas de reposición.
6. Vinculado a Artículo (PT): relaciona el insumo con un producto terminado. Se deshabilita automáticamente si el tipo es General o Mecánico (esos no requieren vínculo).
7. Valor (Costo USD): con hasta 4 decimales.
8. «Guardar». Filtros disponibles: Tipo, Unidad y Vínculo.

Caché y propagación de cambios

Flujo de datos

Recursos Humanos

Recursos Humanos es el módulo de gestión de personal de planta: asistencia, horarios, disciplina, licencias, turnos adicionales, pre-liquidación de haberes, indicadores y comunicaciones (incluido el envío de recibos por WhatsApp). Solo rol 1 (Gerente). Es uno de los módulos más extensos del sistema; abajo se documenta cada solapa, sub-vista, acción y escenario.

Estructura general

La barra superior tiene seis solapas (switchRRHHTab): Importar, Horarios, Novedades, Licencias, Gerencia y Comunicaciones. «Gerencia» y «Comunicaciones» son a su vez hubs con varias sub-vistas internas.

El circuito mensual (visión de conjunto)

1. Importar la asistencia del período (fichadas del reloj).
2. El sistema la consolida contra los horarios y clasifica cada día (trabajado, tardanza leve/media/grave, ausente justificado/injustificado, licencia).
3. Se cargan novedades (sanciones, cortes de luz), licencias y turnos adicionales que ajustan el cálculo.
4. En Gerencia → Pre-Liquidación se revisan los haberes y se cierra el período.
5. En Comunicaciones → Recibos se publican los recibos de sueldo a cada empleado por WhatsApp.

Solapa «Importar»

Sube el archivo de fichadas (reloj/Excel) del período y lo consolida contra los horarios definidos, generando rrhh_asistencia_consolidada y marcando excepciones (días con desvío respecto del horario teórico).

Empleados y Horarios

El modal de empleado (alta/edición) se usa desde esta solapa:

1. Nuevo / Editar empleado: nombre, datos y, sobre todo, ID de Reloj (la clave que vincula al empleado con sus fichadas) y su horario asignado.
2. Al guardar, valida que el ID de Reloj no esté duplicado en otro empleado (consulta rrhh_empleados por id_reloj).
3. Los selectores de empleado en todo el módulo filtran a los dados de baja.

Solapa «Novedades»

• Sanciones rápidas (el centro completo está en Gerencia → Sanciones).
• Cortes de luz: modal de alta; se muestran limitados a los últimos 3 para no ensuciar la vista.
• Otros eventos del personal del día.

Solapa «Licencias»

Gestiona licencias con sub-pestañas (Activas / Histórico) y maneja feriados. Hay licencia Individual (un empleado, con smart selector) y Global (afecta a todos, p. ej. feriado/parada de planta), separadas a propósito. Las licencias impactan la consolidación de asistencia y la liquidación.

Solapa «Gerencia» (hub de Capital Humano)

Es un hub con seis sub-vistas:

Reportes / Dashboard

Indicadores con tarjetas y drill-down (clic para ver el detalle por empleado): Presentismo (% blando y % duro), Impuntualidad (cantidad de tardanzas), Caídos (ausencias), Horas plus (minutos extra netos, ya descontando lo que no cuenta como extra) y Skills. Se computa cruzando asistencia consolidada, sanciones y licencias del período.

Legajos

Ficha de cada empleado con su historial (ID de reloj, datos, antecedentes).

Sanciones (Centro de Disciplina)

1. Feed de sanciones con buscador por empleado y un gráfico por tipo de sanción.
2. Wizard de Sanción: se elige el empleado, el motivo (con textos legales pre-redactados, p. ej. ausencia injustificada) y la fecha del fichaje que la motivó. El texto es editable antes de emitir.
3. Genera el documento de la sanción/apercibimiento (que luego puede descontar puntaje de conducta según Parámetros).

Turnos Adicionales

Tareas fuera de la jornada (mantenimiento, limpieza) que no cuentan como horas extra: son control horario.

1. Nueva asignación de turno adicional a un empleado (tipo de turno tomado de Parámetros).
2. Registrar día sobre una asignación activa: Caso A (la tarea se hace al fin del turno) y Caso B (el empleado se retira y vuelve más tarde), con asentamiento manual.
3. Listas de Asignaciones activas e Histórico; se puede editar o eliminar una asignación.

Pre-Liquidación de Haberes

1. Abre un modal con la tabla de haberes del período por empleado (días trabajados, licencias, ausencias, descuentos por conducta, plus, etc.).
2. Toma como base el último período cerrado (rrhh_liquidaciones_cerradas, ordenado por fecha de fin) y arma el actual.
3. Cerrar período: guarda el cierre definitivo en rrhh_liquidaciones_cerradas con su ID de período. Se puede ver o eliminar un cierre cargado.

Parámetros

Configuración del cálculo, en pestañas:

Solapa «Comunicaciones» (hub WhatsApp)

Cuatro sub-pestañas:

Flujo de datos

Configuración

Configuración agrupa la administración técnica del sistema. Solo rol 1 (Gerente). Pestañas: Internos y Externos (usuarios), Períodos (cierre contable), Herramientas (ajustes de stock y migración) y Mapeo Flexxus.

Usuarios — visión general

Es el control de quién entra al sistema y qué ve. Cada usuario tiene una cuenta real en Firebase Authentication (donde vive la contraseña, hasheada) y un documento en la colección users (donde viven el rol, el vínculo y el estado activo). Las dos primeras pestañas separan:

Alta de usuario

Botón «Nuevo Usuario» (crea según la pestaña activa).

Usuario interno

1. Nombre de usuario (login): con «Juan» se crea automáticamente la cuenta juan@moyco.com en Firebase Auth.
2. Contraseña inicial: la define el gerente (texto visible al crear). El usuario la cambiará desde Mi Cuenta después del primer ingreso.
3. Rol: Gerente / Administración / Producción / Ventas. Define qué módulos y permisos tendrá.

Cliente externo (rol 4)

1. Usuario (login) y contraseña inicial.
2. Email real del cliente.
3. Cuentas relacionadas: selección múltiple (Ctrl/Cmd + clic) de los propietarios cuyo stock podrá ver en el portal. Es obligatorio al menos una; sin vínculo el portal muestra «No tiene cuentas asociadas».

Contraseñas (claves)

• Al crear: la contraseña inicial la pone el gerente y se la comunica al usuario (verbal / WhatsApp).
• Mínimo 6 caracteres (regla de Firebase Auth).
• El usuario la cambia él mismo en Mi Cuenta (ver abajo).
• Si la olvida: el gerente la resetea (no se recupera la vieja, se genera una nueva temporal — ver abajo).

«Mi Cuenta» — el usuario cambia su propia clave

Cualquier usuario (interno o externo) tiene la pantalla Mi Cuenta para cambiar su propia contraseña. Pide:

1. Contraseña actual: se valida de verdad contra Firebase Auth (reautenticación). Si te dieron una clave temporal tras un reseteo, esa es la «actual».
2. Nueva contraseña (mín. 6, no puede ser igual a la actual) + confirmación. Hay botón 👁 para ver/ocultar.

Reseteo de contraseña (recupero gestionado)

En la fila del usuario, el ícono 🔑 (llave) «Resetear contraseña»:

1. Pide confirmación (avisa que la clave anterior dejará de funcionar al instante).
2. Llama a la Cloud Function resetPassword, que valida en el servidor que quien la invoca sea rol 1 (un usuario común no puede resetear a otros).
3. Genera una clave aleatoria de 12 caracteres, la aplica en Auth y la devuelve para mostrarla en un modal una única vez (con botón Copiar).
4. Esa clave no se guarda ni se vuelve a mostrar: se le pasa al usuario y este la cambia en Mi Cuenta (usándola como «contraseña actual»).

Usuario inactivo (baja y reactivación)

Un usuario no se borra: se da de baja (queda inactivo). Esto preserva la trazabilidad/auditoría y es reversible.

Editar perfil y rol

El ícono lápiz edita el perfil: en internos cambia el rol; en externos cambia el email y las cuentas vinculadas. No cambia la contraseña (en edición el campo de clave se oculta a propósito: la clave se cambia con Reset o desde Mi Cuenta).

Seguridad de acceso y sesión

Escenarios típicos (usuarios)

Errores y validaciones comunes

Ajustes de Stock (pestaña Herramientas)

Registra ajustes de stock (pérdidas, ganancias, mermas) sobre la composición del stock seleccionado. No genera un movimiento normal (MW): ajusta directamente la composición/saldo. Acción restringida a gerentes (si no, «Acceso denegado»).

Períodos (cierre contable)

Define hasta qué fecha está cerrado el período: los usuarios no pueden registrar movimientos con fecha igual o anterior. Soporta auto-cierre (bloquea automáticamente todo lo anterior a N días atrás) y un cierre manual adicional; si ambos aplican, prevalece la fecha más reciente. Configuración global, solo gerentes.

Mapeo Flexxus

Tabla que traduce cada cuenta contable de Flexxus a un tipo de venta de GS (propia / AZEF / consignación). El cruce Flexxus la usa para clasificar automáticamente los asientos según la cuenta del comprobante (ver capítulo Integración Flexxus).

Migración de Líneas (pestaña Herramientas)

Utilidad de una sola vez: recorre las colecciones endulzantes_* y asigna el campo linea a documentos viejos (por defecto EDULCORANTES) para separar Edulcorantes de Jugos. No se usa en la operación diaria; solo se corrió al introducir las líneas.

Flujo de datos

Portal del Cliente

El Portal del Cliente es la vista acotada para usuarios rol 4 (cliente externo). No ven la operación interna: solo lo suyo, y todo en solo lectura. Tres accesos: Mi Stock, Mis Órdenes y Mi Cuenta. Al ingresar, el sistema redirige al portal automáticamente.

Mi Stock

1. Muestra el stock que el cliente tiene en consignación/depósito (de stock_snapshots filtrado por las cuentas que Configuración → Usuarios le vinculó).
2. Botón «Ver Todo» para el detalle, e «Historial Consolidado» con opción de descargar Excel.
3. Si el usuario no tiene cuentas vinculadas, muestra «No tiene cuentas asociadas — contacte a la administración».

Mis Órdenes

Seguimiento de sus órdenes/entregas con el estado de cada una (en preparación, despachada, cumplida). Lee ordenesCarga y movimientos filtrados por ese cliente.

Mi Cuenta

Datos de la cuenta del usuario y cambio de contraseña.

Flujo de datos

100% lectura y siempre filtrado por el cliente logueado: el portal nunca muestra datos de otros clientes ni permite operar sobre el stock. La vinculación cliente ↔ cuentas de stock se administra en Configuración → Usuarios (usuario externo). La información es la misma que maneja la operación interna, recortada a lo que le corresponde.

Integración Flexxus (Bridge)

El sistema GS Moyco se integra con Flexxus (el ERP contable de la empresa, base Firebird) a través de un componente llamado Bridge. Esta integración es transversal: aparece en Compras (vincular una OCA con su OC de Flexxus), en el despacho desde Orden de Carga (cruzar contra la factura de Flexxus) y en la vinculación posterior desde el listado de movimientos. Este capítulo explica qué es, cómo se usa y todos los escenarios.

Qué es el Bridge y por qué a veces "no está disponible"

El Bridge es un servicio local en Python que corre en la PC del usuario (repositorio gs-flexxus-bridge) y expone la base de Flexxus al sistema web. No es parte del sitio: es un programa aparte que tiene que estar corriendo en esa computadora y con acceso a la red de Flexxus.

• Puede correr en distintos puertos según la PC (8770 o 8765); el sistema los prueba en orden y usa el primero que responde.
• Antes de cada operación se hace un chequeo de salud que devuelve si está online y si la base está accesible (db_ok).
• Si el Bridge no está corriendo (no instalado, dado de baja, PC sin conexión a la LAN de Flexxus), el sistema lo avisa y ofrece la carga manual como alternativa. Nunca se "rompe": simplemente no se puede cruzar/vincular hasta que el Bridge esté activo.

El "cruce" GS vs. Flexxus (coloreo verde / amarillo / rojo)

Cuando se listan facturas u OCs de Flexxus, cada una se cruza contra el contexto de GS (cantidades, precio, CUIT del proveedor/cliente, OCA). El resultado se muestra con colores y por línea:

El cruce usa tolerancias configuradas para kilos y para precio por kilo (no exige coincidencia exacta al gramo/centavo). Además clasifica el tipo de operación según el mapeo de cuenta contable (ver Configuración → Mapeo Flexxus): la cuenta del asiento define si es venta propia, AZEF o consignación.

Vincular / desvincular una OCA en Compras

En el detalle de una compra/OCA (módulo Compras & Consignación) hay dos botones ámbar: Vincular Flexxus y Desvincular Flexxus.

Vincular OC Flexxus

1. Botón «Vincular Flexxus». Si la compra ya está vinculada, avisa y no continúa.
2. Hace el chequeo de salud del Bridge. Si no está online o la base no responde, muestra el aviso y aborta.
3. Abre el selector de OC de Flexxus: muestra todas las OCs recientes, ya coloreadas según el cruce contra esta compra (kg, bolsas, precio por bolsa, CUIT del propietario, OCA). Las OCs ya vinculadas a otras compras se excluyen de la lista.
4. Al elegir una OC, el sistema guarda en la compra un bloque flexxusOC con: tipo, número, código de proveedor, razón social, CUIT, fecha de la OC, precio unitario sin IVA, marca de "vinculada posteriormente", fecha/hora y usuario que vinculó. Los datos de la compra GS no se modifican: solo se agrega la referencia.
5. Se reabre el detalle de la OCA mostrando el vínculo.

Desvincular OC Flexxus

1. Botón «Desvincular Flexxus». Si no está vinculada, avisa.
2. Pide confirmación, aclarando que los datos de la compra GS no se modifican.
3. Borra el bloque flexxusOC (queda en null). La OC vuelve a estar disponible para vincular en otra compra.

Cruce en el despacho desde Orden de Carga

Al despachar desde una Orden de Carga (Ventas → En Carga → Despachar → Paso 0.5 «Vincular venta de Flexxus»), si el Bridge está online el sistema ofrece cruzar contra la factura de Flexxus. El paso a paso completo y todos los escenarios están en el capítulo «Pedidos & Ventas» → Despacho; acá se muestran las pantallas:

1. Chequeo de salud → trae las facturas recientes filtradas por el CUIT del cliente. Rango 3/7/30 días. Botones 👁 Ver (solo inspección) y Vincular →.
2. Se elige la factura → trae su detalle → se calcula el cruce N×M (varias líneas GS contra varias líneas Flexxus, agregando por artículo).
3. El modal de detalle muestra los 4 controles con coloreo: 1·Tipo (informativo), 2·Cantidad kg y 3·Precio $/kg (bloqueantes, tolerancia 1 kg / $0,01), 4·Chofer + Patentes (informativo).
4. «Confirmar y cargar» queda bloqueado si hay desvío de kg/precio o si el CUIT no matchea. Al confirmar, el movimiento de stock queda con un snapshot completo de la factura Flexxus + el resultado de los controles, y se autocompletan/bloquean los campos Factura y Remito.

Vinculación posterior de factura (posthoc) desde Movimientos

Si un despacho se hizo sin Bridge (estaba caído) o la factura todavía no estaba emitida, después se puede asociar desde el listado de Movimientos de Stock: el flujo es idéntico al del despacho (salud → facturas → detalle → los 4 controles → confirmar), reconstruyendo el contexto N×M a partir de los movimientos «hermanos» del mismo viaje. Son exactamente las mismas dos pantallas de arriba («Facturas recientes en Flexxus» y el detalle con los 4 controles); cambia solo el punto de entrada.

Flujo de datos

División Polvos — Conceptos

La División Polvos es el segundo negocio del sistema, en paralelo al de Azúcar. Se entra desde el selector Azúcar / División Polvos arriba a la derecha: al cambiar, todo el sistema pasa al tema verde y muestra los módulos de Polvos (Inicio, Pedidos/Ventas, Movimientos, Stock, Producción, Calidad y ABM propios).

Cómo funciona el selector de línea (pill)

En cada módulo de Polvos hay un selector tipo pill Edulcorantes / Jugos (arriba de la pantalla o en el sidebar). Es el control más importante de la división:

• Acota todo lo que se ve y se carga a esa línea: el listado, los KPIs, el buscador de artículos, el alta de pedidos/movimientos, etc.
• Al crear algo (un pedido, un movimiento, una producción), queda marcado con la línea activa en ese momento. Cargar en la línea equivocada es el error más común — verificá el pill antes de guardar.
• Cambiar el pill recarga la vista con los datos de la otra línea (no se mezclan).

Conceptos clave (válidos para todos los módulos de Polvos)

Inicio (Polvos)

Inicio (División Polvos) es el tablero de la división: stock de producto terminado, demanda pendiente, planificación activa, alertas de insumos y stock por línea. Vista de consulta. Roles 1, 2, 3 y 5. Tema verde.

Cómo se usa

El selector Edulcorantes / Jugos (pill superior) acota todos los indicadores a esa línea. Tarjetas:

Flujo de datos

Lee endulzantes_articulos, endulzantes_insumos, endulzantes_movimientos, endulzantes_pedidos y las órdenes de producción para armar los KPIs por línea. No escribe: refleja lo cargado en los módulos de Polvos.

Pedidos/Ventas (Polvos)

Pedidos/Ventas (División Polvos) es el circuito comercial completo de Endulzantes y Jugos: desde que se carga un pedido hasta que la mercadería sale físicamente y el pedido queda cumplido. Este capítulo está escrito para que una persona que no conoce la empresa pueda hacer un despacho de principio a fin. Roles 1 (Gerente) y 5 (Comercial) ven todo incluido «Nuevo Pedido»; otros roles entran directo a «Pendientes». Trabaja por línea (pill Edulcorantes / Jugos en el sidebar verde).

Conceptos base (leer antes de operar)

Paso 1 — Nuevo Pedido

En el sidebar, «Nuevo Pedido» (solo roles 1 y 5). Se completa en orden:

1. Cliente: buscador inteligente por nombre o CUIT. Al elegirlo se autocompleta el ejecutivo comercial y se cargan sus sucursales.
2. Sucursal / Planta de entrega: si el cliente tiene una sola, se preselecciona. Al elegirla se llenan solas la provincia y localidad de destino.
3. Orden de Compra / Referencia del cliente (opcional pero recomendado) y fecha de nota.
4. Agregar mercadería (panel verde): buscar el artículo, poner la cantidad (en cajas si el producto va en caja — el sistema avisa «CONTENIDO: N por caja») y el precio unitario. Botón «Agregar»: el ítem cae al carrito. Repetir por cada producto.
5. El pie calcula Base imponible, IVA 21% y Total automáticamente. Se fija el plazo de cobro en días (default 30).
6. «Generar Pedido» → pide confirmar el total → crea el pedido con número PVE-XXXXXX en estado AUTORIZADO y lleva a «Pendientes».

Paso 2 — Pendientes (bandeja de entrada)

Lista los pedidos AUTORIZADOS sin orden de carga de la línea. Es la vista por defecto del módulo. Por fila se puede:

El botón clave es «Generar Orden de Carga» (Mesa de Control), que arma el viaje.

Generar la Orden de Carga (OCE) — Mesa de Control

1. Cliente: el desplegable solo muestra clientes con pedidos pendientes.
2. Aparecen los ítems pendientes de ese cliente. Se tildan los que van en este viaje y se pone cuántas cajas de cada uno (se puede cargar menos que lo pedido: el resto queda pendiente — «split»).
3. Logística obligatoria: fecha de carga, empresa de transporte y chofer. Opcionales: fecha/hora de descarga, turno, patentes, tarifa $/Tn y observaciones.
4. Confirmar → genera el número OCE-XXXXXX, asigna esa logística y mueve los pedidos a EN_CARGA. Los pedidos cargados completos pasan enteros; los parciales se parten (lo que viaja a EN_CARGA, el resto sigue AUTORIZADO).

Paso 3 — En Carga (bandeja de salida)

Muestra las órdenes de carga (agrupadas por OCE) de la línea, con cliente, detalle consolidado (en cajas y unidades) y logística. Acciones por orden:

Paso 4 — El Despacho (Picking de lotes) · capítulo crítico

Esta es la operación que da de baja el stock. Hasta acá nada salió del inventario; recién al confirmar el despacho la mercadería «sale». Seguí estos pasos exactamente.

1. En En Carga, botón verde «Confirmar Despacho» (📤) de la orden. Abre el modal «Picking de Carga: OCE-XXXXXX».
2. Por cada producto el modal muestra cuánto hay que cargar (REQUERIDO, en cajas) y una fila de lote. El sistema ya sugiere un lote con stock suficiente y completa la cantidad (sugerencia automática tipo FIFO) — solo hay que verificar que el lote coincida con lo que físicamente se está cargando.
3. Si la mercadería sale de varios lotes, botón «Añadir Lote» y se reparte la cantidad entre ellos. Cada lote muestra su stock disponible (en cajas).
4. El indicador de cada producto debe quedar en verde «Completo» (lo asignado = lo requerido). Si dice «Faltan N» o «Excede», ajustá las cantidades. No se puede asignar más que el stock del lote.
5. «Confirmar Salida»: el sistema valida todo y salta al formulario de Movimiento de Producto ya precargado y bloqueado (cliente, transporte, chofer, destino, ítems y lotes vienen heredados de la orden).
6. En ese formulario, revisar y presionar «Confirmar»: se registra el movimiento de egreso. El servidor recalcula el stock (baja del lote elegido) y el pedido pasa a CUMPLIDO.

Paso 5 — Cumplidos (Historial) y Devolución

Lista los pedidos CUMPLIDOS de la línea. Es consulta; además permite la devolución de cliente (roles 1, 2, 3, 5) con el botón ↩️.

Devolución de cliente

1. ↩️ en el pedido cumplido → modal de devolución multi-renglón (se puede devolver uno o varios productos del pedido).
2. Por cada renglón se confirma el lote al que vuelve la mercadería y la cantidad.
3. Al confirmar, el sistema crea movimientos con tipo_movimiento: "DEVOLUCION" (que el servidor trata como ingreso y repone stock), actualiza la cantidad devuelta acumulada del movimiento de salida original y deja un documento resumen en endulzantes_devoluciones_ventas.

Escenarios típicos

Errores y validaciones comunes

Flujo de datos

Movimientos (Polvos)

Movimientos de Stock (División Polvos) es el libro mayor de inventario de Endulzantes y Jugos: cada entrada, salida, ajuste, devolución y despacho queda registrado acá. El stock no se edita nunca a mano — se registra un movimiento y el servidor recalcula. Este capítulo explica todas las funciones de la pantalla, una por una, con ejemplos. Roles 1, 2, 3 y 5. Trabaja por línea (pill Edulcorantes / Jugos).

Conceptos base

La pantalla y cómo se navega

1. Pill de línea (Edulcorantes / Jugos): cambia la línea activa y recarga el listado desde el servidor.
2. Tabs Insumos / Productos: cambian la tabla y también qué crea el botón verde (Registrar Insumo o Registrar Producto).
3. Buscador: filtra sobre lo ya descargado (nombre, N° MED, cliente, remito, factura, proveedor).
4. El listado trae 20 movimientos por página (botón «Cargar 20 más»), ordenados por fecha. Cada fila se colorea: verde ingreso, rojo salida, ámbar devolución.
5. Clic en una fila → detalle del movimiento (ver más abajo).

Botones de la barra superior

Registrar Movimiento de Insumo

Pestaña Insumos → «Registrar Insumo». Campos:

1. Tipo: 📥 Compra (Entrada) = INGRESO, o 📤 Devolución (Salida) = EGRESO.
2. Fecha del movimiento.
3. Insumo: buscador inteligente (endulzantes_insumos). Al elegirlo se muestra su unidad de medida.
4. Cantidad en la unidad del insumo.
5. Proveedor / Destino: buscador del ABM de proveedores (endulzantes_proveedores, lista compartida entre las dos líneas). Si no está, se acepta texto libre.
6. Factura y Remito (formato N°: 5 + 8 dígitos), Lote del proveedor y observaciones.
7. Confirmar Movimiento → genera MED-XXXXXX. Si es EGRESO, antes de crear valida que el lote/total tenga saldo (no permite negativo).

Registrar Movimiento de Producto

Pestaña Productos → «Registrar Producto». Campos:

1. Tipo: 📤 Salida (venta/envío) o 📥 Ingreso (devolución/producción).
2. Fecha y Destino / Procedencia (buscador de destinos).
3. Producto (buscador) y Lote:
   • Si es Ingreso: el lote es un campo de texto (lote nuevo).
   • Si es Salida: el lote es un selector con los lotes que tienen stock (no se puede sacar de un lote vacío).
4. Cantidad (en cajas o unidades según el producto).
5. Carga Múltiple (checkbox): permite varios productos/lotes en un mismo movimiento (tabla de ítems).
6. Logística: transporte, chofer, provincia, localidad y Tarifa $/Tn (se autocompleta desde el Tarifario al elegir localidad).
7. Remito / Orden / Factura (split 5+8), Ref. interna, ajuste de Pallets (+/-) y observaciones.
8. Confirmar → registra el movimiento; el servidor recalcula stock y lotes.

El Despacho llega acá (Picking)

Cuando en Pedidos/Ventas → En Carga se confirma un despacho, el Picking de lotes y el formulario precargado son de este módulo: el sistema arma el movimiento de SALIDA con los lotes elegidos (sugerencia FIFO, conversión cajas↔unidades) y al confirmar baja el stock. El paso a paso completo del despacho está en el capítulo Pedidos/Ventas (Polvos); acá solo cae el movimiento resultante, que queda como una salida más en el listado.

Ver el detalle de un movimiento

Clic en cualquier fila. Muestra cantidad y tipo, fecha, ID, proveedor/destino, factura, remito y lote, y las observaciones. Desde acá:

• Ver Trazabilidad (solo productos con lote real): abre la trazabilidad del lote (de dónde salió, a dónde fue).
• Editar: reabre el alta con los datos cargados.
• Anular: deja el movimiento sin efecto (ver abajo).

Editar un movimiento

Reabre el formulario con todo cargado. Se puede corregir lo que no esté bloqueado.

Anular un movimiento

Desde el detalle, botón «Anular». Pide confirmación. El movimiento no se borra: se marca anulado: true y su cantidad pasa a 0. Eso hace que el servidor detecte la diferencia y revierta el efecto en el stock automáticamente (un ingreso anulado descuenta lo que había sumado; una salida anulada repone). Queda el rastro en el historial con el prefijo [ANULADO] en las observaciones.

Carga de Stock Inicial (PT)

Herramienta para sembrar stock de producto terminado sin trazabilidad de producción (puesta en marcha / ajuste de apertura). Pide producto, cantidad (unidades), lote y fecha; crea un movimiento de INGRESO especial (docAzucel: INGRESO_INICIAL). Úsese con precaución: lo que entra por acá no tiene parte de producción detrás.

Escenarios típicos

Errores y validaciones comunes

Flujo de datos

Stock (Polvos)

Stock (Polvos) es la foto del inventario de la División Polvos: cuánto hay de cada insumo (materia prima) y de cada producto terminado (PT), con su detalle de lotes, su valorización y sus alertas de stock mínimo — todo separado por línea (Edulcorantes / Jugos). Es una pantalla de consulta y control: el saldo no se carga acá. Roles 1, 2, 3 y 5.

Edulcorantes y Jugos en el stock

El pill superior cambia la línea con switchStockLinea; el filtrado es en memoria (no vuelve a consultar Firestore), así que el cambio es instantáneo. Hay una diferencia importante entre insumos y productos:

Las dos solapas: Insumos y Productos (PT)

Dentro de cada línea, el selector Insumos / Productos (PT) alterna entre las dos grillas. Al entrar al módulo se abre Productos y se descarga fresco de la nube (no usa caché) para que el saldo sea el más reciente.

Solapa «Insumos» (materia prima)

Columnas: Nombre (con su unidad de medida), Categoría (tipo), Stock Físico, Stock Mínimo, Valorizado (stock × valor unitario) y Estado. Un insumo entra en alerta cuando tiene mínimo definido y el stock actual es ≤ ese mínimo: el número se pinta de rojo y el estado muestra ⚠. Si está OK, ✓ verde.

Solapa «Productos (PT)» — cajas y unidades

Para productos, el stock se guarda en unidades pero se muestra de forma legible usando el factor unidadesPorBulto del artículo:

Buscar, filtrar y paginar

1. Buscador inteligente (servidor): busca un insumo/producto por nombre directamente en Firestore. Al seleccionarlo, el sistema hace un getDoc en vivo para mostrar el saldo exacto de ese ítem (no el cacheado). Borrar el buscador recarga la lista normal.
2. Filtro «Tipo / Categoría»: se llena automáticamente con las categorías presentes en lo cargado. Filtra en memoria.
3. «Solo Alertas»: muestra únicamente los ítems en o bajo el stock mínimo — útil para «¿qué tengo que reponer/producir?».
4. «Cargar más registros»: la lista trae de a 50; el botón al pie carga el siguiente bloque (paginación con startAfter).
5. 🔄 Recargar: limpia memoria y vuelve a descargar la lista completa desde la nube (saldos frescos).

Detalle de lotes (clic en una fila)

Al hacer clic en cualquier fila se abre «Composición de Stock por Lote»: el saldo total y el desglose lote por lote. Los lotes con saldo 0 se muestran en gris. Desde cada lote hay dos accesos directos:

• Trazabilidad → abre la historia de ese lote en el módulo Trazabilidad y Calidad (de dónde vino, a quién se vendió).
• Rectificar → ajusta el saldo de ese lote puntual (ver abajo).

Rectificar / Ajustar stock

Hay un botón «Rectificar» en la barra (y también por lote dentro del modal de composición), tanto para Insumos como para Productos. Es el camino correcto para corregir un saldo sin tocar el número a mano: genera un movimiento que el servidor procesa.

1. Producto / Insumo: precargado si se entró desde una fila/lote; si no, hay un buscador.
2. Lote a rectificar: se elige de la lista de lotes con su saldo actual.
3. Tipo de ajuste: + Incremento (suma al lote) o − Merma (resta del lote).
4. Cantidad y Observaciones (recomendado: «conteo físico», «merma por vencimiento», etc.).
5. Confirmar Ajuste: se genera el movimiento; el saldo lo recalcula el servidor unos segundos después. La merma no puede dejar el lote negativo (barrera de stock no-negativo).

Exportar a Excel

El botón «Excel» exporta a CSV lo que está visible (respeta los filtros de tipo y «Solo Alertas» activos, ordenado alfabéticamente). Insumos: nombre, tipo, UM, stock, mínimo, estado (OK / BAJO / SIN STOCK), valor unitario y total. Productos: además cajas/bultos estimados, unidades por bulto y total valorizado. El archivo sale como Stock_…_Endulzantes_AAAA-MM-DD.csv.

Cómo se usa (resumen)

1. Elegí la línea (pill Edulcorantes / Jugos).
2. Elegí la solapa Insumos o Productos (PT).
3. Buscá / filtrá / activá «Solo Alertas» para ver lo que falta.
4. Clic en una fila → composición por lote → Trazabilidad o Rectificar.
5. Si necesitás el dato afuera, exportá a Excel.

Flujo de datos

Producción (Polvos)

Producción (División Polvos) es donde se fabrica: convierte insumos en productos. Tiene dos solapas, que son dos etapas distintas del mismo circuito: Elaboración (preparar el granel / intermedio a partir de una fórmula) y Envasado (convertir ese granel + envases en el producto terminado a partir de una estructura). Todo funciona por línea: el pill Edulcorantes / Jugos de arriba decide con qué familia de productos, recetas e insumos se trabaja. Roles 1, 2 y 3.

Edulcorantes y Jugos: misma mecánica, distinto producto

El módulo es uno solo y funciona igual para las dos líneas. Lo único que cambia es qué se fabrica: cuando el pill está en Edulcorantes el buscador, las recetas/estructuras y el historial muestran productos de esa línea; cuando está en Jugos, los de jugos. Los insumos compartidos (marcados linea: AMBAS en ABM, ej. azúcar, ácido cítrico) aparecen disponibles en las dos.

Conceptos base (imprescindible)

Elaboración vs. Envasado — la diferencia

SOLAPA «ELABORACIÓN» — paso a paso

Lista las Órdenes de Producción de intermedios de la línea activa, divididas en dos bloques: Órdenes Planificadas (arriba, las pendientes de producir) e Historial de Producción (abajo, los partes PEI ya cerrados, con buscador). Botón «Nueva Orden de Producción». Por fila de una orden planificada: PRODUCIR (confirmar la elaboración), Ver detalle 👁, Imprimir OP 🖨 y Anular 🗑.

Crear la orden — asistente de 3 pasos

1. Paso 1 — Qué y cuánto: fecha planificada, lote destino (opcional, se autogenera), producto a elaborar (buscador, solo intermedios de la línea activa) y cantidad a producir (kg en edulcorantes, L en jugos). Al pasar de paso, el sistema verifica que el producto tenga receta; si no, avisa y hay que cargarla en Fórmulas.
2. Paso 2 — Asignación de materia prima: por cada insumo de la receta el sistema calcula el requerido (% × cantidad) y sugiere lotes FIFO. Se puede agregar/cambiar lotes y repartir cantidades. No deja asignar más de lo que hay en stock del lote.
3. Paso 3 — Confirmar planificación: resumen (producto, cantidad, fecha, lote, componentes reservados) → «Crear Orden». Nace OPI-XXXXXX en estado PLANIFICADA y se reservan los insumos (movimiento de EGRESO).

Confirmar la elaboración (lo que realmente salió)

1. En la lista de Órdenes Planificadas, sobre una OP PLANIFICADA, botón «PRODUCIR».
2. El modal muestra el resumen y los lotes de insumo asignados, y pide la «Producción Real Obtenida» (viene sugerida con lo planificado; se corrige con lo que de verdad salió).
3. «Confirmar y Afectar Stock»: genera el parte PEI-XXXXXX, un movimiento de INGRESO del granel con su lote, y cierra la OP en estado COMPLETADA (con la cantidad real y el lote final). Pasa al Historial de Producción.

Ver detalle de una elaboración

El botón 👁 (o, en el historial, «Consultar») abre el detalle del parte: producto, lote producido, planificado vs. real vs. merma, las materias primas utilizadas con sus lotes y las observaciones del proceso. Es la base de la trazabilidad hacia atrás (ver módulo Trazabilidad y Calidad).

SOLAPA «ENVASADO» — paso a paso

Misma estructura que Elaboración pero para productos terminados: lista las Órdenes de Envasado planificadas de la línea + Historial de envasado. Botón «Nueva OP». Por fila: PRODUCIR (Confirmar Parcial), Ver detalle, Editar, Imprimir OP y Anular.

Crear la orden — asistente de 3 pasos

Igual estructura que Elaboración, pero usa la estructura del producto:

1. Paso 1: fecha, lote destino, producto terminado (de la línea activa) y cantidad a envasar.
2. Paso 2: el sistema analiza la estructura (qué granel y qué envases lleva) y arma los componentes con sus lotes.
3. Paso 3: resumen → «Crear Orden» → OPT-XXXXXX PLANIFICADA.

Confirmar Parcial — envasar de a tandas

El envasado normalmente no se hace todo de una vez. El modal Confirmar Parcial permite cargar tandas sucesivas:

1. Muestra el Saldo Pendiente de la orden (lo que falta envasar) y el lote destino.
2. Se carga la Producción Real de esta tanda (puede ser menor o incluso mayor que lo pendiente — se permite sobre-rendimiento).
3. Casilla «Cerrar orden con esta cantidad (anular saldo)»:
   • Merma: se produjo menos y no se va a producir más para esa orden → cerrarla con lo hecho (se anula el saldo restante).
   • Sobrante: se produjo más de lo planeado → cerrar la orden con ese excedente.
   Si no se tilda, la orden queda con el saldo pendiente para la próxima tanda.
4. Al confirmar: parte PET-XXXXXX, INGRESO del PT con su lote y EGRESO automático de los componentes consumidos (granel + envases).

Reglas de oro

• Primero el pill, después la OP. La orden hereda la línea activa (Edulcorantes / Jugos) y eso ya no se cambia.
• Sin fórmula/estructura no hay producción. Cargarlas primero en ABM.
• El stock lo recalcula el servidor a partir de los movimientos; nunca se duplica ni queda negativo.
• Planificar reserva, confirmar fabrica. Crear la OP descuenta/reserva insumos; recién al confirmar ingresa el producto.
• Insumos AMBAS (azúcar, ácido cítrico, etc.) se consumen del mismo stock en las dos líneas.

Escenarios típicos

Errores y validaciones comunes

Flujo de datos

Trazabilidad y Calidad (Polvos)

Trazabilidad y Calidad (División Polvos) reconstruye la historia completa de un lote de Endulzantes o Jugos: de qué orden de producción salió, con qué insumos y lotes se fabricó, cuánto stock tuvo en cada momento y a qué clientes se despachó. Es la herramienta para responder un reclamo de calidad o un recall en minutos. Es 100% consulta (no genera movimientos). Roles 1, 2 y 5. Trabaja por línea (pill Edulcorantes / Jugos).

Conceptos base

Cómo encontrar un lote (dos caminos)

Camino A — Búsqueda Rápida (por documento)

El más usado ante un reclamo: se tiene un papel en la mano (un remito, una factura, un N° de movimiento). Caja índigo, arriba.

1. Escribir el documento y Enter (o lupa): acepta remito (0001-00000055), MED (MED-000123) u orden / referencia (OPT-000001).
2. El sistema busca por coincidencia exacta en los movimientos de la línea activa (solo los que tienen lote).
3. Si hay un único resultado, salta directo a la historia del lote. Si el documento tocó varios lotes (ej. una orden con varios productos), muestra la lista para elegir cuál trazar.

Camino B — Búsqueda Manual (producto + lote)

Cuando se conoce el producto pero no un documento. Caja blanca.

1. Producto: buscador inteligente (filtrado por la línea activa).
2. Lote: el desplegable se llena con los lotes de ese producto y muestra el stock de cada uno (ej. «AC42M10 (Stock: 1.200)»).
3. «Consultar Lote» → arma la historia.

La «Historia del Lote»

El encabezado muestra el lote, el producto y el stock actual del lote. La tabla lista todos los movimientos de ese producto+lote, ordenados del más reciente al más viejo:

Trazabilidad hacia ATRÁS (genealogía) — «VER ORIGEN»

Si un ingreso del lote vino de producción, el botón «VER ORIGEN» abre la orden de producción que lo fabricó (OPT terminado u OPI intermedio) y lista las Materias Primas / Lotes Utilizados: cada insumo con su lote y cantidad.

Trazabilidad hacia ADELANTE (destinos)

La misma tabla de historia, mirando las filas de SALIDA, responde la otra mitad del reclamo: a qué clientes se despachó ese lote y en qué fechas. No hace falta otra pantalla — el destino está en la columna «Destino / Cliente» de cada salida.

Trazabilidad desde otros módulos

No hace falta venir siempre acá: el botón «Ver Trazabilidad» que aparece en el detalle de un movimiento (módulo Movimientos de Polvos) abre la misma «Historia del Lote» en una ventana, sin perder lo que se estaba haciendo. Es el atajo natural cuando se está revisando un movimiento puntual.

Caso completo: gestionar un reclamo

1. Entrar al lote: Búsqueda Rápida con el remito del cliente (o Manual: producto «Jugo Naranja x12» → lote JN-2407).
2. Hacia adelante: en la historia, las SALIDAS muestran que JN-2407 fue a 3 clientes además del que reclamó → se los puede contactar preventivamente.
3. Hacia atrás: el INGRESO de JN-2407 dice «PRODUCCION OPT-000045» → botón «VER ORIGEN». La OP usó, entre otros, «Saborizante Naranja lote SB-9912».
4. Profundizar: clic en el lote SB-9912 → la trazabilidad salta a ese insumo y muestra de qué compra entró y a qué otras OPT se asignó.
5. Conclusión: si el problema es el saborizante SB-9912, desde su trazabilidad se ven todos los lotes de PT que lo usaron → alcance real del recall, con clientes incluidos.

Escenarios típicos

Errores y validaciones comunes

Flujo de datos

ABM (Polvos)

ABM (Polvos) administra los catálogos de la División Polvos. Seis vistas: Artículos, Insumos, Catálogos, Recetas, Estructuras y Proveedores. Roles 1, 2, 3 y 5. Las vistas de Artículos e Insumos usan el pill de línea (Edulcorantes / Jugos).

Entidades

Cómo se usa

1. Se elige la vista; en Artículos/Insumos, el pill define la línea activa.
2. Alta/edición/eliminación con el formulario propio de cada entidad. En Artículos se asigna la línea; en Insumos se puede marcar AMBAS.

Flujo de datos

Colecciones: endulzantes_articulos, endulzantes_insumos, endulzantes_recetas, endulzantes_estructuras, endulzantes_proveedores y los catálogos de valores (polvos_catalogos). Se cachean en el navegador; tras un alta puede hacer falta Actualizar. El stock de artículos e insumos no se toca acá: lo maneja el trigger del servidor.