Firmantes
Un firmante es una persona que debe firmar el documento. Los firmantes se envían al crear el documento, en el campo firmantes, como un arreglo JSON.
Qué se pide de cada uno
rut: el RUT de una persona natural, con o sin puntos y guion. Se guarda y se devuelve sin puntos, con guion y con el dígito verificador en minúscula. Se rechaza el RUT de una persona jurídica (desde 50.000.000) y un RUT repetido en el mismo documento.nombre: opcional. La identidad la verifica PINRUT y el documento lleva el nombre verificado.cargo: opcional. El cargo del firmante en este documento, declarado por quien envía, de hasta 80 caracteres. ValidaFirma no lo verifica; se imprime en la página de firmas y se muestra en la validación pública (ver cierre).canal: cómo le llega la invitación.
Cada documento admite de 1 a 100 firmantes. Para sumar firmantes a un documento pendiente, ver cierre. No hay orden de firma: cada persona firma cuando quiera.
Con cumplimiento_laboral (ver documento), cada firmante lleva email con su correo personal, también por WhatsApp o enlace. Si falta, la creación responde VALIDACION_ERROR con firmantes[i].email: obligatorio con cumplimiento laboral, sin crear ni cobrar.
Los tres canales
| Canal | Qué exige | Cómo llega la invitación |
|---|---|---|
email (por defecto) |
El campo email. |
Por correo. |
whatsapp |
El campo telefono, en formato internacional de Chile (+56 y nueve dígitos). |
Por WhatsApp, con respaldo por SMS. |
enlace |
Nada más. | ValidaFirma no envía nada: tú entregas la url_firma que devuelve la creación. |
El canal depende de cómo prefieren recibir la invitación quienes firman. Con enlace la url_firma es de ese firmante: trátala como una llave y entrégala solo a esa persona.
Validar el contacto
El campo opcional validar_contacto pide que el firmante confirme con un código su correo, su teléfono o los dos antes de firmar. Pedirlo vuelve obligatorio el dato. Con email solo admite telefono; con whatsapp, solo email; con enlace, uno o los dos.
Firmantes desatendidos
Un firmante desatendido ya creado se nombra con firmante_desatendido_id (un UUID) en vez de rut. No admite validar_contacto.
Reenviar una invitación
POST /api/fes/documentos/{documentoId}/reenviar-notificaciones reenvía la invitación a mano. Entre dos envíos al mismo firmante, por el mismo canal y al mismo destinatario, pasan 5 minutos. Cada firmante admite un reenvío por WhatsApp y cinco por correo (un envío que no llegó no cuenta), y a un mismo destinatario se le intenta como máximo tres veces sin éxito. En la API el tope y los intentos rigen desde la fecha de corte que se anuncia el día del despliegue; antes de esa fecha solo rige la espera. El reenvío es parcial: responde enviados y omitidos, y cada omitido trae su motivo (ventana, tope, intentos_fallidos, bloqueado, enlace, firmado; el documento de un poder se omite). Cuando pides un único firmante, el rechazo llega como error: si es muy pronto responde REENVIO_EN_VENTANA (con disponible_desde); si llegó al tope, REENVIO_TOPE_ALCANZADO; si agotó los intentos, REENVIO_INTENTOS_AGOTADOS; si el firmante está bloqueado, FIRMANTE_BLOQUEADO; si ya firmó, YA_FIRMADO.
Ejemplo con datos ficticios
[
{ "rut": "49999901-1", "canal": "email", "email": "firmante@ejemplo.cl" }
]
Para tu agente
Para saber qué canal usar, pregunta a la persona cómo prefiere que le lleguen las invitaciones a quienes firman. En prueba usa solo RUT de prueba y correos de ejemplo.cl. Un error en los datos responde VALIDACION_ERROR con detalles que nombran al firmante y el dato; léelos antes de reintentar.