Firma electrónica de estados de pago y certificados de obra

La firma electrónica permite asociar una persona con un documento electrónico y registrar su manifestación dentro de un proceso. En un estado de pago o certificado de obra, su valor operativo depende de algo más que mostrar una firma dibujada: la organización debe saber qué versión se firmó, quién fue convocado, qué autenticación se utilizó y cuál fue el resultado.

La Ley 19.799 regula en Chile los documentos electrónicos, la firma electrónica y los servicios de certificación. Distingue categorías y efectos que deben revisarse según el documento y el caso. Una plataforma de obra no debe afirmar que toda firma tiene idéntico efecto ni decidir por sí sola qué modalidad exige un contrato.

Aprobación y firma son decisiones relacionadas, pero distintas

El workflow interno puede aprobar un estado de pago antes de generar el documento que se enviará a firma. La firma posterior confirma la actuación sobre esa versión. Si el documento cambia, la firma anterior no debería aparecer asociada a la nueva revisión.

También puede existir una secuencia de firmantes: contratista, inspección, administración de contrato y mandante. Define si firman en paralelo o en orden, qué ocurre ante un rechazo y quién puede reiniciar el proceso.

Evidencia mínima de un expediente de firma

Integrar un proveedor sin perder el control del expediente

Una integración puede crear el documento en el proveedor, registrar firmantes y recibir eventos por webhook. ZapSign, por ejemplo, documenta eventos como creación, visualización, firma, rechazo y expiración. Esos eventos ayudan a actualizar el estado, pero deben validarse, procesarse de forma idempotente y relacionarse con el identificador interno correcto.

Los enlaces temporales del proveedor no son un archivo de largo plazo. La propia documentación de ZapSign advierte que ciertas URL expiran; por eso conviene descargar y conservar el documento final según la política del proyecto, junto con el identificador externo y la evidencia de la firma.

Un webhook no es una orden ciega

El endpoint receptor debe verificar el secreto o mecanismo acordado, rechazar cargas inválidas y tolerar eventos repetidos. Nunca uses solo el nombre del archivo para encontrar el estado de pago. Relaciona el evento mediante un identificador externo previamente guardado y confirma que pertenece a la organización y documento esperados.

Si llega un evento fuera de orden, el sistema no debe retroceder silenciosamente de firmado a enviado. Registra el evento, aplica reglas de transición y deja el caso visible para revisión cuando sea inconsistente.

Qué ocurre cuando alguien rechaza

El rechazo debe registrar persona, fecha y motivo cuando el proveedor lo entregue. La versión rechazada permanece congelada. El equipo corrige el origen —por ejemplo, una partida, monto o antecedente— y genera una nueva revisión con su propio proceso de firma.

Sobrescribir el PDF rechazado borra evidencia de la conversación contractual. Reenviar el mismo enlace después de modificar un archivo local también rompe la cadena entre aprobación y firma.

Seguridad y privacidad

Limita quién puede iniciar, cancelar o reenviar una firma. No expongas tokens del proveedor al navegador. Protege los callbacks, cifra secretos y evita registrar documentos o datos personales en logs. El historial visible al usuario debe mostrar lo necesario para operar sin revelar credenciales técnicas.

Firma dentro de Codenergy

Codenergy genera el documento desde la versión aprobada, inicia el flujo con ZapSign y conserva estados y archivos vinculados al contrato. La integración ayuda a eliminar la descarga, envío y carga manual; la modalidad de firma y la matriz de autoridad siguen definiéndose para cada organización.

Guía editorial de organización operacional y documental. Los ejemplos son ficticios y deben adaptarse al contrato, los procedimientos aprobados y los requisitos aplicables a cada proyecto.