Sync diario
Sync diario
Sección titulada «Sync diario»Cada día, Asientra corre un job por cada cliente con credenciales de Hacienda (usuario y contraseña ATV) 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 4:00 a. m. hora de Costa Rica). Para cada cliente:
- Autenticación: abre sesión en el portal TRIBU-CR con el usuario y la contraseña ATV 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 pantalla de alertas del cliente (ver 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
En la ficha del cliente, andá a Configuración → TRIBU-CR. Arriba ves el Estado de sincronización de la última corrida y, abajo, el Historial reciente con:
- Inicio de cada ejecución.
- Estado.
- Duración.
- Comprobantes Recibidos y Errores.
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, Asientra no genera una alerta: revisá el estado de las últimas sincronizaciones en el historial. Las causas más frecuentes:
- Credenciales vencidas: la contraseña ATV del cliente cambió o la sesión se invalidó. Actualizala en las credenciales de Hacienda.
- Portal de Hacienda caído: el portal OVI tiene mantenimientos periódicos. El job vuelve a correr en la sincronización del día siguiente.
- 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 inválidas | Contraseña ATV cambiada o cuenta bloqueada | Actualizá las credenciales de Hacienda |
| 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 |