Integración Siigo Facturación

Generación automática de facturas electrónicas DIAN al confirmar cada pago. Cumplimiento tributario sin esfuerzo manual.

Funcionalidades

FeatureDescripción
Crear ClienteCrea cliente en Siigo si no existe (por cédula/NIT)
Factura ElectrónicaGenera factura DIAN con el pago confirmado
Código de ProductoUsa código desde HubSpot, slug del plan, o código fijo
Descubrir IDsAuto-detecta document types, sellers, productos disponibles
Actualizar HubSpotGuarda número de factura en el deal de HubSpot

Flujo de Facturación

1 Pago confirmado (Wompi)
→
2 HubSpot: obtiene código producto
→
3 Siigo: crea cliente
→
4 Siigo: genera factura
→
5 HubSpot: guarda # factura

Configuración

  1. Ve a Configuración → Integraciones → Siigo
  2. Ingresa credenciales:
    • Usuario: Tu email de Siigo
    • Access Key: Llave de API de Siigo
    • Partner ID: ID de integración (provisto por Siigo)
  3. Clic en "Descubrir IDs de Siigo"
  4. Selecciona de los dropdowns:
    • Document Type: Tipo de factura electrónica
    • Seller: Vendedor asignado
    • Payment Method: Método de pago
    • Tax ID: Impuesto a aplicar (IVA)
    • Producto: Código de producto por defecto
  5. Configura el origen del código de producto
  6. Guarda la configuración

Origen del Código de Producto

PayWL puede obtener el código de producto de 3 fuentes:

OrigenDescripciónUso
Código Fijo Un código de producto estático Cuando todos los planes usan el mismo producto en Siigo
Desde HubSpot Extrae de la propiedad del line item Cuando cada producto en HubSpot tiene su código Siigo
Slug del Plan Usa el slug del plan de PayWL Cuando los slugs coinciden con códigos Siigo
Fallback: Si HubSpot no devuelve código (ej: reintentos manuales), se usa el código de producto configurado como fallback.

Descubrir IDs de Siigo

El botón "Descubrir IDs" consulta la API de Siigo y muestra:

  • Document Types: Tipos de documento (factura electrónica, etc.)
  • Sellers: Vendedores configurados
  • Payment Methods: Métodos de pago
  • Taxes: Impuestos disponibles
  • Products: Productos/servicios existentes

Datos del Cliente

Para crear el cliente en Siigo, PayWL usa:

Campo PayWLCampo Siigo
Nombre completoname
Emailcontacts[].email
Teléfonocontacts[].phone (max 10 chars)
Tipo documentoid_type (CC, NIT, etc.)
Número documentoidentification

Sistema de Reintentos

Si la facturación falla, PayWL reintenta automáticamente:

  • Intento 1: Inmediato
  • Intento 2: +1 minuto
  • Intento 3: +5 minutos
  • Intento 4: +15 minutos

Después de 3 fallos, aparece en Alertas del dashboard para reintento manual.

Errores Comunes

ErrorCausaSolución
invalid_reference: product code Código de producto no existe en Siigo Verifica el código en Siigo o usa "Descubrir IDs"
document_settings Document Type no habilitado Selecciona otro Document Type con "Descubrir IDs"
already_exists Cliente ya existe (OK) No es error, PayWL continúa con la factura
unauthorized Token expirado o credenciales incorrectas Verifica usuario, access key y partner ID

Obtener Credenciales de Siigo

  1. Ingresa a developer.siigo.com
  2. Crea una cuenta de desarrollador
  3. Solicita acceso a la API
  4. Obtén tu Partner ID y Access Key
  5. Para sandbox usa: [email protected]