Facturación electrónica
El panel de entrada a todo lo que tiene que ver con la DIAN: qué se ha enviado, qué falta, y con qué numeración se está trabajando.
Antes de usar esta sección, leé este aviso completo. No es la parte opcional del manual: describe qué de lo que ves en pantalla es real hoy y qué no.
Acceso
- Menú: Facturación > Facturación electrónica.
- Ruta:
/facturacion/electronica/panel.
El estado real de la facturación electrónica
Esta integración está congelada, no terminada. El código que habla con la DIAN (libs/integrations-dian/) y el núcleo de facturas/RIPS del backend (libs/domain-facturacion/src/facturas, .../rips) dejaron de recibir desarrollo nuevo mientras el resto del módulo —radicación, glosas, cartera, conciliación, capitación— siguió creciendo. Esto es lo que significa para quien opera la pantalla:
- El proveedor tecnológico es Cosmox, y por defecto el ambiente arranca con un proveedor "de mentira" (
FE_PROVEEDOR=fake). En ese modo, el sistema no envía nada real a la DIAN: marca las facturas como aceptadas dentro de BIAI, pero el propio código lo advierte al arrancar — "Las facturas se marcan como aceptadas localmente pero NO llegan a la DIAN". Sólo un tenant con credenciales de Cosmox configuradas emite de verdad. - Aun con credenciales reales, el proveedor no maneja el CUV (el sello de validación del RIPS ante el Ministerio): sin CUV, la entidad responsable de pago no puede radicar el RIPS que acompaña la factura.
- Las notas crédito y débito se firman pero no se transmiten. Cosmox responde con el XML firmado, pero no las persiste ni las expone después: no aparecen en la bandeja de Documentos electrónicos, no tienen PDF, y quedan en BIAI como emitidas sin que eso sea equivalente a un trámite ante la DIAN completado. Ver el detalle en Notas crédito y débito.
- No hay notificación automática (push) del proveedor. Cosmox no le avisa a BIAI cuando la DIAN acepta o rechaza un documento. Lo que sí existe es una reconsulta automática cada 10 minutos (un proceso interno revisa en lotes los envíos pendientes), además del botón manual Reconsultar en cada pantalla. Pasados 30 días sin veredicto, la reconsulta automática deja de intentarlo — el envío sigue visible y se puede reconsultar a mano.
- Ver PDF y Descargar XML están deshabilitados en toda esta sección. No es una restricción de permisos: el backend todavía no publica una ruta para servir esos archivos, aunque el adaptador sepa traerlos del proveedor.
En la práctica: estas pantallas sirven hoy para ver el estado de lo que ya se intentó enviar y para administrar certificados y numeración, pero no son la vía confiable para emitir factura electrónica de venta ante la DIAN. Si tu institución ya resolvió esto por otra vía (portal directo del proveedor, por ejemplo), lo que veas acá puede no reflejar la realidad del trámite.
Las pantallas de esta sección
| Pantalla | Qué muestra | Página |
|---|---|---|
| Panel | Conexión con el proveedor, datos de la empresa ante la DIAN, contadores de documentos, consumo de numeración y un histórico de 12 meses. | Esta página. |
| Documentos | Un renglón por factura: su estado electrónico, CUFE/CUV y las acciones de emitir/reemitir. | Documentos electrónicos |
| Envíos | La bitácora por intento de envío (una factura puede tener varios): fecha, respuesta y mensaje de cada uno. | Envíos |
| Certificados | Vigencia del certificado de firma digital de la empresa. | /facturacion/electronica/certificados — sin página propia en este manual: la pantalla siempre está vacía hoy, ver más abajo. |
El Panel en detalle
El panel no tiene filtros ni tabla: son cinco bloques informativos, armados con varias llamadas al backend porque no existe todavía un endpoint que entregue el resumen de una sola vez.
| Bloque | Qué informa |
|---|---|
| Conexión con el proveedor | Un botón Verificar que hoy está siempre deshabilitado. El propio panel lo explica: "No disponible: el backend todavía no publica la comprobación de credenciales." |
| Datos de empresa DIAN | NIT, dígito de verificación y razón social, si el backend los tiene configurados. "Plan contratado" y "Documentos del plan" muestran siempre "Sin dato": son datos comerciales del proveedor que todavía no tienen endpoint. |
| Contadores de documentos | Borradores, total, aceptados, rechazados y pendientes. Cada número lleva a Documentos ya filtrado por ese estado. |
| Uso de numeración | Una barra de consumo por resolución DIAN vigente. Cuenta todos los números tomados (aceptados y rechazados), porque así los descuenta el propio backend al validar si se puede emitir. Si no hay ninguna resolución vigente con rango disponible, lo dice en un aviso: "Hoy no se puede emitir ningún documento: no hay resoluciones vigentes con rango disponible." Se administra desde Configuraciones > Resoluciones. |
| Documentos por mes | Gráfica de los últimos 12 meses. Exige el permiso de informes de facturación; sin él, o si el informe no respondió, la gráfica lo explica en vez de mostrarse en blanco. |
Certificados: por qué esta pantalla no tiene página propia
/facturacion/electronica/certificados existe en la aplicación, pero la lista que muestra está vacía siempre: el backend todavía no publica los certificados del proveedor. El propio texto de la pantalla lo dice: "No disponible: el backend todavía no publica los certificados del proveedor. Mientras tanto, la vigencia hay que consultarla en el panel del proveedor tecnológico." Documentar columnas y comportamientos de una tabla que nunca tiene filas sería describir una pantalla que no existe todavía en la práctica — cuando el backend publique ese endpoint, esta página se actualiza con el detalle real.
Recomendaciones
- No asumas que "aceptada" en BIAI significa "aceptada por la DIAN". Mientras el ambiente esté en
FE_PROVEEDOR=fake, es una aceptación simulada. Confirmá con tu administrador qué proveedor está configurado en tu institución. - Verificá con tu área de facturación electrónica cómo se está resolviendo el trámite real hoy. Estas pantallas no reemplazan un proceso paralelo si tu institución lo tiene.
- Antes de reenviar un documento, reconsultá primero. Un envío ya aceptado que se reenvía genera un duplicado.
Así se ve la pantalla
Dirección en el sistema:
/facturacion/electronica/panel