Ir al contenido
Asientra

Credenciales TRIBU-CR

Credenciales TRIBU-CR

Sección titulada «Credenciales TRIBU-CR»

Asientra necesita credenciales separadas para conectarse al portal TRIBU-CR (OVI) de cada cliente. Estas credenciales son distintas de las credenciales de Hacienda para facturación electrónica — el OVI es el portal de obligaciones voluntarias e informativas de Hacienda, y usa un sistema de autenticación propio.

Video próximamente · 3min

Ingresá las credenciales OVI del cliente

Andá a Clientes → [nombre del cliente] → TRIBU-CR → Credenciales OVI. Ingresá:

  • Usuario OVI: el nombre de usuario con que el cliente ingresa al portal tributos.hacienda.go.cr. Generalmente es el número de cédula o el correo electrónico registrado en Hacienda.
  • Contraseña OVI: la contraseña del portal.

Hacé click en Guardar. Asientra encripta ambas credenciales con el mismo mecanismo de encrypted attributes que usa para las credenciales de facturación — nunca se almacenan en texto plano ni aparecen en logs.

Validá la conexión

Después de guardar, hacé click en Probar conexión. Asientra intenta autenticarse en el OVI con las credenciales ingresadas y te confirma:

  • Conexión exitosa: las credenciales son válidas y Asientra puede acceder al OVI del cliente. El sync diario se habilita automáticamente.
  • Credenciales incorrectas: usuario o contraseña no válidos. Verificá con el cliente o restablecé la contraseña en el portal de Hacienda.
  • Cuenta bloqueada: la cuenta OVI está bloqueada por intentos fallidos. El cliente debe desbloquearla desde el portal de Hacienda o vía contacto con el servicio al contribuyente.

Configurá el ambiente

Al igual que con las credenciales de facturación, podés configurar las credenciales OVI en dos ambientes:

  • Sandbox: para pruebas con el ambiente de desarrollo de Hacienda. Usá las credenciales de prueba que Hacienda provee para el sandbox.
  • Producción: las credenciales reales del cliente para el portal de producción de TRIBU-CR.

Durante el piloto, todos los clientes operan en producción para el OVI, ya que el sync de XMLs reales requiere el ambiente real. El sandbox solo aplica para el envío de facturas electrónicas.

Renová cuando la sesión expira

El OVI tiene sesiones con tiempo de expiración. Cuando la sesión expira, el sync diario falla y Asientra genera una alerta en la cola del despacho con nivel warning. Para renovar:

  1. Andá a Clientes → [nombre del cliente] → TRIBU-CR → Credenciales OVI.
  2. Si la contraseña cambió, actualizala. Si la sesión solo expiró por inactividad, las credenciales siguen siendo válidas — hacé click en Probar conexión y Asientra restablece la sesión.
  3. Si el portal de Hacienda le exigió al cliente cambiar la contraseña, actualizala en Asientra con la nueva.

Errores frecuentes

Sección titulada «Errores frecuentes»

| Mensaje | Causa probable | Cómo resolverlo | |---|---|---| | Credenciales OVI inválidas | Usuario o contraseña incorrectos | Verificar con el cliente; si olvidó la contraseña, recuperarla en el portal de Hacienda | | Cuenta OVI bloqueada | Múltiples intentos fallidos en el portal | El cliente debe desbloquear la cuenta directamente en tributos.hacienda.go.cr | | Sesión OVI expirada | Sesión inactiva o contraseña cambiada externamente | Actualizar contraseña en Asientra si cambió, o simplemente probar conexión para renovar sesión | | Timeout al conectar | Problema de red o portal de Hacienda caído | Reintentar en 30 minutos; si persiste, verificar el estado del portal de Hacienda |