RIPS Capita Final
RIPS sin factura
Endpoint
- Método: POST
- URL:
{{BASE_URL}}/api/PaquetesFevRips/CargarCapitaFinal
Autenticación
Bearer Token: {{API_TOKEN}}
Body
{
"rips": {
"numDocumentoIdObligado": "901355357",
"numFactura": "SETP9900001023",
"tipoNota": "",
"numNota": "",
"usuarios": [
{
"consecutivo": 1,
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "11223344",
"fechaNacimiento": "1990-01-01",
"codSexo": "F",
"tipoUsuario": "12",
"codPaisResidencia": "170",
"codPaisOrigen": "170",
"codMunicipioResidencia": "11001",
"codZonaTerritorialResidencia": "01",
"incapacidad": "NO",
"servicios": {
"consultas": [
{
"consecutivo": 1,
"codPrestador": "760011269401",
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "11223344",
"fechaInicioAtencion": "2025-05-26 09:00",
"codConsulta": "890202",
"codServicio": 478,
"vrServicio": 40000,
"valorPagoModerador": 5000,
"conceptoRecaudo": "01",
"numFEVPagoModerador": "SETP9900001023",
"finalidadTecnologiaSalud": "10",
"grupoServicios": "01",
"modalidadGrupoServicioTecSal": "01",
"causaMotivoAtencion": "10",
"tipoDiagnosticoPrincipal": "01",
"codDiagnosticoPrincipal": "Z000",
"codDiagnosticoRelacionado1": null,
"codDiagnosticoRelacionado2": null,
"codDiagnosticoRelacionado3": null,
"numAutorizacion": null
}
]
}
},
{
"consecutivo": 2,
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "55667788",
"fechaNacimiento": "1985-05-10",
"codSexo": "M",
"tipoUsuario": "12",
"codPaisResidencia": "170",
"codPaisOrigen": "170",
"codMunicipioResidencia": "05001",
"codZonaTerritorialResidencia": "01",
"incapacidad": "NO",
"servicios": {
"consultas": [
{
"consecutivo": 1,
"codPrestador": "760011269401",
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "55667788",
"fechaInicioAtencion": "2025-05-26 10:00",
"codConsulta": "890203",
"codServicio": 478,
"vrServicio": 40000,
"valorPagoModerador": 4000,
"conceptoRecaudo": "02",
"numFEVPagoModerador": "SETP9900001023",
"finalidadTecnologiaSalud": "10",
"grupoServicios": "01",
"modalidadGrupoServicioTecSal": "01",
"causaMotivoAtencion": "10",
"tipoDiagnosticoPrincipal": "01",
"codDiagnosticoPrincipal": "Z001",
"codDiagnosticoRelacionado1": null,
"codDiagnosticoRelacionado2": null,
"codDiagnosticoRelacionado3": null,
"numAutorizacion": null
}
]
}
},
{
"consecutivo": 3,
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "99887766",
"fechaNacimiento": "2000-09-15",
"codSexo": "F",
"tipoUsuario": "12",
"codPaisResidencia": "170",
"codPaisOrigen": "170",
"codMunicipioResidencia": "76001",
"codZonaTerritorialResidencia": "01",
"incapacidad": "NO",
"servicios": {
"consultas": [
{
"consecutivo": 1,
"codPrestador": "760011269401",
"tipoDocumentoIdentificacion": "CC",
"numDocumentoIdentificacion": "99887766",
"fechaInicioAtencion": "2025-05-26 11:00",
"codConsulta": "890201",
"codServicio": 478,
"vrServicio": 40000,
"valorPagoModerador": 0,
"conceptoRecaudo": "05",
"numFEVPagoModerador": "SETP9900001023",
"finalidadTecnologiaSalud": "10",
"grupoServicios": "01",
"modalidadGrupoServicioTecSal": "01",
"causaMotivoAtencion": "10",
"tipoDiagnosticoPrincipal": "01",
"codDiagnosticoPrincipal": "Z002",
"codDiagnosticoRelacionado1": null,
"codDiagnosticoRelacionado2": null,
"codDiagnosticoRelacionado3": null,
"numAutorizacion": null
}
]
}
}
]
},
// No requiere
"xmlFevFile": ""
}
Ejemplo cURL
curl --request POST '{{BASE_URL}}/api/PaquetesFevRips/CargarCapitaFinal' \
--header 'Content-Type: application/json' \
--data-raw '{ "rips": { "numDocumentoIdObligado": "901355357", "numFactura": "SETP9900001023", "tipoNota": "", "numNota": "", "usuarios": [ { "consecutivo": 1, "tipoDocumentoIdentificacion": "CC", "numDocumentoIdentificacion": "11223344", "fechaNacimiento": "1990-01-01", "codSexo": "F", "tipoUsuario": "12", "codPaisResidencia": "170", "codPaisOrigen": "170", "codMunicipioResidencia": "11001", "codZonaTerritorialResidencia": "01", "incapacidad": "NO", "servicios": { "consultas": [ { "consecutivo": 1, "codPrestador": "760011269401", "tipoDocumentoIdentificacion": "CC", "numDocumentoIdentificacion": "11223344", "fechaInicioAtencion": "2025-05-26 09:00", "codConsulta": "890202", "codServicio": 478, "vrServicio": 40000, "valorPagoModerador": 5000, "conceptoRecaudo": "01", "numFEVPagoModerador": "SETP9900001023", "finalidadTecnologiaSalud": "10", "grupoServicios": "01", "modalidadGrupoServicioTecSal": "01", "causaMotivoAtencion": "10", "tipoDiagnosticoPrincipal": "01", "codDiagnosticoPrincipal": "Z000", "codDiagnosticoRelacionado1": null, "codDiagnosticoRelacionado2": null, "codDiagnosticoRelacionado3": null, "numAutorizacion": null } ] } }, { "consecutivo": 2, "tipoDocumentoIdentificacion": "CC", "numDocumentoIdentificacion": "55667788", "fechaNacimiento": "1985-05-10", "codSexo": "M", "tipoUsuario": "12", "codPaisResidencia": "170", "codPaisOrigen": "170", "codMunicipioResidencia": "05001", "codZonaTerritorialResidencia": "01", "incapacidad": "NO", "servicios": { "consultas": [ { "consecutivo": 1, "codPrestador": "760011269401", "tipoDocumentoIdentificacion": "CC", "numDocumentoIdentificacion": "55667788", "fechaInicioAtencion": "2025-05-26 10:00", "codConsulta": "890203", "codServicio": 478, "vrServicio": 40000, "valorPagoModerador": 4000, "conceptoRecaudo": "02", "numFEVPagoModerador": "SETP9900001023", "finalidadTecnologiaSalud": "10", "grupoServicios": "01", "modalidadGrupoServicioTecSal": "01", "causaMotivoAtencion": "10", "tipoDiagnosticoPrincipal": "01", "codDiagnosticoPrincipal": "Z001", "codDiagnosticoRelacionado1": null, "codDiagnosticoRelacionado2": null, "codDiagnosticoRelacionado3": null, "numAutorizacion": null } ] } }, { "consecutivo": 3, "tipoDocumentoIdentificacion": "CC", "numDocumentoIdentificacion": "99887766", "fechaNacimiento": "2000-09-15", "codSexo": "F", "tipoUsuario": "12", "codPaisResidencia": "170", "codPaisOrigen": "170", "codMunicipioResidencia": "76001", "codZonaTerritorialResidencia": "01", "incapacidad": "NO", "servicios": { "consultas": [ { "consecutivo": 1, "codPrestador": "760011269401", "tipoDocumentoIdentificacion": "CC", "numDocumentoIdentificacion": "99887766", "fechaInicioAtencion": "2025-05-26 11:00", "codConsulta": "890201", "codServicio": 478, "vrServicio": 40000, "valorPagoModerador": 0, "conceptoRecaudo": "05", "numFEVPagoModerador": "SETP9900001023", "finalidadTecnologiaSalud": "10", "grupoServicios": "01", "modalidadGrupoServicioTecSal": "01", "causaMotivoAtencion": "10", "tipoDiagnosticoPrincipal": "01", "codDiagnosticoPrincipal": "Z002", "codDiagnosticoRelacionado1": null, "codDiagnosticoRelacionado2": null, "codDiagnosticoRelacionado3": null, "numAutorizacion": null } ] } } ] }, // No requiere "xmlFevFile": "" }'
Respuesta de ejemplo (rechazado)
{
"ResultState": false,
"ProcesoId": 0,
"NumFactura": "SETP9900001023",
"CodigoUnicoValidacion": "No aplica a paquetes procesados en estado [RECHAZADO] o validaciones realizadas antes del envío al Ministerio de Salud y Protección Social",
"FechaRadicacion": "2025-06-16T16:20:21.2129742+00:00",
"RutaArchivos": null,
"ResultadosValidacion": [
{
"Clase": "RECHAZADO",
"Codigo": "CFR003",
"Descripcion": "Se encontraron errores al procesar el archivo Json de Fev",
"Observaciones": "",
"PathFuente": "",
"Fuente": "CapitaFinal"
},
{
"Clase": "RECHAZADO",
"Codigo": "RVC034",
"Descripcion": "Diligenciar el valor mayor a cero (0) si la modalidad de pago corresponde a 'Pago por evento'. Para las demás modalidades informar cero (0).",
"Observaciones": "El campo valor servicio [40000] no es valido, para el tipo de modalidad de pago [03]",
"PathFuente": "usuarios[0].servicios.consultas[0].vrServicio",
"Fuente": "Rips"
},
{
"Clase": "RECHAZADO",
"Codigo": "RVC034",
"Descripcion": "Diligenciar el valor mayor a cero (0) si la modalidad de pago corresponde a 'Pago por evento'. Para las demás modalidades informar cero (0).",
"Observaciones": "El campo valor servicio [40000] no es valido, para el tipo de modalidad de pago [03]",
"PathFuente": "usuarios[1].servicios.consultas[0].vrServicio",
"Fuente": "Rips"
},
{
"Clase": "RECHAZADO",
"Codigo": "RVC034",
"Descripcion": "Diligenciar el valor mayor a cero (0) si la modalidad de pago corresponde a 'Pago por evento'. Para las demás modalidades informar cero (0).",
"Observaciones": "El campo valor servicio [40000] no es valido, para el tipo de modalidad de pago [03]",
"PathFuente": "usuarios[2].servicios.consultas[0].vrServicio",
"Fuente": "Rips"
},
{
"Clase": "RECHAZADO",
"Codigo": "RVG06",
"Descripcion": "El dato informado no corresponde al contenido requerido.",
"Observaciones": "Para facturas por modalidad de pago CAPITA, el valor total reportado en los servicos de ser igual a cero (0)",
"PathFuente": "rips",
"Fuente": "Rips"
},
{
"Clase": "RECHAZADO",
"Codigo": "RVG06",
"Descripcion": "El dato informado no corresponde al contenido requerido.",
"Observaciones": "Verificar tabla de referencia, dato (478)",
"PathFuente": "usuarios[0].servicios.consultas[0].codServicio",
"Fuente": "Rips"
},
{
"Clase": "RECHAZADO",
"Codigo": "RVG06",
"Descripcion": "El dato informado no corresponde al contenido requerido.",
"Observaciones": "Verificar tabla de referencia, dato (10)",
"PathFuente": "usuarios[0].servicios.consultas[0].finalidadTecnologiaSalud",
"Fuente": "Rips"
},
{
"Clase": "RECHAZADO",
"Codigo": "RVG06",
"Descripcion": "El dato informado no corresponde al contenido requerido.",
"Observaciones": "El Código causa motivo atención [10] no es válido, por favor verificar tabla de referencia.",
"PathFuente": "usuarios[0].servicios.consultas[0].causaMotivoAtencion",
"Fuente": "Rips"
},
{
"Clase": "RECHAZADO",
"Codigo": "RVG06",
"Descripcion": "El dato informado no corresponde al contenido requerido.",
"Observaciones": "Verificar tabla de referencia, dato (478)",
"PathFuente": "usuarios[1].servicios.consultas[0].codServicio",
"Fuente": "Rips"
},