Desarrollador WooCommerce en Bilbao

Cómo emitir facturas TicketBAI desde una tienda WooCommerce en Bizkaia: software garante, momento de la factura, devoluciones como rectificativas, encadenamiento con pedidos simultáneos y certificados.

Desarrollador WooCommerce

Mi lugar en la comunidad WordPress

  • Tengo cuenta en wordpress.org desde 2006.
  • He contribuido al núcleo de WordPress en las versiones 7.0 y 7.1.
  • Mantengo 30 plugins en wordpress.org.
  • Organizo WordCamps y hablo en ellos como ponente.
  • He asistido a todas las WordCamp Europe de 2017 a 2026.
  • Meetup local de WordPress: WordPress Bilbao

Mi perfil en WordPress.org

Me llamo Mariusz Szatkowski, trabajo con WordPress desde 2006 y programo tiendas WooCommerce en remoto, desde Gdynia, para empresas de toda España. Esta página va de un solo asunto: tu empresa tributa en Bizkaia, vende por internet con WooCommerce y cada pedido tiene que acabar en una factura TicketBAI correcta. Explico quién emite esa factura, en qué momento del pedido, qué documento sale con un reembolso y por qué dos pedidos simultáneos pueden romper la cadena de facturas.

#Lo que pide Bizkaia a quien vende online

La Diputación Foral de Bizkaia define Batuz como una estrategia de asistencia y control de la tributación que alcanza a todas las empresas y autónomos sujetos a la normativa de Bizkaia, sea cual sea su tamaño. Una de sus piezas es el software garante de facturación TicketBAI, y las facturas que emite se anotan solas en el libro registro de operaciones económicas (LROE). El calendario de entrada lo fijó la Norma Foral 8/2023, y en la página de implantación definitiva hay una calculadora por tipo de contribuyente y actividad; la fecha más tardía de esa tabla es el 1 de enero de 2026.

La propia Diputación hace campaña entre los compradores: en la portada de batuz.eus pide exigir siempre el ticket con código QR, en el fisio, en la peluquería y también en el pintxo-pote. Tu cliente online recibe la misma factura con QR, solo que en un correo o en un PDF, y puede comprobarla en la sede electrónica.

Si tu empresa tributa en Bizkaia o en otro territorio es algo que determina tu asesoría. Todo lo que sigue da por hecho que la respuesta es Bizkaia.

Edificio en la plaza del Ensanche, Bilbao

Foto: Ea Aldunate, CC0, Wikimedia Commons.

#Un pedido de WooCommerce no es una factura TicketBAI

WooCommerce gestiona pedidos y cobros. La factura TicketBAI tiene que salir de un software garante, que la Orden Foral 1482/2020 define como el sistema que garantiza la trazabilidad y la inviolabilidad de los registros de ventas, elaborado por una persona o entidad desarrolladora e inscrito en el registro de software garante.

Eso deja dos arquitecturas posibles:

  • El software garante vive dentro de WordPress. Es un plugin inscrito en el registro como software garante. En el registro de software, consultado el 15 de noviembre de 2026, cinco entradas mencionan WooCommerce en su nombre o en su descripción. Las descripciones las escriben los propios desarrolladores y aparecen recortadas, así que lo que cubre cada programa se comprueba en su documentación.
  • El software garante es tu programa de facturación o tu ERP. La tienda envía cada pedido pagado por API y el programa emite la factura, la firma y la anota. WooCommerce solo guarda el número de factura y el PDF que le devuelven.

Según las preguntas frecuentes de Batuz, un programa inscrito en un territorio queda registrado también en Álava y Gipuzkoa. La lista tiene además una columna que indica, programa por programa, si está en euskera.

Desde la Orden Foral 601/2025, publicada en el BOB el 16 de diciembre de 2025, el software garante tiene que poder conectarse a internet, gestionar certificados electrónicos, enviar los ficheros de alta y de anulación al LROE y procesar la respuesta de la Diputación. Si el plugin o el programa que tienes en mente no hace alguna de esas cuatro cosas, no es una opción.

#Qué contiene cada factura

El artículo 3 de la Orden Foral 1482/2020 obliga al software garante a generar un fichero XML, el fichero TicketBAI, con carácter previo a la emisión de la factura. Ese fichero se firma electrónicamente (artículo 5) y recoge, entre otros datos:

  • el NIF y el nombre del emisor y, cuando el reglamento de facturación lo exige, los del destinatario;
  • la serie y el número, y la fecha y hora de expedición;
  • si es una factura completa o simplificada, y si es rectificativa;
  • una descripción general de la operación; según Batuz, en Bizkaia no hace falta el bloque de detalle por línea y, si se envía, no se trata;
  • la base imponible, los tipos de IVA y, en su caso, el recargo de equivalencia;
  • los datos de la factura anterior: serie, número, fecha y las primeras 100 posiciones de su firma.

La factura que recibe tu cliente lleva dos elementos que salen de ese fichero. El anexo IV de la orden, en la versión publicada en el BOB del 11 de septiembre de 2020, describe un código identificativo de 39 caracteres que empieza por TBAI e incluye el NIF, la fecha y parte de la firma, y un código QR de entre 30 y 40 milímetros de lado, con nivel de corrección de errores M, que apunta a la aplicación de comprobación de la Diputación. Si el QR no se puede leer, la factura no cumple. En un PDF generado por la tienda, el tamaño del QR se fija en milímetros.

Las preguntas frecuentes de Batuz aclaran que la fecha y la hora de expedición son las del momento en que la factura se expide a través del sistema TicketBAI, aunque nadie la imprima.

#En qué momento del pedido sale la factura

WooCommerce mueve cada pedido por estados que describe en su documentación de estados. Procesando significa que el pago se ha recibido y el pedido espera a ser enviado. Completado significa que ya se ha servido. En espera es el estado típico de una transferencia: el stock se reserva, pero el pago está sin confirmar.

La pregunta es a cuál de esos estados se ata la factura. Las preguntas frecuentes de Batuz, en el apartado del LROE, responden a un caso parecido, el pago anticipado: cuando cobras antes de entregar, la factura TicketBAI se expide al cobrar, y al hacer la entrega se expide una segunda factura en la que se descuenta el anticipo. Si en tu tienda el cobro y la entrega van separados, o si se aplica otra regla, lo decide tu asesoría. Yo programo lo que quede escrito, y no antes.

Las transferencias traen otra duda. Muchas tiendas mandan una factura proforma al recibir el pedido en espera. Batuz lo permite con tres condiciones: la proforma no puede llevar ni el código TicketBAI ni el QR, tiene que indicar claramente que no es definitiva y, si la genera el sistema, tiene que estar vinculada al software garante para que quede registrada junto a la factura que la sustituye. Un plugin de PDF genérico que pone la palabra factura en un documento que no ha pasado por el software garante crea justo el problema que el sistema quiere evitar. Revisa también que el correo de pedido recibido no adjunte nada que parezca una factura.

#Reembolsos, anulaciones y facturas que se sustituyen

En WooCommerce, un reembolso se hace desde el pedido, por líneas o por importe, y la guía de reembolsos distingue el automático, que devuelve el dinero a través de la pasarela, del manual, que solo lo anota. Si el reembolso no cubre todo el pedido, el estado no cambia a Reembolsado. Al crear un reembolso, el código de WooCommerce lanza las acciones woocommerce_order_partially_refunded o woocommerce_order_fully_refunded, y después woocommerce_order_refunded. Ahí se engancha la integración con el software garante.

Lo que tiene que salir de cada caso, según las preguntas frecuentes de Batuz:

Lo que pasa en la tiendaDocumento TicketBAIDetalle
Reembolso parcial o total de un pedido facturadoFactura rectificativaCódigo R1 a R5 según el motivo, tipo S (sustitución) o I (diferencias)
Reembolso de un pedido con factura simplificadaFactura rectificativa simplificadaCódigo R5 y marca de simplificada
Factura con datos erróneos aún no entregada al clienteFichero de anulación y factura nuevaLa nueva lleva otro número y otra fecha; la anulada sigue contando en el encadenamiento
El cliente pide factura completa tras recibir una simplificadaFactura en sustitución de la simplificadaSe envían los dos ficheros, el de la simplificada y el de la que la sustituye
Cambio de dirección antes de facturarNadaEl pedido aún no tiene factura

En una rectificativa, la fecha de operación es la de la factura original. Qué código de R1 a R5 corresponde a cada motivo de devolución lo decide tu asesoría; en la tienda se guarda como una tabla de motivos que el personal elige al reembolsar, no como un campo de texto libre.

#Pedidos simultáneos y la cadena de facturas

El encadenamiento es la parte que más se rompe en una tienda online. Según las preguntas frecuentes de Batuz, cada factura identifica a la anterior y solo puede ser la anterior de una única factura. Dentro de un mismo dispositivo o centro de facturación la cadena sigue el orden temporal, sea cual sea la serie: una rectificativa de otra serie puede ser la anterior de una factura ordinaria. Si varios procesos facturan en paralelo, cada uno encadena dentro de su propio centro.

En un TPV de mostrador eso pasa poco. En WooCommerce, dos clientes que pagan en el mismo segundo disparan dos procesos PHP a la vez. Si los dos leen la misma factura anterior antes de que el otro termine, aparecen dos facturas que apuntan a la misma anterior. La solución que aplico es una cola: los pedidos pagados entran en una lista y se facturan de uno en uno por centro de facturación, con un bloqueo que impide que dos procesos tomen el mismo turno. WooCommerce ya usa Action Scheduler para tareas en segundo plano como sus webhooks, y suele bastar para esto.

Dos detalles más de las mismas preguntas frecuentes. La primera factura del año se encadena con la última del año anterior si el dispositivo es el mismo. Y si cambias de software garante, el nuevo debe recoger los datos de encadenamiento del anterior, salvo que sea técnicamente imposible o muy costoso.

#Moneda, idiomas y datos del cliente

Si vendes en otras monedas, el fichero TicketBAI que llega a Hacienda va siempre en euros. La factura que recibe el cliente puede estar en otra moneda, pero la cuota de IVA repercutida se expresa en euros, con el tipo de cambio que fija el artículo 79 de la Norma Foral del IVA. En WooCommerce eso afecta a los plugins de varias monedas: el importe en euros se guarda en el pedido en el momento del cobro.

En las facturas completas consta el nombre o la razón social del destinatario, y su NIF en los casos que enumera el artículo 6 del reglamento de facturación. Una factura simplificada también puede llevar el NIF del cliente, y entonces se llama simplificada cualificada. Si tu checkout ofrece la casilla “quiero factura con NIF”, ese dato tiene que llegar al software garante antes de que se expida la factura.

#Certificados y la conexión con la Diputación

El fichero se firma, y el envío se autentica, con uno de estos certificados: cualificado de persona física, cualificado de sello electrónico, de dispositivo o de autónomo. Si el software garante corre en el mismo servidor que WordPress, la clave privada del certificado también está ahí. Te aconsejo guardarla fuera de la carpeta pública, con permisos solo para el proceso que firma, y fuera de las copias de seguridad que se descargan sin cifrar.

Las tres diputaciones están cambiando la cadena de certificados SSL de sus servicios TicketBAI a una nueva jerarquía de Sectigo. Según la nota técnica, la instalación en el entorno de pruebas estaba prevista para el 1 de octubre de 2026, y el almacén de confianza del software debe incluir la raíz Sectigo Public Server Authentication Root R46. En las novedades de batuz.eus, la Diputación de Bizkaia fijó el cambio en producción para el 24 de noviembre de 2026. El fichero de certificados que trae WordPress incluye esa raíz. Si tu plugin usa su propio almacén o el del servidor, pregunta al desarrollador del software garante si lo ha comprobado y haz un envío de prueba al entorno de pruebas.

#Cómo lo planteo contigo

  1. Me escribes con la URL de la tienda, el software de facturación que usas hoy, tu asesoría o gestoría y lo que quieres resolver. Respondo con mis preguntas, por escrito.
  2. Tu asesoría decide por escrito el tipo de factura de cada venta, el momento de emisión y la tabla de motivos de reembolso con sus códigos.
  3. Dejo por escrito el alcance: qué software garante, qué eventos de WooCommerce disparan qué documento, cómo se guarda el número de factura en el pedido y qué queda fuera.
  4. Construyo en staging, una copia de la tienda conectada al entorno de pruebas, nunca a producción.
  5. Hago los pedidos de la lista de abajo y te paso el resultado de cada uno. Lo revisas con tu asesoría.
  6. Publicación con el certificado definitivo y un punto de reversión probado. Si quieres que después vigile actualizaciones y errores de envío, existe el mantenimiento WordPress en Bilbao como servicio aparte.

Tu empresa me entrega el diseño de las vistas, si hay que tocar alguna; yo no diseño. Si la integración va contra un ERP con API propia, te puede interesar también la página de desarrollo PHP en Bilbao. Para el sistema estatal tengo una guía sobre VeriFactu en WooCommerce.

#Lista de comprobación antes de facturar desde la tienda

Sirve aunque no trabajes conmigo. Cada fila es una prueba en staging contra el entorno de pruebas.

PruebaQué compruebas
Pedido pagado con tarjetaSale una factura con código TBAI y un QR que lee la aplicación de comprobación
Pedido por transferenciaLa proforma, si existe, no lleva QR ni código y dice que no es definitiva
Dos pagos en el mismo segundoCada factura apunta a una anterior distinta
Reembolso parcialSale una rectificativa con el código que fijó tu asesoría
Reembolso de una simplificadaLa rectificativa lleva R5 y la marca de simplificada
Factura completa a peticiónSe envían los ficheros de la simplificada y de su sustituta
Pedido en otra monedaEl fichero va en euros y coincide con lo guardado en el pedido
PDF impresoEl QR mide entre 30 y 40 milímetros y se lee con el móvil
Cambio de certificadosEl envío al entorno de pruebas funciona sin errores de certificado

#Preguntas frecuentes

¿WooCommerce emite facturas TicketBAI por sí solo? No. La factura TicketBAI la emite un software garante inscrito en el registro de la Diputación Foral de Bizkaia. Ese software puede ser un plugin de WordPress inscrito como tal o tu programa de facturación, al que la tienda envía cada pedido.

¿La factura sale al cobrar el pedido o al enviarlo? Lo decide tu asesoría y queda por escrito antes de programar nada. Las preguntas frecuentes de Batuz explican que, cuando se cobra un anticipo, la factura TicketBAI se expide en el momento del cobro y después se expide otra al realizarse la entrega, descontando el anticipo.

¿Puedo seguir mandando una factura proforma a quien paga por transferencia? Sí, siempre que no lleve el código TicketBAI ni el QR, diga claramente que no es definitiva y quede vinculada al software garante. Cuando la venta se realiza, se sustituye por la factura TicketBAI.

¿Qué documento sale cuando hago un reembolso parcial en WooCommerce? Una factura rectificativa, con un código de R1 a R5 según el motivo (R5 si rectifica una factura simplificada) y el tipo S, por sustitución, o I, por diferencias. Qué código corresponde a cada motivo lo fija tu asesoría.

¿Qué pasa si entran dos pedidos en el mismo segundo? Cada factura solo puede tener una factura anterior. Si dos procesos emiten a la vez dentro del mismo centro de facturación, los dos pueden apuntar a la misma anterior y la cadena se rompe. Por eso las facturas se emiten en cola, de una en una por centro, con independencia de la serie.

¿Diseñas la tienda? No. Maquetas, wireframes y diseño gráfico llegan de tu empresa o de quien te los haga. Yo programo la conexión entre WooCommerce y el software garante y la pruebo.

#Escríbeme

Si tu tienda ya factura con TicketBAI y algo no cuadra (una cadena rota, un QR que no se lee, reembolsos que no generan rectificativa), o si vas a montar la conexión desde cero, escríbeme desde la página de contacto. Cuéntame la URL de la tienda, el software garante o el programa de facturación que usas, cuántos pedidos y reembolsos mueves al mes y la fecha que tienes en mente. Mi respuesta llega por escrito, en días laborables, y esa primera estimación no tiene coste.

¿Buscas el servicio: Desarrollador WooCommerce en Bilbao?

Describe tu proyecto por e-mail. Respondo en 48 horas.

Describe tu proyecto

Explora otros servicios WordPress y base de conocimiento