Facturae and FACe for WooCommerce — e-invoices for Spanish administrations

Facturae for WooCommerce turns a shop order into a Facturae 3.2.2 file, the format Spanish public administrations take. It all happens on your own server, with no third-party invoicing service. At the checkout the buyer types the NIF/CIF and the three DIR3 codes of the administration, and the order gets a “Facturae” box with buttons. Pro signs the file with your business certificate and sends it to FACe, the general entry point for e-invoices of the Spanish State administration.

What the free version does

The classic and block checkout get optional fields: the buyer’s NIF/CIF and three DIR3 codes — accounting office (oficina contable), managing body (órgano gestor) and processing unit (unidad tramitadora). The control letter of a Spanish NIF is checked. The Facturae box on the order makes the invoice: issuer and buyer, lines with quantity and unit price, coupons as line discounts, shipping and fees, taxes grouped by rate, payment term and IBAN. IVA, IGIC (Canary Islands) and IPSI (Ceuta and Melilla) are supported. Every file is validated against the Facturae 3.2.2 XSD bundled with the plugin before it is saved: a file that does not pass is not saved, and you see why. A series and a counter of your own never give the same number twice and never leave a gap because of a refused invoice. The NIF, the DIR3 codes, the proposing body and the file reference (expediente) can be corrected in the order box and the invoice made again with the same number. The XML is downloaded from the order screen.

What Pro adds

The certificate of your business (.p12/.pfx or PEM) signs the invoice with a XAdES signature following the Facturae signature policy; the private key is stored encrypted, the password of the file is not stored, and the signature is verified right after signing. A refund of an invoiced order gets its corrective invoice (factura rectificativa) in a separate series, pointing at the invoice it corrects. Invoices can be made automatically — when the order is Processing or Completed — signed and attached to the e-mails sent to the buyer. The signed invoice is sent to FACe (the supplier REST API): the registry number and status are kept on the order and refreshed every hour, and a cancellation request, with or without a reason, can be made from the order. This needs a qualified certificate and an integrator registration in the FACe portal. There is a zip export of the files of chosen orders or of a period, and a journal of what was signed, sent and answered.

Good to know before you start

• The file made by the free version is not signed: entry points such as FACe ask for a signature, so sign it with your own tool or use Pro.
• Signing needs a qualified certificate of your business with an exportable private key (.p12/.pfx or PEM). EC keys are not supported; an old .p12 with RC2 on OpenSSL 3 has to be exported again.
• FACe needs a registration as an integrator in the FACe integrators portal and the certificate added to a platform there. Without it, making and signing still work.
• The FACe environment is the test one by default; production is an explicit choice in the settings.
• An invoice is a legal document: the correctness of totals and taxes stays with the shop. When the invoice total differs from the order, the module warns but does not block.
• Not implemented: recargo de equivalencia, IRPF withholding, exempt operations with their legal reason, euro equivalent for foreign currency, attachments to FACe, the FACe invoice repository and FACeB2B.
• The tax period of a corrective invoice is the calendar month of the corrected invoice; a shop that files quarterly can change it with the filter ccfe_corrective_data.
• If another plugin already numbers your invoices, Facturae needs a separate series.
• Alongside our Verifactu module (records for AEAT): they do different jobs — Verifactu sends records to AEAT, Facturae sends invoices to administrations; the NIF saved by Verifactu is read as a fallback.

How it works, step by step

1. In WooCommerce → Facturae enter your business data (NIF/CIF, name, address), the series and the shop tax, and save.
2. The buyer types the NIF and DIR3 codes at the checkout, or you type them in the order box.
3. On the order press “Make the invoice” and download the XML.
4. In Pro upload the certificate, sign the invoice and press “Send to FACe”; the status is refreshed every hour.

Under the hood

• The Facturae 3.2.2 and xmldsig schemas ship with the plugin; making and checking the invoice calls no external service.
• The FACe transport is the supplier REST API (/providers/v1) with a JWT RS256 token signed by your certificate.
• The private key is stored encrypted (AES-256); the password of the file is not stored.
• The hourly status check takes the invoices checked least recently, so every open invoice is followed.
• Classic and block checkout, HPOS; languages: English, español.

How to install

1. Plugins → Add New → Upload Plugin: choose the zip and activate it.
2. WooCommerce → Facturae: enter your business data, the series and save.
3. Make an invoice on an order that has the buyer’s NIF.
4. For Pro, upload the certificate on the “Signature and FACe” tab.

The module is not on wordpress.org yet: the free version and Pro are one archive from this page. Without a key it works as the free version.