KSeF para WooCommerce: para qué deben prepararse las tiendas polacas

Si gestionas una tienda WooCommerce que vende en Polonia, el KSeF es uno de los cambios más importantes que se avecinan en la facturación. La facturación se desplaza de los PDF y los adjuntos de correo electrónico hacia documentos electrónicos estructurados que se emiten a través de una plataforma estatal central. La buena noticia: casi todo el trabajo con sentido que puedes hacer hoy es higiene de datos, y la higiene de datos se amortiza de inmediato, con independencia de cuándo empiece tu fase. Esta guía explica qué es el KSeF, a quién afecta, qué aspecto tienen realmente unos datos de facturación limpios y cómo Polski for WooCommerce prepara tu tienda sin pretender ser tu sistema contable.

Qué es el KSeF y por qué es importante para tu tienda

KSeF (Krajowy System e-Faktur, el Sistema Nacional de Facturas Electrónicas) es la plataforma central de Polonia para emitir y recibir facturas. En lugar de generar un PDF y enviarlo por correo electrónico a un cliente, un vendedor transmite una factura electrónica estructurada al KSeF. El sistema la valida y la registra, le asigna un identificador oficial y la pone a disposición del comprador. La factura deja así de ser un documento que tú diseñas para ser un registro que custodia el Estado.

El cambio decisivo consiste en que la factura pasa a ser una estructura de datos determinada en lugar de un archivo de diseño libre. Un PDF puede contener cualquier maquetación, una factura estructurada debe contener determinados campos en un determinado formato para que el sistema pueda leerla automáticamente. Ya no hay sitio para un “eso ya lo aclara la contabilidad”, cuando un nombre de empresa que falta o un número fiscal erróneo provocan un rechazo en la transmisión.

Para una persona que gestiona una tienda WooCommerce, esto es importante porque los datos de facturación ya no pueden estar formateados de cualquier manera. El número fiscal del comprador, el nombre de la empresa, la dirección, las líneas de producto y los tipos de IVA deben registrarse todos de forma limpia y coherente, pues fluyen directamente al documento estructurado. Todo lo que captures como texto libre desordenado en el pago se convierte en un problema en la facturación.

Quién está afectado y la implantación por fases

El KSeF se introduce por fases y no de golpe. Según el calendario actual, se incorporan primero los mayores contribuyentes, y otras empresas siguen en etapas posteriores de la implantación por fases. El objetivo es, con el tiempo, una amplia cobertura de la facturación B2B para las empresas que operan en Polonia.

Dado que los calendarios regulatorios pueden desplazarse, deberías considerar provisional cualquier fecha concreta que leas. La vía fiable consiste en verificar el calendario actual y tu propia obligación directamente con el Ministerio de Hacienda (Ministerstwo Finansow) y, en su caso, con tu asesor fiscal. Lo que apenas cambiará es la dirección de fondo: las facturas electrónicas estructuradas a través de un sistema central llegan, y preparar tus datos con antelación te cuesta muy poco y a la vez hace que estés listo en cuanto llegue tu fase. Si el KSeF se aplica a tu empresa concreta, y cuándo, es una determinación que solo tú y tu asesor podéis tomar.

Qué datos de facturación y de cliente deben ser correctos

El formato estructurado que utiliza el KSeF (a menudo denominado esquema FA_VAT) presupone datos completos y bien formados. En la práctica, merece la pena afinar los siguientes ámbitos en tu tienda:

• NIP en clientes empresa. Cuando un cliente compra como empresa, necesitas su número polaco de identificación fiscal, capturado en el pago y guardado en el pedido. Un NIP con un número de dígitos equivocado o una suma de control fallida es mejor atajarlo en el punto de venta que en la transmisión.
• Datos completos del comprador. El nombre de la empresa, la dirección completa y el código postal deben estar presentes y ser coherentes, no solo rellenados en parte o introducidos libremente de forma impredecible.
• Tipos de IVA correctos. Cada línea de producto debe llevar el tipo de IVA correcto. Los tipos dispares o ausentes son una causa frecuente de errores de facturación.
• Una señal clara de “es este un pedido de empresa”. Debes saber por pedido si acaso se espera una factura, para que los pedidos de empresa no se traten como compras anónimas de particulares.
• Datos limpios y estructurados en su conjunto. Dado que el documento se lee de forma automática, pequeñas lagunas que una persona perdonaría (un campo que falta, un carácter inusual, un nombre de empresa vacío) se convierten en problemas reales.

Registrar bien estos fundamentos beneficia ya hoy a tu contabilidad, con independencia de en qué fase del KSeF caigas.

Qué debe lograr una buena capa de preparación

Una tienda WooCommerce no necesita una pasarela KSeF completa incorporada en cada plugin. Necesita una capa de preparación que haga bien unas pocas cosas y no se interponga en el camino de la herramienta de facturación que finalmente realiza la transmisión. Usa esto como lista de comprobación:

• Capturar el NIP limpiamente en el pago, con validación, para que los números erróneos nunca lleguen a un pedido.
• Funcionar en el pago clásico y en el de bloques, pues las tiendas usan ambos, y los datos deben aterrizar en cualquier caso en el mismo sitio.
• Reconocer qué pedidos necesitan una factura, para que no tengas que revisar cada pedido a ojo.
• Hacer visible ese estado allí donde trabajas, en la lista de pedidos, no escondido en una caja de metadatos.
• Proporcionar hooks, para que una integración de facturación o contabilidad dedicada pueda reaccionar a un pedido en cuanto esté listo, sin que tengas que ensamblar nada a mano.

Fíjate en lo que no figura en esta lista: el envío efectivo de las facturas al KSeF. Una capa de preparación que en secreto intentara ser un sistema contable se sobrepasaría. La tarea consiste en hacer que los datos sean correctos y el estado del pedido legible; la transmisión queda para una herramienta construida a tal efecto.

Cómo lo resuelve Polski

Polski for WooCommerce es un plugin gratuito y modular para tiendas polacas, y su soporte de KSeF está concebido deliberadamente como una capa de preparación, no como un motor de facturación. Dos módulos hacen el trabajo: los campos de pago B2B, que capturan los datos, y el módulo apto para KSeF, que los marca y los pone a disposición.

Capturar los datos en el pago

El módulo de pago B2B añade los campos que necesita un pedido de empresa polaco. Hay un interruptor opcional “Comprar como empresa”, un campo NIP, así como campos opcionales REGON e IBAN, cada uno activado o desactivado según lo que tu tienda quiera recabar realmente. El NIP se valida con una suma de control correcta, de modo que un dígito intercambiado o un número que simplemente no es un NIP válido se rechaza en el pago con un aviso claro en lugar de guardarse sin cambios. El REGON se comprueba respecto a la longitud correcta de 9 o 14 dígitos, y el IBAN se valida en su totalidad, incluido el dígito de control módulo 97 según ISO 13616, de modo que unos datos bancarios mal tecleados no se cuelen.

Lo decisivo es que los campos funcionan tanto en el pago clásico como en el de bloques. En WooCommerce moderno (8.6 y posterior), Polski los registra a través de la API unificada de campos adicionales de WooCommerce, de modo que aparecen de forma nativa en el pago de bloques, y refleja los valores de vuelta en los metadatos estándar del pedido _billing_nip, _billing_regon e _billing_iban. Este reflejo es importante: significa que el módulo KSeF, una herramienta de facturación o una exportación contable leen todos las mismas claves previsibles, sin importar qué pago capturó los datos.

Marcar pedidos para el KSeF

Con el módulo apto para KSeF activado, Polski comprueba cada pedido al formalizarse y decide, en función de la presencia de un NIP, si parece necesitar una factura KSeF. Escribe esa decisión en el pedido y proporciona una columna KSeF en la lista de pedidos de WooCommerce, que funciona tanto con el almacenamiento clásico como con HPOS (High-Performance Order Storage). Un pedido que necesita una factura muestra un marcador de estado con color, uno que no la necesita muestra un guion neutro. También la pantalla de detalle del pedido en el administrador muestra el estado KSeF en el área de facturación. Así ves de un vistazo, a lo largo de toda una pantalla de pedidos, cuáles de ellos son facturas de empresa que aún hay que procesar.

Los hooks en los que se engancha una integración

Aquí la capa de preparación se gana su nombre. La decisión “es esto necesario” pasa por el filtro polski/ksef/is_required, de modo que una integración o tu propio código pueda sobrescribir la regla (por ejemplo, para marcar también pedidos sin NIP que lleven una casilla “factura necesaria”). Cuando se determina que un pedido necesita una factura, Polski dispara la acción polski/ksef/invoice_ready y entrega el pedido. Un plugin de facturación, una conciliación contable o un script propio puede escuchar ese único hook y arrancar su propio proceso en el momento en que un pedido está listo, con los datos de NIP y de factura ya validados y guardados bajo claves de metadatos conocidas. Obtienes el cableado sin escribir tú mismo el pegamento.

La instalación

Dejar activa la capa de preparación lleva solo unos minutos:

1. Instala Polski for WooCommerce desde Plugins > Instalar y actívalo. WooCommerce debe estar instalado y activo.
2. Abre el menú Polski y ve a Módulos.
3. Activa los campos de pago B2B, para que el NIP (y, si lo deseas, REGON e IBAN) se recabe en el pago. Elige qué campos se muestran.
4. Activa el módulo apto para KSeF, para que los pedidos se marquen y la columna KSeF aparezca en la lista de pedidos.
5. Asegúrate de que tus tipos de IVA de WooCommerce sean correctos, ya que el IVA por línea forma parte de cada factura estructurada.
6. Formaliza un pedido de prueba con un NIP de empresa y comprueba si queda marcado en la lista de pedidos y muestra un estado KSeF en la pantalla del pedido.

Como Polski es compatible con HPOS y admite tanto el carrito y el pago clásicos como los de bloques, encaja limpiamente en una instalación moderna de WooCommerce. Los módulos son independientes, de modo que puedes operar solo los bloques de KSeF y B2B y dejar apagado el resto del plugin.

Consejos prácticos para estar listo ahora

Un plugin aporta el mecanismo, la disciplina recae en ti. Algunos apuntes prácticos:

• Activa la validación del NIP antes de necesitarla. Atajar un número fiscal erróneo en el pago es mucho más barato que descubrirlo cuando se rechaza una factura. La validación ya está presente en cuanto el campo está activado.
• Concilia los registros de clientes existentes. Revisa las cuentas de empresa y añade ahora los números fiscales y las direcciones que faltan, mientras es rutina y no urgencia.
• Estandariza la captura de datos de empresa. Un único campo NIP validado es mejor que dejar que los clientes peguen su número fiscal en el campo de observaciones, donde ninguna herramienta puede leerlo con fiabilidad.
• Decide pronto tu herramienta de facturación. La capa de preparación gratuita marca y pone a disposición los pedidos, algo debe generar y transmitir el documento. Saber si eso es una integración contable o un plugin de facturación dedicado determina cómo usas los hooks.
• Trata los datos como provisionales. Construye la disciplina de datos ahora, para que la transición posterior sea un paso de configuración y no una operación a la desesperada.

Preparación para el KSeF frente a WooCommerce estándar

WooCommerce puede aceptar y reembolsar un pedido, pero no conoce el concepto de un NIP, no sabe qué pedidos son facturas de empresa y no ofrece ningún hook en el que un sistema de facturación pudiera engancharse. Aquí está la diferencia específicamente para la preparación del KSeF:

Función	WooCommerce estándar	Polski for WooCommerce
Campo NIP en el pago	No incorporado	Campo NIP validado, pago clásico y de bloques
Captura de REGON / IBAN	Ninguna	Opcional, con validación de longitud y módulo 97
Validación de dígito de control del NIP	Ninguna	Sí, rechazado en el pago si es inválido
Señal “pedido de empresa”	Ninguna	Interruptor “Comprar como empresa” y marcado por pedido
Qué pedidos necesitan una factura KSeF	Conjetura manual	Marcados automáticamente al formalizar el pedido
Estado KSeF en la lista de pedidos	Ninguno	Columna en la lista de pedidos clásica y HPOS
Hooks de integración	Ninguno	Filtro is_required, acción invoice_ready
Generación de la factura / del KSeF-XML	Ninguna	Manual / externa (PRO lo añade)
Coste	Gratuito (sin conocimiento del KSeF)	Gratuito; PRO añade facturas y KSeF-XML

Gratuito frente a PRO

La edición gratuita es una verdadera capa de preparación y no un bocado de cebo: captura validada de NIP, REGON e IBAN en el pago clásico y en el de bloques, marcado automático de los pedidos que necesitan una factura KSeF, una columna de estado KSeF en la lista de pedidos, así como el filtro y la acción en los que se engancha una integración. Para la mayoría de las tiendas que se preparan antes de su fase, es exactamente el trabajo que hay que hacer ahora.

Polski PRO construye el motor de facturación encima. Añade facturas en PDF (Faktura VAT) con numeración automática y exportación de KSeF-XML, la validación completa del NIP con la API GUS/REGON junto con un botón de pago “obtener datos de GUS” que rellena automáticamente el nombre de la empresa, la dirección y el REGON desde el registro oficial, un motor de reglas fiscales que asigna códigos GTU y JPK_V7, así como una conciliación contable con wFirma, Fakturownia e iFirma. También hay un endpoint de factura en Markdown, de modo que las herramientas de contabilidad y de atención al cliente pueden leer datos de factura, incluidos la referencia y el estado del KSeF, sin parsear un PDF. La capa gratuita captura y marca, PRO genera y transmite.

Un aviso transversal se aplica a todo esto: Polski proporciona módulos técnicos, no asesoramiento jurídico, y ningún plugin puede garantizar la conformidad. Confirmar si tu tienda cumple los requisitos del KSeF sigue siendo tu responsabilidad, idealmente con tu asesor fiscal y sobre la base de las indicaciones oficiales del Ministerio de Hacienda.

En resumen

El KSeF convierte la factura de un PDF que tú diseñas en un registro estructurado que el Estado valida, lo que significa que tus datos de facturación deben ser limpios, completos y legibles por máquina antes de que llegue tu fase. WooCommerce estándar no tiene conocimiento de nada de esto. El gratuito Polski for WooCommerce cierra la brecha de preparación: captura un NIP validado (más, opcionalmente, REGON e IBAN) en el pago clásico y en el de bloques, marca qué pedidos necesitan una factura KSeF, muestra ese estado en la lista de pedidos y proporciona hooks a los que una herramienta de facturación puede reaccionar. PRO añade el motor que genera los PDF de Faktura VAT, exporta el KSeF-XML, valida contra GUS y concilia con tu sistema contable, cuando estés listo para automatizar el resto.