WooCommerce es la forma más común de vender en WordPress, pero la facturación electrónica de la DGII queda fuera de su alcance. El plugin de Aura se engancha a los eventos de WooCommerce (pago y reembolso), traduce el pedido a una emisión de e-CF contra la API de Aura y guarda el e-NCF y el QR en los metadatos del pedido.

Qué hace el plugin

  • Emite e-CF automáticamente al pagarse el pedido: E31 con crédito fiscal si hay RNC, E32 de consumo si no lo hay.
  • Añade un campo «RNC o Cédula» en el checkout, guardado en el meta _billing_rnc.
  • Genera notas de crédito (E34) automáticamente al reembolsar, total o parcial.
  • Es compatible con HPOS (High-Performance Order Storage de WooCommerce).
  • Recibe el estado de la DGII por webhook firmado (HMAC-SHA256) y lo escribe en los metadatos del pedido, sin polling.

Requisitos

  • WordPress 6.0 o superior.
  • WooCommerce 7.0 o superior.
  • PHP 7.4 o superior.
  • Una cuenta de Aura con un cliente emisor certificado y una API Key.

Instalación y configuración

  1. Copia la carpeta aura-ecf-woocommerce/ a wp-content/plugins/.
  2. Actívalo desde la pantalla «Plugins» de WordPress.
  3. Ve a WooCommerce → Ajustes → Integraciones → Aura e-CF y completa:
    • URL de la API de Aura (con o sin /v1)
    • API Key (de prueba o de producción)
    • Client ID del emisor
    • (Opcional) Emisión automática, tipo de e-CF sin RNC y secreto de webhook

El endpoint de webhook entrante del plugin queda en https://tu-sitio/wp-json/aura-ecf/v1/webhook; configúralo en Aura para recibir el estado de la DGII en tiempo real.

El RNC del checkout decide el tipo. Con un RNC válido el cliente recibe un E31 con crédito fiscal; sin RNC, un E32 de consumo. El plugin elige por ti en cada pedido.

Disponibilidad

Próximamente en el directorio de plugins de WordPress.org. Estamos preparando la publicación. Mientras tanto, escríbenos y te enviamos el plugin para instalarlo manualmente en tu sitio.

Cómo empezar

Crea tu cuenta de Aura gratis: incluye 100 e-CF por mes y las emisiones en CerteCF no se cobran. Regístrate en aura.nexo.com.do, obtén tu API Key y tu Client ID, y pégalos en los ajustes del plugin.

La referencia de la API (OpenAPI 3.1) está en aura.nexo.com.do/docs, y los detalles de la plataforma en la página de Aura.