> ## Documentation Index
> Fetch the complete documentation index at: https://api.contractia.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Contractia API

> Introducción a la Public API de Contractia para crear, gestionar, enviar y firmar documentos digitales con autenticación mediante API key y user ID.

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

<Steps>
  <Step title="Crear una tarea">
    [POST /v2/tareas](/platform/api-tareas)

    Una tarea representa el proceso principal de firma.<br />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.
  </Step>

  <Step title="Subir documentos">
    [POST /v2/tareas/tarea\_id/documentos](/cargar-nuevo)

    Los 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.
  </Step>

  <Step title="Agregar participantes">
    [POST /v2/tareas/tarea\_id/participaciones](/platform/crear)

    Los participantes representan usuarios involucrados en el flujo, como firmantes o validadores.
  </Step>

  <Step title="Iniciar el proceso de firma">
    [POST /v2/tareas/tarea\_id/start](/platform/iniciar)

    Una 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
  </Step>
</Steps>

## Próximos pasos

* Cómo crear un [contacto en la Agenda](/nuevo)
* Cómo obtengo el [certificado de auditoría](/platform/auditoria)
* Cómo descargo un [documento firmado](/descargar)