Skip to main content
La Public API de Contractia permite a organizaciones integrar de forma segura y flexible la creación, gestión, envío y firma de documentos digitales dentro de sus propios sistemas. Cada integración se realiza en el contexto de un tenant, el cual puede ser creado de manera autónoma registrándose en Contractia. Dentro de un tenant, pueden crearse múltiples usuarios, cada uno identificado por su correo electrónico.

🔐 Antes de empezar:

El acceso a esta API requiere dos elementos:
  • API Key: Asociada al tenant. Debe solicitarse contactando al equipo comercial de Contractia.
  • User Id: El correo electrónico de un usuario registrado dentro del tenant.
Ambos valores deben incluirse en cada solicitud para su autenticación y autorización.

🧩 Funcionalidades Principales

La API permite automatizar el ciclo completo de documentos digitales:
  • 📄 Creación de tareas de firma
  • ✏️ Gestión y modificación de tareas
  • 📬 Envío de documentos a firmantes
  • 🔍 Seguimiento del estado
  • ✍️ Firma electrónica

Flujo básico

1

Crear una tarea

POST /v2/tareasUna tarea representa el proceso principal de firma.
Todos los participantes, documentos y acciones estarán asociados a esta tarea.Las tareas evolucionan a través de diferentes estados, reflejando su progreso desde la creación hasta su finalización.
2

Subir documentos

POST /v2/tareas/tarea_id/documentosLos documentos son los archivos que serán enviados a firma dentro de la tarea creada previamente.Los documentos deben subirse en formato base64.Una tarea puede contener uno o múltiples documentos.
3

Agregar participantes

POST /v2/tareas/tarea_id/participacionesLos participantes representan usuarios involucrados en el flujo, como firmantes o validadores.
4

Iniciar el proceso de firma

POST /v2/tareas/tarea_id/startUna vez configurados los participantes y documentos, se debe iniciar la tarea para comenzar el flujo de firma.Al iniciar el proceso:
  • se generan las solicitudes de firma
  • se notifican los participantes correspondientes
  • la tarea cambia a estado En Progreso

Próximos pasos