Facturación y débitos

El último tramo del negocio: convertir lo que se hizo en plata cobrada, y entender qué parte de eso el financiador no va a pagar.

Las entidades

Entidad	Schema	Qué es
liquidaciones	pami_billings	La liquidación del período
transmisiones	pami_billings	La transmisión al financiador
transmisionArchivo*	pami_billings	Los archivos de la transmisión
debitos	pami_billings	Los débitos aplicados
debitosSII	pami_billings	Débitos leídos del SII
internacion · ambulatorio	pami_billings	Las vistas de facturación por tipo de episodio
practicasRealizadasInternacion · practicasRealizadasAmbulatorio	pami_billings	Las prácticas efectivamente brindadas
bocasAtencion	pami_billings	Puntos físicos de atención del prestador
Billing	finances	Facturación del lado del episodio

El circuito

El Circuito Administrativo de Facturación Unificada es el circuito obligatorio de PAMI, y es lo que modelan transmisiones, liquidaciones y transmisionArchivo*.

Qué es un débito

Un débito es plata que el prestador facturó y el financiador descuenta: una práctica sin autorización, un día de internación sin respaldo, un código que no está en el nomenclador vigente, una cantidad que supera el tope autorizado.

El débito llega después de facturar, cuando ya no se puede corregir sin retrabajo. De ahí la razón de existir del motor de reglas por financiador: producir el mismo diagnóstico antes de transmitir, en forma de hallazgos con su severidad.

Severidad del hallazgo	Significado
Débito	Incumplimiento seguro: el financiador lo va a debitar
Posible débito	Riesgo alto, depende de datos que no siempre están disponibles
Informativo	Ajuste o aviso esperado; no es un error

El motor también trabaja hacia atrás: permite evaluar períodos ya facturados para ver los débitos históricos y entender qué se está perdiendo de forma sistemática.

Cómo se factura una internación

La modalidad se decide con la regla MÓDULO vs COMÚN (ver Episodios). La lógica vive en tres lugares que hay que mantener en sync:

1. AtentionProcessService (la aplicación),
2. el SP finances.SP_get_episode_metrics,
3. el SP configuration.generar_transmision_internacion.

Los stored procedures no viajan con el código

Una parte importante de la facturación está implementada en stored procedures (12 en configuration, 20 en finances). Si se restaura o migra la base, hay que re-aplicarlos. Y si se cambia una regla que también vive en un SP, hay que cambiarla en los dos lados. Ver DDL y ops.

Ajustes por egreso

El motivo de egreso del episodio puede cambiar el porcentaje del módulo que se cobra (por ejemplo, una defunción no paga el módulo completo). Es la regla AJUSTE_POR_EGRESO, de severidad informativa: no es un error, es un ajuste esperado que conviene tener calculado antes de facturar.

Cuentas de control

control-pami es la sección de cuentas de control: la conciliación entre lo que el prestador cree que facturó y lo que el financiador reconoce. Tiene su propio worker (control-account-worker) y su cola (CONTROL_ACCOUNT_ONBOARDING).

Gotchas

• AtentionProcess.BILLED es smallint en la DB aunque la entidad lo declare boolean. Marcar un episodio como facturado pasándole un booleano tira 22P02.
• Los débitos del SII se leen scrapeando, igual que todo lo demás: llegan con la latencia del worker.
• Sin COMPANYID poblado, las vistas de facturación quedan vacías para usuarios no privilegiados.
• El dashboard de control y varios indicadores de facturación se calculan con SQL crudo; parte de ese SQL todavía está en dialecto MySQL y se porta a medida que aparece roto. Ver Porteo de SQL.