Cómo funciona la importación automática de SisNube¶
Tipo: explicación. Para quién: administrador que quiere entender qué hace Hexalba por su cuenta con SisNube, cuándo y qué pasa si algo falla. Para configurarla, ver la guía.
El latido¶
Hexalba tiene un proceso programado (el "cron") que late cada 15 minutos. En cada latido revisa todas las configuraciones de SisNube en modo Automático y cada una decide por su cuenta si le toca importar. El latido es solo la granularidad mínima: la frecuencia real la define cada configuración.
El proceso solo tiene en cuenta las configuraciones activas en modo Automático, y solo si su organización tiene la feature Data Import — SisNube habilitada. Si una configuración falla, las demás siguen.
flowchart TD
A["Latido cada 15 minutos"] --> B{"¿Configuración activa, automática<br/>y con la feature habilitada?"}
B -- No --> Z["No hace nada"]
B -- Sí --> C{"¿Qué reporte?"}
C -- CMV --> H{"¿Hay días para reprocesar<br/>o para completar?"}
H -- No --> Z
H -- Sí --> D["Reprocesa los últimos días cerrados<br/>y completa días faltantes"]
C -- "Venta, Receta o Estadística" --> E{"¿Le toca según<br/>la frecuencia y la hora?"}
E -- No --> Z
E -- Sí --> F["Importa"]
D --> G["La corrida queda en el Historial:<br/>Completada o Error"]
F --> G
Qué reportes se traen y cada cuánto¶
| Reporte | Cuándo importa | Qué trae |
|---|---|---|
| Venta Detallada | Según la frecuencia (cada N horas o días) anclada a la hora de arranque | Los días calendario que abarca el intervalo hacia atrás desde ese momento, hasta hoy inclusive. Por ejemplo, con "cada 1 día" trae ayer y hoy; con "cada 3 horas", normalmente solo hoy (o ayer y hoy si la corrida es de madrugada). |
| Receta Valorizada | Igual que el anterior | La foto actual de todas las recetas con su costo. |
| Estadística de Venta | Igual que el anterior | Los últimos 90 días de todas las sucursales, para armar el catálogo de familias. |
| CMV | Reproceso diario a la hora de reproceso, y relleno del historial en cada latido | Consumo teórico por día cerrado (ver más abajo). |
Frecuencia en horas o días¶
Una configuración con "cada N horas" corre en las horas que están en fase con la hora de arranque (por ejemplo, arranque 10:00 y cada 3 horas: 10, 13, 16, 19, 22, 01, 04, 07). Con "cada N días" corre a la hora de arranque, una vez que pasaron N días desde la última importación exitosa. Además hay una guarda de tiempo: no vuelve a correr antes de que pase (casi) todo el intervalo desde la última exitosa, así que un latido atrasado o repetido no duplica el trabajo.
El CMV tiene su propia lógica¶
El CMV no usa la frecuencia. En cada latido:
- Reproceso diario: a partir de la hora configurada, reimporta los 3 últimos días cerrados, una vez por día. El día que acaba de cerrar se toma recién a esa hora, porque la venta de la noche puede seguir cargándose después de medianoche; los dos anteriores absorben correcciones tardías.
- Relleno del historial: busca los días sin importar desde la primera venta importada del local hasta el último día cerrado y los completa, del más reciente al más viejo. Entre reproceso y relleno se importan como máximo 20 días por latido, y todo eso queda como una sola corrida en el Historial. No guarda un cursor: en cada latido recalcula qué falta, por eso retoma solo después de un corte.
- Un candado por organización evita que dos latidos superpuestos pidan lo mismo.
Qué pasa si SisNube falla¶
- La corrida queda en Error en el Historial, con el mensaje.
- Cuándo se reintenta depende del reporte. En Venta Detallada, Receta Valorizada y Estadística de Venta, los latidos que caen dentro de la misma hora en que tocaba importar vuelven a intentarlo (cada 15 minutos); si siguen fallando, la próxima oportunidad es el turno siguiente de la frecuencia (por ejemplo, al día siguiente a la hora de arranque). En CMV, cada latido vuelve a calcular qué días faltan y los reintenta.
- La importación nunca deja datos a medias: se guarda dentro de una transacción. Los datos anteriores quedan como estaban.
- En CMV, un día que falla frena el relleno de los días más viejos hasta que se resuelva, pero los días ya publicados quedan.
- Si el servidor se reinicia a mitad de una importación, esa corrida queda "En proceso"; después de una hora el sistema la marca como Error para no dejarla colgada.
- Las causas típicas son credenciales vencidas o cambiadas, una sucursal a la que la cuenta ya no tiene acceso, o que SisNube no responda en ese momento. Todo eso se ve en el mensaje del historial.
Reimportaciones¶
Importar el mismo período dos veces no duplica: reemplaza lo que había. Por eso es seguro lanzar una importación manual de un día para corregir algo.
Por qué los datos del día pueden estar incompletos¶
- La importación es por fotos: lo vendido después de la última corrida no está hasta la siguiente. Comparar períodos lo avisa cuando el rango incluye hoy ("hoy es parcial hasta la última importación"); los demás reportes de Ventas no lo avisan.
- El CMV de hoy no existe: se importa cuando el día cierra.
- Si pasó mucho tiempo sin importar, hay días sin importación completada. Los reportes de comparación los detectan y marcan el período como "no comparable".
- Los reportes de Ventas leen hasta un tope de filas (100.000 comprobantes en Ventas por hora, 200.000 comprobantes en Ventas por mozo y 200.000 ítems en Productos). Si se alcanza, aparece el aviso ámbar "Resultado parcial…": no es un problema de importación sino de tamaño del rango. Achicá las fechas o los locales.
Páginas relacionadas¶
- Referencia: Data Import: SisNube, Ventas, CMV.
- Guías: Cómo importar ventas de SisNube.
- Explicación: Qué es el CMV.