Integrar WooCommerce WordPress con plugins homologados DIAN

Guía para Integrar WooCommerce/WordPress con Plugins Homologados por la DIAN (Colombia)
(Actualizado para 2024, según Resolución 000042 de 2022 y normativa vigente)

1. ¿Qué es un Plugin Homologado por la DIAN?

Son herramientas certificadas por la Dirección de Impuestos y Aduanas Nacionales (DIAN) que cumplen con los requisitos técnicos y legales para:

• Generar facturas electrónicas válidas.
• Firmar documentos con certificado digital.
• Transmitir XML al ambiente de validación de la DIAN.
• Gestionar CUDE, QR y contingencia.

Listado de Proveedores Homologados:
Consulta aquí los PT (Proveedores Tecnológicos) autorizados.

2. Plugins Recomendados para WooCommerce

Estos plugins están desarrollados por PT homologados y permiten integración directa:

a) Alegra Facturación Electrónica

• Enlace: Alegra WooCommerce
• Funciones:
• Genera facturas electrónicas DIAN automáticamente.
• Configuración de resoluciones de facturación.
• Envío automático al cliente por correo.
• Costo: Desde $99,000 COP/mes (según volumen).

b) Siigo Factura Electrónica

• Enlace: Siigo Nube
• Funciones:
• Sincronización de productos y clientes.
• Generación de CUDE y QR.
• Histórico de documentos en la nube.
• Costo: Planes desde $89,000 COP/mes.

c) Habemus Facturación

• Enlace: Habemus WooCommerce
• Funciones:
• Firma digital con certificado DIAN integrado.
• Ambiente de pruebas y producción.
• Notificaciones de aceptación/rechazo DIAN.
• Costo: $0.15 COP por factura (primeras 100 gratis).

d) Efactura.co

• Enlace: Plugin Efactura
• Funciones:
• Emisión masiva de facturas.
• Configuración de retenciones e impuestos.
• Reportes DIAN en tiempo real.
• Costo: Desde $75,000 COP/mes.

3. Pasos para Integrar un Plugin Homologado

Paso 1: Registrar Cuenta en el Proveedor Tecnológico

1. Crea una cuenta en el sitio del PT (Ej: Alegra).
2. Activa el ambiente de pruebas (usando certificado de habilitación DIAN).
3. Obtén las credenciales de API (API Key y Token).

Paso 2: Instalar el Plugin en WordPress

1. Ve a Plugins > Añadir nuevo en tu WordPress.
2. Busca el plugin (Ej: “Alegra WooCommerce”).
3. Instala y activa.

Paso 3: Configurar Conexión con el PT

1. Ve a WooCommerce > Ajustes > Facturación Electrónica.
2. Ingresa:

• API Key: Proporcionada por el PT.
• Certificado .p12: Sube tu certificado DIAN.
• Resolución DIAN: Números asignados por la DIAN (Ej: 18764000000).
• Ambiente: Pruebas o Producción. (Ejemplo de configuración en Alegra)
  

Paso 4: Configurar Campos Obligatorios

Los plugins suelen añadir automáticamente:

• NIT/CI en el checkout.
• Tipo de responsabilidad fiscal (R-99-PN, O-13, etc.).
• Dirección fiscal completa.

Si no lo hacen, usa este snippet:
php // Añadir campo NIT al checkout add_filter('woocommerce_billing_fields', 'custom_nit_field'); function custom_nit_field($fields) { $fields['billing_nit'] = array( 'label' => 'NIT/Cédula', 'required' => true, 'class' => array('form-row-wide'), 'priority' => 25 ); return $fields; }

Paso 5: Probar una Transacción

1. Realiza una compra de prueba en tu tienda.
2. Verifica que:

• El plugin genere la factura en XML y PDF.
• El PDF incluya QR y CUDE.
• La factura aparezca en el portal del PT y en el ambiente de pruebas DIAN.

Paso 6: Sincronizar con Ambiente de Producción

1. Solicita a tu PT cambiar de pruebas a producción.
2. Actualiza en WordPress:

• Certificado DIAN definitivo.
• Resolución de facturación en producción.
• Configuración de numeración DIAN (Ej: FE-1-1000).

4. Flujo de una Factura con Plugin Homologado

1. Cliente paga: WooCommerce envía los datos de la orden al plugin.
2. Plugin PT:

• Valida los datos contra estándares DIAN.
• Genera XML con estructura UBL 2.1.
• Firma el documento con tu certificado.
• Transmite a los servidores de la DIAN.

1. DIAN responde:

• Aceptada: Envía CUDE y adjunta PDF a WooCommerce.
• Rechazada: Notifica errores vía email o API.

1. Cliente recibe: Factura en PDF con QR válido en su correo.

5. Costos y Consideraciones Legales

• Tarifas: Desde $0.10 COP por factura (Ej: Habemus) hasta planes mensuales fijos.
• Responsabilidades:
• Tú: Conservar XML y PDF por 10+ años (Art. 774 Estatuto Tributario).
• PT Homologado: Mantener certificación DIAN y actualizar el plugin.
• Sanciones: Usar plugins no homologados puede generar multas de hasta 10,000 UVT ($424 millones COP aprox).

6. Solución de Problemas Comunes

Error: “Certificado Inválido”

• Causa: Certificado .p12 no coincide con el NIT registrado.
• Solución:

1. Renueva el certificado en la DIAN.
2. Actualízalo en el plugin y el PT.

Error: “CUFE Inválido”

• Causa: Numeración DIAN incorrecta o duplicada.
• Solución:

1. Revisa la resolución de facturación en WooCommerce > Ajustes.
2. Configura rangos válidos (Ej: FE-1-100 a FE-1-500).

Error: “Rechazo DIAN – XSD”

• Causa: XML no cumple estructura UBL 2.1.
• Solución:

1. Actualiza el plugin a su última versión.
2. Verifica que todos los campos obligatorios estén mapeados.

7. Ventajas de Usar Plugins Homologados

• Cumplimiento Legal: Garantizan que las facturas son válidas ante la DIAN.
• Automatización: No necesitas generar XML manualmente.
• Soporte Técnico: Los PT brindan asistencia para problemas DIAN.
• Actualizaciones: Los plugins se actualizan ante cambios normativos (Ej: Resoluciones 2024).

8. Conclusión

Integrar WooCommerce con un plugin homologado por la DIAN es la única forma legal de emitir facturas electrónicas en Colombia. Los pasos clave son:

1. Elegir un PT de la lista oficial.
2. Configurar el plugin con certificado y resolución DIAN.
3. Probar en ambiente de pruebas antes de producción.

Recursos Adicionales:

• Guía DIAN para Facturación Electrónica.
• Tutorial Oficial DIAN para Integraciones.

(Documentación actualizada al 15 de julio de 2024).