Skip to main content

RIPS NC

RIPS con factura

  • el campo "xmlFevFile" esta relacionado con el campo "attacheddocument" de la respuesta de una factura (aceptada) en el API

    • tambien cuenta con servicios para obtener el valor

    • si posee el zip, puede convertirlo en Base64 y añadir el string obtenido

  • el campo "numFactura" debe contener el correlativo y numeración juntos, sin caracteres especiales

Endpoint​

  • Método: POST
  • URL: {{BASE_URL}}/api/PaquetesFevRips/CargarNC

Autenticación​

Bearer Token: {{API_TOKEN}}

Body​

{
  "rips": {
    "numDocumentoIdObligado": "{{IDENTIFICACION}}",
    "numFactura": "SETP990000103",
    "numNota": "NC1",
    "tipoNota": "NC",
    "usuarios": [
      {
        "tipoDocumentoIdentificacion": "CC",
        "numDocumentoIdentificacion": "{{IDENTIFICACION}}",
        "tipoUsuario": "02",
        "fechaNacimiento": "1990-08-17",
        "codSexo": "M",
        "codPaisResidencia": "170",
        "codMunicipioResidencia": "11001",
        "codZonaTerritorialResidencia": "02",
        "incapacidad": "NO",
        "codPaisOrigen": "170",
        "consecutivo": 1,
        "servicios": {
          "consultas": [
            {
              "codPrestador": "{{IDENTIFICACION}}",
              "fechaInicioAtencion": "2024-06-22 00:00",
              "numAutorizacion": "",
              "codConsulta": "{{IDENTIFICACION}}",
              "modalidadGrupoServicioTecSal": "01",
              "grupoServicios": "01",
              "codServicio": 328,
              "finalidadTecnologiaSalud": "25",
              "causaMotivoAtencion": "38",
              "codDiagnosticoPrincipal": "S934",
              "codDiagnosticoRelacionado1": "S903",
              "codDiagnosticoRelacionado2": null,
              "codDiagnosticoRelacionado3": null,
              "tipoDiagnosticoPrincipal": "02",
              "tipoDocumentoIdentificacion": "CC",
              "numDocumentoIdentificacion": "{{IDENTIFICACION}}",
              "vrServicio": 700,
              "valorPagoModerador": 0,
              "numFEVPagoModerador": "",
              "conceptoRecaudo": "05",
              "consecutivo": 1
            }
          ]
        }
      }
    ]
  },
  "xmlFevFile": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iV"
}

Ejemplo cURL​

curl --request POST '{{BASE_URL}}/api/PaquetesFevRips/CargarNC' \
  --header 'Content-Type: application/json' \
  --data-raw '{ "rips": { "numDocumentoIdObligado": "{{IDENTIFICACION}}", "numFactura": "SETP990000103", "numNota": "NC1", "tipoNota": "NC", "usuarios": [ { "tipoDocumentoIdentificacion": "CC", "numDocumentoIdentificacion": "{{IDENTIFICACION}}", "tipoUsuario": "02", "fechaNacimiento": "1990-08-17", "codSexo": "M", "codPaisResidencia": "170", "codMunicipioResidencia": "11001", "codZonaTerritorialResidencia": "02", "incapacidad": "NO", "codPaisOrigen": "170", "consecutivo": 1, "servicios": { "consultas": [ { "codPrestador": "{{IDENTIFICACION}}", "fechaInicioAtencion": "2024-06-22 00:00", "numAutorizacion": "", "codConsulta": "{{IDENTIFICACION}}", "modalidadGrupoServicioTecSal": "01", "grupoServicios": "01", "codServicio": 328, "finalidadTecnologiaSalud": "25", "causaMotivoAtencion": "38", "codDiagnosticoPrincipal": "S934", "codDiagnosticoRelacionado1": "S903", "codDiagnosticoRelacionado2": null, "codDiagnosticoRelacionado3": null, "tipoDiagnosticoPrincipal": "02", "tipoDocumentoIdentificacion": "CC", "numDocumentoIdentificacion": "{{IDENTIFICACION}}", "vrServicio": 700, "valorPagoModerador": 0, "numFEVPagoModerador": "", "conceptoRecaudo": "05", "consecutivo": 1 } ] } } ] }, "xmlFevFile": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iV" }'

Respuesta de ejemplo (rechazado)​

{
  "ResultState": false,
  "ProcesoId": 0,
  "NumFactura": "",
  "CodigoUnicoValidacion": "-",
  "CodigoUnicoValidacionToShow": "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-05-27T20:38:13.0766104+00:00",
  "RutaArchivos": null,
  "ResultadosValidacion": [
    {
      "Clase": "RECHAZADO",
      "Codigo": "RVG06",
      "Descripcion": "El dato informado no corresponde al contenido requerido.",
      "Observaciones": "Object reference not set to an instance of an object.",
      "PathFuente": "Estructura general",
      "Fuente": "Rips"
    }
  ]
}