Antes de empezar
- Tu RUT actualizado, con el correo electrónico registrado.
- Acceso a ese correo: la DIAN envía por ahí los códigos de acceso.
- Una cuenta en Alegra, que es el proveedor tecnológico. Se paga aparte de TendaGest.
- Unos 45 minutos. Casi todo es esperar a que carguen los portales de la DIAN.
1 Crea tu cuenta en Alegra
Alegra es quien transmite las facturas a la DIAN. TendaGest se conecta a tu cuenta; no reemplaza este paso.
- Regístrate en
alegra.comy elige "Para mi empresa". - Como objetivo inicial marca "Facturar y gestionar mis ventas".
- Ve a Configuración → Empresa y completa tus datos fiscales.
Completa también identificación con dígito de verificación, responsabilidad tributaria, municipio, dirección y correo. Todo tiene que coincidir con tu RUT, letra por letra.
2 Regístrate como facturador ante la DIAN
- Entra a
dian.gov.co→ Temas de interés → Factura Electrónica → Habilitación. - En el ingreso, elige la pestaña "Persona" si facturas a nombre propio. Ahí te identificas con cédula, aunque en Alegra hayas puesto NIT: para entrar al portal eres una persona, para facturar eres un contribuyente.
- Te llega un enlace al correo. No hace falta contraseña.
- Menú Registro y habilitación → Documentos electrónicos → Factura electrónica.
- Completa el correo de recepción de facturas y pulsa Registrar.
3 Asocia Alegra como tu proveedor
- Pulsa Configurar modos de operación.
- Modo: Software de un proveedor tecnológico.
Al asociar, la DIAN genera tres datos. Cópialos antes de salir de esa pantalla:
| Dato | Dónde está |
|---|---|
| ID del software | en la tabla del modo de operación |
| PIN | en la misma tabla |
| TestSetId | en el icono 👁 de la columna Acciones |
Con el TestSetId, vuelve a Alegra y pégalo en el paso Set de pruebas. Alegra envía sola los documentos de prueba; tarda unos minutos. No recargues la página mientras corre.
4 Solicita tu numeración
La habilitación te autoriza a facturar. La numeración te asigna los números que llevarán tus facturas. Son trámites distintos.
- Entra a
muisca.dian.gov.co→ Usuario Registrado, a nombre propio. - Numeración de Facturación → Solicitar Numeración de Facturación → Ingresar.
- Pulsa Autorizar Rangos y completa:
- Tipo: Factura electrónica de venta
- Prefijo: el que quieras, corto — por ejemplo
FE - Rango: de 1 a 5000 va sobrado, y la resolución dura dos años
- Agregar → Borrador → Aceptar → Definitivo.
1302 es tu solicitud; el
1876 es la autorización, y es el que pide Alegra.
Descarga su PDF y guárdalo.
5 Asocia el prefijo a Alegra
- Espera al menos una hora desde que obtuviste el 1876. La DIAN tarda en sincronizarlo entre sus sistemas.
- Entra al portal de producción y ve a Configuración → Gestionar Asociación de Prefijos.
- Proveedor: SOLUCIONES ALEGRA S.A.S - Alegra. Prefijo: el tuyo. Agregar.
Si el desplegable de prefijos sale vacío, la DIAN aún no ha propagado tu resolución. Espera y vuelve a intentar.
6 Conecta Alegra con TendaGest
app.alegra.com/configuration/api. Verás tu correo y tu token.
- En TendaGest, abre Facturación y busca el panel de facturación electrónica.
- Pega el correo y el token.
- Pulsa Conectar. Debe responder con el nombre de tu empresa.
- Elige tu numeración en la lista, pon Emisión activa: Sí y Guarda.
7 Revisa tus impuestos
TendaGest busca en tu cuenta de Alegra un impuesto con el mismo porcentaje que lleva cada producto. Si no lo encuentra, detiene la emisión en vez de facturar por un valor equivocado.
Antes de emitir la primera
No hay modo de ensayo. En cuanto tu cuenta está habilitada, cualquier factura que emitas es un documento fiscal real: se reporta a la DIAN, consume un número de tu rango y anularla exige una nota crédito. Haz la primera con una venta de verdad, aunque sea pequeña, en lugar de una inventada.
¿Te atascaste?
Los pasos 2 a 5 ocurren en portales de la DIAN, no en TendaGest. Si algo no responde como dice esta guía, lo más rápido suele ser el chat de soporte de Alegra: hacen este trámite todos los días.
Y si el problema es de TendaGest —la conexión, la numeración que no aparece, un error al emitir— escríbenos desde el centro de ayuda.