Estructura JSON del RIPS Ministerio de Salud - Indice Manual Integración Directa HKA Fácil RIPS
Este artículo documenta la estructura completa de datos del archivo JSON del RIPS según los lineamientos técnicos del Ministerio de Salud y Protección Social (Resolución 2275 de 2023, versión 3.2 - mayo 2025). Cada nodo corresponde a un objeto o arreglo dentro del JSON que se envía al mecanismo único de validación del Ministerio.
El nodo raíz del RIPS contiene los datos de identificación de la transacción. Corresponde a los campos T01 a T04 del Anexo Técnico 1 de la Resolución 2275 de 2023.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
numDocumentoIdObligado
T01
String
4..12
SI
NIT del facturador electrónico en salud (PSS/PTS) obligado a reportar RIPS.
Tipo cadena. Todos los PSS/PTS deben usar tipo de documento NIT.
Rechazo Si el NIT no coincide con el registrado en la FEV (RVC001) o no existe en las tablas IPSCodHabilitacion / IPSNoREPS (RVC002).
numFactura
T02
String
AN
SI
Número de la Factura Electrónica de Venta (FEV), según especificaciones de la DIAN.
Informar null para entidades con objeto social diferente (EOSD) o profesionales independientes no obligados a generar FEV (RIPS sin factura).
tipoNota
T03
String
0..2
SI
Tipo del documento que soporta el RIPS. Valores permitidos:
NC Nota Crédito
ND Nota Débito
NA Nota de Ajuste de RIPS
RS RIPS sin Factura (profesionales independientes o EOSD)
Cuando en el mismo trámite corresponda NC parcial y NA, el campo debe ser NC.
Tabla de referencia SISPRO: TipoNota
numNota
T04
String
0..20
SI
Número de la nota crédito, nota débito, nota ajuste o consecutivo asignado por el prestador.
Para RIPS sin FEV (profesionales independientes/EOSD), informar un consecutivo de 1 a infinito asignado por el prestador.
Object.usuario
Arreglo que contiene los datos de identificación de cada usuario (paciente) atendido. Corresponde a los campos U01 a U11 del Anexo Técnico 1.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
tipoDocumentoIdentificacion
U01
String
2
SI
Tipo de documento de identificación del paciente. Valores según edad y nacionalidad:
CC Cédula de Ciudadanía (≥18 años, colombianos)
TI Tarjeta de Identidad (7 a 17 años)
RC Registro Civil (≤6 años)
CN Certificado de Nacido Vivo (hasta 3 años, 9 a 20 chars)
PA Pasaporte (extranjeros con visa de trabajo, ≤7 años, refugiados)
CE Cédula de Extranjería
CD Carné Diplomático
SC Salvoconducto
PE Permiso Especial de Permanencia (migrantes venezolanos)
DE Documento Extranjero
AS Adulto sin Identificación (>18 años)
MS Menor sin Identificación
SI Sin identificación
Tabla de referencia SISPRO: TipoIdPISIS
numDocumentoIdentificacion
U02
String
..20
SI
Número del documento de identificación del paciente.
08 Personas privadas de la libertad (Fondo Nacional de Salud)
09 Tomador / Amparado ARL
10 Tomador / Amparado SOAT
11 Tomador / Amparado Planes Voluntarios de Salud
12 Particular
13 Especial o Excepción no cotizante (Ley 352/97 - servicio militar)
fechaNacimiento
U04
String
date
SI
Fecha de nacimiento del paciente.
Formato: YYYY-MM-DD. Ejemplo: 1990-01-15
codSexo
U05
String
1
SI
Código del sexo según el documento de identificación emitido por la Registraduría Nacional.
Tomar de la columna Extra_III de la tabla SISPRO Sexo:
M Masculino
F Femenino
I Indeterminado o Intersexual
codPaisResidencia
U06
String
AN
SI
Código del país de residencia habitual del usuario (donde vivió más tiempo en el último año calendario).
Tabla de referencia SISPRO: País
codMunicipioResidencia
U07
String
5
C/C
Código DIVIPOLA del municipio de residencia habitual (dos primeros dígitos = departamento + tres últimos = municipio).
Obligatorio cuando el país de residencia (U06) es Colombia.
Tabla de referencia SISPRO: Municipio
codZonaTerritorialResidencia
U08
String
1
SI
Zona territorial de residencia del usuario.
Tabla de referencia SISPRO: ZonaVersion2
incapacidad
U09
String
2
SI
Indica si el profesional tratante expidió un certificado de incapacidad durante el proceso de atención.
Valores: SI o NO
Tabla de referencia SISPRO: LstSiNo
consecutivo
U10
Integer
INT32
SI
Posición del usuario en el RIPS. Inicia en 1, se incrementa de uno en uno, no puede repetirse.
En facturas multiusuario depende de la cantidad de usuarios informados.
codPaisOrigen
U11
String
AN
SI
Código del país de nacimiento del usuario.
Tabla de referencia SISPRO: País
Nota
Debajo de cada usuario se registran los datos de los servicios prestados dentro del objeto servicios, que puede contener los arreglos: consultas, procedimientos, urgencias, hospitalizacion, recienNacido, medicamentos y otrosServicios.
Object.consultas
Arreglo con los datos de las consultas realizadas (médicas, odontológicas, de enfermería, interconsultas, etc.). Corresponde a los campos C01 a C21.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
codPrestador
C01
String
12
SI
Código de habilitación del prestador de servicios de salud (número de habilitación con sede, 12 caracteres).
Tabla de referencia SISPRO: IPSCodHabilitacion / IPSNoREPS
fechaInicioAtencion
C02
String
16
SI
Fecha y hora en que el usuario fue atendido. Debe estar dentro del periodo de facturación de la FEV.
Agrupación del servicio según la Resolución 3100 de 2019 (REPS).
Valores permitidos (tabla SISPRO GrupoServicios):
01 Consulta externa
02 Apoyo diagnóstico y complementación terapéutica
03 Internación
04 Quirúrgico
05 Atención inmediata
codServicio
C07
String
3
SI
Código de tres dígitos del servicio según la Resolución 3100 de 2019.
Tabla de referencia SISPRO: Servicios
finalidadTecnologiaSalud
C08
String
2
SI
Código de la finalidad de la tecnología en salud aplicada en la consulta.
Tomar de la columna ExtraI: Consultas de la tabla SISPRO RIPSFinalidadConsultaVersion2.
Código numérico de dos caracteres. No todas las opciones aplican para consultas.
causaMotivoAtencion
C09
String
2
SI
Código de la causa externa que motivó la atención. Valores del 21 al 30.
Tabla de referencia SISPRO: RIPSCausaExternaVersion2
codDiagnosticoPrincipal
C10
String
..8
SI
Código CIE-10 del diagnóstico principal definido al finalizar el proceso de atención.
Ejemplo: Z000, J189
Tabla de referencia: CIE10
codDiagnosticoRelacionado1
C11
String
..8
NO
Código CIE-10 de otras afecciones o problemas relacionados con la consulta que coexistieron durante el manejo de la afección principal.
Tabla de referencia: CIE10
codDiagnosticoRelacionado2
C12
String
..8
NO
Código CIE-10 de diagnóstico relacionado 2 (opcional).
Tabla de referencia: CIE10
codDiagnosticoRelacionado3
C13
String
..8
NO
Código CIE-10 de diagnóstico relacionado 3 (opcional).
Tabla de referencia: CIE10
tipoDiagnosticoPrincipal
C14
String
2
SI
Tipo del diagnóstico principal según el grado de aproximación y confirmación.
01 Impresión diagnóstica
02 Confirmado nuevo
03 Confirmado repetido
tipoDocumentoIdentificacionMedico
C15
String
2
SI
Tipo de documento de identificación del profesional que realizó la consulta.
El profesional debe estar registrado en RETHUS.
Tabla de referencia SISPRO: TipoIdPISIS
numDocumentoIdentificacionMedico
C16
String
AN
SI
Número del documento de identificación del profesional que realizó la consulta.
vrServicio
C17
Decimal
-
SI
Valor monetario del servicio en pesos colombianos (COP).
Modalidad pago por evento: informar el valor pactado (ya con descuentos).
Otras modalidades (capitación, PGP, paquete): informar 0.
conceptoRecaudo
C18
String
2
SI
Código del tipo de pago moderador aplicado al usuario.
Valores (tabla SISPRO conceptoRecaudo):
01 Copago
02 Cuota moderadora
03 Pagos compartidos en planes voluntarios de salud
04 Anticipos
05 No aplica
Rechazo Si el valor no corresponde a los permitidos por el Ministerio de Salud
valorPagoModerador
C19
Decimal
-
SI
Valor del pago moderador recaudado al usuario, en pesos colombianos (COP).
Informar 0 si no aplica pago moderador.
En facturas monousuario, no puede ser mayor que el valor del servicio.
numFEVPagoModerador
C20
String
AN
C/C
Número de la FEV expedida al paciente por concepto del pago moderador.
Informar null si no aplica.
consecutivo
C21
Integer
INT32
SI
Posición de la consulta dentro del arreglo de consultas del usuario. Inicia en 1.
Object.procedimientos
Arreglo con los datos de los procedimientos realizados (diagnósticos, terapéuticos, quirúrgicos, no quirúrgicos, de protección específica, de detección temprana, vacunación, etc.). Corresponde a los campos P01 a P20.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
codPrestador
P01
String
12
SI
Código de habilitación del prestador de servicios de salud con sede (12 caracteres).
Tabla de referencia SISPRO: IPSCodHabilitacion / IPSNoREPS
fechaInicioAtencion
P02
String
16
SI
Fecha y hora de realización del procedimiento. Debe estar dentro del periodo de facturación.
Número de ID de entrega si el procedimiento no es financiado con cargo a la UPC.
Informar null si el procedimiento es financiado con la UPC, salvo los que deban prescribirse desde MIPRES.
Si es financiado con presupuesto máximo, debe coincidir con el ID de prescripción MIPRES.
numAutorizacion
P04
String
..30
C/C
Número de autorización emitida por el pagador para realizar el procedimiento.
codProcedimiento
P05
String
AN
SI
Código CUPS del procedimiento según la resolución de CUPS vigente del Ministerio de Salud.
Solo se aceptan CUPS definidos por el Ministerio. No se pueden crear códigos propios.
Tabla de referencia SISPRO: CUPSRips
viaIngreso
P06
String
2
SI
Vía de ingreso al servicio donde se ejecuta el procedimiento.
Tabla de referencia SISPRO correspondiente.
modalidadGrupoServicioTecSal
P07
String
2
SI
Modalidad de atención del procedimiento.
Tabla de referencia SISPRO: ModalidadAtencion (mismos valores que C05)
grupoServicios
P08
String
2
SI
Agrupación del servicio según la Resolución 3100 de 2019.
Tabla de referencia SISPRO: GrupoServicios (mismos valores que C06)
codServicio
P09
String
3
SI
Código de tres dígitos del servicio según la Resolución 3100 de 2019.
Tabla de referencia SISPRO: Servicios
finalidadTecnologiaSalud
P10
String
2
SI
Código de la finalidad de la tecnología en salud del procedimiento.
Tomar de la columna Extra II: Procedimientos de la tabla SISPRO RIPSFinalidadConsultaVersion2.
Valores permitidos: del 12 al 20, y del 22 al 44.
tipoDocumentoIdentificacionMedico
P11
String
2
SI
Tipo de documento de identificación del profesional que realizó el procedimiento.
Tabla de referencia SISPRO: TipoIdPISIS
numDocumentoIdentificacionMedico
P12
String
AN
SI
Número del documento de identificación del profesional que realizó el procedimiento.
codDiagnosticoPrincipal
P13
String
..8
SI
Código CIE-10 del diagnóstico principal de la atención.
Preferentemente no debe iniciar por R, W, V o Z (salvo excepciones como hemoclasificación, TSH neonatal).
Tabla de referencia: CIE10
codDiagnosticoRelacionado1
P14
String
..8
NO
Código CIE-10 del diagnóstico relacionado 1.
Tabla de referencia: CIE10
codComplicacion
P15
String
..8
NO
Código CIE-10 de la complicación presentada durante el procedimiento.
Tabla de referencia: CIE10
vrServicio
P16
Decimal
-
SI
Valor monetario del procedimiento en COP.
Pago por evento: debe ser mayor a 1. Otras modalidades: informar 0.
conceptoRecaudo
P17
String
2
SI
Código del tipo de pago moderador aplicado.
Tabla de referencia SISPRO: conceptoRecaudo (mismos valores que C18)
Rechazo Si el valor no corresponde a los permitidos por el Ministerio de Salud
valorPagoModerador
P18
Decimal
-
SI
Valor del pago moderador en COP. Informar 0 si no aplica.
numFEVPagoModerador
P19
String
AN
C/C
Número de la FEV por concepto del pago moderador. Informar null si no aplica.
consecutivo
P20
Integer
INT32
SI
Posición del procedimiento dentro del arreglo de procedimientos del usuario.
Object.urgencias
Arreglo con los datos de atenciones de urgencias con observación. Se requiere que exista una consulta de urgencia registrada con fecha y hora mayor o igual a la fecha de ingreso a urgencias. Corresponde a los campos R01 a R11+.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
codPrestador
R01
String
12
SI
Código de habilitación del prestador con sede (12 caracteres).
Tabla de referencia SISPRO: IPSCodHabilitacion / IPSNoREPS
fechaInicioAtencion
R02
String
16
SI
Fecha y hora de inicio de la atención de urgencias. Debe estar dentro del periodo de facturación de la FEV.
Formato: AAAA-MM-DD hh:mm
causaMotivoAtencion
R03
String
2
SI
Código de la causa externa que motivó la urgencia. Debe coincidir con el de la consulta de urgencia asociada.
Tabla de referencia SISPRO: RIPSCausaExternaVersion2
codDiagnosticoPrincipalIngreso
R04
String
..8
SI
Código CIE-10 del diagnóstico principal al ingreso a urgencias.
Tabla de referencia: CIE10
codDiagnosticoRelacionadoIngreso1
R05
String
..8
NO
Código CIE-10 de diagnóstico relacionado al ingreso (1).
Tabla de referencia: CIE10
codDiagnosticoRelacionadoIngreso2
R06
String
..8
NO
Código CIE-10 de diagnóstico relacionado al ingreso (2).
Tabla de referencia: CIE10
codDiagnosticoRelacionadoIngreso3
R07
String
..8
NO
Código CIE-10 de diagnóstico relacionado al ingreso (3).
Tabla de referencia: CIE10
codDiagnosticoPrincipalEgreso
R08
String
..8
SI
Código CIE-10 del diagnóstico principal al egreso de urgencias.
Tabla de referencia: CIE10
condicionSalidaUrgencia
R09
String
2
SI
Condición en que egresó el usuario del servicio de urgencias.
Tabla de referencia SISPRO correspondiente (condición de salida).
codDiagnosticoRelacionadoEgreso
R10
String
..8
NO
Código CIE-10 de diagnóstico relacionado al egreso de urgencias.
Tabla de referencia: CIE10
fechaEgreso
R11
String
16
SI
Fecha y hora de egreso de urgencias. Debe estar dentro del periodo de facturación de la FEV.
Formato: AAAA-MM-DD hh:mm
consecutivo
-
Integer
INT32
SI
Posición del registro de urgencias dentro del arreglo del usuario.
Object.hospitalizacion
Arreglo con los datos de hospitalización. Para estancias prolongadas o cambio de pagador (por ejemplo, víctimas de accidentes de tránsito) se utilizan los campos de fecha de inicio y egreso. Corresponde a los campos H01 a H14+.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
codPrestador
H01
String
12
SI
Código de habilitación del prestador con sede (12 caracteres).
Tabla de referencia SISPRO: IPSCodHabilitacion / IPSNoREPS
viaIngreso
H02
String
2
SI
Vía o forma de ingreso al servicio de hospitalización.
Tabla de referencia SISPRO correspondiente.
fechaInicioAtencion
H03
String
16
SI
Fecha y hora de inicio de la hospitalización. Debe estar dentro del periodo de facturación.
Formato: AAAA-MM-DD hh:mm
numAutorizacion
H04
String
..30
C/C
Número de autorización emitida por la EPS/aseguradora para la hospitalización.
causaMotivoAtencion
H05
String
2
SI
Código de la causa externa que motivó la hospitalización.
Tabla de referencia SISPRO: RIPSCausaExternaVersion2
codDiagnosticoPrincipalIngreso
H06
String
..8
SI
Código CIE-10 del diagnóstico principal al ingreso a hospitalización.
Tabla de referencia: CIE10
codDiagnosticoRelacionadoIngreso1
H07
String
..8
NO
Código CIE-10 de diagnóstico relacionado al ingreso (1).
Tabla de referencia: CIE10
codDiagnosticoRelacionadoIngreso2
H08
String
..8
NO
Código CIE-10 de diagnóstico relacionado al ingreso (2).
Tabla de referencia: CIE10
codDiagnosticoRelacionadoIngreso3
H09
String
..8
NO
Código CIE-10 de diagnóstico relacionado al ingreso (3).
Tabla de referencia: CIE10
codDiagnosticoPrincipalEgreso
H10
String
..8
SI
Código CIE-10 del diagnóstico principal al egreso de hospitalización.
Tabla de referencia: CIE10
codDiagnosticoRelacionadoEgreso1
H11
String
..8
NO
Código CIE-10 de diagnóstico relacionado al egreso.
Tabla de referencia: CIE10
condicionSalidaHospitalizacion
H12
String
2
SI
Condición en que egresó el usuario de hospitalización.
Incluye la opción 08: Paciente continúa en el servicio (corte de facturación).
Tabla de referencia SISPRO correspondiente.
codDiagnosticoCausaMuerte
H13
String
..8
C/C
Código CIE-10 de la causa de muerte, si aplica.
Tabla de referencia: CIE10
fechaEgreso
H14
String
16
SI
Fecha y hora de egreso de hospitalización. Debe estar dentro del periodo de facturación.
Formato: AAAA-MM-DD hh:mm
consecutivo
-
Integer
INT32
SI
Posición del registro de hospitalización dentro del arreglo del usuario.
Object.recienNacido
Arreglo con los datos del recién nacido. Se registra obligatoriamente cuando se atiende un parto vaginal o cesárea, en el RIPS de la madre. Si el recién nacido debe hospitalizarse, se hace una admisión independiente con su propia FEV y RIPS. Corresponde a los campos N01 a N11+.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
codPrestador
N01
String
12
SI
Código de habilitación del prestador con sede (12 caracteres).
Tabla de referencia SISPRO: IPSCodHabilitacion / IPSNoREPS
tipoDocumentoIdentificacion
N02
String
..20
SI
Tipo de documento del recién nacido. Todo niño nacido en el prestador debe tener documento (CN, RC o MS para poblaciones especiales).
No se registra el documento de la madre.
Tabla de referencia SISPRO: TipoIdPISIS
numDocumentoIdentificacion
N03
String
..20
SI
Número del documento de identificación del recién nacido.
fechaNacimiento
N04
String
date
SI
Fecha de nacimiento del recién nacido.
Formato: YYYY-MM-DD
edadGestacional
N05
Integer
INT32
SI
Edad gestacional del recién nacido al momento del nacimiento, expresada en semanas completas.
pesoAlNacer
N06
Decimal
-
SI
Peso del recién nacido al momento del nacimiento, expresado en gramos.
codSexoBiologico
N07
String
2
SI
Código del sexo biológico del recién nacido.
Tomar de la columna Extra II de la tabla SISPRO Sexo:
01 Hombre
02 Mujer
03 Indeterminado
codDiagnosticoPrincipal
N08
String
..8
SI
Código CIE-10 del diagnóstico principal del recién nacido.
Tabla de referencia: CIE10
condicionDestinoUsuarioEgreso
N09
String
2
SI
Condición y destino del recién nacido al egreso.
Tabla de referencia SISPRO correspondiente (condición de egreso).
codDiagnosticoCausaMuerte
N10
String
..8
C/C
Código CIE-10 de la causa de muerte del recién nacido, si aplica.
Tabla de referencia: CIE10
codDiagnosticoRelacionado
N11
String
..8
NO
Código CIE-10 de diagnóstico relacionado del recién nacido.
Tabla de referencia: CIE10
consecutivo
-
Integer
INT32
SI
Posición del registro de recién nacido dentro del arreglo del usuario.
Object.medicamentos
Arreglo con los datos de medicamentos dispensados o administrados. Incluye medicamentos del plan de beneficios, de presupuesto máximo, preparaciones magistrales y medicamentos no POS. Corresponde a los campos M01 a M20+.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
codPrestador
M01
String
12
SI
Código de habilitación del prestador con sede (12 caracteres).
Tabla de referencia SISPRO: IPSCodHabilitacion / IPSNoREPS
numAutorizacion
M02
String
AN
C/C
Número de autorización del medicamento emitida por la EPS.
idEntrega
M03
String
AN
C/C
Número de ID de entrega para medicamentos no financiados con cargo a la UPC.
Coincide con el ID de prescripción MIPRES para medicamentos de presupuesto máximo.
fechaDispensAdmon
M04
String
16
SI
Fecha y hora de dispensación o administración del medicamento.
Pacientes hospitalarios/urgencias: fecha y hora de cada administración.
Pacientes ambulatorios: fecha y hora de entrega al paciente.
Formato: AAAA-MM-DD hh:mm
codDiagnosticoPrincipal
M05
String
..8
SI
Código CIE-10 que justifica la prescripción del medicamento.
Preferentemente no debe iniciar por V o Y.
Tabla de referencia: CIE10
codDiagnosticoRelacionado
M06
String
..8
NO
Código CIE-10 del diagnóstico relacionado con la prescripción.
Tabla de referencia: CIE10
tipoMedicamento
M07
String
AN
SI
Tipo de medicamento dispensado.
Para preparaciones magistrales (PM): registrar un objeto por cada principio activo.
Tabla de referencia SISPRO: TipoMedicamentoPOSVersion2
01 Medicamento POS (Plan de Beneficios)
02 Medicamento No POS
03 Preparación Magistral
(y demás opciones según tabla SISPRO)
codTecnologiaSalud
M08
String
AN
SI
Código del medicamento.
Usar el IUM (Identificador Único de Medicamento) preferentemente.
Si no tiene IUM, usar el CUM (Código Único de Medicamento).
Para preparaciones magistrales: CUM/IUM de cada principio activo o código DCI de Cannabis.
Tablas SISPRO: IUM o CatalogoCUMs
nomMedicamento
M09
String
AN
NO
Nombre del medicamento (se obtiene de M08, se puede dejar en blanco manteniendo el campo).
concentracionMedicamento
M10
String
AN
C/C
Concentración de cada principio activo dentro de la formulación.
Obligatorio para preparaciones magistrales (cuando M07 = 03). Informar null para otros tipos.
unidadMedida
M11
String
AN
SI
Unidad de medida del medicamento.
Tabla de referencia SISPRO: UMM (Unidad de Medida de Medicamento)
formaFarmaceutica
M12
String
AN
SI
Forma farmacéutica del medicamento (tableta, cápsula, ampolla, etc.).
Tabla de referencia SISPRO: FFM
unidadMinDispensa
M13
String
AN
SI
Unidad mínima de medida en la que se dispensó el medicamento (vial, tableta, frasco).
Para preparaciones magistrales: la misma unidad de medida de la preparación en todos los principios activos.
Tablas de referencia SISPRO: UPR y UMM
cantidadMedicamento
M14
Decimal
-
SI
Cantidad de unidades mínimas dispensadas o administradas.
Para preparaciones magistrales: diligenciar en uno de los principios activos; en los demás informar 0.
diasTratamiento
M15
Integer
INT32
SI
Número de días de tratamiento. No acepta decimales, aproximar al número más alto.
Para preparaciones magistrales: diligenciar en uno de los principios activos; en los demás informar 0.
tipoDocumentoIdentificacionMedico
M16
String
2
SI
Tipo de documento de identificación del profesional que prescribió el medicamento.
Tabla de referencia SISPRO: TipoIdPISIS
numDocumentoIdentificacionMedico
M17
String
AN
SI
Número del documento de identificación del profesional prescriptor.
vrUnitMedicamento
M18
Decimal
-
SI
Valor unitario del medicamento (por unidad mínima de dispensación). Ya con descuentos pactados.
Pago por evento: debe ser mayor a 0. Otras modalidades: informar 0.
Para PM: valor de cada principio activo o sumatoria en uno de ellos (los demás en 0).
vrServicio
M19
Decimal
-
SI
Valor total del medicamento en COP.
Para PM: sumatoria de todos los principios activos, diligenciado en uno de ellos (los demás en 0).
conceptoRecaudo
M20
String
2
SI
Código del tipo de pago moderador.
Valores (tabla SISPRO conceptoRecaudo):
01 Copago
02 Cuota moderadora
03 Pagos compartidos en planes voluntarios de salud
04 Anticipos
05 No aplica
Rechazo Si el valor no corresponde a los permitidos
valorPagoModerador
-
Decimal
-
SI
Valor del pago moderador en COP. Informar 0 si no aplica.
numFEVPagoModerador
-
String
AN
C/C
Número de la FEV por pago moderador. Informar null si no aplica.
consecutivo
-
Integer
INT32
SI
Posición del medicamento dentro del arreglo del usuario.
Object.otrosServicios
Arreglo con los datos de otros servicios y tecnologías de salud: dispositivos médicos, insumos, estancias, honorarios profesionales, traslados y servicios complementarios MIPRES. Corresponde a los campos S01 a S12+.
Atributo
Cód.
Tipo Dato
Formato
Requerido
Descripción
codPrestador
S01
String
12
SI
Código de habilitación del prestador con sede (12 caracteres).
Tabla de referencia SISPRO: IPSCodHabilitacion / IPSNoREPS
fechaInicioAtencion
S02
String
16
SI
Fecha y hora de inicio del servicio. Dentro del periodo de facturación.
Formato: AAAA-MM-DD hh:mm
numAutorizacion
S03
String
..30
C/C
Número de autorización emitida por la EPS o aseguradora.
idEntrega
S04
String
AN
C/C
Número de ID de entrega para servicios no financiados con UPC. Puede coincidir con ID MIPRES.
tipoOtroServicio
S05
String
2
SI
Tipo del otro servicio. Valores (tabla de referencia SISPRO):
01 Dispositivos médicos / insumos
02 Estancias
03 Honorarios profesionales
04 Traslados
05 Servicios complementarios (MIPRES)
Si se registran estancias, debe haber datos en hospitalización y/o urgencias con observación.
codTecnologiaSalud
S06
String
AN
SI
Código del servicio u tecnología:
Dispositivos médicos: usar IDM (Identificador del Dispositivo Médico) o UDI (Unique Device Identifier).
Estancias, honorarios y traslados: usar el código CUPS correspondiente.
Honorarios: usar el CUPS del procedimiento realizado.
Servicios complementarios: usar códigos de la tabla de referencia MIPRES.
Tabla de referencia SISPRO: CUPSRips (para estancias/traslados/honorarios)
nomOtroServicio
S07
String
AN
C/C
Nombre del dispositivo médico o insumo. Informar null para otros tipos de servicio.
cantidad
S08
Decimal
-
SI
Cantidad del servicio en unidades.
Para honorarios, informar siempre 1.
tipoDocumentoIdentificacionMedico
S09
String
2
SI
Tipo de documento del profesional que prescribió u ordenó el servicio.
Tabla de referencia SISPRO: TipoIdPISIS
numDocumentoIdentificacionMedico
S10
String
AN
SI
Número del documento del profesional que prescribió u ordenó el servicio.
vrServicio
S11
Decimal
-
SI
Valor total del servicio en COP.
Si el dispositivo está gravado con IVA, informar el valor con IVA.
conceptoRecaudo
S12
String
2
SI
Código del tipo de pago moderador.
Tabla de referencia SISPRO: conceptoRecaudo (mismos valores que C18)
Rechazo Si el valor no corresponde a los permitidos
valorPagoModerador
-
Decimal
-
SI
Valor del pago moderador en COP. Informar 0 si no aplica.
numFEVPagoModerador
-
String
AN
C/C
Número de la FEV por pago moderador. Informar null si no aplica.
consecutivo
-
Integer
INT32
SI
Posición del registro dentro del arreglo de otros servicios del usuario.
Tablas de Referencia SISPRO
Para el correcto diligenciamiento de los campos de datos del RIPS, se deben consultar las tablas de referencia publicadas en el micrositio oficial del Ministerio de Salud y Protección Social.
Clasificación Internacional de Enfermedades, versión 10. Códigos de diagnóstico.
conceptoRecaudo
C18, P17, M20, S12
Tipos de pago moderador: copago, cuota moderadora, planes voluntarios, anticipos, no aplica.
TipoMedicamentoPOSVersion2
M07
Tipos de medicamento: POS, No POS, preparación magistral, UNIRS, MVND, Cannabis, entre otros.
IUM
M08
Identificador Único de Medicamento.
CatalogoCUMs
M08
Código Único de Medicamento (cuando no tiene IUM).
UMM
M11
Unidades de medida de medicamentos.
FFM
M12
Formas farmacéuticas de medicamentos.
UPR
M13
Unidades de presentación para dispensación.
@IMPORTANTE: Los campos y valores permitidos están sujetos a actualización continua por parte del Ministerio de Salud. Siempre consultar la versión vigente de las tablas en web.sispro.gov.co y el documento de lineamientos técnicos vigente publicado en el micrositio de Factura Electrónica en Salud.
