Activar

Aquí enciendes el facturador electrónico de tu empresa, guardas las credenciales que te entrega Agapanto y dejas la resolución DIAN cargada en el documento de venta. Todo está en Menú → Configuración (ruta /app/config), pestañas Preferencias y Documentos.

Permiso

Necesitas ACCESO_CONFIGURACION. La tarjeta Facturación electrónica (DIAN) solo aparece si tu empresa tiene el módulo ELECTRONIC_BILLING.

Un vistazo

Menú → Configuración → Preferencias

DocumentosFormas de pagoEmpresaPreferenciasTienda

Opciones de la empresa

Tienda publicada en la web Mostrar mapa de mesas en el POS Facturador electrónico 1 Mostrar botón de WhatsApp en la tienda

save Guardar

Facturación electrónica (DIAN) 2

Es facturador electrónico

Token API (apidian)•••••••••••••••• 3

Token DIAN••••••••••••

Llave técnica•••••••••••••••• 4

save Guardar

Pestaña Preferencias de Panadería Los Manjares con el módulo de facturación electrónica activo.

1. 1 Facturador electrónico: la casilla general de la empresa. Es el mismo interruptor que Es facturador electrónico de la tarjeta DIAN; puedes marcarlo desde cualquiera de las dos.
2. 2 Tarjeta Facturación electrónica (DIAN): solo se ve con el módulo ELECTRONIC_BILLING.
3. 3 Token API (apidian) y Token DIAN: las credenciales del servicio de emisión. Te las entrega Agapanto después de contratar el servicio; no se generan desde aquí.
4. 4 Llave técnica: la clave técnica que la DIAN asigna a tu resolución para el set de pruebas. Aparece en el portal de la DIAN junto a la resolución.

Paso a paso

1. Carga la resolución en el documento de venta. Configuración → Documentos → fila Factura de venta → editar. Llena Resolución DIAN, Vencimiento resolución, Numeración desde y Numeración hasta; revisa que Consecutivo actual esté dentro del rango. Pulsa Guardar.
2. Contrata el servicio con Agapanto y recibe tus credenciales. Se cotiza por volumen mensual de facturas.
3. Abre Configuración → Preferencias, tarjeta Facturación electrónica (DIAN): marca Es facturador electrónico, pega Token API (apidian), Token DIAN y Llave técnica, y pulsa Guardar.
4. Avisa al equipo de Agapanto para correr el set de pruebas de la DIAN con tu llave técnica. Cuando la DIAN apruebe la habilitación, tu empresa queda lista para emitir.

Editar — Tipos de documento

NombreFactura de venta

NaturalezaSalida (venta)

Resolución DIAN18764012345678

Vencimiento resolución2027-08-31

Numeración desde1

Numeración hasta5000

Consecutivo actual1248

CancelarGuardar

Los campos de resolución viven en el documento, no en la empresa: cada tipo de documento puede tener su propia resolución.

Las credenciales no se inventan

Los tokens y la llave técnica son secretos de tu empresa. Si los pegas mal, las facturas simplemente no llegarán a la DIAN y nadie recibirá un aviso claro. Cópialos tal cual te los entregó Agapanto y no los compartas por chat abierto.

Vencimiento y rango

La DIAN rechaza facturas fuera del rango autorizado o con resolución vencida. Cuando Consecutivo actual se acerque a Numeración hasta, pide una nueva resolución con tiempo.

¿Problemas?

• No veo la tarjeta Facturación electrónica (DIAN). Tu empresa no tiene el módulo ELECTRONIC_BILLING. Es un servicio adicional: escríbenos por WhatsApp para cotizarlo.
• No puedo entrar a Configuración. Te falta ACCESO_CONFIGURACION; pídeselo al administrador en Roles y permisos.
• Guardé los tokens pero no pasa nada con mis facturas. Activar solo deja la empresa lista; lee Enviar y consultar para entender cómo se envía hoy una factura.
• La resolución no aparece en la tirilla. Revisa que la llenaste en el documento Factura de venta (no en otro documento) y que el formato de impresión la incluya (Formatos de impresión).

Siguiente: Enviar y consultar.