Ir al contenido
Volver a los artículos
Tecnología9 min de lecturaActualizado:

Certificado KSeF o token: cómo conectar el CRM y la tienda online a la API del KSeF 2.0

Cómo inicia sesión un CRM, una tienda online o un portal B2B en la API del KSeF 2.0, el sistema polaco de facturación electrónica: token o certificado KSeF, validez de los tokens después de 2026 según el proyecto de 27/10/2026, cómo obtener el certificado, el certificado offline y los entornos TEST y DEMO.

En resumen

  • Un CRM, una tienda online o un portal B2B que envía por sí mismo las facturas al KSeF (Krajowy System e-Faktur, el sistema polaco de facturación electrónica) inicia sesión en la API del KSeF 2.0 con un token KSeF o con un certificado KSeF de autenticación. Ambos métodos funcionan en paralelo.
  • Según el reglamento vigente, los tokens funcionan hasta el 31 de diciembre de 2026. El Ministerio de Finanzas polaco ha anunciado que el método se mantiene, y el proyecto de modificación del reglamento de 27 de octubre de 2026 prevé que los tokens actuales sean válidos hasta el 30 de noviembre de 2027 y los nuevos, como máximo 365 días. A 14 de noviembre de 2026, se trata de un proyecto.
  • El certificado KSeF es válido como máximo 2 años. Se solicita en la Aplikacja Podatnika KSeF 2.0 (la aplicación del contribuyente del Ministerio de Finanzas) o a través de la API, tras iniciar sesión con Profil Zaufany (la identidad electrónica pública polaca), firma cualificada o sello electrónico cualificado. Con un token no se puede solicitar un certificado.
  • Para las facturas en modo offline se necesita un certificado offline independiente: sin él, el sistema no generará el segundo código QR.
  • La integración se prueba primero en el entorno TEST, después en DEMO y solo al final en producción.

¿Cómo inicia sesión un CRM o una tienda online en la API del KSeF 2.0?

Un programa que envía facturas al KSeF sin intervención humana no inicia sesión con una contraseña. En cada conexión sigue un breve procedimiento: obtiene del KSeF un desafío de un solo uso, lo confirma con un token o con una firma mediante certificado y, a cambio, recibe un token de acceso con el que envía y descarga facturas. El token de acceso es válido entre diez y veinte minutos, y el token de actualización, como máximo 7 días. Pasado ese tiempo, el sistema tiene que autenticarse de nuevo.

Autenticación en la API del KSeF 2.0 paso a paso (documentación del Ministerio de Finanzas, a 14/11/2026)
PasoLlamada a la APIQué hay que saber
1. DesafíoPOST /auth/challengeEl desafío es válido durante 10 minutos.
2a. CertificadoPOST /auth/xades-signatureEl sistema firma un documento XML con el desafío y el NIP (NIF polaco) mediante una firma XAdES: con certificado KSeF, firma cualificada o sello electrónico cualificado.
2b. Token KSeFPOST /auth/ksef-tokenEl sistema envía el token unido a la marca de tiempo del desafío, cifrado con la clave pública del Ministerio de Finanzas.
3. EstadoGET /auth/{referenceNumber}Se consulta hasta obtener un resultado. La verificación de una firma cualificada ante su prestador puede tardar más; la del certificado KSeF es inmediata.
4. Tokens de accesoPOST /auth/token/redeemDevuelve el token de acceso y el token de actualización. Una segunda llamada con el mismo token de autenticación termina en error.
5. RenovaciónPOST /auth/token/refreshNuevo token de acceso sin volver a iniciar sesión, mientras el token de actualización siga siendo válido.
Fuente: documentación de la API del KSeF 2.0 del Ministerio de Finanzas polaco en GitHub (autenticación).

Token o certificado KSeF: ¿qué elegir para la integración?

Según las preguntas frecuentes del Ministerio de Finanzas, el token y el certificado funcionan en paralelo, y un sistema externo puede utilizar uno u otro. Se diferencian en cómo se obtienen, en su validez y en lo que permiten hacer además de iniciar sesión.

Token KSeF y certificado KSeF en la integración (a 14/11/2026)
CaracterísticaToken KSeFCertificado KSeF (autenticación)
Qué esCadena de caracteres generada en el KSeF con un alcance de permisos definido, p. ej., envío y lectura de facturas.Confirmación electrónica de la identidad de una persona o empresa, con un par de claves. La clave privada se queda en su poder.
Cómo se obtieneSe genera en la Aplikacja Podatnika KSeF 2.0 o a través de la API (POST /tokens) tras iniciar sesión.Solicitud en la Aplikacja Podatnika KSeF 2.0 o a través de la API, tras iniciar sesión con Profil Zaufany, firma cualificada o sello electrónico cualificado.
ValidezNormativa vigente: hasta el 31/12/2026. Proyecto de 27/10/2026: los actuales, hasta el 30/11/2027; los nuevos, como máximo 365 días.Como máximo 2 años, con posibilidad de renovarlo mientras sea válido.
PermisosRegistrados en el token. Cambiar el alcance supone generar un token nuevo.El certificado no los contiene: el KSeF comprueba los permisos de la persona o empresa a cuyo nombre se emitió.
Requisitos para el sistemaCifrado del token con la clave pública del Ministerio de Finanzas.Firma XAdES del documento de autenticación.
LimitacionesTras iniciar sesión con un token no se puede generar un certificado KSeF.No sirve para iniciar sesión en la Aplikacja Podatnika KSeF: está pensado para sistemas que se conectan a través de la API.
Base: § 6 y § 13 del reglamento de 12/12/2025 (Dz.U. 2025 poz. 1815), página del Ministerio de Finanzas sobre los certificados KSeF, preguntas frecuentes sobre KSeF 2.0 y documentación de la API.

El token es más sencillo para empezar, porque el sistema no tiene que firmar documentos XAdES. El certificado ofrece una validez más larga y previsible y, en una integración que se desarrolla hoy, tiene otra ventaja: no depende de cómo termine el cambio de la normativa sobre los tokens. Lo más seguro es desarrollar la integración de forma que el método de inicio de sesión pueda cambiarse en la configuración, sin modificar el programa.

¿Cómo obtener un certificado KSeF paso a paso?

Desde febrero de 2026, el certificado se solicita en la Aplikacja Podatnika KSeF 2.0 o a través de la API del KSeF 2.0. El Moduł Certyfikatów i Uprawnień (MCU, el módulo de certificados y permisos), en el que se emitían los certificados desde noviembre de 2025, funcionó hasta finales de enero de 2026. En la aplicación, el proceso es el siguiente:

  1. Inicie sesión en la Aplikacja Podatnika KSeF 2.0 con Profil Zaufany (a través de login.gov.pl), con firma cualificada o con el sello electrónico cualificado de la empresa. Compruebe que trabaja en el contexto del NIP correcto.
  2. Abra la pestaña «Certyfikaty» (certificados) y elija «Wnioskuj o certyfikat» (solicitar certificado). La aplicación toma los datos de la solicitud del inicio de sesión.
  3. Elija el uso: autenticación o modo offline. Cada certificado tiene un único uso, así que para ambos necesita dos solicitudes.
  4. Proteja la clave privada. El par de claves se crea al hacer la solicitud, y al Ministerio solo llega la clave pública. Sin la clave privada, el certificado no sirve de nada, y quien la tenga puede actuar en su nombre dentro de los límites de sus permisos.
  5. Descargue el certificado y cárguelo en el sistema junto con la clave privada, por un canal seguro. No envíe la clave por correo electrónico.
  6. Anote la fecha de caducidad. Puede solicitar el siguiente certificado antes de que caduque el anterior. Programe un recordatorio con al menos un mes de antelación.

El sistema también puede presentar la solicitud por sí mismo, a través de la API: comprueba los límites (GET /certificates/limits), obtiene los datos para la solicitud (GET /certificates/enrollments/data), envía una solicitud CSR en formato PKCS#10 (POST /certificates/enrollments), comprueba el estado y descarga el certificado (POST /certificates/retrieve). La documentación admite claves RSA 2048 y EC P-256 y recomienda EC. Solo el titular puede revocar un certificado, p. ej., tras una filtración de la clave (POST /certificates/{numer}/revoke), y un certificado revocado no se puede restaurar.

¿De quién debe ser el certificado que usa el sistema de la empresa?

El certificado confirma la identidad, pero no otorga permisos. En cada conexión, el KSeF comprueba qué puede hacer la persona o empresa a cuyo nombre se emitió el certificado. Según las preguntas frecuentes del Ministerio de Finanzas, pueden obtener un certificado las personas físicas identificadas con NIP o PESEL (el número de identificación personal polaco) y las empresas que inician sesión con un sello electrónico cualificado. El certificado de una empresa se puede compartir con los empleados, mientras que el de un autónomo (JDG, jednoosobowa działalność gospodarcza) es personal.

  • Certificado de la empresa (sello electrónico cualificado): la integración no depende de una sola persona. Es una opción razonable para un CRM o una tienda online que emite las facturas de toda la empresa.
  • Certificado de un empleado: funciona mientras ese empleado tenga permisos en el KSeF para la empresa. Si se marcha y pierde los permisos, el sistema dejará de enviar facturas.
  • Gestoría o proveedor externo: inicia sesión con su propio certificado y actúa dentro de los permisos que le ha concedido la empresa. El proyecto de modificación del reglamento de 27 de octubre de 2026 prevé también un certificado emitido en el contexto de un único NIP indicado, es decir, que solo funciona para un cliente concreto. Es un proyecto.

¿Cuándo se necesita un certificado KSeF offline?

Cuando emite una factura sin conexión con el KSeF, tiene que marcarla con dos códigos QR. El primero permite verificar la factura en el KSeF; el segundo confirma la identidad del emisor y requiere un certificado KSeF para el modo offline. Ese certificado no sirve para iniciar sesión, y el certificado de inicio de sesión no puede firmar el código QR. Plazos para enviar la factura al KSeF después de emitirla, según la documentación de la API:

Modos offline en el KSeF 2.0 y plazos para enviar la factura
ModoCuándoPlazo de envío al KSeF
offline24Por cualquier motivo, a decisión del contribuyenteHasta el día hábil siguiente a la fecha de emisión
offline (indisponibilidad)Indisponibilidad del KSeF anunciadaHasta el día hábil siguiente al fin de la indisponibilidad
de emergenciaAvería del KSeF anunciadaHasta 7 días hábiles desde el fin de la avería
avería totalAvería anunciada en los medios de comunicaciónFactura sin códigos QR y sin obligación de enviarla después al KSeF
Fuente: modos offline en la documentación de la API del KSeF 2.0.

Para el sistema, esto supone cuatro cosas: enviar la factura marcada como emitida en modo offline, tomar la fecha de emisión exclusivamente del campo P_1, incluir ambos códigos QR en la copia impresa y en el PDF, y controlar el plazo de envío. Una tienda online o un CRM sin certificado offline no podrá emitir una factura correcta a una empresa mientras el KSeF no esté disponible.

¿Dónde probar la integración con el KSeF: TEST, DEMO o producción?

Entornos de la API del KSeF 2.0 (documentación del Ministerio de Finanzas de 16/03/2026)
EntornoDirección de la APIPara qué sirve
TESTapi-test.ksef.mf.gov.plPrimeras pruebas de la integración. Números NIP ficticios, certificados generados por uno mismo; los datos pueden ser visibles para otros integradores. Pausas de mantenimiento de 16 a 18 h.
DEMO (preproducción)api-demo.ksef.mf.gov.plÚltima comprobación con una configuración similar a la de producción. Sin facturas reales ni datos reales de empresas.
Producciónapi.ksef.mf.gov.plFacturas con plenos efectos jurídicos.
La especificación OpenAPI está en la dirección de cada entorno con el sufijo /docs/v2. El Ministerio también ofrece bibliotecas cliente oficiales en C# y Java.

En TEST se comprueba el inicio de sesión, el envío de una factura, el rechazo, la factura rectificativa y el modo offline. En DEMO se repite lo mismo con el certificado que utilizará en producción. No envíe facturas reales a ninguno de estos entornos.

¿Qué más debe gestionar la integración, además del inicio de sesión?

  • Renovación del acceso: actualización del token de acceso y nuevo inicio de sesión cuando caduque el token de actualización.
  • Avisos de caducidad: advertencia antes de que caduque el certificado o el token, enviada a la persona que puede generar uno nuevo.
  • Almacenamiento seguro: el token y la clave privada, en un gestor de secretos o en una configuración cifrada, nunca en el código del programa ni en una hoja de cálculo.
  • Método de inicio de sesión intercambiable: pasar del token al certificado sin rehacer la integración.
  • Facturas: envío en FA(3), número KSeF y UPO (el acuse de recibo oficial) junto a la factura, gestión de rechazos, facturas rectificativas con el número KSeF de la factura original, descarga de facturas recibidas y límites de peticiones a la API.

Comparamos las formas de conectar una tienda online y un CRM al KSeF, con sus precios (aplicación del Ministerio de Finanzas, programa de facturación, plugin, pasarela API, integración directa), en el artículo KSeF en el CRM y la tienda online: 5 formas de integración, y los plazos para 2027, en la lista de control del KSeF 2027. Encontrará los conceptos en el glosario IT para empresas.

¿Cuándo basta con un programa estándar y cuándo hace falta una integración?

Si emite las facturas en un programa de facturación o en la plataforma de la tienda online y estos ya son compatibles con el KSeF, el certificado o el token se carga allí según las instrucciones del proveedor y no necesita un programador. La integración con la API tiene sentido cuando la factura se genera en su CRM, portal B2B o sistema de pedidos, cuando tiene varias fuentes de facturas o cuando quiere que el número KSeF vuelva al pedido y al pago.

UNSEEN realiza este tipo de integraciones desde 1.400 EUR sin IVA (UN·Connect), y un módulo financiero con KSeF desde 6.850 EUR sin IVA (UN·Finance). Entre otros proyectos, hemos desarrollado el envío de facturas al KSeF en el CRM de una empresa de renovables: la factura emitida en el sistema llega al KSeF junto con el UPO, y las facturas recibidas entran en el sistema. Describimos el alcance completo en la página facturas del CRM y la tienda online al KSeF.

Preguntas frecuentes sobre el certificado y el token KSeF

¿Dejará de funcionar el token KSeF el 31 de diciembre de 2026?

Según el reglamento vigente, se puede iniciar sesión con token hasta el 31 de diciembre de 2026. El Ministerio de Finanzas polaco ha anunciado que el método se mantendrá, y el proyecto de modificación del reglamento de 27 de octubre de 2026 prevé que los tokens actuales sean válidos hasta el 30 de noviembre de 2027 y los nuevos, como máximo 365 días. Mientras la modificación no se publique, rige el 31 de diciembre de 2026.

¿Dónde se genera el certificado KSeF?

En la Aplikacja Podatnika KSeF 2.0, en la pestaña «Certyfikaty» (certificados), o a través de la API del KSeF 2.0. Antes, desde noviembre de 2025 hasta finales de enero de 2026, los certificados los emitía el Moduł Certyfikatów i Uprawnień (MCU).

¿Cuánto tiempo es válido un certificado KSeF?

Como máximo 2 años desde su generación o desde la fecha de inicio indicada en la solicitud. Se puede renovar antes de que caduque.

¿Puedo iniciar sesión en la Aplikacja Podatnika con el certificado KSeF?

No. El certificado de autenticación sirve para sistemas que se conectan al KSeF a través de la API, p. ej., programas de facturación, tiendas online y CRM. En la Aplikacja Podatnika se inicia sesión con Profil Zaufany, firma cualificada o sello electrónico cualificado.

¿Se necesita un certificado aparte para las facturas offline?

Sí. El segundo código QR de una factura offline requiere un certificado KSeF para el modo offline. El certificado de inicio de sesión no lo sustituye, y un mismo certificado no puede tener ambos usos.

¿Se puede solicitar un certificado con un token KSeF?

No. Tras iniciar sesión con un token no se puede generar un certificado KSeF. Para la solicitud hay que iniciar sesión con Profil Zaufany, firma cualificada o sello electrónico cualificado.

Historial de actualizaciones

  • Primera versión. Métodos de autenticación, validez de los tokens y certificados, entornos y modos offline comprobados el 14/11/2026 en el Dziennik Ustaw, en el RCL, en las páginas del Ministerio de Finanzas polaco y en la documentación de la API del KSeF 2.0.

Fuentes

  1. Reglamento del Ministro de Finanzas y Economía (MFiG) de 12 de diciembre de 2025 sobre el uso del KSeF, Dz.U. 2025 poz. 1815 (§ 6, § 13) (comprobado el 14/11/2026)
  2. RCL: proyecto de reglamento por el que se modifica el reglamento sobre el uso del KSeF (27/10/2026) (comprobado el 14/11/2026)
  3. Ministerio de Finanzas polaco: certificados KSeF (comprobado el 14/11/2026)
  4. Ministerio de Finanzas polaco: preguntas y respuestas sobre KSeF 2.0 (comprobado el 14/11/2026)
  5. Documentación de la API del KSeF 2.0: autenticación (comprobado el 14/11/2026)
  6. Documentación de la API del KSeF 2.0: certificados KSeF (comprobado el 14/11/2026)
  7. Documentación de la API del KSeF 2.0: tokens KSeF (comprobado el 14/11/2026)
  8. Documentación de la API del KSeF 2.0: modos offline (comprobado el 14/11/2026)
  9. Documentación de la API del KSeF 2.0: entornos (comprobado el 14/11/2026)
  10. Infor.pl: cambios en el KSeF a partir de 2027, proyecto de modificación del reglamento (9/11/2026) (fuente secundaria)

El artículo tiene carácter informativo y no constituye asesoramiento fiscal: en materia tributaria, la decisión corresponde a su gestor o asesor fiscal.

¿Necesita asesoramiento personalizado?

Reserve una consulta gratuita. Analizaremos su negocio y le propondremos soluciones concretas.

Reservar llamada gratuita (30 min)

Cookies analíticas y de marketing solo con su consentimiento. Más información en la política de privacidad.