RIPS y salud

Dos cosas distintas (no las mezcles)

Capacidad	Qué es	Guía
Factura sector salud	FE con health_fields	Factura sector salud
RIPS / SISPRO	Módulo /api/rips/*	Esta página

---

¿Qué es RIPS?

RIPS (Registro Individual de Prestación de Servicios de Salud) permite armar y enviar información de salud hacia SISPRO, pensado para IPS / prestadores (casos tipo CPSAS y afines).

GridBilling expone el módulo bajo /api/rips/* con Bearer de la empresa.

Alcance

RIPS es un módulo especializado de salud. Si tu integración es solo FE/nómina/RADIAN, puedes ignorar esta sección. Si eres prestador de salud, úsala junto con las tablas /api/table/health_*.

Flujo recomendado

1. POST /api/rips/configuration     → credenciales SISPRO
2. CRUD service-providers           → prestadores (opcional)
3. CRUD patients                    → pacientes
4. CRUD appointments                → citas
5. GET  services/tables|procedures|cies → catálogos
6. POST /api/rips/documents         → arma el documento RIPS
7. POST /api/rips/documents/generate/{id} → envía a SISPRO (sin factura)

Autenticación

Todas las rutas siguientes requieren:

Authorization: Bearer <token_empresa>

Base URL: {{base_url}}/api (Sandbox o Producción).

Configuración SISPRO

POST /api/rips/configuration
Content-Type: application/json

{
  "type_document_identification_id": 6,
  "number_identification": "900123456",
  "password": "clave_sispro",
  "url": "https://…sispro…"
}

Prestadores

GET    /api/rips/service-providers
POST   /api/rips/service-providers
GET    /api/rips/service-providers/{id}
PUT    /api/rips/service-providers/{id}
DELETE /api/rips/service-providers/{id}

Alta típica: document_type_id, name, email, code, document_number.

Pacientes

GET  /api/rips/patients/tables
GET  /api/rips/patients?search=
POST /api/rips/patients
GET  /api/rips/patients/{id}
PUT  /api/rips/patients/{id}

Campos frecuentes: type_document_identification_id, document_number, name, last_name, email, birth_date, rips_user_type_id, rips_gender_id, municipality_id, rips_zone_id, country_code (Colombia 170).

patients/tables devuelve catálogos (tipos de documento, género, zona, municipios, etc.).

Citas

GET  /api/rips/appointments?search=&month=
POST /api/rips/appointments
GET  /api/rips/appointments/{id}

Alta: patient_id, user_id, date (Y-m-d), time (H:i).

Catálogos de servicios

GET /api/rips/services/tables
GET /api/rips/services/procedures?search=
GET /api/rips/services/cies?search=

Útiles para códigos de procedimiento y CIE (diagnósticos).

Documentos RIPS y envío

POST /api/rips/documents
Content-Type: application/json

Ejemplo listo (consulta): rips-consulta.example.json

{
  "appointment_id": 1,
  "services": [
    {
      "service_type_id": 1,
      "fechaInicioAtencion": "2026-07-20T08:30:00",
      "codConsulta": "890201",
      "modalidadGrupoServicioTecSal": "01",
      "grupoServicios": "01",
      "codServicio": 328,
      "finalidadTecnologiaSalud": "11",
      "causaMotivoAtencion": "38",
      "codDiagnosticoPrincipal": "J00X",
      "tipoDiagnosticoPrincipal": "01",
      "vrServicio": 50000,
      "conceptoRecaudo": 0,
      "valorPagoModerador": 0,
      "consecutivo": 1
    }
  ]
}

Luego genera/envía a SISPRO:

POST /api/rips/documents/generate/{id}

También en Postman: carpeta 14 - RIPS Salud.

Tipos de servicio (service_type_id)

id	Grupo
1	Consultas
2	Procedimientos
3	Urgencias
4	Hospitalización
5	Recién nacidos
6	Medicamentos
7	Otros servicios

Cada tipo agrega campos propios (p. ej. procedimientos usan códigos CUPS distintos). Usa services/tables, procedures y cies para armar códigos válidos.

Precaución

POST /api/rips/ (raíz) es un stub de compatibilidad. El envío real a SISPRO es documents/generate/{id}.

Tablas de salud (FE + RIPS)

Además del módulo RIPS:

GET /api/table/health_type_document_identifications
GET /api/table/health_type_users
GET /api/table/health_contracting_payment_methods
GET /api/table/health_coverages

Úsalas cuando facturas con sector salud (campos de cobertura / usuario en la FE) o al armar RIPS.

Relación con facturación

Puedes:

• Emitir factura de salud por UBL (/api/ubl2.1/invoice con datos de salud), y/o
• Generar RIPS sin factura vía documents/generate/{id} hacia SISPRO.

Coordina con tu operación clínica cuál flujo aplica (muchas IPS hacen ambos).

Soporte salud / CPSAS

Si necesitas onboarding asistido (mapeo de códigos, primer envío SISPRO):

WhatsApp GridSoft — RIPS / salud