=== Factunexo - Facturación Electrónica y Contabilidad For WooCommerce ===
Contributors: xinersoft
Donate link: https://www.xinersoft.com
Tags: woocommerce, facturacion electrónica
Requires at least: 6.8
Tested up to: 6.8
Stable tag: 1.0.0
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Integración automática de facturación electrónica con Factunexo para WooCommerce, cumpliendo con normativas del SRI de Ecuador.

== Description ==

**Factunexo Integration** conecta tu tienda WooCommerce con el sistema de facturación electrónica Factunexo, permitiendo la **emisión automática de facturas** válidas ante el SRI (Servicio de Rentas Internas) de Ecuador cada vez que se completa una venta en tu tienda online.

= Características Principales =

* **Generación automática de facturas** cuando cambia el estado del pedido
* **Validación en tiempo real** de Cédula y RUC ecuatorianos en el checkout
* **Campos personalizados** para datos de facturación
* **Integración completa** con la API de Factunexo
* **Columna de facturas** en el listado de pedidos de WooCommerce
* **Compatibilidad con WooCommerce Blocks** (checkout moderno)
* **Soporte para HPOS** (High-Performance Order Storage)
* **Envío automático** de facturas por correo electrónico
* **Validación según normativa SRI 2025**

= Para el Cliente =

* Campos personalizados en checkout para datos de facturación
* Validación en tiempo real de Cédula y RUC
* Interfaz intuitiva compatible con WooCommerce Blocks
* Mensajes de error claros si los datos son incorrectos
* Recepción automática de factura por email

= Para el Administrador =

* Configuración sencilla desde WordPress Admin
* Generación automática de facturas al procesar pedidos
* Columna de facturas en el listado de pedidos
* Visualización de estado de factura (Guardada, Autorizada, Rechazada)
* Número de autorización y secuencial visible
* Debug integrado para diagnóstico de problemas

= Seguridad y Cumplimiento =

* Validación según normativa SRI
* Algoritmos de verificación de Cédula y RUC
* Transmisión segura vía HTTPS
* Autenticación mediante API Key y Secret
* Logs de auditoría para seguimiento

= Requisitos =

* Cuenta activa en Factunexo ([Registrarse aquí](https://factunexo.com.ec))
* API Key de Factunexo (obtener desde el panel de administración)
* Seleccionar el punto de venta desde donde emitir. Ejemplo: 001 o 002.
* WooCommerce 10.0 o superior instalado y activo

== Installation ==

= Instalación Automática =

1. Ve a **Plugins → Añadir nuevo** en tu panel de WordPress
2. Busca "Factunexo Facturacion Electrónica"
3. Haz clic en **Instalar ahora**
4. Activa el plugin

= Instalación Manual =

1. Descarga el archivo ZIP del plugin
2. Ve a **Plugins → Añadir nuevo → Subir plugin**
3. Selecciona el archivo ZIP descargado
4. Haz clic en **Instalar ahora**
5. Activa el plugin

= Configuración Inicial =

1. Ve a **Factunexo → Configuración** en el menú de WordPress
2. Ingresa tu **API Key** y **API Secret** de Factunexo
4. Selecciona tu **Punto de Venta (POS)**
5. Configura el **momento de emisión** de facturas (Procesando o Completado)
6. Haz clic en **Probar conexión** para verificar la configuración
7. Guarda los cambios

= Verificar Instalación =

Después de activar, deberías ver:
* Nuevo menú **"Factunexo"** en el sidebar de WordPress
* Campos adicionales en el checkout de WooCommerce
* Nueva columna "Factura Factunexo" en pedidos

== Frequently Asked Questions ==

= ¿Necesito tener una cuenta en Factunexo? =

Sí, necesitas una cuenta activa y un plan contratado en Factunexo. Puedes registrarte en [factunexo.com.ec](https://factunexo.com.ec).

= ¿El plugin es gratuito? =

El plugin es gratuito, pero necesitas una suscripción a Factunexo para generar facturas.

= ¿Funciona con WooCommerce Blocks? =

Sí, es 100% compatible con el nuevo checkout basado en bloques de WooCommerce.

= ¿Cuándo se crea la factura? =

Por defecto, cuando el pedido cambia a estado "Procesando". Puedes configurar esto en las opciones del plugin.

= ¿Puedo crear facturas manualmente? =

Sí, desde el panel del pedido, en "Acciones del pedido" → "Crear factura Factunexo".

= ¿Qué pasa si falla la creación de la factura? =

El pedido se procesa normalmente, pero verás un mensaje de error. Puedes reintentar desde el panel del pedido.

= ¿El cliente recibe la factura por email? =

Sí, si activas la opción "Enviar factura por email" en la configuración.

= ¿Por qué no acepta mi RUC? =

Verifica que:
* Tenga exactamente 13 dígitos
* Los últimos 3 dígitos sean correctos (001 para natural, 0001 para público)
* El tercer dígito sea válido (0-5 para natural, 6 para público, 9 para privado)

= ¿Puedo deshabilitar las validaciones? =

No es recomendable, ya que el SRI puede rechazar facturas con datos inválidos.

= ¿Dónde se guardan las facturas? =

En Factunexo. El plugin solo guarda referencias (IDs y metadatos) en WordPress.

= ¿Afecta el rendimiento de mi tienda? =

No. Las peticiones a la API son asíncronas y no bloquean el proceso de compra.

== Screenshots ==

1. Página de configuración del plugin con campos de API Key, Secret
2. Selcción de punto de venta
3. Importación de productos
4. Sincronización de productos
5. Campos personalizados en el checkout de WooCommerce
6. Emisión de facturas a nombre de empresa (persona jurídica)
7. Columna de facturas en el listado de pedidos mostrando secuencial y estado

== Changelog ==

= 1.0.0 =
* Lanzamiento inicial
* Integración con Factunexo API
* Campos personalizados en checkout
* Validación de Cédula y RUC ecuatorianos
* Generación automática de facturas
* Compatible con WooCommerce Blocks
* Columna de facturas en pedidos
* Modo debug integrado
* Soporte para HPOS (High-Performance Order Storage)
* Envío automático de facturas por email

== Upgrade Notice ==

= 1.0.0 =
* Primera versión del plugin. Configura tu API Key y Secret antes de usar.


== Support ==

[EC]

* **Documentación**: [www.factunexo.com.ec](https://www.factunexo.com.ec/producto/integracion-wordpress-woocommerce)
* **Soporte Técnico**: soporte@xinersoft.com
* **Sitio Web**: [www.factunexo.com.ec](https://www.factunexo.com.ec)

== Credits ==

Desarrollado por **Xinersoft**.

== License ==

Este plugin está licenciado bajo la **GPLv2 o posterior**.

Ver el archivo LICENSE.txt para más detalles.

