Errores SAF de Autofirma: qué significa cada código
Qué significa cada código SAF de Autofirma según su código fuente: mensaje literal, causa real y por dónde empezar, con SAF_08 y SAF_45 al detalle.
Actualizado el
Los códigos de error de Autofirma empiezan siempre por SAF_ seguido de un número. La sede electrónica suele mostrarlos en una ventana emergente con poco más contexto que «Error en la firma», y a partir de ahí cada uno busca el código en Google y cae en páginas que se contradicen entre sí. Esta guía resuelve eso de la única forma fiable: leyendo el código fuente de Autofirma, que es público, y anotando qué hace exactamente la aplicación cuando lanza cada código.
Los códigos con más búsquedas tienen su propia guía con el orden exacto de comprobaciones: SAF_03, SAF_08, SAF_09, SAF_16 y SAF_11, SAF_19, SAF_26 y SAF_27 y SAF_45. Lo que sigue es la referencia completa.
De dónde salen los códigos
Autofirma es una aplicación de escritorio a la que la sede llama mediante el protocolo afirma://. La clase que gestiona esa llamada, Protocol, define una constante por cada situación de error y le asocia un código SAF_xx y un mensaje en castellano. Cuando algo falla, la sede recibe el código y la aplicación muestra el mensaje. Los códigos son estables entre versiones —no se reasignan—, pero algunos han desaparecido del código actual y otros nuevos se han añadido, así que las listas de hace cinco años ya no coinciden con lo que la aplicación hace hoy.
La tabla siguiente está tomada del código en la rama principal del proyecto en GitHub. Los mensajes son literales, con sus erratas incluidas (el «envio» sin tilde de SAF_11 y el «ningun» de SAF_19 vienen así en la aplicación).
Tabla de códigos SAF verificados
| Código | Nombre interno | Mensaje literal | Qué significa y por dónde empezar |
|---|---|---|---|
| SAF_03 | ERROR_ | Error en los parámetros de entrada | La petición que envía la sede está mal formada o pide algo que tu versión no soporta. Actualiza Autofirma; si persiste, es la sede. Guía completa. |
| SAF_08 | ERROR_ | Error accediendo al almacén de claves y certificados | Autofirma no puede abrir el almacén de certificados: perfil de Firefox equivocado, entrada sin clave privada, almacén dañado. Guía completa. |
| SAF_09 | ERROR_ | Error realizando la firma electrónica | La operación de firma en sí ha fallado: controlador, clave inaccesible, algoritmo no soportado. Firma el fichero fuera de la sede para aislar la causa. Guía completa. |
| SAF_11 | ERROR_ | Error en el envio del resultado de la operación. | La firma se hizo, pero no se pudo devolver al servidor intermedio de la sede: proxy, cortafuegos corporativo, opción «sitios seguros». Guía junto a SAF_16. |
| SAF_13 | ERROR_ | Se ha pedido acceso a una dirección local, pero por seguridad se ha bloqueado el acceso | La sede intentó que Autofirma accediera a una dirección local y la aplicación lo bloqueó. Suele ser una integración mal configurada. |
| SAF_14 | ERROR_ | La aplicación está obsoleta y no puede procesarse la petición. Por favor, instale una versión actualizada y reintente el proceso de nuevo. | Lo que dice: la sede exige una versión más nueva. Desinstala e instala la última desde el portal oficial. |
| SAF_16 | ERROR_ | Error al recuperar los datos del servidor intermedio | Autofirma no pudo descargar lo que tenía que firmar: proxy, sesión caducada en la sede, raíz de confianza que falta. Vuelve a empezar el trámite. Guía completa. |
| SAF_19 | ERROR_ | No hay ningun certificado válido en su almacén. Compruebe las fechas de caducidad e instale un certificado válido. | El almacén se abrió pero no hay ningún certificado utilizable: caducado, en otro almacén, sin clave privada o filtrado por la sede. Guía completa. |
| SAF_26 | ERROR_ | Error en la comunicación con el servicio de firma de lotes. | Solo en firma por lotes (portafirmas): el servicio de lotes de la sede no responde. No depende de tu equipo. Guía junto a SAF_27. |
| SAF_27 | ERROR_ | El servicio informó de un error durante la firma del lote. | El servicio de lotes devolvió un error. Tampoco es tu equipo; contacta con la sede. Guía completa. |
| SAF_41 | ERROR_ | El uso de este trámite web requiere una versión más reciente de Autofirma. Actualice a la última versión disponible. | Igual que SAF_14, con otra redacción: actualiza. |
| SAF_45 | ERROR_ | No se pudo abrir un socket para la comunicación con la aplicación | El navegador y Autofirma no consiguen hablarse por el puerto local: antivirus, cortafuegos, puerto ocupado, certificado raíz del Llavero. Guía completa. |
Fuente: código de Autofirma en GitHub, revisado el 2026-09-01 (Protocol y protocolmessages_; enlaces al final).
El código actual define bastantes más constantes de las que aparecen en la tabla —de SAF_00 a SAF_53, con huecos—, pero la mayoría son situaciones que el usuario rara vez ve: datos que no son un PDF (SAF_28), PDF con contraseña (SAF_33), PDF certificado que no admite más firmas (SAF_35), tipo de clave no soportado (SAF_51), almacén o tarjeta bloqueados (SAF_52, «El almacen de claves esta bloqueado») y el genérico SAF_53, «Error desconocido». Si tu código es uno de estos, el mensaje que lo acompaña es literal y suele bastar. Ten en cuenta también que las sedes que ya usan la versión 4.1 o superior del protocolo reciben los errores en otro formato, con un código más largo y una descripción, en lugar del SAF_xx clásico.
Los códigos que no aparecen en la tabla
Si has buscado tu código y no está arriba, hay dos posibilidades. La primera es que sea un código que ya no existe en el código actual de Autofirma: SAF_07, SAF_10, SAF_22, SAF_24, SAF_36, SAF_37, SAF_40 o SAF_42 aparecen en listados de terceros porque los tuvieron versiones antiguas. Si tu Autofirma los muestra, el primer paso es siempre el mismo: actualizar a la última versión y volver a intentarlo. La segunda es que sea un error sin código SAF, un mensaje literal que también tiene su historia:
- «Error al obtener los alias de los certificados»: Autofirma no consigue enumerar los certificados del almacén. Mismo terreno que SAF_08 y SAF_19; en Linux y con Firefox es casi siempre el perfil o la base de datos NSS. Guía completa.
- «Error al cargar el nuevo almacén de claves»: el almacén que has seleccionado en Preferencias no se puede abrir. Cambia al otro almacén disponible.
- «Autofirma no instalada o con problemas. Revise requisitos mínimos»: lo muestra la sede, no Autofirma, cuando la llamada
afirma://no obtiene respuesta. Es el mismo problema que SAF_45 visto desde el otro lado; el diagnóstico en tres preguntas está en Autofirma no funciona y, si la aplicación ni arranca, en Autofirma no se abre. - «Apple no ha podido verificar…» y «quiere usar el llavero Sistema»: son avisos de macOS, no de Autofirma. Los cubre Autofirma no funciona en Mac.
Cómo leer un SAF en treinta segundos
Los doce códigos de la tabla se agrupan en cuatro familias, y saber en cuál estás ahorra la mitad del diagnóstico:
- Tu almacén de certificados (SAF_08, SAF_19, SAF_52): Autofirma no encuentra un certificado con el que firmar, o el almacén está bloqueado. Se arregla en tu equipo, revisando almacén, perfil de Firefox y clave privada.
- La comunicación local (SAF_45, SAF_13): el navegador y la aplicación no se hablan. Antivirus, cortafuegos, puerto y certificado raíz local.
- La comunicación con la sede (SAF_11, SAF_16, SAF_26, SAF_27): la firma o los datos no viajan entre tu equipo y el servidor intermedio. Proxy, red corporativa o un servicio de la sede caído.
- Versiones y parámetros (SAF_03, SAF_14, SAF_41): la sede pide algo que tu versión no hace. Actualizar resuelve la mayoría; si no, es la integración de la sede. Y uno aparte, la operación de firma en sí (SAF_09): certificado encontrado, clave que no responde.
Cuándo dejar de pelear con Autofirma
Merece la pena distinguir dos situaciones que la gente mezcla:
- Necesitas firmar dentro de la sede, en un formulario que se firma en el propio navegador. Aquí no hay atajo: o consigues que Autofirma funcione, o usas Cl@ve o el certificado desde otro equipo. ¿Lo aceptará la sede? explica cómo reconocer este caso.
- Necesitas entregar un PDF firmado. Es el caso mayoritario: un anexo, una declaración responsable, un contrato, una autorización. Aquí Autofirma es solo la herramienta que alguien te recomendó, no un requisito legal.
En el segundo caso, el código SAF deja de importar. Firmas el PDF con cualquier herramienta que produzca una firma PAdES válida y lo adjuntas ya firmado. FirmaLocal hace exactamente eso desde el navegador, sin instalar nada y sin almacén que acertar: cargas tu certificado .p12 y tu PDF, y la firma se calcula en tu propio equipo. Puedes probarlo ahora mismo y comprobar el resultado en VALIDe.
Cómo comprobar que la firma ha quedado bien
Sea cual sea la herramienta que uses, la comprobación es la misma y lleva un minuto:
- Abre el PDF firmado en Adobe Acrobat Reader. Debe aparecer el panel de firmas arriba, indicando que el documento está firmado.
- Sube el PDF a VALIDe, el validador oficial de la Administración, y comprueba que reconoce la firma y el certificado.
- Verifica que el nombre del firmante coincide con el titular del certificado y que la fecha es la esperada.
Si esas tres cosas se cumplen, el documento es válido para presentarlo, independientemente del programa con el que lo hayas firmado.
Fuentes
Protocol, donde se definen los códigosInvocation Launcher Error Manager. java SAF_xxy su constante interna. Consultado el 2026-09-01.protocolmessages_, con los mensajes literales en castellano. Consultado el 2026-09-01.es_ ES. properties - FNMT, «Errores con Autofirma», preguntas frecuentes de la sede. Consultado el 2026-09-01.