Skip to main content
Los sellos de organización están disponibles en todos los planes sin coste adicional. Un crédito por envío cubre tanto las firmas de los destinatarios como los participantes de sello en la solicitud.

​
Qué es un sello de organización

Un sello de organización es un sello electrónico aplicado en nombre de una persona jurídica (tu empresa), no de una persona física. Coloca una imagen de sello de empresa y metadatos en el documento firmado de forma automática, sin requerir que una persona actúe en el momento de la firma. Úsalo para automatizar la contrafirma de tu empresa: la plataforma aplica el sello en la posición que elijas dentro del orden de firma, de modo que nadie de tu parte tiene que firmar el documento a mano. Cada sello incluye:
  • Una imagen de sello (cargada, generada a partir del nombre de la empresa o dibujada)
  • Un nombre visible y un cargo del firmante opcional
  • Una declaración registrada en el momento de la creación, confirmando la autoridad del creador para aplicar el sello en nombre de la empresa
El sello aparece en el PDF final junto a las firmas humanas. El certificado de finalización lo enumera como participante con la etiqueta “Aplicado automáticamente”, nunca “Firmado”.

​
Quién puede crear un sello

Solo los propietarios de la empresa (rol Propietario) pueden crear, reemplazar, revocar o borrar sellos de organización en el panel de control. Los sellos de empresa se gestionan en Configuración > Sellos de organización; los sellos de espacio de trabajo, en Configuración > Sellos de organización del espacio correspondiente. En la API, se requiere una clave API protegida (la clave del espacio de trabajo protegido de la empresa) para los sellos de ámbito de empresa. Los sellos de ámbito de espacio de trabajo aceptan la clave propia de ese espacio o la clave protegida.

​
La declaración de autoridad

Cada sello requiere una declaración antes de poder utilizarse. El creador lee y acepta una declaración confirmando que tiene la autoridad para vincular a la empresa. Esta aceptación se registra con:
  • La identidad del declarante (el usuario del panel de control o la clave API que realizó la llamada)
  • Dirección IP y user agent
  • Idioma y versión de la declaración
  • Un hash SHA-256 del texto canónico de la declaración

​
Reemplazar un sello

Desde el 13 de octubre de 2026, PATCH /seals/{id} crea una nueva versión cuando envías image, typed, display_name, signatory_title o statement. Lee primero el sello con GET /seals/{id}. Envía statement con accepted: true, version: 1, language, text exactamente igual al statement_text devuelto y signatory_name. Incluye statement.signatory_title si lo necesitas. Sin statement, la solicitud devuelve 400 SEAL_STATEMENT_REQUIRED y no escribe nada. Cada versión de reemplazo registra su propia aceptación: el momento del reemplazo (attested_at), el usuario o la clave API que lo realizó y el firmante enviado con el reemplazo (signatory_name y signatory_title_attested). El texto de la declaración, el hash SHA-256, el idioma, la versión de la declaración y authority_name siguen siendo los de la versión 1 del sello. Las solicitudes ya enviadas conservan la versión del sello fijada al enviarlas. Las solicitudes enviadas después del reemplazo usan la nueva versión; sus certificados muestran el nuevo firmante y la fecha de aceptación de la declaración. El comportamiento de creación de POST /seals no cambia. Para un sello cuyo statement_language sea es, envía este cuerpo a PATCH /seals/{id}. Sustituye el marcador de text por el statement_text exacto de GET /seals/{id}. Usa el idioma almacenado del sello para language.
Los objetos de sello devueltos por POST /seals, GET /seals, GET /seals/{id} y PATCH /seals/{id} incluyen statement_text y statement_hash. El objeto seal de los webhooks organization_seal.created, organization_seal.updated y organization_seal.deleted también los incluye. Los identificadores de usuario y clave API del declarante, la dirección IP y el user agent se excluyen de estos objetos de sello.

​
Ámbito y valores predeterminados

Los sellos existen en dos niveles: Establece como máximo un predeterminado por ámbito. El remitente siempre puede cambiar a un sello diferente del ámbito correspondiente al crear o editar una solicitud de firma.

​
Añadir un participante de sello

Un participante de sello es un espacio en el orden de firma que el sistema completa automáticamente. Añade participantes de sello a plantillas y solicitudes de firma junto con los destinatarios humanos. Destinatarios y sellos comparten un mismo espacio de orden.

​
En los editores

En el editor de plantillas abre el panel Usuarios de la plantilla de la barra lateral; en el editor de solicitudes de firma abre el panel Firmantes. Haz clic en Añadir sello, elige el sello en el desplegable de la fila y arrastra la fila para fijar su posición. La fila indica Se aplica al enviar en la primera posición y Se aplica tras el anterior en cualquier otra. Selecciona la fila del sello y coloca al menos un campo de sello en el documento. Mientras una fila de sello está seleccionada, la paleta de campos se limita a sello, texto y fecha.

​
A través de la API

En POST /signing-requests y POST /signing-requests/create-and-send, envía un array seal_participants. Cada entrada incluye:
  • temp_id es un identificador elegido por el cliente para asignar campos al sello (seal_participant_temp_id en el campo)
  • seal_id es el sello de organización a aplicar; debe estar en el ámbito del espacio de trabajo de la solicitud. En las rutas de creación puedes omitirlo para usar el sello predeterminado.
  • order es la posición en el espacio de orden compartido. Orden 1 (primera posición): el sello se aplica al enviar, antes de invitar a ningún destinatario o cobrar ningún crédito. Después del destinatario N: el sello se aplica automáticamente una vez que todos los participantes con un orden inferior hayan terminado
En PATCH /signing-requests/{id} y PATCH /templates/{id}, envía en su lugar un único objeto seal_participant. Sin id añade un participante de sello (seal_id, order); con el id de uno existente lo mueve (order) o cambia su sello (seal_id). En las solicitudes de firma, id con swap_to_seal_id intercambia uno en pausa (ver Intercambiar más abajo). PUT /templates/{id} acepta un array seal_participants y reemplaza el conjunto completo de participantes de sello de la plantilla. Aplica cada entrada de users y deleted_users por separado; las entradas aplicadas antes de un fallo permanecen aplicadas, así que vuelve a leer la plantilla después de cualquier respuesta distinta de 2xx. Para las entradas de un array seal_participants en las rutas de creación, un sello de otra empresa o limitado a otro espacio de trabajo devuelve 404 NOT_FOUND; un sello revocado, eliminado o reemplazado (que no es el actual) devuelve 409 SEAL_UNAVAILABLE; omitir seal_id cuando no hay un sello predeterminado devuelve 400 SEAL_UNAVAILABLE. Cuando los sellos de organización no están habilitados, una creación con sellos devuelve 503 SEALS_DISABLED. Al crear, una solicitud sin un sello resuelto numera los destinatarios según el orden del array cuando use_signing_order es false o algún destinatario omite order. Una creación basada en un documento con sellos requiere un order en cada destinatario y un espacio de orden contiguo. Los participantes de sello poseen campos de sello (al menos uno), un campo de fecha opcional y campos de texto rellenados a partir de display_name y signatory_title. Todos los campos de sello los genera el servidor y son de solo lectura; los valores proporcionados por el cliente en ellos se ignoran. Da a cada sello al menos un campo de estampa: enviar una solicitud de firma cuyo sello no tiene ninguno devuelve 400 SEAL_NO_IMAGE_FIELD. En POST /signing-requests y POST /signing-requests/create-and-send, un campo de texto propio de un sello puede usar seal_attribute (display_name o signatory_title) para elegir la propiedad del sello que imprime. Cualquier otro valor distinto de null devuelve 400 VALIDATION_ERROR; null se acepta. POST /templates no acepta seal_participants. Ignora la clave y devuelve una entrada en warnings en el 201. Añade sellos con PATCH /templates/{id} o PUT /templates/{id}. Para eliminar un participante de sello y sus campos de una solicitud no enviada, llama a DELETE /signing-requests/{id}/seal-participants/{participant_id}. Los participantes restantes se renumeran para cerrar el hueco.

​
Crear a partir de una plantilla

Cuando creas con template_id, la clave seal_participants decide qué ocurre con los sellos de la plantilla:
  • Ausente o null: la solicitud hereda los sellos de la plantilla y sus campos.
  • Un array: el array reemplaza los sellos de la plantilla. Los campos de sello de la plantilla no se copian.
  • []: la solicitud se crea sin sellos.
  • Cualquier otro tipo devuelve 400 VALIDATION_ERROR.
Los campos del cuerpo solo reemplazan campos de la plantilla; por eso, en una plantilla que tiene campos, los sellos de un array de reemplazo no pueden obtener un campo de estampa en esa llamada y enviar la solicitud devuelve 400 SEAL_NO_IMAGE_FIELD. Para usar tus propios sellos con sus campos, crea a partir de un documento (o, solo en POST /signing-requests, usa una plantilla sin campos y asigna campos del cuerpo con seal_participant_temp_id). En caso contrario, hereda los sellos de la plantilla. Un sello heredado usa la versión actual del sello. Si el sello no tiene versión actual, o esa versión está revocada o eliminada, la creación devuelve 409 SEAL_UNAVAILABLE y no se crea nada. Si se conserva al menos un sello heredado y los sellos de organización no están habilitados, la creación devuelve 503 SEALS_DISABLED. Un sello heredado limitado a otro espacio de trabajo se omite junto con sus campos, y la respuesta lo lista con dropped: true; cada entrada persistida tiene dropped: false. Cuando se resuelve al menos un sello en una creación basada en una plantilla, la solicitud se renumera 1..n. Los sellos heredados conservan su posición relativa a los destinatarios de la plantilla; los sellos de un array de reemplazo se colocan según su order; un sello va primero cuando empata con un destinatario. Desde el 13 de octubre de 2026, en POST /signing-requests y POST /signing-requests/create-and-send con template_id, si la plantilla no tiene destinatarios propios y seal_participants está ausente o es null, los sellos heredados conservan el orden de la plantilla en las posiciones 1..k; los destinatarios de la solicitud van después, a partir de k+1. Los arrays de reemplazo explícitos, las plantillas con destinatarios y las solicitudes sin sellos conservan su comportamiento de orden anterior. POST /templates/{id}/duplicate adjunta la versión almacenada del sello tal cual (un sello reemplazado, revocado o eliminado falla al enviar) y no devuelve seal_participants para ninguna empresa durante el funcionamiento normal. Mientras la edición multidocumento está suspendida, duplicar una plantilla en la ruta multidocumento de solo lectura devuelve 409 MULTI_DOCUMENT_READ_ONLY. Para las demás plantillas durante esa suspensión, la operación copia los sellos de la plantilla de la misma manera: versión actual, 409 SEAL_UNAVAILABLE, 503 SEALS_DISABLED, y los sellos limitados a otro espacio de trabajo distinto del de destino se listan con dropped: true; devuelve seal_participants.

​
Leer los sellos de una plantilla

GET /templates/{id} y PUT /templates/{id} devuelven seal_participants, ordenados por order, o [] cuando la plantilla no tiene ninguno.

​
Cambiar el orden

Los firmantes, los aprobadores y los sellos comparten un único espacio de orden; los destinatarios CC van aparte. En una solicitud no enviada, con PATCH /templates/{id} o PATCH /signing-requests/{id}:
  • Mueve un participante a una posición dentro de [1..n]. Los participantes entre la posición antigua y la nueva se desplazan una posición. Una posición de destino mayor que n devuelve 400 INVALID_SIGNING_ORDER.
  • Inserta un nuevo destinatario en una posición dentro de [1..n+1], u omite order para añadirlo al final. En un nuevo destinatario, order: 0 o una posición fuera de ese rango devuelve 400 INVALID_SIGNING_ORDER. Un nuevo participante de sello requiere un order entero positivo; un valor ausente o cero devuelve 400 VALIDATION_ERROR, y una posición fuera de [1..n+1] devuelve 400 INVALID_SIGNING_ORDER.
  • Si los participantes cambian de forma concurrente, una escritura puede devolver 409 PARTICIPANTS_CHANGED. Recarga y vuelve a intentarlo.
Una vez que una solicitud de firma está enviada (incluidas las finalizadas y canceladas), PATCH /signing-requests/{id} devuelve 409 ALREADY_SENT. La única excepción: un llamador protegido puede intercambiar un participante de sello en pausa en una solicitud que no está finalizada ni cancelada (ver Intercambiar más abajo). DELETE /signing-requests/{id}/seal-participants/{participant_id} devuelve 409 SEAL_MUTATION_NOT_ALLOWED en una solicitud enviada, y 409 ALREADY_FINISHED o 409 ALREADY_CANCELLED en una finalizada o cancelada.

​
Qué muestra el certificado

El certificado de finalización incluye una fila por participante de sello:
La columna Identidad muestra uno de tres valores: Si un sello fue pausado y luego intercambiado, ambos eventos aparecen en el certificado. No se registra dirección IP para los participantes de sello.

​
Revocar, detener pendientes e intercambiar

​
Revocar

Revocar un sello es prospectivo: los nuevos envíos no pueden usarlo, pero los participantes ya vinculados en solicitudes enviadas continúan aplicando su versión vinculada. Revoca desde el menú del sello en el panel de control o con DELETE /seals/{id}. Elige detener aplicaciones pendientes (DELETE /seals/{id}?stop_pending=true) para pausar también cada participante en tránsito que aún no se haya aplicado. Cada participante pausado:
  • Dispara un webhook signing_request.seal.paused
  • Envía un correo electrónico al remitente explicando qué solicitud se ve afectada
  • Bloquea el progreso de la firma hasta que el remitente lo resuelva

​
Intercambiar

Un participante de sello pausado puede intercambiarse por otro sello del ámbito correspondiente. Lo hace un propietario de la empresa desde la vista de la solicitud, o a través de la API con clave protegida:
Cada intercambio escribe una fila de seguimiento de solo adición. Después del envío, las únicas salidas para un participante de sello son intercambiar (en un participante pausado) o cancelar toda la solicitud.

​
Consultar un sello

  • GET /seals enumera los sellos visibles en el ámbito de la clave; GET /seals/{id} devuelve uno
  • GET /seals/{id}/image devuelve el PNG canónico. Cada lectura de imagen se registra en el registro de acceso del sello
  • GET /seals/{id}/applications enumera las solicitudes de firma en las que se aplicó el sello
  • GET /seals/{id}/access-log enumera los eventos de ciclo de vida y de lectura de imagen del sello

​
Borrado y retención

Las versiones de sellos, declaraciones y filas de registro de acceso se conservan mientras alguna solicitud de firma enviada o finalizada (incluidas las de prueba) haga referencia a la versión. Esto tiene la misma consideración que los documentos firmados. Un linaje de sello revocado que no esté referenciado por ninguna solicitud ni ninguna plantilla puede borrarlo un propietario de la empresa 90 días después de la revocación, en el panel de control o con DELETE /seals/{id}/erase. La respuesta enumera qué plantillas y solicitudes bloquean el borrado si las hay. El borrado se registra como solo adición.

​
Webhooks

Los sellos de organización generan siete tipos de eventos:

​
Eventos del ciclo de vida del sello

  • organization_seal.created: se creó un nuevo sello
  • organization_seal.updated: se reemplazó la imagen de un sello (nueva versión), se renombró o cambió su marca de predeterminado
  • organization_seal.deleted: se revocó un sello
  • organization_seal.erased: se borró permanentemente un linaje de sello revocado

​
Eventos de sello en solicitudes de firma

  • signing_request.seal.applied: se aplicó un sello a un documento
  • signing_request.seal.paused: se pausó un participante de sello (sello revocado con detención de pendientes, o discrepancia de integridad)
  • signing_request.seal.swapped: se intercambió un participante de sello pausado por un sello diferente
Suscríbete a estos eventos a través de la configuración de Webhooks. Al crear un sello, prefiere un nombre de empresa escrito o un logo de empresa en lugar de una reproducción de una firma autógrafa real. Una imagen manuscrita en un sello de organización es engañosa (implica que una persona firmó) y puede constituir un activo de falsificación. Los modos de texto y dibujo producen una marca limpia y reconocible que representa honestamente a la empresa.

​
Modo de prueba

Las claves API de prueba pueden crear y gestionar sellos activos. Las solicitudes de firma de prueba pueden aplicarlos. Cada documento de prueba lleva una marca de agua, por lo que ningún artefacto de prueba queda sin marcar. El sello digital PAdES se aplica a los documentos de prueba cuando está habilitado en el espacio de trabajo.

​
Guías relacionadas