Introducción al módulo de Facturación

Facturación es el módulo que convierte lo que se prestó al paciente en dinero: abre la cuenta de la admisión, acumula lo que consumió, liquida qué paga el paciente y qué paga la entidad, arma la factura, la radica ante quien debe pagarla, sigue las glosas que esa entidad objete y registra el pago. Es el módulo más grande de la aplicación —trece grupos en el menú— porque ese ciclo tiene trece responsabilidades distintas, y en una IPS real casi nunca las hace la misma persona.

Importante: la cuenta de facturación no se abre aquí desde cero. Se abre eligiendo una admisión que todavía no tiene cuenta, y hereda de ella el paciente, el pagador, el plan y el ámbito. Si esos datos están mal, el error viene de Agendamiento o de Admisiones, no de esta pantalla.

El ciclo completo

Admisión cerrada
      │
      ▼
Cuenta de paciente ──► se acumulan los cargos ──► se liquida
      │                                                │
      │                                                ▼
      │                                            Factura
      │                                                │
      │                          ┌─────────────────────┼─────────────────────┐
      │                          ▼                      ▼                     ▼
      │                    Corte y radicación    Facturación masiva    Facturación electrónica
      │                          │                    (lotes)               (DIAN)
      │                          ▼
      │                    Glosas y devoluciones
      │                          │
      ▼                          ▼
    Caja                     Cartera (pagos, edades, estado de cuenta)
(cobro al paciente)         (cobro a la entidad)

¿Qué resuelve este módulo?

• Abrir y liquidar la cuenta de cada admisión: qué se prestó, cuánto vale según el contrato, y cuánto de eso paga el paciente frente a lo que paga la entidad (copago, cuota moderadora, topes).
• Emitir la factura con la numeración autorizada por la DIAN, agrupando una o varias cuentas liquidadas de un mismo pagador.
• Facturar en volumen: lotes para generar muchas facturas de una vez, y capitación para la población que se cobra por período y no por lo prestado.
• Radicar el paquete de soportes ante la entidad responsable de pago, dentro del plazo que exige la norma.
• Seguir las glosas: lo que la entidad objeta después de radicar, con su reloj de respuesta, y las devoluciones de factura completa.
• Conciliar lo que prestador y entidad no lograron resolver por la vía normal de la glosa.
• Cobrar: caja para lo que paga el paciente en la institución, cartera para lo que debe cada entidad.
• Reportar al Estado: generar el RIPS de cada factura y revisar sus inconsistencias antes de radicar.
• Corregir sin perder trazabilidad: notas crédito y débito, y reaperturas administrativas de episodios ya cerrados.

Mapa del módulo

Grupo del menú	Contenido	Página
Panel	Indicadores de dónde está atascado el ciclo hoy.	Panel de facturación
Cuentas y facturas	Cuentas de paciente, cargos por confirmar, facturas, notas crédito/débito, reaperturas.	Cuentas y facturas
Caja	Turnos de caja, cobro al paciente, devoluciones de caja.	Caja — pendiente de documentar en este manual.
Radicación	Cortes de facturación, radicaciones ante la entidad, plazos por administradora.	Radicación
Glosas y devoluciones	Glosas recibidas, respuestas, devoluciones de factura, catálogo de causales.	Glosas y devoluciones
RIPS	Inconsistencias, generación y bitácora del reporte al Estado.	RIPS
Facturación masiva	Lotes: generar muchas facturas de una corrida.	Facturación masiva
Facturación electrónica	Panel, documentos, certificados y envíos a la DIAN.	Facturación electrónica
Capitación	Períodos, población capitada y liquidación por evento pagado por cupo.	Capitación — pendiente de documentar en este manual.
Informes	Siete informes de lectura sobre lo facturado, el recaudo y lo pendiente.	Informes
Configuraciones	Cajas, conceptos de recaudo, resoluciones de numeración, recaudo por plan y nivel.	Configuraciones
Conciliación	Expedientes de conciliación y acuerdos de pago.	Conciliación — pendiente de documentar en este manual.
Cartera	Documentos, pagos recibidos, cartera por edades y estado de cuenta por entidad.	Cartera

Facturación electrónica: el estado real

La facturación electrónica no está terminada ni se está desarrollando activamente. El código que integra con la DIAN (libs/integrations-dian/) y el núcleo de facturas/RIPS (libs/domain-facturacion/src/facturas, .../rips) quedaron congelados mientras el resto del módulo —radicación, glosas, cartera, conciliación, capitación— siguió creciendo. Concretamente, para quien opera:

• El proveedor tecnológico integrado es Cosmox, y por defecto el ambiente arranca con un proveedor "de mentira" (FE_PROVEEDOR=fake) que no envía nada real a la DIAN. Sólo emite de verdad un tenant con credenciales configuradas.
• Aun con credenciales reales, el proveedor no maneja el CUV (el sello de validación de la DIAN): 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: no llegan a la DIAN, no tienen PDF y no aparecen en la bandeja de documentos electrónicos.
• El proveedor no le notifica a BIAI cuando la DIAN acepta o rechaza un documento (no hay webhook). Sí hay una reconsulta automática cada 10 minutos, además del botón manual en la pantalla de envíos — pero mientras no se dé ese ciclo (o alguien reconsulte a mano), el estado que ves puede estar desactualizado.
• El panel de Facturación electrónica lo dice de primera mano en varias de sus secciones ("No disponible: el backend todavía no publica…"): no es un panel terminado con datos de relleno, es un panel honesto sobre lo que todavía falta.

En la práctica: las pantallas de facturación electrónica sirven para ver el estado de lo que ya se intentó enviar y para administrar resoluciones y certificados, pero no es la vía confiable para emitir factura electrónica de venta ante la DIAN hoy. Ver el detalle en Facturación electrónica.

Orden recomendado de operación

Paso	Qué se hace	Por qué va aquí
1	La admisión se cierra en Admisiones.	Sin egreso no hay nada que facturar: mientras el episodio siga abierto, su cuenta no factura.
2	Se abre la cuenta del paciente desde esa admisión.	La cuenta hereda pagador, plan y ámbito: es la base de toda la tarifación posterior.
3	Se revisan y confirman los cargos por confirmar y se liquida la cuenta.	La liquidación separa lo que paga el paciente de lo que paga la entidad.
4	Se agrupan las cuentas liquidadas en una factura, a mano o por lote.	La numeración DIAN sólo se consume al emitir, nunca antes.
5	Se cierra un corte y se arma la radicación con sus soportes.	Radicar fuera del plazo pactado es causal de devolución.
6	Se hace seguimiento a las glosas que la entidad objete.	Una glosa sin respuesta a tiempo se acepta tácitamente y esa plata se pierde.
7	Se registra el pago en Cartera y se concilia lo que quede sin resolver en Conciliación (pendiente de documentar en este manual).	Cierra el ciclo: lo facturado, lo pagado y lo que sigue en disputa.

Requisitos previos fuera de este módulo

Necesitas	Dónde se configura
Manuales tarifarios y tarifas	Contratación > Parametrización > Manuales. Sin tarifa, el cargo sale en cero.
Administradoras y planes, con sus reglas de cuota moderadora y copago	Contratación > Parametrización > Administradoras y Planes.
Resolución de numeración DIAN vigente	Facturación > Configuraciones > Resoluciones. El sistema se niega a emitir sin una resolución vigente con folios disponibles.
Admisión cerrada con egreso	Admisiones > Detalle.
Unidad funcional en cada atención	Agendamiento > Agenda. Sin unidad funcional, el cargo no encuentra tarifa.

Así se ve la pantalla

---

Dirección en el sistema: /facturacion