No estoy de acuerdo
`). `null` si nadie ha rechazado. | | `signatures` | `Array` | Firmantes del documento. Ver [Campos de cada firmante](#campos-de-cada-firmante). | | `spectators` | `Array` | Espectadores del documento. Puede venir vacío; en los avisos de creación siempre viene vacío y los espectadores aparecen desde el aviso de subida del PDF. Ver [Campos de cada espectador](#campos-de-cada-espectador). | | `sign_position` | `string` | `UPPER_RIGHT`, `UPPER_LEFT`, `LOWER_RIGHT`, `LOWER_LEFT`, `NONE` o `CUSTOM`. | | `mode` | `string` | Modo de firmado: `CLASSIC`, `PDF_SIGNATURE` o `CLASSIC_BATCH`. | | `notification_mode` | `string` | `ENABLED` o `DISABLED`. | | `logo_mode` | `string` | `FULL_BRANDING`, `MEDIUM_BRANDING`, `NO_BRANDING` o `NO_SIGNATURE_SHEET`. | | `ordered` | `string` | `ACTIVE` (firma en orden) o `INACTIVE`. | | `company_id` | `string` | Carpeta de trabajo del documento. | | `created_at` | `string` | Fecha de creación del documento. | | `updated_at` | `string` | Fecha del último cambio. Úsala para ordenar los avisos. | > **Algunos nombres cambian respecto a la creación** > > Tres campos se llaman distinto en el webhook que en la petición de [crear documento](/document-management/create-document): `sign_mode` llega como `mode`, `mode_logo` llega como `logo_mode` y `sign_ordered` llega como `ordered`. Las fechas vienen en formato ISO 8601 sin zona horaria (por ejemplo, `2026-05-04T20:14:56.945158`). La cantidad de decimales de los segundos puede variar. #### Estados del documento (`signed`) | Valor | Significado | | :-: | :- | | `1` | Sin firmas. Nadie ha firmado ni rechazado todavía. | | `2` | Firmado parcialmente. Al menos un firmante firmó y faltan otros. | | `3` | Firmado. Todos los firmantes firmaron. | | `4` | Rechazado. Un firmante rechazó el documento y el proceso termina. | #### Campos de cada firmante | Campo | Tipo | Valores posibles / Descripción | | :- | :- | :- | | `id` | `string` | Identificador del firmante. Es el `signatureId` que se usa en [Firma vía API](/sign-via-api/sign-via-api-introduction). | | `signatureId` | `string` | Mismo valor que `id`. | | `name` | `string` | Nombre del firmante. | | `email` | `string` | Correo del firmante. | | `phone` | `string` \| `null` | Teléfono del firmante, si se envió. | | `rfc` | `string` \| `null` | RFC del firmante, si se conoce. | | `curp` | `string` \| `null` | CURP del firmante, si se conoce. | | `nameSource`, `emailSource`, `rfcSource`, `curpSource` | `string` \| `null` | Copias de `name`, `email`, `rfc` y `curp`. Usa los campos principales. | | `order` | `int` | Posición del firmante, empezando en `0`. Importa cuando `ordered` es `ACTIVE`. | | `signed` | `string` | Estado del firmante: `PENDING`, `SIGNED` o `REJECTED`. | | `signedAt` | `string` \| `null` | Fecha en que firmó. `null` si no ha firmado (también si rechazó). | | `signature` | `string` \| `null` | Firma digital en Base64. `null` si no ha firmado. | | `try` | `int` | Número de recordatorio en el que va el firmante. Empieza en `1`. | | `rememberAt` | `string` | Fecha del siguiente recordatorio (`YYYY-MM-DD`). | | `positions` | `Array` \| `null` | Posiciones de firma si el documento usa `sign_position: "CUSTOM"`; cada una con `posX`, `posY`, `width`, `height`, `page` y `rotation`. `null` en otro caso. | | `allowedSignatureMethods` | `Array` \| `null` | Métodos de firma permitidos para este firmante (`FIREL`, `EFIRMA`, `IDENTITY`, `SIMPLE`). `null` si no se limitaron. | | `createdAt` | `string` | Fecha de alta del firmante. | | `updatedAt` | `string` | Fecha del último cambio del firmante. | #### Campos de cada espectador | Campo | Tipo | Descripción | | :- | :- | :- | | `id` | `int` | Identificador numérico del espectador. | | `name` | `string` | Nombre del espectador. | | `email` | `string` | Correo del espectador. | | `createdAt` | `string` | Fecha de alta del espectador. | | `updatedAt` | `string` | Fecha del último cambio del espectador. | *** ### Ejemplos por estado Los ejemplos usan un documento con dos firmantes (Juan Perez y Maria Lopez) y un espectador. Los datos son ficticios. **1 · Sin firmas** Documento con el PDF ya subido y ningún firmante ha actuado. ```json { "id": "ac110005-9df4-1d1b-819d-f5eac471003a", "file": "contrato-servicios.pdf", "tries": 3, "remember_every": 3, "remember_at": "12:30", "signed": 1, "signed_at": null, "xml_with_signs": null, "webhook": "https://tudominio.com/webhooks/verificamex-firma", "redirect_url": "https://tudominio.com/fin-firma", "reject_commentary": null, "signatures": [ { "id": "ac110005-9df4-1d1b-819d-f5eac478003b", "email": "jpe@gmail.com", "phone": "+522291449388", "name": "Juan Perez", "rememberAt": "2026-05-07", "rfc": null, "curp": null, "signature": null, "signed": "PENDING", "try": 1, "createdAt": "2026-05-04T20:14:56.888302", "updatedAt": "2026-05-04T20:14:56.888310", "positions": null, "allowedSignatureMethods": null, "order": 0, "signatureId": "ac110005-9df4-1d1b-819d-f5eac478003b", "emailSource": "jpe@gmail.com", "signedAt": null, "nameSource": "Juan Perez", "rfcSource": null, "curpSource": null }, { "id": "ac110005-9df4-1d1b-819d-f5eac47a003c", "email": "mlopez@tudominio.com", "phone": null, "name": "Maria Lopez", "rememberAt": "2026-05-07", "rfc": null, "curp": null, "signature": null, "signed": "PENDING", "try": 1, "createdAt": "2026-05-04T20:14:56.891004", "updatedAt": "2026-05-04T20:14:56.891010", "positions": null, "allowedSignatureMethods": null, "order": 1, "signatureId": "ac110005-9df4-1d1b-819d-f5eac47a003c", "emailSource": "mlopez@tudominio.com", "signedAt": null, "nameSource": "Maria Lopez", "rfcSource": null, "curpSource": null } ], "spectators": [ { "id": 88416, "name": "Hector Lavoe", "email": "hl@hotmail.com", "createdAt": "2026-05-04T20:14:56.918561", "updatedAt": "2026-05-04T20:14:56.918583" } ], "sign_position": "LOWER_RIGHT", "mode": "PDF_SIGNATURE", "notification_mode": "ENABLED", "logo_mode": "FULL_BRANDING", "ordered": "INACTIVE", "company_id": "ac110005-9d0c-1243-819d-0c3b71220000", "created_at": "2026-05-04T20:14:56.945158", "updated_at": "2026-05-04T20:16:10.402771" } ``` **2 · Firmado parcialmente** Juan Perez ya firmó; falta Maria Lopez. ```json { "id": "ac110005-9df4-1d1b-819d-f5eac471003a", "file": "contrato-servicios.pdf", "tries": 3, "remember_every": 3, "remember_at": "12:30", "signed": 2, "signed_at": "2026-05-05T17:02:41.633120415", "xml_with_signs": null, "webhook": "https://tudominio.com/webhooks/verificamex-firma", "redirect_url": "https://tudominio.com/fin-firma", "reject_commentary": null, "signatures": [ { "id": "ac110005-9df4-1d1b-819d-f5eac478003b", "email": "jpe@gmail.com", "phone": "+522291449388", "name": "Juan Perez", "rememberAt": "2026-05-07", "rfc": null, "curp": null, "signature": "El monto del contrato no es correcto.
", "signatures": [ { "id": "ac110005-9df4-1d1b-819d-f5eac478003b", "email": "jpe@gmail.com", "phone": "+522291449388", "name": "Juan Perez", "rememberAt": "2026-05-07", "rfc": null, "curp": null, "signature": null, "signed": "REJECTED", "try": 1, "createdAt": "2026-05-04T20:14:56.888302", "updatedAt": "2026-05-05T17:02:40.715", "positions": null, "allowedSignatureMethods": null, "order": 0, "signatureId": "ac110005-9df4-1d1b-819d-f5eac478003b", "emailSource": "jpe@gmail.com", "signedAt": null, "nameSource": "Juan Perez", "rfcSource": null, "curpSource": null }, { "id": "ac110005-9df4-1d1b-819d-f5eac47a003c", "email": "mlopez@tudominio.com", "phone": null, "name": "Maria Lopez", "rememberAt": "2026-05-07", "rfc": null, "curp": null, "signature": null, "signed": "PENDING", "try": 1, "createdAt": "2026-05-04T20:14:56.891004", "updatedAt": "2026-05-04T20:14:56.891010", "positions": null, "allowedSignatureMethods": null, "order": 1, "signatureId": "ac110005-9df4-1d1b-819d-f5eac47a003c", "emailSource": "mlopez@tudominio.com", "signedAt": null, "nameSource": "Maria Lopez", "rfcSource": null, "curpSource": null } ], "spectators": [ { "id": 88416, "name": "Hector Lavoe", "email": "hl@hotmail.com", "createdAt": "2026-05-04T20:14:56.918561", "updatedAt": "2026-05-04T20:14:56.918583" } ], "sign_position": "LOWER_RIGHT", "mode": "PDF_SIGNATURE", "notification_mode": "ENABLED", "logo_mode": "FULL_BRANDING", "ordered": "INACTIVE", "company_id": "ac110005-9d0c-1243-819d-0c3b71220000", "created_at": "2026-05-04T20:14:56.945158", "updated_at": "2026-05-05T17:02:41.633201" } ``` *** ### Cómo identificar qué pasó Como el cuerpo siempre es el documento completo, compara lo que recibes con lo último que guardaste: 1. **Valida la firma:** si no coincide, responde `401` y descarta el aviso (ver [Seguridad de webhooks](/webhooks/webhooks-security)). 2. **Descarta avisos viejos:** si `updated_at` es menor o igual al último que procesaste para ese `id`, ignóralo. 3. **Revisa `signed`:** `3` significa que ya puedes [descargar el PDF firmado](/document-management/download-signed-pdf); `4` significa que el proceso terminó por rechazo y el motivo está en `reject_commentary`. 4. **Revisa cada firmante:** el que cambió de `PENDING` a `SIGNED` o `REJECTED` es quien acaba de actuar. ```js // Ejemplo con Express. verifyVerificamexFirmaSignature está en "Seguridad de webhooks". app.post('/webhooks/verificamex-firma', express.raw({ type: 'application/json' }), async (req, res) => { if (!verifyVerificamexFirmaSignature(req.body, req.get('X-Verificamex-Firma-Signature'), WEBHOOK_SECRET)) { return res.sendStatus(401); // No lo envió Verificamex Firma o lo modificaron. } res.sendStatus(200); // Responde rápido; procesa después. const doc = JSON.parse(req.body.toString('utf8')); const previous = await db.documents.find(doc.id); if (previous && previous.updated_at >= doc.updated_at) return; // Aviso viejo o repetido. switch (doc.signed) { case 1: /* Sin firmas */ break; case 2: /* Firmado parcialmente */ break; case 3: /* Firmado: descarga el PDF firmado */ break; case 4: /* Rechazado: doc.reject_commentary */ break; } await db.documents.save(doc); }); ```