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 Barcelona
Facturae y FACe desde una aplicación PHP
Soy Mariusz Szatkowski, de WPPoland, en Gdynia (Polonia). Trabajo con WordPress desde 2006 y escribo PHP para empresas que necesitan que su software de gestión haga algo concreto con otro sistema. En Barcelona ese encargo suele llegar con un cliente público detrás: un ayuntamiento, un organismo de la Generalitat, un ente municipal. La empresa que vende a esa administración tiene que emitir una factura Facturae firmada y entregarla en el punto de entrada correcto. Esta página explica cómo se hace desde una aplicación PHP (Laravel, Symfony o a medida) y qué hay que comprobar antes de escribir código.
Trabajo siempre en remoto. Ni reuniones ni visitas: todo, de la primera pregunta a la aceptación final, queda por escrito. Si el proyecto incluye pantallas, los gráficos, las maquetas y los wireframes llegan del cliente y yo los implemento.

Foto: Daniel Kraft, CC BY-SA 3.0, Wikimedia Commons.
Qué dice la ley y quién está obligado
La norma de referencia es la Ley 25/2013, de impulso de la factura electrónica y creación del registro contable de facturas en el Sector Público. Los artículos que más pesan en un proyecto de integración son cuatro:
- Artículo 4. Todos los proveedores pueden expedir y remitir factura electrónica. Están obligadas, en todo caso, las sociedades anónimas, las sociedades de responsabilidad limitada, las entidades sin nacionalidad española, los establecimientos permanentes de no residentes y las uniones temporales de empresas, entre otras. Las administraciones pueden excluir reglamentariamente las facturas de hasta cinco mil euros.
- Artículo 5. La factura va en formato estructurado y firmada con firma electrónica avanzada basada en certificado reconocido. También se admite el sello electrónico avanzado de una persona jurídica.
- Artículo 6. El Estado, las comunidades autónomas y las entidades locales tienen un punto general de entrada de facturas. Las entidades locales pueden adherirse al de su diputación, su comunidad autónoma o el Estado.
- Artículo 9. La factura debe identificar los órganos administrativos destinatarios. Este artículo nombra expresamente a Barcelona: el Estado, las comunidades autónomas y los municipios de Madrid y Barcelona pueden excluir del registro contable las facturas en papel de hasta cinco mil euros.
La consecuencia práctica: que tu cliente sea un ayuntamiento o una sociedad pública no te dice por sí solo si debes facturar por vía electrónica ni por qué punto de entrada. Lo decide la forma jurídica de tu empresa, el importe y el organismo. Esto no es asesoramiento jurídico, y para el caso concreto necesitas a tu gestor o abogado. Lo que sí puedo hacer es programar el flujo una vez que sepas qué te toca.
Dos puertas de entrada en Cataluña: FACe y e.FACT
En Barcelona conviven dos puntos de entrada y la aplicación tiene que saber a cuál va cada factura.
FACe es el punto general de la Administración General del Estado. Según la ficha de la solución en el catálogo CTT, ofrece servicios de recepción a más de 8.000 administraciones públicas españolas y permite remitir facturas por un portal web o por servicios web desde el sistema de gestión del proveedor.
e.FACT es el servicio del Consorci AOC para las administraciones catalanas adheridas. La página de la Diputació de Barcelona explica que el formato es un XML Facturae, que las versiones aceptadas por e.FACT son la 3.2 y la 3.2.1 y que un formato anterior se rechaza. También describe una bústia de lliurament donde consultar el estado de la factura enviada.
Dos entes del Ajuntament de Barcelona publican qué punto usan. Foment de Ciutat indica que se presenta por la plataforma del CAOC y que su código DIR3 es LA0009214. El Institut Municipal d’Informàtica indica que los puntos de entrada son Pimefactura y CAOC y que el código DIR3 que debe constar en todos los campos es LA0007818. Dos entes del mismo ayuntamiento, dos códigos distintos: la aplicación no puede llevar un único “código del Ajuntament” fijo.
Un detalle técnico que me interesa como desarrollador: la documentación de la librería Facturae-PHP explica que algunas administraciones despliegan su propio servicio con el WSDL de FACe y que, para e-FACT, hay que cambiar el espacio de nombres del servicio web. Es decir, el cliente SOAP de FACe no se apunta sin más a otro punto de entrada. Se comprueba con una factura de prueba.
Qué debe llevar el XML antes de salir de tu aplicación
Formato. El manual SOAP de FACe (versión 2.0.0, 30 de mayo de 2024) indica que se admiten Facturae 3.2, 3.2.1 y 3.2.2, UBL y CII. La página de Facturae detalla qué añade la 3.2.2 respecto a la 3.2.1: campos para documentación de cesiones, descripción general de la factura, referencias a nivel de factura, pago en especie y el formato HTML en la lista de formatos admitidos.
Firma. Las facturas Facturae deben ir firmadas con un certificado reconocido. Las FAQ de FACe (revisión del 11 de octubre de 2021) citan XAdES B-Level con política de firma, XAdES-EPES y XAdES-XL. La firma se hace sobre el XML final: cualquier cambio posterior invalida el documento, así que la aplicación guarda el XML firmado tal cual y no lo regenera al reenviar.
Destinatarios. Es lo que más facturas rechazadas provoca. Toda factura debe ir dirigida a una oficina contable, un órgano gestor y una unidad tramitadora, y los tres se informan en el BuyerParty con el código DIR3 de la unidad:
| Rol | Código en RoleTypeCode | Quién es | Obligatorio |
|---|---|---|---|
| Fiscal | 01 | Oficina contable | Sí |
| Receptor | 02 | Órgano gestor | Sí |
| Pagador | 03 | Unidad tramitadora | Sí |
| Comprador | 04 | Órgano proponente | No |
Las FAQ añaden que el nombre de la unidad DIR no tiene por qué coincidir con el de la oficina contable, el órgano gestor o la unidad tramitadora que se crea a partir de ella. Por eso los códigos los da tu cliente o se leen del directorio de unidades del portal de FACe.
Antes de firmar, mi aplicación comprueba que los tres roles obligatorios llevan código. Es una función corta y evita que el rechazo llegue horas después:
function missingCentres(string $xml): array
{
$doc = new DOMDocument();
$doc->loadXML($xml, LIBXML_NONET);
$xp = new DOMXPath($doc);
$found = [];
foreach ($xp->query('//*[local-name()="BuyerParty"]//*[local-name()="AdministrativeCentre"]') as $c) {
$role = $xp->evaluate('string(*[local-name()="RoleTypeCode"])', $c);
$code = $xp->evaluate('string(*[local-name()="CentreCode"])', $c);
if (trim($code) !== '') {
$found[] = $role;
}
}
return array_values(array_diff(['01', '02', '03'], $found));
}Si devuelve algo distinto de una lista vacía, la factura no sale. El XPath ignora el espacio de nombres para que sirva con las tres versiones de Facturae.
Dos interfaces automáticas de FACe: SOAP y REST
Para enviar desde un sistema, sin pasar por el portal web, hay que dar de alta el sistema como integrador en el Portal de Integradores (entorno de pruebas llamado “servicios estables” y entorno de producción), generar una plataforma y asociarle el certificado en formato PEM. Los manuales de FACe en el área de descargas describen dos interfaces:
SOAP. Las peticiones van firmadas con WS-Security 1.0 y un token X.509 que valida @firma. El manual indica SHA-1 como método de firma y SHA-256 como digest. No admite el envío por fragmentos: la petición debe llevar Content-Length. Esa línea importa en PHP: el cliente HTTP debe mandar el cuerpo completo con su longitud, y una petición chunked no es válida para este servicio.
REST. El manual de API (versión 2.0.0, 19 de noviembre de 2025) describe recursos bajo /v1/invoices: remisión de una factura, búsqueda, lista de estados y solicitud de anulación. El cuerpo de la remisión lleva filename, content (el XML en Base64) y email, y admite anexos en PDF o HTML. La autenticación es un JWT firmado con JWS, válido cinco minutos, cuyo encabezado lleva el certificado en x5c. Un token en PHP, con la extensión OpenSSL y sin dependencias:
function faceToken(string $certPem, string $keyPem): string
{
$clean = preg_replace('/-----(BEGIN|END) CERTIFICATE-----|\s+/', '', $certPem);
$b64 = static fn (string $s): string => rtrim(strtr(base64_encode($s), '+/', '-_'), '=');
$now = time();
$head = $b64(json_encode(['typ' => 'JWT', 'alg' => 'RS256', 'x5c' => [$clean]], JSON_THROW_ON_ERROR));
$body = $b64(json_encode(['username' => sha1($clean), 'iat' => $now, 'exp' => $now + 300], JSON_THROW_ON_ERROR));
openssl_sign("$head.$body", $sig, $keyPem, OPENSSL_ALGO_SHA256);
return "$head.$body." . $b64($sig);
}El username es la huella SHA-1 del certificado sin las líneas de cabecera, como describe el manual. Como el token caduca a los cinco minutos, lo genero por cada lote de envíos y no lo guardo en configuración. Antes de pasar a producción lo pruebo contra el entorno de servicios estables.
Mi criterio para un proyecto nuevo: REST, porque no obliga a firmar cada mensaje con WS-Security. Si tu aplicación ya usa SOAP y funciona, no la migro sin motivo.
Estados de la factura: lo que tu aplicación debe guardar
Enviar es la mitad del trabajo. El manual REST publica la lista de estados que devuelve FACe:
| Código | Estado | Significado según el manual |
|---|---|---|
| 1200 | Registrada | Registrada en el registro electrónico |
| 1300 | Registrada en RCF | Registrada en el registro contable de facturas |
| 2400 | En trámite | Contabilizada la obligación reconocida |
| 2500 | Pagada | Factura pagada |
| 2600 | Rechazada | La unidad rechaza la factura |
| 3100 | Anulada | La unidad aprueba la propuesta de anulación |
Qué guardo en la base de datos de cada factura: el XML firmado, el código de registro que devuelve la respuesta de remisión, la fecha de envío, el último estado conocido y la fecha en que cambió. Con eso, un trabajo programado consulta los estados pendientes y deja una nota en la factura cuando pasa a rechazada. Para anular, la API tiene una petición de anulación con un comentario obligatorio: el proveedor la solicita y la unidad decide.
El catálogo CTT de FACe cuenta además que FACe ofrece un servicio SOAP de notificación proactiva de cambios de estado, creado porque los proveedores consultaban el estado con demasiada frecuencia. Si tu volumen es alto, sondear cada factura cada pocos minutos no es buena idea.
Facturae-PHP o código propio
Existe una librería abierta, Facturae-PHP, con licencia MIT. Su README dice que genera facturas en las versiones 3.2, 3.2.1 y 3.2.2, las firma con XAdES de acuerdo con la política de firma de Facturae 3.1, aplica sellado de tiempo y las envía a FACe y FACeB2B. Según Packagist, la última versión es la 1.8.6, del 3 de noviembre de 2026.
Para un proyecto con pocas facturas y un solo punto de entrada, la uso: es más barato mantener una dependencia que escribir la firma XAdES. Para un sistema con varios puntos de entrada, estados y reintentos, uso la librería para generar y firmar el XML y escribo yo la capa de envío, estados y colas, porque ahí está la lógica de tu negocio. En los dos casos el XML pasa por la validación de destinatarios de arriba y por una prueba en el entorno de servicios estables antes de producción.
Lista de comprobación antes de integrar
Sirve aunque no trabajes conmigo:
- Sabes si tu forma jurídica está en el artículo 4.1 de la Ley 25/2013 y si el organismo excluye las facturas de importe bajo.
- Cada cliente público tiene su punto de entrada anotado (FACe, e.FACT u otro) y los tres códigos DIR3.
- Tienes un certificado reconocido para firmar y una persona que lo renueva antes de que caduque.
- El sistema está dado de alta en el Portal de Integradores, con el certificado asociado.
- La aplicación valida los roles 01, 02 y 03 antes de firmar.
- Guardas el XML firmado, el código de registro y el historial de estados.
- Alguien recibe el aviso cuando una factura pasa a rechazada.
- Has probado el flujo completo en el entorno de pruebas del punto de entrada.
Cómo funciona un proyecto conmigo
Cada proyecto sigue el mismo recorrido, sin reuniones:
- Brief escrito. Me mandas el repositorio o la URL, qué se factura y a quién, y la fecha en que debe funcionar.
- Preguntas por escrito. Te pido la lista de clientes públicos con su punto de entrada, un ejemplo de factura real anonimizada y el nombre del programa que hoy emite las facturas.
- Alcance y supuestos. Recibes un documento con lo que se hace, lo que queda fuera y lo que necesito de ti, como el certificado de pruebas.
- Entorno de pruebas. Desarrollo en un staging que puedes ver y envío facturas de prueba al entorno de servicios estables.
- Aceptación. Revisas contra el alcance. Corrijo los fallos que entren en lo acordado. Cualquier petición nueva la presupuesto por separado.
- Mantenimiento opcional. Actualizaciones de PHP y de dependencias, y revisión de la integración cuando cambie la documentación de FACe. Las horas contratadas se usan dentro de su mes y no se acumulan.
Preguntas frecuentes
¿Está obligada mi empresa a facturar en formato electrónico a la administración?
El artículo 4.1 de la Ley 25/2013 lista a las entidades obligadas: sociedades anónimas, sociedades de responsabilidad limitada, uniones temporales de empresas, establecimientos permanentes de entidades no residentes y otras figuras. Un autónomo persona física no figura en esa lista, aunque puede facturar electrónicamente. El mismo artículo permite a cada administración excluir las facturas de hasta cinco mil euros, así que la decisión depende del organismo que recibe la factura.
¿Qué diferencia hay entre FACe y e.FACT?
FACe es el punto general de entrada de la Administración General del Estado. e.FACT es el servicio del Consorci AOC que usan las administraciones catalanas adheridas. El Ajuntament de Barcelona remite a sus proveedores a la plataforma del CAOC en algunos de sus entes, como Foment de Ciutat. Antes de programar nada compruebo cuál es el punto de entrada de tu cliente público, porque cambia el endpoint, el formato admitido y el soporte.
¿Qué versión de Facturae debo generar?
FACe acepta 3.2, 3.2.1 y 3.2.2. La página de la Diputació de Barcelona sobre e.FACT cita las versiones 3.2 y 3.2.1 y avisa de que un formato anterior se rechaza. Si facturas a organismos de ambos puntos de entrada, la 3.2.1 es la opción que sirve para los dos. La 3.2.2 solo la necesitas para campos como la cesión de crédito con documentación o el pago en especie.
¿Qué códigos DIR3 necesito y de dónde salen?
Cada factura debe indicar oficina contable (rol 01), órgano gestor (rol 02) y unidad tramitadora (rol 03). Los códigos los facilita tu cliente o salen del directorio de unidades del portal de FACe. No los invento ni los deduzco del nombre del organismo: una unidad con el nombre correcto y el código equivocado llega a la bandeja equivocada.
¿Puedo enviar la factura desde mi ERP o mi aplicación sin usar el portal web?
Sí. FACe ofrece una interfaz SOAP y una API REST para sistemas de gestión. Para usarlas das de alta tu sistema en el Portal de Integradores y asocias el certificado con el que firmas las peticiones. Tu aplicación genera el XML, lo firma, lo envía y consulta después el estado. Si solo emites unas pocas facturas al año, el portal web puede bastarte.
¿Qué puedo hacer si la administración rechaza una factura?
FACe devuelve el estado de la factura: registrada, registrada en RCF, en trámite, pagada, rechazada o anulada. Si hay un dato erróneo, el proveedor puede pedir la anulación con un comentario y volver a emitir una factura corregida. En tu aplicación conviene guardar el código de registro y el motivo, y avisar a quien factura cuando el estado cambia a rechazada.
Cuéntame qué factura tu empresa a la administración
Si tienes una aplicación PHP que debe enviar Facturae y trabajas con clientes públicos de Barcelona o de Cataluña, escríbeme desde la página de contacto. Indica la URL o el repositorio, a qué administraciones facturas, tu fecha límite y el stack actual. La estimación inicial, también por escrito, no tiene coste.
Proyectos seleccionados
Ejemplos de mi trabajo.
Portal deportivo local: sportostroda.pl
Sportostroda.pl fue un portal deportivo local para Ostróda y alrededores, con noticias, calendario de eventos, galerías, comentarios y SEO local.
Portbrzezno.pl - sitio web del parque de cuerdas Port Brzeźno
El parque de cuerdas Port Brzeźno en Gdańsk es un lugar de aventura para niños y adultos, con recorridos en altura, reservas online y venta de vales.
QUALITY WATCH - Soluciones de Mystery Shopping y Experiencia del Cliente
El proyecto Quality Watch fue creado con el objetivo de presentar los servicios de una empresa especializada en crear funciones a medida en estándares de servicio al clientes, gestión de calidad y experiencia del clientes.
Soporte y desarrollo WordPress en Barcelona
¿Buscas el servicio: Desarrollador PHP en Barcelona?
Describe tu proyecto por e-mail. Respondo en 48 horas.
Describe tu proyectoExplora otros servicios WordPress y base de conocimiento
Ingeniería WordPress y arquitectura personalizada.
Tiendas, checkout y lógica comercial.
Temas Shopify, Liquid y migraciones WooCommerce → Shopify.
Headless WordPress, Sanity, Strapi y Contentful con Astro o Next.js.
Claude, OpenAI y RAG en WordPress con BYOK y residencia UE.
Automatización de procesos de negocio en torno a WordPress y sistemas empresariales.
Biblioteca de casos concretos de automatización.
Categorías relacionadas
Artículos de apoyo

Lista de cambios concretos en wp-config, reglas de Cloudflare y decisiones de schema que mueven TTFB, cumplimiento AEPD y rankings en proyectos WordPress españoles.

Una guía práctica para lanzar un sitio WordPress que posicione en 2026. SEO técnico, Core Web Vitals, schema, AEO, GEO, hreflang y el orden que hace que salga bien a la primera.

Migra de Shopify a WooCommerce sin perder datos, clientes ni posiciones SEO. Cubre transferencia de productos, redirecciones 301, mapeo de URL, automatización con WP-CLI y lista de verificación post-migración.