=== Verifactu Módulo ===
Contributors: verifactumodulo
Tags: verifactu, ticketbai, facturacion electronica, woocommerce, aeat, nif, factura, autonomos, ley antifraude, qr
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
WC requires at least: 7.0
WC tested up to: 11.0

Facturación electrónica Verifactu y TicketBAI para WooCommerce. Cada pedido se reporta a la AEAT con QR y NIF/CIF.

== Description ==

**Verifactu Módulo** es el plugin de facturación electrónica para WooCommerce en España. Conecta tu tienda con [app.verifactumodulo.com](https://app.verifactumodulo.com) y cumple **Verifactu**, **TicketBAI** (Euskadi) y la normativa de la **AEAT** sin cambiar tu forma de vender.

El software de facturación genera la factura, el QR de verificación y, si hay devolución, la factura rectificativa. Tú no numeras nada: Hacienda recibe el mismo documento que tu cliente.

= Facturación Verifactu para WooCommerce =

* Reporta automáticamente los pedidos en *procesando*, *completado* o *en espera*.
* QR y enlace de verificación AEAT: confirmación, Mi cuenta, emails, o shortcode `[verifactu_qr]`.
* NIF, CIF, DNI y NIE en el checkout, con letra de control oficial.
* Empresas y autónomos: un CIF marca B2B; el IRPF se calcula en el servidor.
* Reembolsos: factura rectificativa total (sustitución) o parcial (diferencia).
* Reintentos inteligentes si AEAT o la red fallan. El mismo pedido no duplica facturas.
* Compatible con HPOS y con el checkout de bloques.

= ¿Por qué Verifactu Módulo? =

La facturación electrónica es **obligatoria** para quienes emiten facturas en España (Reglamento Verifactu / RD 1007/2023 y TicketBAI en el País Vasco). Un plugin de WooCommerce que solo imprime un PDF no basta: hay que **remitir** el registro a la Agencia Tributaria.

Verifactu Módulo lo hace en segundo plano. Actívalo, conecta la cuenta (sandbox gratis) y sigue vendiendo.

= Ideal para =

* Tiendas WooCommerce en España y Canarias
* Autónomos y pymes que facturan por internet
* Comercios que necesitan TicketBAI (Bizkaia, Gipuzkoa, Álava) o Verifactu en el resto del territorio
* Quienes quieren NIF/CIF en el checkout sin otro plugin de IVA

Empieza en dos minutos: WooCommerce → Verifactu Módulo → **Empezar ahora**.

== Installation ==

1. Sube la carpeta del plugin a `/wp-content/plugins/verifactu-modulo` o instálalo desde el escritorio de WordPress.
2. Activa **Verifactu Módulo**. WooCommerce debe estar activo.
3. En WooCommerce → Verifactu Módulo pulsa **Empezar ahora — sandbox gratis**.
4. Completa empresa, firmante y plan. Volverás con la clave API guardada.
5. Si ya tienes cuenta, pega la clave (`vfp_…`) y pulsa **Probar conexión**.

== Frequently Asked Questions ==

= ¿Verifactu es obligatorio para mi WooCommerce? =

Si emites facturas en España, sí: debes usar un software de facturación que remita los registros a la AEAT (Verifactu) o a Hacienda Foral (TicketBAI). Este plugin conecta WooCommerce con ese software.

= ¿Tengo que crear facturas a mano en WooCommerce? =

No. El plugin no genera documentos locales ni números de factura. Todo ocurre en Verifactu Módulo y ante la AEAT.

= ¿El NIF es obligatorio en el checkout? =

Para empresa o autónomo, sí. Un particular solo lo necesita si solicita factura. Validamos DNI, NIE y CIF con el algoritmo oficial, no con una simple expresión regular.

= ¿Qué pasa si falla el envío a Hacienda? =

Un 429 o un error de servidor se reintenta solo. Un error de datos (NIF, IVA de una línea) se muestra en el pedido con qué corregir y un botón **Reenviar a Verifactu**.

= ¿Puedo probarlo sin facturar de verdad? =

Sí. El alta empieza en sandbox: facturas de prueba, sin efecto fiscal. Pasa a producción desde el panel cuando esté listo.

= ¿Funciona con devoluciones de WooCommerce? =

Sí. Un reembolso total o parcial crea la factura rectificativa correspondiente. No hagas albaranes ni crédito a mano.

= ¿Dónde aparece el QR para el cliente? =

En WooCommerce → Verifactu Módulo eliges confirmación del pedido, Mi cuenta y emails. También puedes insertarlo: shortcode `[verifactu_qr]` en una página, o `{verifactu_qr}` en el contenido adicional de un email. Desactiva el sitio automático si no quieres duplicarlo.

== Screenshots ==

1. Conexión en dos minutos: cumple Verifactu sin cambiar el checkout.
2. Estado de la factura, QR AEAT y reenvío en el pedido.
3. NIF/CIF validado para particulares, empresas y autónomos.

== Changelog ==

= 1.1.1 =
* Compatible con WordPress 7.1 y WooCommerce 11.0.

= 1.1.0 =
* Ajustes para mostrar el QR al cliente: confirmación, Mi cuenta, emails y email cuando la factura está lista.
* Shortcode [verifactu_qr] y marcador {verifactu_qr} para insertarlo en páginas o emails.
* Página del plugin en español, orientada a conversión y cumplimiento AEAT.
* Interfaz en inglés (idioma de WordPress) y español (es_ES).

= 1.0.0 =
* Primera versión: onboarding, clave API, pedidos, reembolsos, NIF y estado de factura.
