¿Cómo funciona un API de firmas electrónicas?

19 nov 2025

Integración vía Web Service: Todas las funciones que DIGID pone a tu alcance

La transformación digital de los procesos de firma inicia cuando tus sistemas pueden conectarse directamente con plataformas que automatizan cada paso.
Para empresas que requieren integrar sus propios ERPs, CRMs o plataformas internas con un flujo de firma electrónica totalmente automatizado, DIGID ofrece un Web Service robusto, seguro y diseñado para operar a nivel empresarial.

A continuación te presentamos —en lenguaje claro— todas las funciones que nuestro Web Service permite, y cómo se conectan entre sí para automatizar el ciclo completo de gestión documental, desde el registro de clientes hasta la obtención del documento firmado.

1. Administración de clientes y firmantes

Registrar empresas (clientes)
Permite que tu sistema dé de alta automáticamente a tus clientes dentro de DIGID.
La respuesta incluye un ID único de cliente, que utilizarás en los siguientes pasos del flujo.

Crear y actualizar firmantes
Puedes crear firmantes nuevos, actualizar sus datos o consultar su información antes de asignarlos a un documento.
El Web Service soporta:

Registro de nombre, correo, teléfono y RFC
Bandera para marcar a un firmante como representante legal
Activación opcional de firma automática
Consulta por nombre o por ID
Modificación de información en cualquier momento

Con esto, tus aplicaciones pueden manejar cientos o miles de firmantes de forma automatizada.

2. Gestión completa de documentos

DIGID permite que tu sistema cree, actualice y prepare documentos para su proceso de firma.

Crear documentos
Puedes generar un documento nuevo de dos maneras:

Documento basado en archivo PDF/DOCX proporcionado por tu sistema
Documento basado en una plantilla previamente creada

El servicio te regresa:

ID único del documento
URL de previsualización para mostrar o validar contenido

Actualizar documentos
Si necesitas corregir un documento antes de enviarlo a firma, puedes actualizarlo manteniendo su mismo ID.

3. Asignación y control de firmantes en cada documento

Asignar firmantes
Tu sistema puede indicar qué personas deben firmar cada documento y si requieren o no verificación KYC.
La asignación se reemplaza por completo en cada solicitud, lo que permite un control preciso del flujo.

Desasignar firmantes
Si un firmante ya no participa en el proceso, puedes eliminarlo del documento antes de enviarlo.

Activar o desactivar KYC
Puedes decidir automatizadamente qué firmantes deben validar identidad antes de firmar, incluso por documento individual.

4. Envío del documento a firma

Una vez que el documento está listo:

Obtención de URL de envío
Tu sistema puede recuperar la URL que se utilizará para configurar el envío del documento dentro de un IFrame seguro.

Enviar a firmar
Al ejecutar esta función:

Se generan los enlaces de firma por firmante
Se envían automáticamente por correo (o por WhatsApp si aplica)
El documento cambia a estatus En Proceso de Firmas
Se valida que todos los firmantes cumplan requisitos (tipo de firma, RFC, etc.)

Reenviar la información de firma
Si un firmante perdió su correo o no lo encuentra, tu sistema puede reenviar su acceso sin modificar estatus ni romper el flujo.

5. Consulta y monitoreo del proceso

Consultar estado y contenido del documento
Puedes obtener:

Estatus del documento (Pendiente, En Proceso, Firmado o Cancelado)
Estatus de cada firmante
Documento completo en Base64 cuando está firmado

Obtener URL de firma por firmante
En procesos altamente personalizados (apps, CRM propio, gateways internos), puedes recuperar la URL individual para cada firmante dentro de tu propia interfaz.

Cancelar documentos
Si un documento aún no ha concluido, tu sistema puede cancelarlo y bloquear todos los enlaces previamente enviados.

6. Plantillas dinámicas inteligentes

DIGID permite crear contratos y formatos con variables y campos dinámicos para automatizar la generación documental.

Crear plantillas
Puedes subir plantillas base en formato DOCX y decidir si aceptarán anexos futuros.

Actualizar plantillas
Si tu formato legal o comercial cambia, puedes actualizar la versión sin perder su identificador.

Consultar plantillas
Puedes obtener:

Lista de plantillas por cliente
Sus campos variables
Vista previa
Configuración interna

Esto te permite integrar tu ERP o CRM con plantillas 100% dinámicas que generan documentos listos para firma en segundos.

7. Webhooks en tiempo real

Tu plataforma puede recibir notificaciones automáticas cuando:

Un firmante inicia proceso
Firma
Se aprueba su documentación
Cambia el estatus del documento

El Web Service permite registrar la URL de tu servidor para recibir estas notificaciones y actualizar tu sistema en tiempo real (por ejemplo, cambiar automáticamente estatus de contratos, activar usuarios, liberar créditos, etc.).

8. Información de la organización

También puedes consultar los datos del cliente/distribuidor autenticado (razón social, RFC, email, webhook configurado), para integraciones donde tu plataforma necesita validar identidad o sincronizar configuraciones.

Certificación Automática NOM-151

Con esta función podrás conectarte a través de WS para consumir el servicio de certificación de NOM-151 de manera automática o semiautomática, según tus necesidades, solo necesitarás enviar el archivo en Base64 y regresará a ti certificado con la NOM-151. Muy útil para empresas que buscan brindar validez a documentos que no necesariamente tienen que ser firmados.

Conclusión

El Web Service de DIGID permite que cualquier empresa integre su sistema con un flujo de firma electrónica seguro, automatizado y completamente escalable.
Con estas funciones puedes: