¿Cómo conectar Siigo para facturación electrónica?
Si tu centro está en Colombia, sabes lo que cuesta mantener al día la facturación electrónica ante la DIAN: emitir cada factura a mano, controlar qué se ha enviado y corregir errores fiscales consume tiempo que tu equipo podría dedicar a otras tareas. La integración con Siigo conecta CrossHero directamente con tu cuenta de Siigo Nube, de forma que las facturas y los pedidos de tienda se generan y envían a la DIAN automáticamente. Así reduces el trabajo manual y evitas errores de digitación al facturar.
¿Qué necesitas antes de conectarla?
Tener una cuenta activa en Siigo Nube, con usuario y clave de acceso a la API de Siigo.
Tener tu cuenta de Stripe activa en CrossHero. Si no lo está, CrossHero te lo pedirá antes de poder activar la integración.
En Siigo Nube, tener configurados al menos un vendedor y los tipos de documento de factura de venta y de nota crédito, ya que se seleccionan durante la conexión.
Para obtener el usuario y la clave de acceso desde Siigo
Dar “click” en Configuración
En el menú desplegable presionar en “Alianzas e integraciones” y luego seleccionar “Credenciales de integración a plataformas digitales (Siigo API)”.
En la sección de “Aplicaciones vinculadas”
Presionar en “Añadir aplicación”
En tipo de aplicación seleccionar “Facturación Electrónica”
En “Nombre de la aplicación” poner “CrossHero”.
Ir a la sección Datos de acceso (Estos datos son necesarios para la configuración en CrossHero)
Copiar “Usuario API”
Presionar el botón “Copiar Access Key”
¿Cómo conectarla a CrossHero?
Accede a Configuraciones → Integraciones.
Busca la tarjeta de Siigo y pulsa Conectar.
En el paso Autenticación, introduce tu Usuario y tu Clave de acceso de Siigo API y pulsa Guardar y continuar.
Importante: si las credenciales no son válidas, CrossHero te avisará y no podrás avanzar al siguiente paso.
En el paso Configuración, completa:
Vendedor: el usuario de Siigo que aparecerá como vendedor en las facturas.
Tipo de documento: el tipo de documento de Siigo para las facturas.
Tipo de nota crédito: el tipo de documento de Siigo para las notas crédito, usado al sincronizar reembolsos y anulaciones.
Tipo de documento para pedidos (opcional): el tipo de documento para los pedidos de la tienda, si es distinto al de las facturas.
Sincronizar automáticamente con DIAN: si lo activas, las facturas se envían automáticamente a la DIAN después de crearse.
Pulsa Guardar y continuar para completar la conexión.
Si Siigo no devuelve vendedores o tipos de documento durante este paso, revisa que tu cuenta de Siigo Nube los tenga configurados y que las credenciales introducidas sean correctas.
Configuración adicional para que las facturas se generen correctamente
Una vez conectada la integración, hay tres elementos que debes vincular con su equivalente en Siigo para que la facturación funcione sin errores:
Cuotas: en Configuraciones → Cuotas, edita cada cuota y selecciona su Producto de Siigo correspondiente.
Productos de la tienda: en cada producto de la tienda, selecciona también su Producto de Siigo correspondiente.
Impuestos: en Configuraciones → Impuestos, vincula cada impuesto con su impuesto equivalente en Siigo Nube.
Medios de pago: en cada medio de pago, selecciona el Tipo de pago en Siigo correspondiente.
Importante: si un plan o un producto de la tienda no tiene un producto de Siigo asociado, la factura o el pedido correspondiente no podrá sincronizarse con Siigo.
Configuración del cliente para que se cree correctamente en Siigo
Cuando un cliente compra una membresía (o cualquier plan) por primera vez, CrossHero crea automáticamente su ficha de cliente en Siigo a partir de los datos de su perfil. Para que esa creación no falle, el perfil del cliente (Clientes → [cliente] → Perfil) debe tener completos estos campos antes de la compra:
Nombre y apellidos: obligatorio. Si el cliente no tiene nombre completo, la factura no se sincroniza.
NIF (documento de identificación, CC/cédula de ciudadanía): obligatorio. Se usa como identificación del cliente en Siigo.
Ciudad, Provincia y País: obligatorios para determinar el código de ciudad de Siigo. Si el cliente no los tiene completos, CrossHero usa los del centro (configurados en Configuraciones → Cuenta) como reserva; si tampoco están ahí, la factura no se sincroniza.
Dirección: recomendable, aunque no bloquea la sincronización. Si no la completas, CrossHero usa la dirección del centro como reserva.
Teléfono y Email: opcionales, pero si están completos se incluyen en la ficha del cliente en Siigo.
Importante: la ciudad y el país deben coincidir con el listado de países-departamentos-ciudades de Siigo Nube. Si la ciudad indicada (la del cliente o, en su defecto, la del centro) no está en ese listado, la factura no podrá sincronizarse y deberás corregir la ciudad/país antes de reintentar.
Importante: si el cliente ya existe en Siigo con la misma identificación, CrossHero no vuelve a crearlo: usa el cliente existente directamente al facturar. Solo se genera un cliente nuevo en Siigo cuando no se encuentra ninguno con esa identificación.
¿Qué información se sincroniza?
Las facturas y pedidos de tienda de CrossHero se envían a Siigo como documentos de venta.
Los reembolsos y anulaciones se envían a Siigo como notas crédito.
Si la sincronización automática con DIAN está activada, Siigo reenvía esos documentos a la DIAN tras crearse.
El estado de aprobación o rechazo ante la DIAN se sincroniza de vuelta a la factura en CrossHero.
¿Cómo funciona la sincronización?
La sincronización se dispara automáticamente al generarse una factura, un pedido de tienda, un reembolso o una anulación. No es necesario ningún paso manual para que se envíen a Siigo en el momento en que se crean.
Reintentar una sincronización fallida
Accede al detalle de la factura o del pedido de tienda.
Pulsa Reintentar sincronización con Siigo.
Corregir una factura rechazada por la DIAN
Accede al detalle de la factura rechazada y pulsa Corregir factura en Siigo (DIAN).
Introduce el subtotal corregido, selecciona el impuesto de Siigo correspondiente y añade el motivo de la rectificación.
Pulsa Actualizar en Siigo y reenviar.
Esta opción solo está disponible en facturas rechazadas por la DIAN con un documento asociado en Siigo.
Limitaciones
La integración está pensada para centros en Colombia que facturan ante la DIAN a través de Siigo.
Cada plan y cada producto de la tienda debe tener asignado un producto de Siigo; si no lo tiene, la sincronización de esa factura o pedido fallará.
¿Qué pasa ante errores?
Cliente sin datos completos: falta nombre completo o documento de identificación del atleta.
Cliente no existe en Siigo: créalo en Siigo Nube con la misma identificación y vuelve a sincronizar.
Ciudad o país no válidos: deben estar en el listado de Siigo Nube.
Producto sin mapear: falta el producto de Siigo en el plan o producto de tienda.
Límite de peticiones a la API o servicio no disponible: son errores temporales, reintenta en unos minutos.