Integración con CifraHQ

Descripción general

Esta pantalla permite conectar ActivoHQ con el sistema contable CifraHQ para enviar automáticamente los asientos contables generados por los Activos fijos (adquisiciones, depreciaciones, disposals, revaluaciones, etc.). El administrador de la cuenta configura aquí el punto de conexión, el código de empresa y la clave de autenticación; una vez guardados, ActivoHQ publicará los lotes de asientos directamente en el libro mayor de CifraHQ. Si el endpoint no se configura, el sistema opera en modo de prueba sin realizar llamadas externas.

Cómo llegar

Menú lateral: Configuración > Integración

URL directa: /settings/integration

Conceptos clave

Término	Significado
Endpoint	Dirección URL del servicio de CifraHQ que recibe los asientos contables (p. ej. `https://cifrahq.example/api/journals`).
Código de Empresa Cifra	Identificador de la empresa dentro de CifraHQ. Debe coincidir exactamente con el código configurado en CifraHQ.
Clave de API	Credencial secreta que ActivoHQ envía en cada petición para autenticarse ante CifraHQ. Se almacena de forma segura.
Modo de prueba (dry-run)	Cuando el campo URL del Endpoint está en blanco, los procesos de carga se ejecutan internamente sin realizar ninguna llamada a CifraHQ. Útil para validar la Configuración antes de activar la integración en producción.
Mapa de cuentas contables	Tabla que asocia cada tipo de evento contable (p. ej. Adquisición, Depreciación) con el código de cuenta correspondiente en CifraHQ. Se gestiona en la pantalla Mapa de cuentas CifraHQ.
Lote de asientos (journal batch)	Conjunto de asientos contables en estado Pendiente que aún no han sido enviados a CifraHQ.
Tipo de evento contable (GlEvent)	Categoría del movimiento contable: Adquisición de activo, Depreciación, Baja, Revaluación, Deterioro o Transferencia.

Cómo usarla

Configurar la conexión con CifraHQ

En el menú lateral, haga clic en Configuración y luego en Integración.
En la sección Destino de contabilización (esta empresa), complete los tres campos:
- URL del Endpoint — ingrese la dirección completa del API de CifraHQ (p. ej. https://cifrahq.example/api/journals).
- Código de Empresa Cifra — ingrese el código de empresa tal como está registrado en CifraHQ.
- Clave de API — ingrese la clave de API proporcionada por CifraHQ. El valor se oculta como contraseña.
Haga clic en Guardar. El botón mostrará Guardando... mientras procesa; al finalizar, aparecerá la notificación "Configuración de integración guardada".

Probar la conexión

Con los campos completados (o guardados), haga clic en Probar conexión.
ActivoHQ enviará una solicitud de prueba al endpoint configurado.
- Si la conexión es exitosa, verá una notificación de éxito con el mensaje del servidor.
- Si el endpoint está en blanco, ActivoHQ responderá con el modo de prueba activo (sin error).
- Si hay un error de red o autenticación, aparecerá una notificación de error con el detalle.

Validar la cobertura del mapa de cuentas

Haga clic en Validar.
ActivoHQ revisará dos condiciones:
- Si el endpoint está en blanco, mostrará una advertencia (Warning) indicando que el sistema operará en modo de prueba.
- Por cada tipo de evento contable con lotes pendientes que no tenga una cuenta contable mapeada en CifraHQ, mostrará un error (Error).
El panel Validación aparecerá debajo del formulario:
- Si no hay problemas: "Sin problemas — listo para contabilizar."
- Si hay problemas: lista de elementos con su nivel de severidad (Warning o Error) y el mensaje descriptivo.
Corrija los problemas señalados (configure el endpoint o complete el mapa de cuentas) y vuelva a hacer clic en Validar para confirmar.

Operar en modo de prueba

Deje el campo URL del Endpoint en blanco para ejecutar las cargas en modo de prueba (sin llamar a CifraHQ).
En este modo, todos los procesos de publicación se ejecutan localmente sin enviar datos externos. Útil en etapas de implementación o pruebas.

Campos

Campo	Tipo	Obligatorio	Descripción	Validación
URL del Endpoint	Campo de texto	No	Dirección URL del API de CifraHQ que recibirá los asientos. Si se deja en blanco, el sistema opera en modo de prueba.	Sin validación de formato en pantalla; se verifica al usar Probar conexión.
Código de Empresa Cifra	Campo de texto	Sí (para integración activa)	Código que identifica la empresa dentro de CifraHQ.	No se valida en pantalla; debe coincidir con el registro en CifraHQ.
Clave de API	Campo de contraseña	Sí (para integración activa)	Credencial de autenticación emitida por CifraHQ. El valor se enmascara y no se muestra en claro.	Sin validación de longitud en pantalla; se verifica al usar Probar conexión.

Botones

Botón	Acción
Guardar	Guarda los tres campos en la Configuración de su cuenta. Se deshabilita mientras procesa.
Probar conexión	Envía una solicitud de prueba al endpoint configurado y muestra el resultado en una notificación.
Validar	Ejecuta las comprobaciones previas al envío y muestra el panel de Validación con los problemas encontrados.

Permisos

Disponible para los usuarios con acceso al módulo de Configuración, según lo configure su administrador.

Notas

Mapa de cuentas contables: Para que la integración funcione correctamente, cada tipo de evento contable que genere lotes pendientes debe tener un registro activo en la pantalla Mapa de cuentas CifraHQ (/master/cifra-gl-account-map). Los eventos contables disponibles son: Adquisición de activo, Depreciación, Baja, Revaluación, Deterioro y Transferencia.
Modo de prueba: Dejar el endpoint en blanco es una opción válida durante la puesta en marcha. No se perderán datos; los lotes permanecen en estado Pendiente hasta que se configure y active el endpoint.
Seguridad: La clave de API se almacena asociada a la Configuración de su cuenta y nunca se muestra en texto claro en la interfaz.
Alcance: La Configuración aplica únicamente a la empresa activa seleccionada en la sesión. Si su cuenta administra varias Empresas, repita el proceso para cada una.

Problemas comunes

Síntoma	Causa probable	Solución
La notificación de Probar conexión muestra un error de autenticación (401 / 403).	La Clave de API es incorrecta o ha expirado.	Solicite una nueva clave de API al administrador de CifraHQ, actualice el campo y haga clic en Guardar.
La notificación de Probar conexión muestra un error de red o tiempo de espera.	La URL del Endpoint es incorrecta o CifraHQ no está disponible.	Verifique la URL con el equipo de CifraHQ y asegúrese de que el servicio esté activo.
El panel Validación muestra errores del tipo "No GL account map for Depreciation".	No existe un mapa de cuenta activo para ese tipo de evento en el periodo actual.	Abra la pantalla Mapa de cuentas CifraHQ y agregue o active el registro correspondiente al evento indicado.
El panel Validación muestra la advertencia "No CifraHQ endpoint configured — uploads run in dry-run mode".	El campo URL del Endpoint está en blanco.	Ingrese la URL del endpoint de CifraHQ y haga clic en Guardar.
Al hacer clic en Guardar aparece una notificación de error.	Error de comunicación con el servidor de ActivoHQ.	Recargue la página e intente nuevamente. Si el problema persiste, contacte al soporte técnico.

Was this page helpful?

Previous Configuración Next Usuarios y roles