Glosario
La regla de oro: muchos términos del negocio no se llaman igual en el código. Buscá la fila acá antes de inventar nombres.
Acrónimos y organismos
| Sigla / término | Significado | Nota |
|---|---|---|
| INSSJP | Instituto Nacional de Servicios Sociales para Jubilados y Pensionados | El organismo. Es el financiador. |
| PAMI | Programa de Atención Médica Integral — nombre comercial del INSSJP | PAMI = INSSJP. En el código es un Insurance puntual. |
| Prestador | El efector que brinda los servicios (persona física, jurídica, red, círculo o colegio médico) | Es "nosotros". En la cartilla local se guarda como texto en RESPONSIBLE. |
| Afiliado / persona beneficiaria | El paciente cubierto | customer.Patient |
| OME | Orden Médica Electrónica | Cada prestación se transmite como OME. Solo cuentan las validadas y valorizadas. |
| CUP | La plataforma de PAMI donde se administran y transmiten las OMEs | Workers cup-worker* |
| SII | Sistema Interactivo de Información de PAMI | El portal que se scrapea: afiliados, OPs, cápitas, diagnósticos. Workers sii-worker* |
| OP | Orden de Prestación (la autorización) | finances.Authorization |
| UGL | Unidad de Gestión Local de PAMI — delimita zona y padrón | ManagementUnit |
| Nomenclador Común | Catálogo oficial de prestaciones de PAMI (Resol. 883/DE/17) | Se refleja en Element / ElementCategory / Price |
| Adenda / Carta de intención | Instrumentos contractuales para adherir al modelo capitado (Anexos IV y V) | La Adenda es para prestadores con contrato vigente; la Carta de intención para nuevos. La entidad CapitaAdenda modela la asignación de cápita por módulo, no el documento legal. |
| GEDO | Sistema de gestión documental del Estado (firma de la resolución) | Solo aparece en el PDF; sin relevancia en el código. |
Negocio → código
| Término | Qué es | Dónde vive |
|---|---|---|
| Paciente / afiliado | La persona beneficiaria. | customer.Patient, customer.PatientInformation |
| Financiador | La obra social / aseguradora que paga. | configuration.Insurance. Se llega vía Patient → PatientAgreement → Agreement → Insurance |
| Credencial / convenio | El vínculo del paciente con un financiador (nº de credencial + convenio). | customer.PatientAgreement. healthcardnumber = credencial PAMI = beneficio + gp |
| Cartilla médica | Las asignaciones (módulo + prestador responsable) del paciente para una credencial. Es dato adicional a la credencial. | Tabla puente customer.PatientAgreementElementCategory |
| Cápita de cartilla | El módulo que el afiliado tiene preasignado en su cartilla, con su prestador responsable. | Fila en PATIENTAGREEMENTELEMENTCATEGORY (ELEMENTCATEGORYID, RESPONSIBLE, ACTIVE) |
| Módulo | Agrupación de prácticas con un código PAMI (2 Radiología, 69 Internación, 543 Cardiología…). | configuration.ElementCategory — code es el código PAMI |
| Práctica | Una prestación concreta del nomenclador. | configuration.Element |
| Autorización / OP | Orden de Prestación: el permiso contra el que se imputa la práctica. | finances.Authorization, finances.AuthorizationDetails, finances.AuthorizationRequest |
| Episodio (proceso de atención) | Una internación o un ambulatorio. | finances.AtentionProcess |
| Internación | Episodio de internación. | finances.AtentionProcess (type=1), finances.HospitalBedOccupancy, pami_billings.internacion |
| Ambulatorio | Atención ambulatoria. | finances.AtentionProcess (type=2), finances.AmbulatoryAuthorization, pami_billings.ambulatorio |
| Práctica realizada | Prestación efectivamente brindada. | pami_billings.practicasRealizadasInternacion / practicasRealizadasAmbulatorio |
| Insumo / producto | Material o medicamento entregado al paciente. | configuration.Element / Product; finances.Supply / PatientSupplies; movimientos SupplyMovement |
| Precio / nomenclador | El valor de una prestación. El financiador es columna obligatoria. | configuration.Price, PriceProcess; pami_billings.practicaPrecio |
| Liquidación / transmisión / débito | La facturación al financiador y sus ajustes. | pami_billings.liquidaciones, transmisiones, transmisionArchivo*, debitos, debitosSII |
| Boca de atención | Punto físico de atención del prestador. | pami_billings.bocasAtencion |
| Hallazgo | El resultado de una regla de validación: un posible débito con severidad y motivo. | RuleFinding — ver motor de reglas |
Los cinco términos que más confusión causan
1. "Cápita" es ambiguo — resolvelo antes de codear
Hay dos cosas distintas que el negocio llama "cápita":
| Cápita global (modelo / contrato) | Cápita de cartilla (local, por paciente) | |
|---|---|---|
| Qué es | Cuánta cápita asignó PAMI por módulo, con sus escalas y tasas (Anexos I / VI / VII) | El módulo que el afiliado tiene preasignado, con su prestador responsable |
| Dónde vive | Schema pami_billings.CAPITA* | Tabla customer.PATIENTAGREEMENTELEMENTCATEGORY |
| UI | Sección "Capitas / Revisar" | ABM de cartilla, en el detalle del paciente |
| Origen | Contrato + snapshot diario calculado | Alta manual local |
| Escritura | Las cápitas que PAMI asignó al afiliado se leen de cache Redis y son read-only | ABM completo |
La cápita de cartilla no deriva de la cache de PAMI. Si un ticket dice "cápita", determiná cuál de las dos antes de escribir una línea.
2. Episodio = AtentionProcess
Un episodio es una internación (type=1) o un ambulatorio (type=2). Abierto = endDate IS NULL.
Su credencial vigente es PATIENTAGREEMENTID.
3. Financiador ≠ credencial
configuration.Insurance es el financiador; la credencial/convenio es customer.PatientAgreement.
El financiador del episodio no es una columna
Se deriva: AtentionProcess → PatientAgreement → Agreement → Insurance. No busques insuranceId en
el episodio, porque no existe.
4. Regla MÓDULO vs COMÚN (internación)
Una internación se factura como MÓDULO si su credencial tiene una cápita activa con
ElementCategory.code = '69' y RESPONSIBLE = 'HOSPITAL POSADAS'. Si no, es COMÚN.
La comparación es literal
RESPONSIBLE es texto libre. Un typo o un espacio de más cambia la modalidad de facturación del
episodio y nadie se entera hasta que llega el débito.
5. OME transmitida ≠ OME validada
Una OME solo cuenta para la tasa de uso y la facturación si PAMI la validó y valorizó. El snapshot
diario distingue explícitamente OMESTRANSMITIDAS de OMESVALIDADAS.
Otros gotchas de vocabulario
ACTIVElógico: la baja esACTIVE = false+ENDDATE = now(). No se borran filas. YACTIVEsuele sersmallinten la DB aunque la entidad lo declareboolean.- Catálogos vacíos no siempre son un bug:
configuration."SERVICES","INSURANCES"y"AGREEMENTS"migraron vacíos en algunos entornos. Una lista en blanco puede ser dato. oxitesayposadasen el código son Proteus:oxitesaes el nombre del paquete y el producto original;posadases la carpeta del frontend donde vive el dominio vivo.
Fuentes normativas
- RESOL-2026-375-INSSJP-DE-INSSJP — "Nuevo Modelo de Pago Capitado con Metas por Tasas de Uso", vigente desde el 1 de febrero de 2026. Anexos I–VII. Es la fuente del modelo de pago capitado.
- Resol. 883/DE/17 — el Nomenclador Común de prestaciones.
- Requerimiento del motor genérico de reglas por financiador (v3.1) — la fuente del catálogo de reglas.