Cómo integrar pagos, envíos y facturación en una tienda virtual en Colombia

PorBrayan Steven Rendón Monsalve
Creación de ecosistemas digitales de venta. Cómo integrar pagos, envíos y facturación en una tienda virtual en Colombia.

Cómo integrar pagos, envíos y facturación en una tienda virtual en Colombia.

Cómo integrar pagos, envíos y facturación en una tienda virtual en Colombia. La integración técnica en WordPress se logra mediante plugins especializados: WooCommerce como base, el plugin oficial de Wompi para procesar pagos, y el conector de Siigo para facturación automática al confirmarse cada orden.

Para integrar pagos, envíos y facturación en una tienda virtual colombiana, se recomienda utilizar Wompi como pasarela de pagos principal por su amplia aceptación de métodos (tarjetas, PSE, Nequi y Daviplata), su API robusta y tarifas competitivas.

Para la facturación electrónica, Siigo es la solución más adecuada por su certificación DIAN, generación automática de documentos y sincronización con plataformas de e-commerce, garantizando el cumplimiento normativo.

Los envíos pueden integrarse mediante APIs de transportadoras como Servientrega o Coordinadora, permitiendo cotización automática, generación de guías y seguimiento en tiempo real.

Para envíos, plugins como «Flexible Shipping» permiten configurar tarifas por zonas, pesos y valores, mientras que la API de transportadoras colombianas facilita la generación automática de guías.

Es crucial añadir campos obligatorios como NIT/CC en el checkout y configurar correctamente el IVA del 19% en WooCommerce.

Esta arquitectura garantiza un flujo automatizado: Al confirmarse el pago vía Wompi, se activan webhooks que generan la factura en Siigo y crean la orden de envío con la transportadora. El cliente recibe automáticamente su factura electrónica y el número de guía para seguimiento. Esta integración total no solo optimiza la operación, sino que asegura el cumplimiento legal de la Resolución 192 de 2021 de la DIAN, evitando sanciones y generando confianza en los compradores colombianos.

1. Arquitectura básica de una tienda virtual.

Para operar legalmente en Colombia necesitas integrar:

  • Sistema de pagos (para recibir dinero).
  • Sistema de facturación electrónica (obligatorio por la DIAN).
  • Sistema de envíos/logística (para entregar productos).

2. Sistemas de Pago Recomendados.

a) Wompi.

  • Ventajas:
    • Procesa tarjetas crédito/débito.(nacionales e internacionales).
    • Transacciones PSE (débito directo desde cuentas bancarias).
    • Pagos con Nequi y Daviplata.
    • Link de pago y checkout personalizado.
    • API robusta para desarrolladores.
    • Tarifas competitivas (~3.5% + IVA por tarjeta).
  • Desventajas:
    • No incluye facturación electrónica automática
    • Requiere integración separada con facturación

b) Mercado Pago

  • Ventajas:
    • Solución todo-en-uno (pagos + facturación básica)
    • Conocido por los usuarios
    • Puede generar facturas aunque limitadas
    • QR de pago
  • Desventajas:
    • Las facturas no cumplen al 100% con requisitos DIAN.
    • Tarifas generalmente más altas que Wompi.

c) Transferencias a Nequi/Bancolombia.

  • Ventajas:
    • Sin comisiones para el vendedor.
    • Familiar para usuarios colombianos.
  • Desventajas:
    • No es automático (depende del cliente notificar).
    • No genera factura automáticamente.
    • Mayor riesgo de fraude/no pago.

3. Facturación Electrónica – Opciones.

a) Siigo (Recomendado).

POR QUÉ USAR SIIGO:

  1. Certificado por la DIAN – Cumple con todos los requisitos técnicos
  2. Facturación automática – Se integra con tu tienda para generar facturas al momento del pago
  3. Inviolabilidad – Garantiza que las facturas no puedan ser modificadas
  4. API robusta – Fácil integración con plataformas de e-commerce
  5. Planes accesibles – Desde $50.000/mes aproximadamente
  6. Soporte especializado – En temas de normatividad colombiana

b) Integradores directos con la DIAN.

  • Opciones: Alegra, SAP, Oracle, Facture.co, Billage
  • Ventaja: Cumplimiento directo con la DIAN
  • Desventaja: Requieren mayor configuración técnica

4. Sistema de Envíos.

Principales opciones:

  1. Servientrega/Coordinadora/Interrapidisimo
    • API disponibles para cotización automática
    • Generación de guías desde tu plataforma
    • Seguimiento integrado
  2. Mercado Envíos (si usas Mercado Libre)
    • Ventaja: Tarifas competitivas
    • Desventaja: Limitado a pedidos de Mercado Libre
  3. DHL/FedEx para envíos internacionales

5. Flujo de Integración Recomendado.

Opción 1: Todo integrado (Recomendado para escalar).

text

Cliente paga → Wompi recibe pago → Webhook activa → 
1. Sistema genera factura en Siigo automáticamente
2. Sistema crea orden de envío con transportadora
3. Factura se envía automáticamente al cliente

Opción 2: Para comenzar (menos costosa).

text

1. Mercado Pago para pagos y facturación básica
2. Envíos manuales con transportadora
3. Actualizar inventario manualmente

6. Recomendaciones por tipo de negocio.

Para microempresas/emprendedores:

  • Pagos: Mercado Pago (por simplicidad)
  • Facturación: Siigo NubeCrea (gratis hasta cierto volumen)
  • Envíos: Acuerdos básicos con transportadora local

Para PYMEs con crecimiento:

  • Pagos: Wompi (mejores tarifas, más profesional)
  • Facturación: Siigo Pyme o Alegra
  • Envíos: API de Servientrega/Coordinadora

Para empresas establecidas:

  • Pagos: Gateway bancario + Wompi como alternativa
  • Facturación: Siigo Enterprise o SAP
  • Envíos: Sistema logístico integrado

7. Consideraciones Legales Importantes.

  1. Resolución 192 de 2021 (DIAN): Obliga facturación electrónica a todos
  2. Registro ante la Cámara de Comercio: Obligatorio antes de facturar
  3. Retenciones en la fuente: Aplican según tu actividad
  4. IVA digital: Para productos/servicios digitales

8. Plataformas Todo-en-Uno para Colombia.

  • TiendaNube: Con integración nativa con Siigo y envíos
  • Shopify + Apps: Con apps para Wompi y facturación colombiana
  • WooCommerce: Con plugins para integración DIAN
  • Mercado Shops: Integrado con Mercado Pago y facturación

Conclusión Final.

¿Por qué Wompi + Siigo es la mejor combinación?.

  • Wompi ofrece el sistema de pagos más completo y con mejores tarifas
  • Siigo garantiza cumplimiento 100% con la DIAN sin complicaciones
  • Juntos automatizan completamente el flujo: pago → factura → envío
  • Ambos tienen APIs bien documentadas y soporte en Colombia

Costos estimados mensuales para una PYME:

  • Wompi: Comisiones por transacción (~3.5%)
  • Siigo: Desde $50.000 a $150.000 según plan
  • Envíos: Dependen del volumen

Recomendación inicial: Comienza con Mercado Pago si estás probando el mercado, pero migra a Wompi + Siigo cuando tengas ventas consistentes para profesionalizar y automatizar tu operación cumpliendo con todas las obligaciones legales colombianas.

Guía Paso a Paso para WordPress en Colombia.

📋 PASO 1: Configuración Inicial Obligatoria.

1.1 Registros Legales.

text

1. Registro en Cámara de Comercio (RUT)
2. Habilitar facturación electrónica en DIAN
3. Obtener certificado digital para facturación
4. Registro de marca si aplica

1.2 Configurar WordPress.

php

// Sitio mínimo recomendado:
- WordPress 6.0+
- WooCommerce 8.0+
- Tema Storefront o Astra Pro
- SSL obligatorio (Certificado HTTPS)

💳 PASO 2: Integración de Pagos (WooCommerce).

2.1 Instalar y Configurar WooCommerce.

text

1. Plugins → Añadir nuevo → Buscar "WooCommerce"
2. Instalar y activar
3. Seguir wizard de configuración:
   - Ubicación: Colombia
   - Moneda: COP ($)
   - Unidades: cm/kg
   - Impuestos: Activar (IVA 19%)

2.2 Elegir Método de Pago.

Opción A: Wompi (RECOMENDADO).

php

// Instalar Plugin Oficial Wompi:
1. Descargar desde: https://wordpress.org/plugins/wompi-para-woocommerce/
2. Subir a WordPress: Plugins → Añadir nuevo → Subir plugin
3. Configurar:
   - Modo: Producción (no pruebas cuando esté listo)
   - Public Key: Desde dashboard.wompi.co
   - Private Key: Desde dashboard.wompi.co
   - Event Sign: Configurar webhooks

Configuración Wompi en WordPress:

text

Ajustes → WooCommerce → Pagos → Wompi
✓ Activar tarjetas crédito/débito
✓ Activar PSE (Transferencias bancarias)
✓ Activar Nequi/Daviplata
✓ Establecer comisiones si las absorbes

Opción B: Mercado Pago.

php

1. Plugins → Buscar "Mercado Pago"
2. Instalar plugin oficial
3. Conectar con credenciales de Mercado Pago
4. Configurar métodos disponibles

Opción C: Transferencias Bancarias Manuales.

text

1. WooCommerce → Ajustes → Pagos
2. Activar "Transferencia bancaria"
3. Configurar:
   - Instrucciones: "Realiza transferencia a Nequi 3101234567"
   - Cuentas bancarias si tienes varias

🧾 PASO 3: Facturación Electrónica con Siigo.

3.1 Conectar Siigo con WordPress.

Método 1: Plugin Siigo (Recomendado).

php

1. Contactar a Siigo para obtener plugin WordPress
   (Email: desarrolladores@siigo.com)
2. Instalar plugin personalizado de Siigo
3. Configurar conexión API:
   - Client ID: [proporcionado por Siigo]
   - Client Secret: [proporcionado por Siigo]
   - Usuario API: [credenciales Siigo Nube]

Método 2: Plugin Facturación Colombia (Alternativa).

php

1. Instalar "WooCommerce Facturación Electrónica Colombia"
2. Configurar datos DIAN:
   - NIT
   - Resolución de facturación
   - Numeración autorizada
   - Certificado digital (.p12)

3.2 Configurar Flujo Automático.

text

1. En Siigo Nube crear:
   - Lista de productos (sincronizar con WooCommerce)
   - Clientes (sincronización automática)
   - Numeración de facturas

2. Configurar triggers:
   - Cuando orden cambia a "Completado" → generar factura
   - Enviar PDF automáticamente al cliente
   - Guardar PDF en servidor WordPress

Código para functions.php (opcional):

php

add_action('woocommerce_order_status_completed', 'generar_factura_siigo');
function generar_factura_siigo($order_id) {
    $order = wc_get_order($order_id);
    
    // Datos para API Siigo
    $data = array(
        'document' => array(
            'id' => $order_id,
            'customer' => array(
                'identification' => $order->get_meta('_billing_dni'),
                'name' => $order->get_billing_first_name() . ' ' . $order->get_billing_last_name()
            ),
            'items' => array()
        )
    );
    
    // Llamar API Siigo
    // wp_remote_post('https://api.siigo.com/v1/invoices', $data);
}

🚚 PASO 4: Sistema de Envíos.

4.1 Configurar Zonas de Envío.

text

1. WooCommerce → Ajustes → Envíos → Zonas de envío
2. Crear zonas:
   - Bogotá D.C. (Local)
   - Colombia (Nacional)
   - Internacional (Opcional)

4.2 Integrar con Transportadoras.

Para Servientrega/Coordinadora:

php

1. Instalar plugin "WooCommerce Shipping"
2. Obtener API Key de transportadora
3. Configurar:
   - Cotización automática por peso/destino
   - Generación automática de guías
   - Seguimiento integrado

Configuración Manual (para empezar):

text

1. WooCommerce → Envíos → Métodos de envío
2. Añadir "Envío por precio fijo" o "Envío por tasa fija"
3. Configurar precios:
   - Bogotá: $8,000
   - Otras ciudades: $15,000-25,000

4.3 Plugin Recomendado: «WooCommerce Table Rate Shipping»

text

- Permite tarifas por ciudad, peso, precio
- Cálculo automático según Región/Distrito
- Ideal para Colombia con múltiples ciudades

🔗 PASO 5: Integración Completa

5.1 Diagrama de Flujo Automatizado

text

CLIENTE COMPRA → WooCommerce procesa orden
        ↓
Wompi procesa pago (éxito/fallo)
        ↓
Webhook Wompi → WooCommerce actualiza estado
        ↓
SI orden = "completada" → Trigger Siigo
        ↓
Siigo genera factura → Envía PDF a cliente
        ↓
Sistema envíos → Genera guía transportadora
        ↓
Cliente recibe confirmación con:
  1. Factura electrónica
  2. Número de guía
  3. Instrucciones seguimiento

5.2 Configurar Webhooks

php

// Wompi Webhooks:
1. En dashboard.wompi.co → Webhooks
2. Añadir endpoint: https://tutienda.com/wc-api/wompi
3. Eventos a capturar:
   - transaction.updated
   - charge.succeeded

// Configurar en WordPress:
add_action('woocommerce_api_wompi', 'procesar_webhook_wompi');
function procesar_webhook_wompi() {
    // Lógica de verificación y actualización
}

⚙️ PASO 6: Configuraciones Específicas Colombia

6.1 Campos Obligatorios para Facturación

php

// Añadir campo NIT/DNI en checkout
add_filter('woocommerce_checkout_fields', 'campos_colombia');
function campos_colombia($fields) {
    $fields['billing']['billing_dni'] = array(
        'label' => 'NIT/Cédula',
        'placeholder' => 'Número de documento',
        'required' => true,
        'class' => array('form-row-wide'),
        'priority' => 25
    );
    return $fields;
}

6.2 Configurar IVA (19%)

text

1. WooCommerce → Ajustes → Impuestos
2. Activar impuestos
3. Añadir clase de impuesto "IVA"
4. Tasa: 19%
5. Configurar:
   - Precios incluidos IVA: SÍ
   - Calcular impuestos: Seguir dirección envío

6.3 Departamentos y Ciudades de Colombia

php

// Instalar plugin: "WooCommerce Cities for Colombia"
// O añadir manualmente en functions.php:
add_filter('woocommerce_states', 'ciudades_colombia');
function ciudades_colombia($states) {
    $states['CO'] = array(
        'BOG' => 'Bogotá D.C.',
        'ANT' => 'Antioquia',
        'ATL' => 'Atlántico',
        // ... añadir todos los departamentos
    );
    return $states;
}

🔧 PASO 7: Plugins Esenciales

Lista de Plugins Obligatorios:

text

1. WooCommerce (carrito compras)
2. Wompi para WooCommerce (pagos)
3. Plugin Siigo (facturación)
4. WooCommerce Table Rate Shipping (envíos)
5. WP Mail SMTP (correos confiables)
6. Really Simple SSL (seguridad)
7. Wordfence Security (protección)
8. Yoast SEO (optimización)
9. Loco Translate (traducciones)

Configuración Específica:

php

// En wp-config.php añadir:
define('WP_DEBUG', false); // En producción
define('WP_MEMORY_LIMIT', '256M');
define('WPLANG', 'es_CO');

🚀 PASO 8: Pruebas y Puesta en Marcha

8.1 Modo Pruebas

text

1. Wompi: Usar keys de sandbox
2. Siigo: Usar ambiente de pruebas
3. Woocommerce: Activar modo mantenimiento
4. Realizar órdenes de prueba

8.2 Checklist Final

markdown

✅ SSL instalado y funcionando
✅ WooCommerce configurado con IVA 19%
✅ Wompi conectado (producción)
✅ Siigo generando facturas de prueba
✅ Métodos de envío configurados
✅ Campos NIT/DNI en checkout
✅ Políticas de privacidad y términos
✅ Contacto: WhatsApp, teléfono, correo
✅ Certificado digital cargado en Siigo
✅ Webhooks configurados y verificados

8.3 Monitoreo Post-Lanzamiento

text

1. Revisar webhooks diariamente
2. Verificar generación de facturas
3. Conciliar pagos Wompi vs WooCommerce
4. Validar envíos con transportadora
5. Backup automático diario

📞 Soporte Técnico en Colombia

Contactos Importantes:

text

• Wompi Soporte: soporte@wompi.co / WhatsApp: +57 318 8953982
• Siigo Soporte: 601 5085263 / soporte@siigo.com
• WooCommerce Soporte: Foros oficiales (inglés)
• Transportadoras:
  - Servientrega: 601 4230300
  - Coordinadora: 601 4105040

Costos Mensuales Estimados:

text

• Hosting WordPress: $50.000 - $150.000 COP
• Plugin premium: $20.000 - $100.000 COP
• Wompi: 3.5% + IVA por transacción
• Siigo: Desde $50.000 COP/mes
• Envíos: Variable según volumen

⚠️ Consideraciones Finales

  1. Backup automático con UpdraftPlus
  2. Velocidad de sitio optimizada (Cloudflare)
  3. Responsive design probado en móviles
  4. Certificado digital actualizado anualmente
  5. Respaldo físico de facturas (obligatorio 5 años)
  6. Conciliación bancaria mensual
  7. Actualizaciones semanales de plugins

Recomendación final: Comienza con configuración básica (Wompi + Siigo manual) y automatiza gradualmente según crezca tu volumen de ventas. Realiza pruebas exhaustivas antes del lanzamiento oficial.

Guía Completa: Integración Todo-en-Uno en WordPress para Colombia

🎯 ARQUITECTURA RECOMENDADA PARA WORDPRESS

text

WORDPRESS + WOOCOMMERCE (Base)
        ↓
    Wompi ← PAGOS
        ↓
    Siigo ← FACTURACIÓN DIAN
        ↓
    Servientrega/Coordinadora ← ENVÍOS

📦 PASO 1: PREPARACIÓN WORDPRESS

1.1 Requisitos Técnicos Mínimos

php

// Hosting Recomendado en Colombia:
• Hostinger Colombia
• Neubox (con servidor en Bogotá)
• GoDaddy (con CDN local)

// Especificaciones:
✓ PHP 7.4 o superior
✓ MySQL 5.7+
✓ 1GB RAM mínimo
✓ SSL (GRATIS con Let's Encrypt)

1.2 Instalación Woocommerce

text

1. WordPress → Plugins → Añadir nuevo
2. Buscar "WooCommerce"
3. Instalar y activar
4. Ejecutar Wizard de configuración:

Configuración Wizard:
• Ubicación: Colombia
• Moneda: Peso Colombiano (COP $)
• Unidades: Centímetros, Kilogramos
• Impuestos: ACTIVAR (IVA 19%)
• Métodos de pago: Dejar para después

💳 PASO 2: INTEGRACIÓN DE PAGOS

2.1 Wompi (RECOMENDADO)

Instalación Plugin Oficial:

text

1. Descargar: https://github.com/wompi/woocommerce-wompi
2. WordPress → Plugins → Añadir nuevo → Subir plugin
3. Subir archivo .zip
4. Activar plugin

Configuración Wompi:

text

1. Crear cuenta en: https://dashboard.wompi.co
2. Obtener API Keys:
   • Modo Pruebas → Para desarrollo
   • Modo Producción → Para tienda real

3. WordPress → WooCommerce → Ajustes → Pagos
4. Buscar "Wompi" y configurar:

CONFIGURACIÓN:
✓ Habilitar: SÍ
✓ Título: "Pago con Tarjeta, PSE o Nequi"
✓ Descripción: "Pago 100% seguro"
✓ Public Key: pk_test_XXXXX (pruebas) / pk_prod_XXXXX
✓ Private Key: sk_test_XXXXX / sk_prod_XXXXX
✓ Event Sign: [Generar en dashboard.wompi.co]

MÉTODOS HABILITAR:
✓ Tarjetas de crédito/débito
✓ PSE (Pagos en línea)
✓ Nequi
✓ Daviplata

2.2 Configurar Otros Métodos

Transferencias Bancarias:

text

WooCommerce → Ajustes → Pagos → Transferencia bancaria
✓ Activar: SÍ
✓ Título: "Transferencia Bancaria"
✓ Descripción: "Realiza transferencia a nuestra cuenta"
✓ Instrucciones: 
  "Banco: Bancolombia
   Cuenta: Ahorros 123-456789-00
   Nombre: Tu Empresa SAS
   NIT: 123456789-0
   Enviar comprobante a WhatsApp: 3101234567"

Pago Contra Entrega:

text

WooCommerce → Ajustes → Pagos → Pago contra entrega
✓ Activar: SÍ (solo para ciudades específicas)
✓ Título: "Paga al recibir tu pedido"
✓ Restringir por zonas de envío

🧾 PASO 3: FACTURACIÓN CON SIIGO

3.1 Plugin Oficial Siigo

Obtener Plugin:

text

1. Contactar a Siigo: desarrolladores@siigo.com
2. Solicitar plugin WooCommerce
3. Recibirás:
   • Plugin personalizado
   • Credenciales API
   • Documentación

Instalación:

text

1. WordPress → Plugins → Añadir nuevo → Subir
2. Subir plugin Siigo (.zip)
3. Activar

4. Configurar:
   WooCommerce → Ajustes → Siigo Facturación
   
CONFIGURAR:
• Client ID: [proporcionado por Siigo]
• Client Secret: [proporcionado por Siigo]
• Usuario API: [tu usuario Siigo Nube]
• Contraseña API: [tu contraseña]
• Ambiente: Pruebas / Producción

3.2 Configuración Automática

Sincronización Productos:

text

1. Siigo Nube → Productos
2. Crear o importar desde Excel
3. En WordPress plugin Siigo:
   ✓ Sincronizar productos automáticamente
   ✓ Actualizar precios cada 24h

Generación Facturas:

text

CONFIGURAR TRIGGERS:
Cuando orden cambia a: "Completado" → Generar factura
Estado factura: "Aprobada" → Enviar PDF al cliente
Guardar copia: En servidor / En Google Drive

3.3 Alternativa sin Plugin Siigo

Plugin Gratuito: «Facturación Electrónica Colombia»

text

1. Instalar: https://wordpress.org/plugins/woo-factura-electronica-colombia/
2. Configurar:
   • NIT Empresa
   • Resolución DIAN
   • Numeración autorizada
   • Certificado digital (.p12)
   • Clave certificado

Código manual en functions.php:

php

// Generar factura automática
add_action('woocommerce_order_status_completed', 'auto_facturacion_dian');
function auto_facturacion_dian($order_id) {
    $order = wc_get_order($order_id);
    
    // Verificar si ya tiene factura
    if(!$order->get_meta('_factura_generada')) {
        
        // Llamar API DIAN o Siigo
        $response = wp_remote_post('https://api.siigo.com/v1/invoices', array(
            'headers' => array('Authorization' => 'Bearer TOKEN'),
            'body' => json_encode(array(
                'document' => array(
                    'id' => $order_id,
                    'customer' => array(
                        'identification' => $order->get_meta('_billing_dni'),
                        'name' => $order->get_billing_first_name() . ' ' . $order->get_billing_last_name(),
                        'email' => $order->get_billing_email()
                    ),
                    'items' => array()
                )
            ))
        ));
        
        // Guardar número de factura
        if(!is_wp_error($response)) {
            $body = json_decode(wp_remote_retrieve_body($response));
            $order->update_meta_data('_factura_generada', true);
            $order->update_meta_data('_numero_factura', $body->number);
            $order->save();
        }
    }
}

🚚 PASO 4: SISTEMA DE ENVÍOS

4.1 Plugin WooCommerce Shipping

Instalación:

text

1. WooCommerce → Ajustes → Envíos → Servicios de envío
2. Conectar con:
   • Servientrega
   • Coordinadora Mercantil
   • Interrapidisimo
   
3. Obtener API Key de transportadora
4. Configurar cálculo automático

4.2 Configuración Manual (Para Empezar)

Crear Zonas de Envío:

text

1. WooCommerce → Ajustes → Envíos → Zonas de envío
2. Añadir Zona: "Bogotá D.C."
3. Añadir Zona: "Otras Ciudades Principales"
4. Añadir Zona: "Ciudades Intermedias"
5. Añadir Zona: "Municipios"

Configurar Tarifas:

text

ZONA BOGOTÁ D.C.:
• Envío estándar: $8,000
• Envío express (mismo día): $15,000

ZONA OTRAS CIUDADES:
• Peso 0-2kg: $15,000
• Peso 2-5kg: $20,000
• Peso 5-10kg: $25,000

4.3 Plugin Recomendado: «Flexible Shipping»

Instalación:

text

1. Buscar en plugins: "Flexible Shipping"
2. Instalar por "WP Desk"
3. Configurar reglas avanzadas:

EJEMPLO REGLAS:
• Si ciudad = "Bogotá" → $8,000
• Si departamento = "Antioquia" → $12,000
• Si peso > 5kg → +$5,000
• Si valor compra > $200,000 → ENVÍO GRATIS

🔗 PASO 5: INTEGRACIÓN COMPLETA

5.1 Flujo Automatizado

5.2 Configurar Webhooks

Wompi Webhooks:

text

1. Dashboard Wompi → Configuración → Webhooks
2. Añadir Endpoint: https://tutienda.com/wc-api/wompi_webhook
3. Seleccionar eventos:
   • transaction.updated
   • charge.succeeded
   • charge.failed

Código para procesar webhook:

php

// En functions.php o plugin personalizado
add_action('woocommerce_api_wompi_webhook', 'procesar_wompi_webhook');
function procesar_wompi_webhook() {
    $payload = file_get_contents('php://input');
    $data = json_decode($payload, true);
    
    $order_id = $data['data']['transaction']['reference'];
    $order = wc_get_order($order_id);
    
    if($data['event'] == 'transaction.updated') {
        if($data['data']['transaction']['status'] == 'APPROVED') {
            $order->update_status('processing', 'Pago confirmado por Wompi');
            
            // Llamar a función de facturación
            generar_factura_siigo($order_id);
        }
    }
}

⚙️ PASO 6: CONFIGURACIONES ESPECIALES COLOMBIA

6.1 Campos Obligatorios Checkout

php

// Añadir NIT/CC en functions.php
add_filter('woocommerce_checkout_fields', 'campos_colombianos_checkout');
function campos_colombianos_checkout($fields) {
    // Campo NIT/Cédula
    $fields['billing']['billing_nit'] = array(
        'label' => 'NIT o Cédula',
        'placeholder' => 'Número de documento',
        'required' => true,
        'class' => array('form-row-wide'),
        'priority' => 22
    );
    
    // Campo Departamento
    $fields['billing']['billing_department'] = array(
        'label' => 'Departamento',
        'type' => 'select',
        'options' => array(
            '' => 'Seleccionar',
            'bogota' => 'Bogotá D.C.',
            'antioquia' => 'Antioquia',
            'valle' => 'Valle del Cauca',
            // ... más departamentos
        ),
        'required' => true,
        'priority' => 80
    );
    
    // Campo Ciudad
    $fields['billing']['billing_city'] = array(
        'label' => 'Ciudad',
        'placeholder' => 'Tu ciudad',
        'required' => true,
        'class' => array('form-row-wide'),
        'priority' => 90
    );
    
    return $fields;
}

6.2 Configurar IVA Correctamente

text

WooCommerce → Ajustes → Impuestos

IMPORTANTE PARA COLOMBIA:
• Precios incluidos IVA: SÍ
• Calcular impuestos: Seguir dirección envío
• Mostrar precios: Incluyendo impuestos

TARIFA IVA:
• Nombre: IVA 19%
• Tasa: 19%
• Clase de impuesto: Estándar

6.3 Departamentos y Ciudades

Plugin: «WooCommerce Cities for Colombia»

text

1. Instalar plugin gratuito
2. Se añaden automáticamente:
   • 32 departamentos
   • 1,100+ municipios
   • Códigos postales

🔧 PASO 7: PLUGINS ESENCIALES

Lista de Plugins Obligatorios:

PluginFunciónCosto
WooCommerceTienda baseGratis
Wompi para WooCommercePagosGratis (comisiones)
Siigo FacturaciónFactura electrónicaDesde $50,000/mes
Flexible ShippingEnvíos avanzados$79 USD/año
WP Mail SMTPCorreos confiablesGratis
Yoast SEOOptimizaciónGratis
Really Simple SSLSeguridad SSLGratis
UpdraftPlusBackupsGratis
Loco TranslateTraduccionesGratis
Product Feed PROMercado Libre$79 USD/año

Configuración Optimizada:

php

// En wp-config.php
define('WP_DEBUG', false);
define('WP_MEMORY_LIMIT', '512M');
define('WP_MAX_MEMORY_LIMIT', '1024M');
define('WOOCOMMERCE_CONTAINER_CLASS', 'container'); // Bootstrap

🚀 PASO 8: PRUEBAS Y LANZAMIENTO

8.1 Checklist Pre-Lanzamiento

markdown

✅ Dominio .com.co registrado
✅ Hosting con SSL activado
✅ WooCommerce configurado
✅ Wompi en modo pruebas funcionando
✅ Siigo generando facturas prueba
✅ Métodos de envío configurados
✅ IVA 19% correctamente aplicado
✅ Campos NIT/CC en checkout
✅ Políticas de privacidad y términos
✅ Contacto: WhatsApp + correo
✅ Diseño responsive probado
✅ Velocidad optimizada (>80/100)
✅ Backups automáticos configurados

8.2 Pruebas de Flujo Completo

text

1. Agregar producto al carrito
2. Proceso checkout con datos reales
3. Pago con Wompi (modo pruebas)
4. Verificar:
   ✓ Orden creada en WooCommerce
   ✓ Factura generada en Siigo
   ✓ PDF enviado al correo
   ✓ Estado orden actualizado
5. Repetir con diferentes métodos de pago

8.3 Configuración Producción

text

1. Cambiar Wompi a modo producción
2. Actualizar API Keys de Siigo
3. Configurar webhooks producción
4. Desactivar plugins de desarrollo
5. Activar cache (WP Rocket)
6. Configurar Google Analytics
7. Conectar Google Search Console

📊 PASO 9: MANTENIMIENTO Y MONITOREO

Tareas Diarias/Semanales:

text

• Revisar órdenes pendientes
• Verificar facturas no generadas
• Conciliar pagos Wompi vs WooCommerce
• Actualizar inventario
• Respaldar base de datos

Código para Monitoreo Automático:

php

// Verificar facturas pendientes
add_action('facturacion_diaria_event', 'verificar_facturas_pendientes');
function verificar_facturas_pendientes() {
    $orders = wc_get_orders(array(
        'status' => 'processing',
        'date_created' => date('Y-m-d', strtotime('-1 day')),
        'limit' => -1
    ));
    
    foreach($orders as $order) {
        if(!$order->get_meta('_factura_generada')) {
            // Enviar alerta administrador
            wp_mail('admin@tutienda.com', 'Factura pendiente', 
                   "Orden #{$order->get_id()} sin factura");
        }
    }
}

// Programar tarea diaria
if(!wp_next_scheduled('facturacion_diaria_event')) {
    wp_schedule_event(time(), 'daily', 'facturacion_diaria_event');
}

⚠️ PROBLEMAS COMUNES Y SOLUCIONES

Problema 1: Wompi no cambia estado de orden

php

SOLUCIÓN: Verificar webhooks
1. Dashboard Wompi → Webhooks
2. Probar endpoint
3. Verificar que WooCommerce API esté activa
4. Revisar logs en: WooCommerce → Estado → Logs

Problema 2: Siigo no genera factura

text

SOLUCIÓN:
1. Verificar credenciales API
2. Chequear numeración disponible en Siigo
3. Validar datos del cliente (NIT obligatorio)
4. Revisar conexión SSL en servidor

Problema 3: Cálculo envíos incorrecto

text

SOLUCIÓN:
1. Verificar pesos de productos
2. Revisar zonas de envío configuradas
3. Probar con diferentes direcciones
4. Actualizar plugin de envíos

📞 SOPORTE ESPECIALIZADO EN COLOMBIA

Contactos Directos:

text

• Wompi Soporte: 
  WhatsApp: +57 318 8953982
  Email: soporte@wompi.co

• Siigo Soporte:
  Teléfono: 601 5085263
  Email: soporte@siigo.com

• WooCommerce Soporte Español:
  Foro: https://es.forums.wordpress.org/forum/woocommerce

• Transportadoras API:
  Servientrega: 601 4230300 Opc. 5
  Coordinadora: developers@coordinadora.com

💰 COSTOS ESTIMADOS MENSUALES.

ConceptoCosto MínimoRecomendado
Hosting WordPress$50,000 COP$150,000 COP
Dominio .com.co$50,000/año$50,000/año
Plugin EnvíosGratis$250,000/año
Wompi Comisiones3.5% + IVA3.5% + IVA
Siigo Facturación$50,000/mes$150,000/mes
Mantenimiento$100,000/mes$300,000/mes
TOTAL ESTIMADO~$250,000/mes~$900,000/mes

🎯 RESUMEN FINAL:

Configuración Rápida (1-2 días):

text

1. Instalar WordPress + WooCommerce
2. Configurar Wompi pagos
3. Añadir campos NIT/CC
4. Establecer tarifas envío manuales
5. Facturación inicial manual con Siigo

Configuración Profesional (1-2 semanas):

text

1. Todo lo anterior +
2. Automatización facturación Siigo
3. Cálculo automático envíos
4. Webhooks configuración
5. Optimización rendimiento
6. Pruebas exhaustivas

Recomendación Final:

Comienza simple, automatiza gradualmente. Prioriza:

  1. ✅ Pagos funcionando (Wompi)
  2. ✅ Facturación legal (Siigo básico)
  3. ✅ Envíos manuales confiables
  4. 🔄 Luego automatiza facturación
  5. 🔄 Luego automatiza envíos
  6. 🔄 Finalmente optimiza conversión
Cómo integrar pagos, envíos y facturación en una tienda virtual en Colombia

Integrar pagos, envíos y facturación es fundamental para operar una tienda virtual exitosa en Colombia. Aquí tienes una guía detallada y práctica sobre las mejores maneras de lograrlo, usando herramientas y servicios comunes en el país:

🛒 Integración de Pagos en tu Tienda Virtual.

La clave es ofrecer variedad y seguridad. En Colombia, estos son los métodos y pasarelas más populares:

1. Pasarelas de Pago Populares.

Estas plataformas actúan como intermediarios, procesando de forma segura tarjetas de crédito, PSE y otros métodos.

  • Epayco: Muy popular y flexible, permite recibir pagos con tarjetas de crédito (Visa, MasterCard, Amex, Diners), PSE (débito bancario), y pagos en efectivo a través de PuntoRed y Baloto.
    • Integración: Ofrecen plugins y módulos para las principales plataformas de e-commerce como WooCommerce, Shopify y PrestaShop.
  • PayU Latam: Una de las más grandes. Acepta tarjetas, PSE y pagos en efectivo en puntos como Baloto.
    • Integración: Similar a Epayco, tiene integraciones directas con las plataformas de comercio electrónico más usadas.
  • Mercado Pago: Si usas Mercado Libre, esta es la opción natural. Es excelente para pagos con tarjeta, PSE, y efectivo en puntos de Efecty.
    • Integración: Fácil de configurar en WooCommerce y Shopify.
  • Wompi (Grupo Bancolombia): Una solución más reciente pero robusta, que se integra fácilmente y suele tener buenas tarifas para clientes Bancolombia.

2. Integración Directa (Punto Clave).

Todas las pasarelas anteriores se integran con tu carrito de compras (WooCommerce, Shopify, etc.) mediante plugins o módulos oficiales. Esto asegura que:

  • El cliente pague sin salir de tu sitio web (o con una redirección segura).
  • Tu sistema reciba automáticamente la notificación de pago.
  • El pedido se marque como «Pagado» o «Procesando».

🚚 Integración de Envíos y Logística.

Optimizar la logística te permite calcular costos de envío precisos en el checkout y gestionar las guías automáticamente.

1. Plataformas de Agregación Logística.

En lugar de negociar con cada transportadora, estas plataformas te dan acceso a varias con una sola integración:

  • Servientrega (Directo): Es la más usada. Puedes contratar el servicio y usar su módulo para calcular costos automáticamente.
  • Envioclick/Shippy/Mensajeros Urbanos: Son plataformas que integran las principales transportadoras colombianas (Servientrega, Coordinadora, Interrapidísimo, TCC, etc.) en una sola interfaz.
    • Beneficio: Permiten al cliente elegir la transportadora y calcular el costo real en el checkout basándose en el peso, las dimensiones y la dirección de destino.
    • Automatización: Al completar un pedido, la plataforma te permite generar la guía de la transportadora elegida con un clic, la cual imprimes y pegas al paquete.

2. Configuración en la Tienda Virtual (WooCommerce/Shopify).

  • Zonas de Envío: Define zonas (p. ej., Bogotá, Medellín, Resto del País) y asigna un costo fijo o usa el plugin de la plataforma logística para un cálculo en tiempo real.
  • Recolección: Coordina con la transportadora o plataforma agregadora para que recojan los paquetes en tu ubicación, lo que minimiza el tiempo de despacho.

📑 Integración de Facturación Electrónica.

La facturación electrónica es obligatoria en Colombia. Integrarla directamente evita tener que digitar cada venta manualmente.

1. Software de Facturación Electrónica (FE).

Necesitas un proveedor tecnológico autorizado por la DIAN.

  • Alegra: Uno de los más populares, con planes escalables y módulos de inventario y contabilidad.
  • Siigo Nube: Una solución robusta, ideal si manejas un volumen de ventas considerable y necesitas contabilidad completa.
  • Loggro: Ofrece facturación, inventario y puntos de venta.
  • FacturaTech/Otros proveedores DIAN: Hay muchos proveedores, elige uno que se ajuste a tu presupuesto y volumen.

2. El Vínculo Mágico: La Integración.

El objetivo es que, cuando un pedido se marque como «Completado» y «Pagado», la información se envíe automáticamente a tu software de facturación.

  • Plugins/Módulos Nativos: Muchos de los softwares de FE (como Alegra o Siigo) ofrecen plugins directos para WooCommerce o Shopify.
  • Integración por API/Zapier: Si no hay un plugin directo, puedes usar herramientas como Zapier o Make (antes Integromat) para crear una conexión:
    1. Activador: Un nuevo pedido «Pagado» en WooCommerce/Shopify.
    2. Acción: Crear una nueva factura de venta en Alegra/Siigo con los datos del cliente y los productos.
  • Resultado: El sistema genera la factura electrónica, la envía a la DIAN para su validación, y la remite al correo del cliente de forma automática.

🚀 Resumen de Flujo de Trabajo Integrado.

  1. Pedido: Cliente agrega productos y llena datos.
  2. Envío: El sistema de logística integrado calcula el costo y el cliente elige la transportadora.
  3. Pago: El cliente paga a través de la pasarela (Epayco, PayU, etc.). La tienda virtual registra el pago.
  4. Despacho (Logística): El vendedor ve el pedido como «Pagado», usa el plugin de envío para generar la guía y programa la recolección.
  5. Facturación (FE): Al marcar el pedido como «Completado/Enviado», la integración de FE genera la factura electrónica y la envía al cliente y a la DIAN.

Servicios o productos disponibles:

Categorías de la tienda:

Pagina web Cali Servicio de diseño de sitios web en Ecuador desde Colombia. Diseño de tiendas virtuales en Cúcuta

Páginas de mi sitio:

Últimas 100 Entradas de blog:

Categorías de blog:

Publicaciones Similares

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *