Crear Firmantes

1. API
2. ›Electrónico
3. ›Crear Firmantes

POST

https://app.firmeasy.legal/api/v1/electronica/firmantes

Crear Firmantes

Este endpoint te permite registrar uno o varios firmantes asociados a un documento electrónico específico. Puedes configurar los flujos de firma (estándar o avanzado) y las coordenadas exactas donde se ubicará la firma dentro del documento.

---

Autorización

Este recurso está protegido. Debes incluir tu token de acceso en el encabezado de la petición.

Precaución

Recuerda que ya debes estar verificado e incluir tu token Bearer válido para consumir este endpoint.

Parámetro	Tipo	Descripción	Límites
Authorization	string	Token de acceso (Bearer token).	Obligatorio
Content-Type	string	Especifica el formato de la petición.	application/json

Authorization

string

Token de acceso (Bearer token).

Límites:Obligatorio

Content-Type

string

Especifica el formato de la petición.

Límites:application/json

---

Parámetros de la Petición

Campos Obligatorios

Los campos marcados con un asterisco (*) son obligatorios y deben ser proporcionados en la solicitud. Los demás campos son opcionales.

El cuerpo de la petición requiere el ID del archivo y un array de objetos con la información de cada firmante.

Parámetro	Tipo	Descripción	Límites
archivo_id	string	ID del archivo al cual se le agregarán los firmantes.	Obligatorio (UUID)
firmantes	array	Lista de objetos con los datos y configuración de cada firmante.	Mínimo 1 firmante

archivo_id

string

ID del archivo al cual se le agregarán los firmantes.

Límites:Obligatorio (UUID)

firmantes

array

Lista de objetos con los datos y configuración de cada firmante.

Límites:Mínimo 1 firmante

Campos del objeto firmantes

• nombre: Nombre completo del firmante.
• email: Correo electrónico.
• celular / codigo_pais: Datos de contacto.
• send_link: Booleano para enviar enlace automático.
• flujoEstandar / flujoAvanzado: Arrays para definir los métodos de validación (ej. firma_biometrica, selfie).
• signature_position_x, y: Coordenadas de ubicación de la firma.
• signature_page: Número de página donde estampar la firma.

---

Ejemplos de Implementación

cURL

curl -X POST [https://app.firmeasy.legal/api/v1/electronica/firmantes](https://app.firmeasy.legal/api/v1/electronica/firmantes) \
  -H "Authorization: Bearer TU_TOKEN_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "archivo_id": "466693fc-025a-4b41-8874-08160d0d2458",
    "firmantes": [
        {
            "nombre": "Nombre del firmante",
            "email": "[email protected]",
            "celular": "9999999999",
            "codigo_pais": "+51",
            "send_link": false,
            "flujoEstandar": ["firma_biometrica"],
            "flujoAvanzado": ["selfie"],
            "signature_position_x": 330,
            "signature_position_y": 540,
            "signature_page": 1
        }
    ]
}'

Node.js (Fetch)

const raw = JSON.stringify({
  "archivo_id": "466693fc-025a-4b41-8874-08160d0d2458",
  "firmantes": [
    {
      "nombre": "Nombre del firmante",
      "email": "[email protected]",
      "celular": "9999999999",
      "codigo_pais": "+51",
      "send_link": false,
      "flujoEstandar": ["firma_biometrica"],
      "flujoAvanzado": ["selfie"],
      "signature_position_x": 330,
      "signature_position_y": 540,
      "signature_page": 1
    }
  ]
});

// ... (Configuración de headers y fetch igual a ejemplos anteriores)

---

Códigos de Estado

Código	Estado	Descripción
200	OK	Firmante registrado correctamente.
400	Bad Request	Error en el JSON o datos requeridos faltantes.
401	Unauthorized	Token ausente o inválido.
500	Server Error	Falla interna en el servidor.