Integra la facturación electrónica en WordPress y WooCommerce con PHP

WordPress con WooCommerce es una de las formas más comunes de vender en línea en Ecuador. Para facturar cada venta al SRI tienes dos caminos.

Opción 1: el plugin listo

Si quieres algo rápido y sin programar, revisa los plugins de facturación electrónica de AZUR para tiendas en línea. Se configuran con tus credenciales y facturan los pedidos.

Opción 2: tu propia integración con el SDK de PHP

Si tu tienda tiene reglas especiales (productos personalizados, varios establecimientos, flujos propios), puedes integrarla con el SDK oficial de PHP:

composer require azur/sdk

Dónde engancharte en WooCommerce

Lo habitual es facturar cuando el pedido pasa a «completado» o «procesando» (pago confirmado), con los hooks de estado de pedido de WooCommerce. En ese momento:

1. Tomas los datos del comprador (identificación, nombre, correo, dirección).
2. Recorres las líneas del pedido con su código, cantidad, precio y tarifa de IVA.
3. Creas la factura con el SDK y guardas la clave de acceso en los metadatos del pedido.

Evita duplicados

Un pedido puede disparar el hook más de una vez. El SDK envía una Idempotency-Key en las escrituras; además, guarda en el pedido que ya fue facturado para no repetirlo.

Hazlo en segundo plano

No factures dentro de la petición del cliente: usa una tarea programada (Action Scheduler de WooCommerce, por ejemplo) para no ralentizar el checkout y poder reintentar.

Datos que no pueden faltar

• Identificación del comprador (cédula, RUC o pasaporte) para la factura.
• Códigos de producto iguales en tu tienda y en AZUR.
• La tarifa de IVA correcta de cada producto.

Recibe la confirmación del SRI

Configura un webhook para enterarte cuando el SRI autoriza la factura y adjuntar el PDF al pedido. Verifica la firma con Azur\Sdk\Webhook::verificar().

¿Y si no usas WordPress?

AZUR también ofrece su propio módulo Tienda Online, conectado directamente a la facturación y al inventario.

Integra tu tienda: crea tu cuenta gratis y consulta la referencia de la API.