Data Import: SisNube¶
Tipo: referencia. Para quién: quien necesita consultar un campo, un estado o un permiso de las pantallas de Data Import. Para aprender el paso a paso, ver las guías enlazadas al final.
Data Import trae a Hexalba información del sistema de ventas SisNube. Tiene tres pantallas en el menú Data Import: Configuración, Importar e Historial.
Requisitos y permisos¶
| Elemento | Detalle |
|---|---|
| Feature de la organización | Data Import — SisNube (clave sisnube). Sin ella no aparecen las pantallas, no se puede configurar ni importar y la importación automática no corre. También habilita Reportes > Ventas. Ver Features por organización. |
Acción Configurar SisNube (configurar_sisnube) |
Ver, crear, editar y eliminar configuraciones; buscar sucursales. Muestra el menú Configuración. |
Acción Ejecutar importación SisNube (importar_sisnube) |
Lanzar importaciones manuales. Muestra el menú Importar. No necesita Configurar SisNube. |
Acción Ver reportes de ventas (ver_ventas_sisnube) |
Ver el historial y los reportes de Ventas. |
| Menú Historial | Se muestra a quien tiene Ejecutar importación SisNube o Ver reportes de ventas. |
| Alcance por local | Solo se ven y usan los locales a los que tu usuario tiene acceso. |
Las tres acciones se asignan por rol (ver Roles y permisos).
Pantalla Configuración¶
Ruta del menú: Data Import > Configuración. Subtítulo: "Fuentes de datos para importación". Muestra las configuraciones de todos tus locales a la vez.
Tabla "Fuentes de datos configuradas"¶
| Columna | Qué muestra |
|---|---|
| Nombre | Nombre de la configuración. |
| Local | Local de Hexalba. En Receta Valorizada dice Todos los locales. |
| Reporte | Venta Detallada, Receta Valorizada, Estadística de Venta (familias) o CMV (consumo teórico). |
| Descripción | Texto libre. |
| Tipo de integración | Siempre Web scraping. |
| Frecuencia | Manual, "Cada N hora(s)" o "Cada N día(s)" y, en CMV automático, "Diario a las HH:00 + histórico". |
| Última ejecución | Fecha y hora argentina de la última corrida. |
| Último resultado | Exitosa, Error o Pendiente (la corrida sigue en curso). "—" si nunca corrió. |
| Estado | Activa o Inactiva. |
| Acciones | Lápiz (editar) y tacho (eliminar). |
Arriba de la tabla hay un buscador (por nombre, descripción o local) y el botón Nueva configuración. Sin configuraciones: "Sin configuraciones de SisNube". En el celular cada configuración es una tarjeta con los mismos datos y botones.
Formulario de configuración¶
Título: "Nueva configuración de SisNube" al crear y "Editar configuración" al editar. Botones Cancelar y Crear (o Guardar).
| Campo | Obligatorio | Notas |
|---|---|---|
| Local de Hexalba | Sí | Se propone el local del selector superior. No se puede cambiar al editar. En Receta Valorizada es solo el "dueño administrativo": las recetas aplican a todos los locales. |
| Reporte | Sí | No se puede cambiar al editar. Una sola configuración por local y reporte. |
| Nombre de la configuración | Sí | Hasta 200 caracteres. |
| Descripción | No | Hasta 500 caracteres. |
| Usuario de SisNube | Sí | Hasta 200 caracteres. |
| Contraseña de SisNube | Sí al crear | Al editar, vacía conserva la guardada ("dejar vacío para no cambiar"). Nunca se muestra. |
| Sucursal de SisNube | Sí | Se elige por nombre después de tocar Buscar. Al editar, muestra "Sucursal actual (…) — buscá para cambiarla" hasta que vuelvas a buscar. |
| Modo de importación | Sí | Manual (bajo demanda) o Automático. |
| Frecuencia ("Cada N" Horas/Días) | Solo en Automático, salvo CMV | N es un número mayor o igual a 1. |
| Hora de arranque (Hora del reproceso diario en CMV) | Solo en Automático | Hora argentina, de 00:00 a 23:00. Por defecto 06:00. |
| Configuración activa | — | Casilla; por defecto tildada. Una configuración inactiva no se puede usar para importar. |
En modo Automático aparece debajo un texto que resume cuándo va a correr (por ejemplo, "Cada 3 horas desde las 10:00 (hora argentina)"; en CMV explica cómo se completa el histórico y a qué hora se reprocesan los últimos días cerrados).
Eliminar pide confirmación: "¿Eliminar esta configuración de SisNube? Las ventas ya importadas no se borran."
Mensajes frecuentes de la pantalla:
| Mensaje | Cuándo |
|---|---|
| "Seleccioná el local de Hexalba" | Falta el local. |
| "Ingresá usuario y contraseña de SisNube primero" | Tocaste Buscar sin usuario o sin contraseña (al crear). |
| "No se pudieron obtener las sucursales de SisNube" o el mensaje de SisNube | Credenciales incorrectas o SisNube no respondió. |
| "Elegí una sucursal de SisNube" | No elegiste sucursal. |
| "El nombre es obligatorio" / "El usuario es obligatorio" / "La contraseña es obligatoria" | Faltan datos. |
| "El intervalo debe ser un número mayor o igual a 1" | Frecuencia inválida. |
| "Ya existe una configuración de SisNube para este local y reporte" | Repetiste local y reporte. |
| "Demasiados intentos. Esperá N segundos." | Límite de intentos por usuario. |
Pantalla Importar¶
Ruta del menú: Data Import > Importar. Subtítulo: "Importación manual desde las fuentes configuradas". Trabaja con el local elegido en el selector superior y solo lista las configuraciones activas de ese local.
Con el permiso Ejecutar importación SisNube alcanza para ver y usar esta pantalla, aunque no tengas Configurar SisNube. En ese caso ves solo lo necesario para elegir la configuración (su nombre y su reporte), sin el usuario ni la sucursal de SisNube. Si no se pueden cargar las configuraciones, la pantalla te muestra el motivo en un recuadro rojo.
| Elemento | Detalle |
|---|---|
| Título | Según el reporte de la configuración elegida: Importar Venta Detallada, Importar Receta Valorizada, Importar Estadística de Venta o Importar CMV. |
| Configuración | Selector con las configuraciones activas del local. |
| Fecha desde / Fecha hasta | Por defecto hoy; al elegir una configuración de CMV se proponen como máximo ayer. No aparecen en Receta Valorizada ni en Estadística de Venta: en su lugar, un texto explica qué se importa. |
| Importar | Lanza la corrida en segundo plano. Mientras trabaja dice Importando… y avisa que podés cerrar la pantalla, porque el resultado queda en el Historial. |
| Resultado | Recuadro verde "Importación completada: N …" o recuadro rojo con el error. |
Reglas por reporte:
| Reporte | Qué trae | Qué cuenta el número del resultado |
|---|---|---|
| Venta Detallada | El rango elegido | Comprobantes |
| Receta Valorizada | El estado actual de todas las recetas (sin fechas) | Recetas |
| Estadística de Venta | Siempre los últimos 90 días, de todas las sucursales de la cuenta | Artículos clasificados en el catálogo de familias |
| CMV | Solo días cerrados (hasta ayer), máximo 31 días por importación | Días publicados |
Validaciones y errores:
| Mensaje | Cuándo |
|---|---|
| "La fecha desde no puede ser posterior a la fecha hasta" | Rango invertido. |
| "La configuración está inactiva" | La configuración se desactivó. |
| "El CMV se importa solo de días cerrados: la fecha hasta tiene que ser anterior a hoy" | CMV con hoy dentro del rango. |
| "El CMV se importa de a 31 días como máximo" | CMV con un rango más largo. |
| "El reporte no contiene comprobantes en el período" | Venta Detallada sin ventas en el rango. |
| "El informe de recetas no contiene filas" | Receta Valorizada vacía. |
| "La estadística de venta no contiene artículos en la ventana" | Estadística de Venta vacía. |
| "Demasiados intentos. Esperá N segundos." | Límite de intentos por usuario. |
Sin configuraciones activas se ve: "No hay configuraciones activas de SisNube. Creá una en la pestaña Configuración."
Pantalla Historial¶
Ruta del menú: Data Import > Historial. Subtítulo: "Importaciones realizadas (manuales y automáticas)". Muestra las corridas del local elegido en el selector superior, de la más reciente a la más vieja, con el título "Historial de importaciones — N" y 15 filas por página.
| Columna | Qué muestra |
|---|---|
| Fecha ejecución | Cuándo arrancó la corrida. |
| Configuración | Nombre de la configuración. |
| Período | Rango importado ("desde → hasta"); "Snapshot" en Receta Valorizada. |
| Estado | Ver tabla de estados. |
| Registros | Cantidad importada; con un ojito si se puede abrir el detalle. En CMV dice "N días". "—" si la corrida no terminó bien. |
| Ejecutó | Nombre y apellido de quien la lanzó, o Automática. |
Sin corridas: "Sin importaciones registradas". En el celular cada corrida es una tarjeta, con el botón Ver comprobantes cuando tiene detalle.
Estados de una importación¶
| Estado | Significado |
|---|---|
| En proceso | La corrida está trabajando. Si sigue así más de 60 minutos (por ejemplo, porque el servidor se reinició), el sistema la cierra como Error. |
| Completada | Terminó bien. |
| Error | Falló; el mensaje se ve debajo del estado. |
Detalle de una importación¶
Se abre tocando la fila de una corrida Completada.
- Comprobantes importados (Venta Detallada): columnas Comprob., Fecha, Apertura, Mesa, Mozo, Estado, Importe y Total; cada comprobante se expande en ítems con Código, Descripción, Cant., P. unit. e Importe. Si no hay: "Sin comprobantes en el período."
- Recetas importadas (Receta Valorizada): buscador "Buscar artículo…" y columnas Artículo, Insumo, UM, Cantidad, Costo unit., Valorizado y Precio venta. Si no hay: "Sin recetas en esta importación."
- Estadística de Venta y CMV no tienen detalle. El CMV se consulta en Reportes > CMV.
Pantalla vieja de SisNube¶
Antes había una única pantalla de SisNube. Los enlaces o favoritos guardados que apuntaban a ella abren ahora la pantalla Importar.
Qué guarda cada configuración y cada corrida¶
- Configuración: local, nombre, descripción, usuario, contraseña (cifrada), sucursal, reporte, si está activa, modo, frecuencia y hora. Una sola por local y reporte.
- Corrida: reporte, fechas, estado, mensaje de error, cantidad importada, origen (manual o automática), quién la ejecutó y cuándo empezó y terminó.
Páginas relacionadas¶
- Guías: Cómo configurar la conexión con SisNube, Cómo importar ventas de SisNube y revisar el historial.
- Explicación: Cómo funciona la importación automática de SisNube.
- Reportes que consumen estos datos: Ventas, CMV.