Factunexo Docs

Plugin de WordPress / WooCommerce

Instala y configura el plugin de Factunexo para emitir facturas electrónicas del SRI automáticamente desde tu tienda WooCommerce.

Factunexo WooCommerce Integration conecta tu tienda WooCommerce con Factunexo y emite facturas electrónicas válidas ante el SRI de Ecuador cada vez que se completa una venta en tu tienda online.

Antes de empezar

Necesitas una cuenta activa en Factunexo con tus credenciales de API (API Key, API Secret, URL de la API y Merchant ID). Puedes crear tu cuenta gratis — 14 días de prueba, sin tarjeta.

¿Qué hace el plugin?

  • Captura los datos fiscales del cliente durante el checkout.
  • Valida identificaciones ecuatorianas (cédula y RUC) en tiempo real.
  • Crea la factura automáticamente cuando cambia el estado del pedido.
  • Muestra la información de la factura en la administración de pedidos.
  • Envía la factura al cliente por correo electrónico.

Compatibilidad

ComponenteVersión mínimaRecomendada
WordPress6.86.8+
WooCommerce10.010.0+
PHP7.48.1+
MySQL5.78.0+
HTTPSRequerido
cURLHabilitado

Compatible con el checkout clásico y con el checkout basado en bloques (WooCommerce Blocks).

Requisitos de cuenta

Además de los requisitos técnicos necesitas: una cuenta activa en Factunexo y tus credenciales API Key, API Secret y Merchant ID (los obtienes desde la app, en Configuración → API).

Instalación

Súbelo a WordPress

En tu panel de WordPress ve a Plugins → Añadir nuevo → Subir plugin, selecciona el archivo .zip descargado y haz clic en Instalar ahora.

Actívalo

Haz clic en Activar. Al activarse aparecen:

  • Un nuevo menú Factunexo en el sidebar de WordPress.
  • Campos adicionales en el checkout de WooCommerce.
  • Una nueva columna Factura Factunexo en el listado de pedidos.

Configuración

Obtén tus credenciales

En tu cuenta de Factunexo ve a Configuración → API y copia: API URL, API Key, API Secret y Merchant ID.

Configúralas en WordPress

En WordPress Admin ve a Factunexo → Configuración y completa los campos: API Key, API Secret, URL de la API y Merchant ID.

Prueba la conexión

Haz clic en Probar conexión para verificar que todo esté correcto. Debe mostrar "Conexión exitosa con Factunexo".

Guía de uso

Para el cliente: proceso de compra

Durante el checkout, el cliente ve campos adicionales de facturación:

  • Tipo de identificación (Cédula, RUC o Pasaporte).
  • Número de identificación, validado en tiempo real:
    • Cédula: algoritmo Módulo 10.
    • RUC: validación según tipo (natural, público, privado).
    • Se muestra un error inmediato si el número es inválido.
  • Nombre para la factura.

Al completar la compra, la factura se genera y (si está activado) se envía al cliente por correo.

Para el administrador: gestión de pedidos

En el listado de pedidos, la columna Factura Factunexo muestra el número de comprobante y su estado:

EstadoSignificado
AutorizadaEl SRI autorizó la factura.
GuardadaRegistrada en Factunexo, pendiente de autorización.
PendienteEn proceso.
RechazadaEl SRI la rechazó; revisa el motivo y corrige.

Por defecto la factura se crea cuando el pedido pasa a estado Procesando. Puedes cambiar el estado disparador en la configuración del plugin.

Sincronización de inventario

Si usas el módulo de Inventario, las ventas web descuentan stock automáticamente y puedes publicar el stock disponible en tu tienda. Ver Inventario → Tienda WooCommerce.

Preguntas frecuentes

¿Necesito una cuenta en Factunexo?

Sí. Puedes crearla gratis con 14 días de prueba, sin tarjeta de crédito.

¿El plugin es gratuito?

El plugin se descarga sin costo. Para emitir facturas electrónicas necesitas una suscripción activa a Factunexo.

¿Funciona con WooCommerce 10+?

Sí, es 100% compatible con WooCommerce 10.0+ y el checkout basado en bloques.

¿Cuándo se crea la factura?

Por defecto, cuando el pedido cambia a estado Procesando. Es configurable.

¿El cliente recibe la factura por email?

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

¿Afecta el rendimiento de mi tienda?

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

Soporte

  • Email: soporte@xinersoft.com
  • WhatsApp: +593 99 101 6410
  • Horario: lunes a viernes, 9:00 – 18:00
  • Tiempo de respuesta: 4–8 horas hábiles