Detalle de la cuenta
La pantalla más grande del módulo: dónde se ve por qué la cuenta vale lo que vale, se completan sus cargos, se liquida y se manda a facturar.
Acceso
Desde Cuentas de paciente, clic en cualquier fila. Ruta: /facturacion/cuentas/:id.
Encabezado
Número de cuenta, paciente y documento, estado (con color), y un resumen con Ámbito, Pagador (administradora / plan, o "Particular"), Sede, Apertura y Total acumulado.
Mientras la cuenta tenga cargos sin tarifa en el plan actual (ver más abajo), aparece un aviso en la cabecera: esos cargos bloquean la liquidación y la facturación hasta resolverlos.
Acciones sobre la cuenta
Todas requieren que la cuenta esté abierta (salvo donde se indica), y se deshabilitan mientras hay una operación en curso.
| Acción | Qué hace | Disponible cuando |
|---|---|---|
| Sincronizar cargos desde HC | Trae de la historia clínica las órdenes médicas ejecutadas y los servicios de la cita atendida que todavía no son cargos de esta cuenta, y los crea. | Cuenta abierta. |
| Agregar cargo manual | Abre el formulario para sumar un cargo a mano (ver más abajo). | Cuenta abierta. |
| Previsualizar liquidación | Calcula copago/cuota moderadora sin guardar nada, para revisar antes de comprometer el valor. | Cuenta abierta. |
| Liquidar cuenta | Fija el copago, la cuota moderadora y el total. La cuenta deja de admitir cargos nuevos y queda lista para facturar. | Cuenta abierta y sin cargos pendientes de tarifa. |
| Cambiar plan | Cambia la entidad responsable de pago y retarifa TODOS los cargos contra el contrato nuevo (ver más abajo). | Cuenta no anulada. |
| Generar factura | Lleva a Nueva factura con esta cuenta preseleccionada. | Sólo aparece cuando la cuenta está liquidada. |
| Anular cuenta | Deja la cuenta y sus cargos como no facturables. No se revierte. Pide un motivo. | Cuenta no anulada ni facturada. |
Cada botón está además condicionado al permiso del perfil (facturacion.cuentas:crear/modificar/anular).
Sincronizar cargos desde historia clínica
Al terminar, muestra cuántos cargos se crearon y, si algún candidato quedó fuera, una tabla con Candidato y por qué quedó fuera — cada uno es un servicio que se prestó y que, si no se revisa, no se va a cobrar. El bloque se cierra con Ya lo revisé.
Agregar un cargo manual (y corregir uno existente)
El precio nunca se digita. El formulario pide qué se prestó y cuánto; el valor lo resuelve el motor de tarifas contra el contrato del paciente y se muestra recién después, junto con su fuente de tarifa — la traza que sostiene ese valor si la EPS lo audita.
| Campo | Obligatorio | Descripción |
|---|---|---|
| Tipo | Sí | Tipo de cargo (servicio, medicamento, insumo…). |
| Ítem del catálogo | Sí | Buscador con mínimo 3 caracteres por código o descripción. Es el campo del que sale el precio: sin ítem no hay cargo posible. |
| Código | — | Se completa solo al elegir el ítem. |
| Descripción en la factura | Sí | Se completa al elegir el ítem; editable. |
| Cantidad | Sí | |
| Fecha del servicio | No |
Al guardar, la ventana muestra el Valor unitario, el Total del cargo y la Fuente de la tarifa. Si no hay traza, avisa en texto de alerta: "Sin traza de tarifa. Verifique la lista de precios del contrato antes de facturar este cargo."
Corregir un cargo ya creado sólo permite cambiar la cantidad. No es una limitación de pantalla: cambiar el ítem o la descripción reescribiría la tarifa ya fijada. Si lo que hay que corregir es el servicio prestado, se anula el cargo con su motivo y se crea el correcto — así queda la traza de la corrección.
Cargos por confirmar (dentro de esta cuenta)
Cuando un kit de procedimiento propone consumibles automáticamente, aparecen en una tabla separada, arriba de los cargos reales, con la leyenda "Cargos por confirmar (N)". No suman en el total de la cuenta hasta que alguien los confirme.
Por cada propuesta: Confirmar (pide la cantidad realmente consumida, precargada con la del kit) o Descartar (pide un motivo de mínimo 10 caracteres). Un cargo sugerido con la marca "Sin tarifa en el plan actual" no se puede confirmar hasta resolver esa tarifa.
Esta tabla es la vista de esta cuenta puntual. Para gestionar cargos sugeridos de todas las cuentas a la vez, ver la bandeja global de Cargos por confirmar.
Cargos
La tabla de lo que la cuenta efectivamente cobra: Tipo, Código, Descripción, Cantidad, Valor unitario, Total, Origen (si vino de historia clínica o se agregó manual) y Fuente de tarifa. Un cargo anulado se ve tachado y en gris, con su motivo debajo de la descripción. Un cargo sin tarifa tras un cambio de plan se resalta con la marca "Sin tarifa en el plan actual · bloquea liquidación y facturación" y, si el backend informó por qué, el motivo al lado.
Sobre cada cargo activo: Corregir (sólo cantidad) y Anular (con motivo obligatorio; el cargo no se borra, queda registrado para poder auditar la cuenta).
Liquidación
Al previsualizar o liquidar, aparece el bloque de liquidación con:
| Campo | Descripción |
|---|---|
| Tipo de recaudo | Copago, cuota moderadora, etc. |
| % aplicado | |
| A cargo del paciente | |
| A cargo del pagador | |
| Total | |
| Tope aplicado | Sólo si el plan tiene un tope configurado. |
| Regla aplicada | Texto que explica en palabras el cálculo — es lo que el facturador usa para responder por qué el copago de este paciente es ese. Si el backend no la informó, la pantalla lo dice explícitamente y pide verificar la parametrización del plan. |
Si el motor dejó advertencias, se muestran en una lista destacada — son lo primero que un auditor de la EPS va a preguntar.
Cuando es una previsualización, un aviso recuerda que no se guardó nada todavía, con dos botones: Descartar o Liquidar con estos valores.
Cambiar el plan de la cuenta
Cambiar el pagador no es corregir un dato: recalcula todos los cargos contra el contrato nuevo, así que el valor de la cuenta puede cambiar por completo.
| Campo | Descripción |
|---|---|
| Atención particular (interruptor) | Si se enciende, la cuenta queda sin administradora y se tarifa contra la lista particular; el buscador de plan desaparece (no se deshabilita: la combinación inválida no se puede ni armar). |
| Plan de destino | Buscador por EPS, nombre o código del plan. Sólo visible con el interruptor de particular apagado. |
| Motivo del cambio | Obligatorio, mínimo 10 caracteres. |
Antes de confirmar, la ventana muestra el pagador y el total actuales, y — si la cuenta ya tiene una factura no anulada — un aviso bloqueante: primero hay que anular la factura (con nota crédito si la DIAN ya la aceptó), después cambiar el plan y volver a facturar.
Al confirmar, el resultado se muestra en el detalle de la cuenta: total anterior, total nuevo, diferencia, cargos recalculados y cargos sin tarifa, más la tabla de los cargos que quedaron sin poder tarifarse (código, descripción y motivo). La liquidación queda invalidada: la cuenta vuelve a estado abierta y hay que liquidarla de nuevo antes de facturar.
Historial de cambios de plan
Debajo, si la cuenta tuvo alguno: fecha, plan anterior, plan nuevo, motivo, total antes/después, cargos recalculados y cargos sin tarifa de cada cambio — para poder explicar meses después por qué la misma atención vale distinto.
Anular la cuenta
Pide un motivo de anulación en un textarea. Al confirmar, la cuenta y sus cargos dejan de ser facturables; no se revierte.
Recomendaciones
- Revisá "Cargos por confirmar" antes de liquidar. Son servicios que ya se prestaron: dejarlos sin revisar es dinero que no se cobra.
- Usá "Previsualizar liquidación" cuando el copago no te cierre. Ahí está la regla aplicada en texto, antes de comprometer ningún valor.
- Un cargo con "Sin traza de tarifa" no se corrige solo. Revisá la lista de precios o el manual tarifario del contrato en Contratación antes de facturar.
Así se ve la pantalla
Dirección en el sistema:
/facturacion/cuentas/:id