Pedidos y Facturación

El plugin se integra automáticamente con el ciclo de vida de los pedidos de WooCommerce. Cuando un pedido es pagado, se genera y envía el comprobante fiscal a la DGII sin intervención manual.

Flujo de Facturación

1. Cliente realiza un pedido — En el checkout, el cliente puede ingresar opcionalmente su RNC o Cédula y Razón Social. Estos campos se agregan automáticamente al formulario de pago.
2. Pedido marcado como pagado — Cuando el estado del pedido cambia a “Processing” o “Completed”, el plugin genera automáticamente el comprobante fiscal (E31 si hay RNC, E32 si no).
3. Envío a la DGII — El comprobante se envía asincrónicamente a la DGII a través de la API de ECF SSD. El proceso no bloquea la experiencia del usuario ni del administrador.
4. Confirmación — Una vez aprobado por la DGII, el eNCF y el código de seguridad se almacenan en el pedido. Si la DGII rechaza el documento, el error se muestra para corrección.

Campos del Checkout

El plugin agrega campos opcionales al formulario de pago de WooCommerce que determinan el tipo de comprobante a emitir:

• RNC / Cédula — Identificación fiscal del comprador. Si se proporciona, se emite un E31 (Crédito Fiscal). Si no, se emite un E32 (Consumo).
• Razón Social — Nombre legal del comprador. Se muestra cuando el cliente ingresa un RNC, necesario para la emisión de facturas de crédito fiscal.

Panel de Administración

Cada pedido muestra una caja de metadatos ECF DGII en el detalle del pedido con toda la información fiscal.

Estados del Comprobante

• approved — Comprobante aprobado por la DGII — el eNCF es válido y registrado.
• submitting — Comprobante enviado, esperando respuesta de la DGII.
• pending — Pendiente de envío — se enviará automáticamente.
• error — Error en el envío — revisar los detalles del error en el metabox.

Información Almacenada

• eNCF — Número de comprobante fiscal electrónico asignado
• Código de Seguridad — Código de verificación emitido por la DGII
• Fecha de Firma — Fecha y hora en que se firmó el documento
• Tipo de Comprobante — E31 (Crédito Fiscal) o E32 (Consumo)
• Estado DGII — Resultado de la validación por la DGII
• RNC Comprador — Identificación fiscal del cliente (si aplica)

Procesamiento Asíncrono

El plugin utiliza Action Scheduler (incluido en WooCommerce) para procesar los comprobantes de forma asíncrona. Esto significa que:

• El checkout del cliente no se ve afectado por el envío a la DGII
• El administrador puede seguir trabajando mientras el comprobante se procesa
• Si hay un error temporal, el plugin reintenta automáticamente según la configuración de reintentos
• Al abrir el detalle de un pedido, el plugin verifica el estado actualizado del comprobante