.jpg)
API GoFirmex
La API GoFirmex ofrece una solución robusta y flexible para integrar funcionalidades de firma electrónica directamente en los sistemas de su empresa. Diseñada para facilitar trámites documentales y optimizar flujos de trabajo, nuestra API permite a los clientes gestionar todo el ciclo de vida de un portafolio de documentos, desde la creación hasta la firma y legalización final.
Características Clave:
Creación y Gestión de Portafolios:
Crear Portafolio:
Inicia procesos de trámite definiendo firmantes (personas naturales) y configurando opciones de notificación (GoFirmex o propia). Permite la inclusión de un identificador de cliente opcional para seguimiento interno y la asignación de un orden para flujos de firma secuenciales o paralelos.
Asignar Documentos:
Añade documentos PDF a un portafolio, especificando el tipo de firma requerido (FES para Simple, FEA para Avanzada) y el document_type para la categorización interna en GoFirmex.
Asignar Documentos de Identidad:
Adjunta documentos de identidad (Cédula de Identidad, Certificado de Título de Dominio, etc.) en formatos PNG, JPG, JPEG o PDF, según el tipo de documento, para la validación de firmantes.
Inicio y Monitoreo del Proceso de Firma:
Iniciar Proceso de Firma:
Una vez que el portafolio y sus documentos están listos, inicia el proceso de evaluación y firma por parte de los firmantes y, si aplica, el notario.
Notificación de Estado de Portafolio:
Recibe notificaciones sobre la aceptación del portafolio, incluyendo los enlaces (sign_url) para que los firmantes accedan a sus documentos y procedan con la firma.
Notificación de Firma Exitosa:
Obten notificaciones en tiempo real cada vez que un firmante complete la firma de un documento específico.
Recepción y Cierre del Trámite:
Recibir Portafolio Completo:
Finaliza el proceso recibiendo el portafolio completo y legalizado, incluyendo toda la información relevante del trámite y un enlace de descarga del documento final.
Manejo de Rechazos:
La API proporciona detalles claros en caso de rechazo del portafolio (REJECTED_BY_NOTARY, REJECTED_BY_GOFIRMEX, REJECTED_BY_CLIENT, REJECTED_BY_EXPIRATION), permitiendo una gestión eficiente de excepciones.
Beneficios
Automatización:
Digitaliza y automatiza la gestión de firmas, reduciendo tiempos y costos operativos.
Eficiencia:
Agiliza los procesos de firma, permitiendo transacciones más rápidas y una mejor experiencia para sus clientes.
Seguridad:
Aprovecha la infraestructura segura de GoFirmex para la autenticación (JWT con llave privada) y el manejo de documentos.
Flexibilidad:
Adapta la integración a tus necesidades específicas, configurando flujos de firma simultáneos o secuenciales.
Trazabilidad:
Realiza un seguimiento interno de sus trámites con identificadores de cliente y reciba notificaciones detalladas sobre el estado de cada portafolio y firma.
Consideraciones Técnicas:
Autenticación:
Utiliza JWT (JSON Web Tokens) firmados con una llave privada, asegurando la autenticidad de las solicitudes.
Formato de respuesta:
Las respuestas de GoFirmex siguen un formato JSON estandarizado, indicando el éxito o error de la consulta, junto con detalles del error y mensajes descriptivos.
Notificaciones del Cliente:
Los clientes deben configurar endpoints para recibir notificaciones de GoFirmex, con un sistema de reintentos incorporado para asegurar la entrega.
Soporte
Inicia procesos de trámite definiendo firmantes (personas naturales) y configurando opciones de notificación (GoFirmex o propia). Permite la inclusión de un identificador de cliente opcional para seguimiento interno y la asignación de un orden para flujos de firma secuenciales o paralelos.
Respuesta directa del líder técnico y/o CTO.
Notificaciones automáticas de error vía Slack.
La API GoFirmex es la herramienta ideal para empresas que buscan una solución integral y confiable para la firma electrónica, mejorando la eficiencia, la seguridad y la experiencia del usuario en sus operaciones documentales.