Sync diario
Sync diario
Sección titulada «Sync diario»Cada noche, Asientra corre un job automático por cada cliente con credenciales OVI configuradas: se conecta al portal TRIBU-CR, descarga los comprobantes electrónicos emitidos y recibidos del día anterior, y los compara contra los registros internos. Este proceso es la base del Watchdog de discrepancias y del pre-llenado de declaraciones.
Qué hace el job diario
Sección titulada «Qué hace el job diario»El TribuCrSyncJob corre una vez por día por cliente (a las 3:00 AM hora CR). Para cada cliente:
- Autenticación OVI: abre sesión en el portal TRIBU-CR con las credenciales del cliente.
- Descarga emitidos: obtiene el listado de comprobantes electrónicos que Hacienda registra como emitidos por el cliente en el día anterior.
- Descarga recibidos: obtiene el listado de comprobantes recibidos.
- Matching con registros internos: compara cada XML descargado contra los registros en Asientra usando la clave numérica del comprobante como identificador único.
- Clasificación de resultados:
- XML en TRIBU-CR y en Asientra, montos iguales → sin acción, marcado como sincronizado.
- XML en TRIBU-CR pero no en Asientra → discrepancia tipo “faltante en sistema”.
- XML en Asientra pero no en TRIBU-CR → discrepancia tipo “no reconocido por Hacienda”.
- XML en ambos con montos distintos → discrepancia tipo “diferencia de monto”.
- Generación de alertas: las discrepancias detectadas generan alertas en la cola del despacho para revisión del Watchdog.
- Actualización de notificaciones: descarga y procesa las notificaciones del inbox OVI del cliente.
El sync es idempotente — si corre dos veces en el mismo día, no duplica discrepancias ni alertas.
Monitoreá el estado del sync
Andá a Clientes → [nombre del cliente] → TRIBU-CR → Historial de sync. Vas a ver el historial de los últimos 30 días con:
- Fecha y hora de cada ejecución.
- Estado:
completado,fallido, oen progreso. - Cantidad de XMLs descargados, matcheados y discrepancias encontradas.
- Duración del job.
Entendé los resultados del último sync
El panel de estado muestra un resumen del último sync exitoso:
- Sincronizados correctamente: comprobantes que coinciden en ambos lados.
- Discrepancias pendientes: diferencias que necesitan revisión. El número en rojo te indica que hay trabajo por hacer antes de la próxima declaración.
- Nuevas notificaciones: mensajes del inbox OVI que aún no procesaste.
Hacé click en Ver discrepancias para ir directamente al panel del Watchdog.
Forzá un sync manual cuando lo necesitás
Hay situaciones en que conviene no esperar al sync nocturno:
- Acaba de pasar el cierre de mes y necesitás confirmar que todos los XMLs están sincronizados antes de calcular la declaración.
- Acabás de subir facturas faltantes y querés confirmar que TRIBU-CR las reconoce.
- Una discrepancia crítica fue reportada y necesitás verificar si ya se resolvió.
Para forzarlo, hacé click en Sincronizar ahora desde el panel de estado del cliente. El job entra a la cola y corre en los próximos minutos. El panel se actualiza al terminar.
Manejo de errores del sync
Sección titulada «Manejo de errores del sync»Si el job falla tres veces consecutivas, Asientra genera una alerta de nivel critical en la cola del despacho. Las causas más frecuentes:
- Sesión OVI expirada: la contraseña del cliente cambió o la sesión se invalidó. Ir a Credenciales TRIBU-CR para renovar.
- Portal de Hacienda caído: el portal OVI tiene mantenimientos periódicos. El job reintenta automáticamente — si el portal sigue caído al día siguiente, la alerta aparece con información del error.
- Timeout de red: el job tiene un timeout de 5 minutos. Si el portal responde muy lento, el job puede fallar por timeout y reintentarlo la próxima noche.
Errores frecuentes
Sección titulada «Errores frecuentes»| Mensaje | Causa probable | Cómo resolverlo | |---|---|---| | Sync fallido: credenciales OVI inválidas | Contraseña cambiada o cuenta bloqueada | Renovar credenciales en TRIBU-CR Settings | | Sync fallido: timeout | Portal OVI lento o caído | Esperar al día siguiente o forzar sync manual más tarde | | Discrepancias no se actualizan | Sync no completó exitosamente | Verificar historial de sync y resolver error antes de revisar discrepancias |