Integración WooCommerce
El plugin ECF DGII Invoicing for WooCommerce automatiza la emisión de Comprobantes Fiscales Electrónicos (E-CF) directamente desde su tienda WooCommerce. Cada vez que un pedido es pagado, el plugin genera y envía el comprobante a la DGII a través de la API de ECF SSD.
Requisitos:
- WordPress 6.2 o superior
- WooCommerce 8.0 o superior
- PHP 8.1 o superior
- Cuenta activa en ecf.ssd.com.do
- Certificado Digital (.p12) delegado en la plataforma
- Estar certificado como Emisor de Facturación Electrónica ante la DGII
¿Aún no es Emisor Electrónico? Debe completar el proceso de certificación con la DGII antes de poder emitir comprobantes fiscales electrónicos. Nuestra plataforma automatiza gran parte de este proceso. Consulte la guía Proceso de Certificación DGII para comenzar.
Instalación
- Descargar el Plugin — Descargue el archivo ZIP del plugin directamente desde nuestra plataforma o desde la página de releases en GitHub.
- Instalar en WordPress — En su panel de WordPress, vaya a Plugins → Añadir nuevo → Subir plugin. Seleccione el archivo ZIP descargado y haga clic en “Instalar ahora”.
- Activar el Plugin — Una vez instalado, haga clic en “Activar plugin”. El plugin creará automáticamente las tablas necesarias en la base de datos.
También puede instalar vía WP-CLI:
wp plugin install ecf-dgii-invoicing-1.0.0.zip --activate
Configuración Inicial
Después de activar el plugin, vaya a WooCommerce → Ajustes → ECF DGII para configurar la conexión con la API.
- Registrarse en ECF SSD — Si aún no tiene una cuenta, regístrese en ecf.ssd.com.do. Cree su compañía y delegue su Certificado Digital (.p12) autorizado por la DGII.
- Generar API Key — En el portal de ECF SSD, genere una API Key para el ambiente que desea utilizar (Test o Producción). Cada ambiente requiere su propia llave.
- Seleccionar Ambiente — En los ajustes del plugin, seleccione el ambiente activo: Producción para comprobantes reales o Test para pruebas sin afectar la DGII.
- Ingresar API Tokens — Copie los API Tokens generados en los campos correspondientes. El plugin mantiene tokens separados para cada ambiente, permitiendo alternar sin perder configuración.
- Configurar Datos de la Empresa — Ingrese el RNC de su empresa. Al hacer clic en “Probar Conexión”, el plugin llenará automáticamente la Razón Social y Nombre Comercial desde la DGII.
- Probar Conexión — Haga clic en el botón “Probar Conexión” para verificar que la comunicación con la API es exitosa. Deberá ver el nombre de su empresa confirmado.
Próximos Pasos
- Configurar Secuencias — Configure las secuencias eNCF autorizadas por la DGII para emitir comprobantes.
- Pedidos y Facturación — Cómo el plugin genera comprobantes automáticamente al procesar pedidos.
- Reembolsos y Notas de Crédito — Generación automática de Notas de Crédito E34 al crear reembolsos.
- Contingencia — Modo de contingencia automático cuando la API no está disponible.
Open Source: Este plugin es de código abierto. Si necesita personalización para su negocio, puede modificar el código fuente libremente. El repositorio está disponible en GitHub.
Soporte: Si necesita ayuda con la instalación o configuración, contáctenos en [email protected] o visite ssd.com.do.