Crear un documento.

El primer paso para iniciar un proceso de firmado legalmente vinculante es la configuración inicial. Aquí definirás quién firma, cómo firma y qué notificaciones recibirá.

Configuración del Proceso: Define métodos de firma, proveedores y orden de ejecución.
Definición de Participantes: Indica quiénes son los firmantes y espectadores.
Personalización: Configura notificaciones, recordatorios y webhooks.

Endpoint de Creación

Para crear un nuevo documento, realiza una petición al siguiente endpoint:

Método: POST https://api.digitafirma.com/v1/documents

Identity Providers

Define qué tecnología validará la identidad:

VERIFICAMEX: Firma con identidad (INE vigente).
LOCAL: Firma simple (ideal para extranjeros).

Sign Modes

Determina cómo se visualizarán las firmas:

PDF_SIGNATURE: Firma incrustada en el PDF.
CLASSIC: Firma tradicional.
CLASSIC_BATCH: Firmado masivo.

Parámetros de la Petición

Campo	Tipo	Descripción
`company_id`	`string`	ID de la carpeta de trabajo (consulta Listar carpetas de trabajo).
`sign_mode`	`enum`	Modo de firmado (`CLASSIC`, `PDF_SIGNATURE`, `CLASSIC_BATCH`).
`webhook`	`string`	URL que recibirá notificaciones de estado.
`sign_ordered`	`enum`	`ACTIVE` para forzar el orden del array de firmantes.

Campo	Tipo	Descripción
`config.identity_providers`	`Array`	Proveedores admitidos (`LOCAL`, `VERIFICAMEX`).
`config.allow_type_signatures`	`Array`	Métodos permitidos (`VERIFICAMEX`, `FIREL`, `EFIRMA`).

Campo	Tipo	Descripción
`signatories`	`Array`	Lista de personas que deben firmar. Requiere `name`, `email`, `phone`, `rfc`.
`spectators`	`Array`	Personas con acceso de solo lectura. Requiere `name`, `email`.

Campo	Tipo	Descripción
`notification_mode`	`enum`	`ENABLED` o `DISABLED`.
`tries`	`int`	Cantidad de intentos de notificación (mínimo 1).
`remember_every`	`int`	Frecuencia de recordatorios en días.
`remember_at`	`string`	Hora del recordatorio (`HH:mm`).

{
"company_id": "ac110005-9d0c-1243-819d-0c3b71220000",
"config": {
    "identity_providers": [
        "VERIFICAMEX",
        "LOCAL"
    ],
    "allow_type_signatures": [
        "VERIFICAMEX",
        "EFIRMA",
        "FIREL"
    ]
},
"signatories": [
    {
        "name": "Juan Perez",
        "email": "jpe@gmail.com",
        "phone": "+522291449388",
        "rfc": "XXXX941024V93"
    }
],
"spectators": [
    {
        "name": "Hector Lavoe",
        "email": "hl@hotmail.com"
    }
],
"webhook": "{URL-WEBHOOK}",
"sign_ordered": "ACTIVE",
"notification_mode": "ENABLED",
"tries": 3,
"remember_every": 1,
"remember_at": "16:54"
}

{
"type": "documents",
"id": "ac110005-9df4-1d1b-819d-f5eac471003a",
"links": {
    "self": "/documents/ac110005-9df4-1d1b-819d-f5eac471003a"
},
"attributes": {
    "original_hash": null,
    "file_name": "",
    "sign_status": 1,
    "signed": false,
    "signature_mode": "PDF_SIGNATURE",
    "signature_ordered": "INACTIVE",
    "owner": "Leonardo Daniel CRUZ ROSAS <leonardo.rosas041024@gmail.com>",
    "isOwner": true,
    "rejected_message": null,
    "tries": 3,
    "remember_at": "16:54:00",
    "remember_every": 3,
    "signed_at": null,
    "created_at": "2026-05-04T20:14:56.945158",
    "config": {
        "allow_type_signatures": [
            "VERIFICAMEX"
        ],
        "primary_color": null,
        "secondary_color": null,
        "lock_phone_for_otp": false,
        "identity_providers": [
            "LOCAL",
            "VERIFICAMEX"
        ]
    },
    "notification_mode": "ENABLED",
    "createdBy": null
},
"relationships": {
    "signatories": {
        "data": [
            {
                "type": "signatures",
                "id": "ac110005-9df4-1d1b-819d-f5eac478003b",
                "links": {
                    "self": "/signatures/ac110005-9df4-1d1b-819d-f5eac478003b"
                },
                "attributes": {
                    "name": "Leonardo Rosas",
                    "rfc": null,
                    "curp": null,
                    "email": "leonardo.rosas041024@gmail.com",
                    "sign_status": "PENDING",
                    "certificate_serial_number": null,
                    "certificate_issuer_name": null,
                    "signed_at": null,
                    "signature": null,
                    "updatedAt": "2026-05-04T20:14:56.888310424",
                    "createdAt": "2026-05-04T20:14:56.888302104"
                },
                "relationships": {
                    "timestamp": null
                }
            }
        ],
        "links": {
            "self": "/signatures"
        }
    },
    "constancy": null
}
}