Inicio/Centro de ayuda/Conectar tus canales
Conectar tu Alegra
Conecta Alegra con tu correo y tu token de API para facturar tus pedidos desde Tingo. Revisa la numeración electrónica y crea el ítem Envío.
Vas a conectar tu Alegra para que Tingo cree tus facturas electrónicas a partir de tus pedidos. Toma unos 3 minutos.
Requisitos
- Tu propia licencia de Alegra, con acceso a la API y facturación electrónica activa. No está incluida en tu plan de Tingo.
- Acceso a Alegra con el usuario administrador de tu empresa.
- Una numeración (resolución DIAN) de factura electrónica de venta ya creada en Alegra.
Paso a paso
En Alegra
- Entra a Alegra con el usuario administrador de tu empresa.
- Abre el menú de tu usuario y ve a Configuración → API / Integraciones (el nombre puede variar según tu versión). Genera o copia el token de API.
- Verifica que tu empresa tenga facturación electrónica activa y una numeración de factura electrónica de venta.
- Si cobras flete a tus clientes, crea un ítem de servicio llamado Envío con referencia
ENVIO.
En Tingo
- Abre el menú Canales y busca la tarjeta de Alegra.
- Pulsa Conectar.
- Escribe el Correo de la cuenta Alegra (el mismo con el que entras a Alegra) y pega el Token de API.
- Pulsa Probar y conectar.
Qué descubre solo la plataforma
Al conectar, Tingo consulta tu Alegra y detecta la numeración de factura electrónica (prefiere la que sea electrónica), el vendedor, el impuesto IVA del 19 %, la cuenta de pago y el ítem de servicio de envío (busca uno cuyo nombre o referencia diga envío, flete, domicilio o transporte).

SKU = referencia del ítem
Tingo enlaza tus productos por SKU. En Alegra, el SKU de tu tienda debe coincidir con la referencia del ítem. Si un SKU del pedido no existe como ítem, la factura no se crea y la app te lo indica.
Qué deberías ver al terminar
- La tarjeta de Alegra con la etiqueta Conectado y el nombre de tu empresa.
- Un punto verde junto a Alegra en el menú.
- Si no tenías Siigo conectado, Alegra queda como tu sistema contable para facturar.
- Si ya tenías Siigo, aparece el selector Facturar con (mira Elegir entre Siigo y Alegra).
Problemas frecuentes
- "Alegra no aceptó el correo o el token de API". Genera de nuevo el token en Configuración → API / Integraciones y confirma que el correo es el del usuario que lo generó.
- "Alegra negó el permiso (403)". Revisa que el usuario del token tenga permisos sobre facturación e inventario.
- "Alegra limitó las solicitudes (429)". Espera un momento y reintenta.
- "No pudimos comunicarnos con Alegra". Inténtalo de nuevo en un momento.
- No se encuentra la numeración. Confirma en Alegra que tienes una numeración de factura electrónica de venta activa.
- Pedido con envío que falla. Crea el ítem Envío con referencia
ENVIO. - Superaste el límite de sistemas contables de tu plan. Sube de plan o desconecta uno.