Facturae-PHP es una clase escrita puramente en PHP que permite generar facturas siguiendo el formato estructurado de factura electrónica Facturae e incluso firmarlas con firma electrónica XAdES sin necesidad de ninguna librería o clase adicional.
- PHP 5.6 o superior
- OpenSSL (solo para firmar facturas)
- Generación de facturas 100% conformes con la Ley 25/2013 del 27 de diciembre listas para enviar a FACe
- Exportación según el formato Facturae 3.2.1
- Firmado de acuerdo a la política de firma de Facturae 3.1 basada en XAdES
- Compatibilidad con el formato Facturae 3.2.2
- Envío de facturas a FACe directamente desde la clase
Facturae-PHP pretende ser una clase extremadamente rápida y sencilla de usar. A continuación se incluyen varios ejemplos sobre su utilización. Para más información sobre todos los métodos de Facturae-PHP, la clase se encuentra comentada según bloques de código de phpDocumentor.
composer require josemmo/facturae-php
// Sistema de carga automática de Composer
require_once __DIR__ . '/../vendor/autoload.php';
// Importamos las clases usadas
use josemmo\Facturae\Facturae;
use josemmo\Facturae\FacturaeParty;
use josemmo\Facturae\FacturaeCentre; // Esta es opcional
use josemmo\Facturae\FacturaeItem; // Este es opcional
// Creamos la factura
$fac = new Facturae();
// Asignamos el número EMP2017120003 a la factura
// Nótese que Facturae debe recibir el lote y el
// número separados
$fac->setNumber('EMP201712', '0003');
// Asignamos el 01/12/2017 como fecha de la factura
$fac->setIssueNumber('2017-12-01');
// Incluimos los datos del vendedor
$fac->setSeller(new FacturaeParty([
"taxNumber" => "A00000000",
"name" => "Perico el de los Palotes S.A.",
"address" => "C/ Falsa, 123",
"postCode" => "123456",
"town" => "Madrid",
"province" => "Madrid"
]);
// Incluimos los datos del comprador
// Con finos demostrativos el comprador será
// una persona física en vez de una empresa
$fac->setBuyer(new FacturaeParty([
"isLegalEntity" => false, // Importante!
"taxNumber" => "00000000A",
"name" => "Antonio",
"firstSurname" => "García",
"lastSurname" => "Pérez",
"address" => "Avda. Mayor, 7",
"postCode" => "654321",
"town" => "Madrid",
"province" => "Madrid"
]);
// Añadimos los productos a incluir en la factura
// En este caso, probaremos con tres lámpara por
// precio unitario de 20,14€ con 21% de IVA ya incluído
$fac->addItem("Lámpara de pie", 20.14, 3, Facturae::TAX_IVA, 21);
// Ya solo queda firmar la factura ...
$fac->sign(
"ruta/hacia/clave_publica.pem",
"ruta/hacia/clave_privada.pem",
"passphrase"
);
// ... y exportarlo a un archivo
$fac->export("ruta/de/salida.xsig");En caso de no utilizar Composer, se deberá sustituir en el ejemplo anterior la línea de código:
require_once __DIR__ . '/../vendor/autoload.php';Por las siguientes:
require_once "../src/Facturae.php"; require_once "../src/FacturaeParty.php"; require_once "../src/FacturaeCentre.php"; require_once "../src/FacturaeItem.php";
Los compradores y vendedores son representados en Facturae-PHP con la clase FacturaeParty y pueden contener los siguientes atributos:
$empresa = new FacturaeParty([
"isLegalEntity" => true, // Se asume true si se omite
"taxNumber" => "A00000000",
"name" => "Perico el de los Palotes S.A.",
"address" => "C/ Falsa, 123",
"postCode" => "123456",
"town" => "Madrid",
"province" => "Madrid",
"countryCode" => "ESP", // Se asume España si se omite
"book" => "0", // Libro
"merchantRegister" => "RG", // Registro Mercantil
"sheet" => "1", // Hoja
"folio" => "2", // Folio
"section" => "3", // Sección
"volume" => "4", // Tomo
"email" => "[email protected]"
"phone" => "910555444",
"fax" => "910555443"
"website" => "http://www.perico.com/",
"contactPeople" => "Perico",
"cnoCnae" => "4791", // Clasif. Nacional de Act. Económicas
"ineTownCode" => "280796" // Cód. de municipio del INE
]);
$personaFisica = new FacturaeParty([
"isLegalEntity" => false,
"taxNumber" => "00000000A",
"name" => "Antonio",
"firstSurname" => "García",
"lastSurname" => "Pérez",
"address" => "Avda. Mayor, 7",
"postCode" => "654321",
"town" => "Madrid",
"province" => "Madrid",
"countryCode" => "ESP", // Se asume España si se omite
"email" => "[email protected]"
"phone" => "910777888",
"fax" => "910777888"
"website" => "http://www.antoniogarcia.es/",
"contactPeople" => "Antonio García",
"cnoCnae" => "4791", // Clasif. Nacional de Act. Económicas
"ineTownCode" => "280796" // Cód. de municipio del INE
]);Para poder emitir facturas a organismos públicos a través de FACe es necesario indicar los centros administrativos relacionados con la administración a facturar. Estos datos pueden obtenerse a través del directorio de organismos de FACe y deben ser indicados a Facturae-PHP de la siguiente forma:
// Tomamos como ejemplo el Ayuntamiento de San Sebastián de los Reyes
$ayto = new FacturaeParty([
"taxNumber" => "P2813400E",
"name" => "Ayuntamiento de San Sebastián de los Reyes",
"address" => "Plaza de la Constitución, 1",
"postCode" => "28701",
"town" => "San Sebastián de los Reyes",
"province" => "Madrid",
"centres" => [
new FacturaeCentre([
"role" => FacturaeCentre::ROLE_GESTOR,
"code" => "L01281343",
"name" => "Intervención Municipal",
"address" => "Plaza de la Constitución, 1",
"postCode" => "28701",
"town" => "San Sebastián de los Reyes",
"province" => "Madrid"
]),
new FacturaeCentre([
"role" => FacturaeCentre::ROLE_TRAMITADOR,
"code" => "L01281343",
"name" => "Intervención Municipal",
"address" => "Plaza de la Constitución, 1",
"postCode" => "28701",
"town" => "San Sebastián de los Reyes",
"province" => "Madrid"
]),
new FacturaeCentre([
"role" => FacturaeCentre::ROLE_CONTABLE,
"code" => "L01281343",
"name" => "Intervención Municipal",
"address" => "Plaza de la Constitución, 1",
"postCode" => "28701",
"town" => "San Sebastián de los Reyes",
"province" => "Madrid"
])
]
]);Es posible añadir una descripción además del concepto al añadir un producto al pasar un array de dos elementos en el primer parámetro del método:
// Solo concepto, sin descripción
$fac->addItem("Lámpara de pie", 20.14, 3, Facturae::TAX_IVA, 21);
// Con descripción incluída
$fac->addItem(["Lámpara de pie", "Lámpara de madera de nogal con base rectangular y luz halógena"], 20.14, 3, Facturae::TAX_IVA, 21);También se puede añadir un elemento sin impuestos, aunque solo debe hacerse en aquellos casos en los que se tenga total certeza:
$fac->addItem("No llevo impuestos", 100, 1);La forma adecuada de añadir elementos a los que no se les aplica IVA es la siguiente:
$fac->addItem("Llevo IVA al 0%", 100, 1, Facturae::TAX_IVA, 0);Nótese que Facturae-PHP no limita este tipo de comportamientos, es responsabilidad del usuario crear la factura de acuerdo a la legislación aplicable.
Supongamos que se quieren añadir varios impuestos a una misma línea de producto. En este caso se deberá hacer uso de la API avanzada de productos de Facturae-PHP a través de la clase FacturaeItem:
// Vamos a añadir un producto utilizando la API avanzada
// que tenga IVA al 10% e IRPF al 15%
$fac->addItem(new FacturaeItem([
"name" => "Una línea con varios impuestos",
"description" => "Esta línea es solo para probar Facturae-PHP",
"quantity" => 1, // Esto es opcional, es el valor por defecto si se omite
"unitPrice" => 43.64,
"taxes" => [
Facturae::TAX_IVA => 10,
Facturae::TAX_IRPF => 15
]
]));Esta API también permite indicar el importe unitario del producto sin incluir impuestos (base imponible), ya que por defecto Facturae-PHP asume lo contrario:
// Vamos a añadir 3 bombillas LED con un coste de 6,50 € ...
// ... pero con los impuestos NO INCLUÍDOS en el precio unitario
$fac->addItem(new FacturaeItem([
"name" => "Bombilla LED",
"quantity" => 3,
"unitPriceWithoutTax" => 6.5, // NOTA: no confundir con unitPrice
"taxes" => [Facturae::TAX_IVA => 21]
]));Como último apunte sobre la API avanzada de productos, por defecto Facturae-PHP interprenta al IRPF como un impuesto retenido (aquellos que se restan a la base imponible) y al resto de impuestos como repercutidos (se suman a la base imponible).
Si necesitas crear una factura "especial" es posible sobreescribir el comportamiento por defecto a través de la propiedad isWithheld:
// Para rizar un poco el rizo vamos a añadir una línea con IVA (repercutido)
// al 21% y también con impuestos especiales retenidos al 4%
$fac->addItem(new FacturaeItem([
"name" => "Llevo impuestos retenidos",
"quantity" => 1,
"unitPrice" => 10,
"taxes" => array(
Facturae::TAX_IVA => 21,
Facturae::TAX_IE => ["rate"=>4, "isWithheld"=>true]
)
]));Es posible indicar la forma de pago de una factura. Por ejemplo, en caso de pagarse al contado:
$fac->setPaymentMethod(Facturae::PAYMENT_CASH);En caso de transferencia también debe indicarse la cuenta bancaria destinataria:
$fac->setPaymentMethod(Facturae::PAYMENT_TRANSFER, "ES7620770024003102575766");Para establecer la fecha de vencimiento del pago:
$fac->setDueDate("2017-12-31");Por defecto, si se establece una forma de pago y no se indica la fecha de vencimiento se interpreta la fecha de la factura como tal.
Aunque es posible exportar las facturas sin firmarlas, es un paso obligatorio para prácticamente cualquier trámite relacionado con la Administración Pública. Para firmar facturas se necesita un certificado electrónico (generalmente expedido por la FNMT) del que extraer su clave pública y su clave privada. Los siguientes comandos permiten extraer el certificado (clave pública) y la clave privada de un archivo PFX:
openssl pkcs12 -in certificado_de_entrada.pfx -clcerts -nokeys -out clave_publica.pem
openssl pkcs12 -in certificado_de_entrada.pfx -nocerts -out clave_privada.pem
Por defecto, al firmar una factura se utilizan la fecha y hora actuales como sello de tiempo. Si se quiere indicar otro valor, se debe utilizar el siguiente método:
$fac->setSignTime("2017-01-01T12:34:56+02:00");Es posible establecer el periodo de facturación con el siguiente método:
$fac->setBillingPeriod("2017-11-01", "2017-11-30");Se pueden incluir textos literales (generalmente, declaraciones responsables del proveedor) en el XML de la factura:
$fac->addLegalLiteral("Este es un mensaje de prueba");
$fac->addLegalLiteral("Y este, otro más");El uso de
LegalLiteralses obligatorio en determinadas facturas. Cosulta la legislación vigente para más información.
También es posible obtener un array con los totales de la factura:
$totales = $fac->getTotals();El método
getTotalsse ha dejado público al considerar que puede ser de gran utilidad para muchos programadores.Aún así, este método es utilizado por la clase principal para generar el documento XML de la factura y, por tanto, su salida está sujeta a cambios frecuentes para acomodar futuras funciones.
En conclusión: si usas este método en tu proyecto lee los cambios de versión antes de actualizar.
| Constante | Descripción |
|---|---|
Facturae::SCHEMA_3_2_1 |
Formato de Facturae 3.2.1 |
Facturae::SIGN_POLICY_3_1 |
Formato de firma 3.1 |
Facturae::PAYMENT_CASH |
Pago al contado |
Facturae::PAYMENT_TRANSFER |
Pago por transferencia |
Facturae::TAX_IVA |
Impuesto sobre el valor añadido |
Facturae::TAX_IPSI |
Impuesto sobre la producción, los servicios y la importación |
Facturae::TAX_IGIC |
Impuesto general indirecto de Canarias |
Facturae::TAX_IRPF |
Impuesto sobre la Renta de las personas físicas |
Facturae::TAX_OTHER |
Otro |
Facturae::TAX_ITPAJD |
Impuesto sobre transmisiones patrimoniales y actos jurídicos documentados |
Facturae::TAX_IE |
Impuestos especiales |
Facturae::TAX_RA |
Renta aduanas |
Facturae::TAX_IGTECM |
Impuesto general sobre el tráfico de empresas que se aplica en Ceuta y Melilla |
Facturae::TAX_IECDPCAC |
Impuesto especial sobre los combustibles derivados del petróleo en la Comunidad Autonoma Canaria |
Facturae::TAX_IIIMAB |
Impuesto sobre las instalaciones que inciden sobre el medio ambiente en la Baleares |
Facturae::TAX_ICIO |
Impuesto sobre las construcciones, instalaciones y obras |
Facturae::TAX_IMVDN |
Impuesto municipal sobre las viviendas desocupadas en Navarra |
Facturae::TAX_IMSN |
Impuesto municipal sobre solares en Navarra |
Facturae::TAX_IMGSN |
Impuesto municipal sobre gastos suntuarios en Navarra |
Facturae::TAX_IMPN |
Impuesto municipal sobre publicidad en Navarra |
Facturae::TAX_REIVA |
Régimen especial de IVA para agencias de viajes |
Facturae::TAX_REIGIC |
Régimen especial de IGIC: para agencias de viajes |
Facturae::TAX_REIPSI |
Régimen especial de IPSI para agencias de viajes |
FacturaeCentre::ROLE_CONTABLEo FacturaeCentre::ROLE_FISCAL |
Oficina contable |
FacturaeCentre::ROLE_GESTORo FacturaeCentre::ROLE_RECEPTOR |
Órgano gestor |
FacturaeCentre::ROLE_TRAMITADORo FacturaeCentre::ROLE_PAGADOR |
Unidad tramitadora |
FacturaeCentre::ROLE_PROPONENTE |
Órgano proponente |
Todas las facturas generadas y firmadas con Facturae-PHP son probadas con las siguientes herramientas online para garantizar el cumplimiento del estándar: