Campos Personalizados

Última revisión: 09 octubre 2025

Los campos personalizados permiten definir configuraciones específicas a nivel de grupo, adaptando el comportamiento del sistema a las necesidades concretas de cada organización.
Funcionan mediante un sistema de pares clave/valor, que pueden utilizarse para automatizar tareas, personalizar notificaciones, integrar servicios externos o definir ajustes técnicos avanzados.


¿Qué son los campos personalizados y para qué sirven?

Los campos personalizados son parámetros configurables que se pueden aplicar a nivel de grupo dentro de la plataforma.
Estos campos permiten:

  • Insertar información específica del grupo en plantillas, políticas o notificaciones.
  • Configurar opciones de correo, integraciones, formatos de firma o servicios externos.
  • Centralizar la gestión de valores repetitivos o sensibles (como URLs, claves API, certificados, etc.).

Un Administrador Global puede crear campos privados, invisibles para los administradores de grupo, marcando la casilla "Admin" al momento de crearlos.


¿Cómo se añaden campos personalizados?

Puedes añadir campos personalizados de dos formas:

  1. Manualmente

    • Crea cada campo uno por uno desde la interfaz.
    • Define una clave (KEY) y un valor (VALUE).
  2. Importando desde un fichero Excel

    • Descarga la plantilla desde la pantalla de configuración.
    • Añade múltiples campos a la vez y súbelos al sistema.

Normas para definir la clave:

  • Debe escribirse en mayúsculas.
  • No puede contener espacios, tildes ni caracteres especiales.
  • Ejemplo válido: COD_DEPARTAMENTO.

Campos no exportables:
Si marcas el check “No exportable”, el campo no se heredará al crear subgrupos mediante la opción “Nuevo grupo”.

💡 Nota: Consulta los campos de claves internas del sistema para conocer funcionalidades adicionales que puedes automatizar.


¿Dónde puedo usar un campo personalizado?

Los campos personalizados pueden utilizarse de dos maneras principales:

1. Como Variables Dinámicas

Permiten insertar información de grupo en distintas partes del sistema usando el prefijo SYS_GROUP_.

Ejemplos:

  • En plantillas:
    Contrato de alta asociado al departamento
  • En notificaciones:
    Hola , aquí tienes el contrato emitido por el departamento listo para su revisión y firma.
  • En políticas o firmas:
    Aprobado por el departamento

También puedes definir variables dinámicas en configuraciones, como URLs de callback o integración con CRMs.
Por ejemplo, para un grupo “G1”, se puede configurar un campo con la URL de respuesta automática, y las plantillas solo referenciarán esa variable.


2. Como Ajustes Específicos o Técnicos

Determinadas claves internas permiten configurar funcionalidades avanzadas del grupo, como:

  • Servidor de correo electrónico propio (SMTP)
  • Logo personalizado
  • Configuración de formatos de firma
  • Integración con Fortress, Inbox o Andes CA
  • Control de expiración de descargas
  • Servicios de terceros (CIFIN, LISIM, Experian, etc.)

Tabla de Campos de Claves Internas Del Sistema

CAMPO DESCRIPCIÓN TIPO / VALORES EJEMPLO
🧩 Configuración General del Grupo
DEFAULT_LANGUAGE_ID Idioma por defecto del grupo Texto ca-ES
DOWNLOAD_EXPIRE_MINUTES Minutos de validez del enlace de descarga Numérico 5
📧 Configuración de Correo Electrónico (SMTP / Notificaciones)
USER_EMAIL_CONFIRM_SUBJECT Asunto del correo de confirmación de usuario Texto Confirma tu cuenta en Viafirma
USER_EMAIL_CONFIRM_BODY Cuerpo del correo de confirmación de usuario (admite HTML) Texto / HTML Hola , confirma tu correo haciendo clic aquí.
MAIL_CALLBACK_ATTACHMENT_AUDIT Adjuntar audit-trail (PDF) en correos automáticos true/false true
MAIL_CALLBACK_ATTACHMENT_PDF Adjuntar PDF firmado en correos automáticos true/false true
MAIL_CALLBACK_ATTACHMENT_XML Adjuntar XML de la solicitud en correos automáticos true/false true
MAIL_HOST_NAME URL o IP del servidor SMTP Texto smtp.miempresa.com
MAIL_PORT Puerto del servidor SMTP Numérico 587
MAIL_SSL Activar seguridad SSL true/false true
MAIL_TLS Activar verificación TLS true/false false
MAIL_SSL_PORT Puerto SSL del servidor Numérico 465
MAIL_START_TLS Activar propiedad START TLS true/false true
MAIL_SMTP_USER Usuario del servicio de correo Texto [email protected]
MAIL_SMTP_PASS Contraseña del servicio de correo Texto ********
MAIL_FROM Dirección “From” del correo Texto [email protected]
MAIL_FROM_NAME Nombre mostrado en “From” Texto Viafirma Documents
MAIL_BCC Envío por copia oculta true/false true
🎨 Personalización Visual
CUSTOM_LOGO_TITLE Título del logo personalizado Texto My Title Logo
CUSTOM_LOGO_URL URL del logo personalizado URL http://mycustomlogo.png
🔐 Formatos de Firma y Certificados
TYPE_FORMAT_SIGN_PDF Formato de firma por defecto para PDF PADES_B / PADES_T / PADES_LT / PADES_LTA PADES_B
TYPE_FORMAT_SIGN_XML Formato de firma para XML XADES_B / XADES_T / XADES_LT / XADES_LTA XADES_B
TYPE_FORMAT_SIGN_CADES Formato de firma para adjuntos (imagen, vídeo, audio) CADES_B / CADES_T / CADES_LT / CADES_LTA CADES_B
🔗 Integraciones y Servicios Externos (Inbox, Fortress, etc.)
inbox.apikey API Key generada por Inbox Texto -
inbox.apipass API Pass generada por Inbox Texto -
inbox.crm.callback URL del servicio de callback del CRM URL https://sandbox.viafirma.com/documents-crm-example/inboxCrmResponse
inbox.crm.process Tipo de proceso implementado Texto GENERIC
inbox.notificationUrl URL de callback de Inbox URL https://sandbox.viafirma.com/documents-web/connect
inbox.restApiPathBase Endpoint base del API de Inbox URL https://testservices.viafirma.com/inbox/api/v3/
FORTRESS_CERTIFICATE_ID Código del certificado instalado en Fortress Texto 432e4b336c2771e8
ANDES_URL URL del servicio Andes CA URL https://ra.andesscd.com.co/test/WebService/soap-server_new.php
ANDES_USER Usuario API Andes CA Texto -
ANDES_PASSWORD Contraseña API Andes CA Texto -
LISIM_SERVICE_URL URL del servicio LISIM URL https://yourserviceprovider.com

Recomendaciones finales

  • Mantén un registro documentado de todos los campos personalizados configurados en cada grupo.
  • Revisa periódicamente los campos de claves internas del sistema, ya que nuevas funcionalidades pueden depender de estos valores.
  • Si integras servicios externos, asegúrate de validar las credenciales o endpoints antes de habilitar la configuración en producción.

© 2025 Viafirma — Guía de configuración de Campos Personalizados para Viafirma Documents.

results matching ""

    No results matching ""