Ver el código de «RIPS:Carga Masiva»

== 📦 Carga Masiva ==
<!--== 📦 <span style="color:#02509f;"> Carga Masiva</span> == -->
<div style="background-color:#f4faff; border:1px solid #c0dffb; padding:15px; border-radius:8px;">

<span style="display:block; font-size:18px; font-weight:bold; margin-bottom:10px; color:#547CCC;"> ✨ Gestión de RIPS de forma fácil </span> 
📌 Hemos incorporado en nuestro portal la nueva funcionalidad <b>"Cargas Masivas"</b>.
<br><br>
<table class="tabla-rips" style="width:100%; border-collapse:collapse; border:none; background:none;">
  <tr>
    <td style="width:35%; vertical-align:top; text-align:center; padding:10px; border:none; background:none;">
      <div style="display:inline-block; border: 1px solid #c0dffb; border-radius: 8px; padding:10px; background-color:#f4faff; box-shadow: 2px 2px 8px rgba(0,0,0,0.1);">
        [[Archivo:rips68.png|300px|center|alt=Acceso a carga masiva en el menú RIPS]]
      </div>
    </td>
    <td style="width:65%; vertical-align:top; padding:10px; font-size:14px; line-height:1.5; color:#333; border:none; background:none;">
<br><br>
<b><span style="color:#547CCC;">¿Qué es la carga masiva?</span></b><br> Este proceso permite <b>enviar de una sola vez</b> la información de uno o varios RIPS, incluyendo datos de pacientes y servicios prestados, a través de un archivo en el formato establecido.<br><br>

<b><span style="color:#547CCC;">Beneficios principales:</span></b><br> ✅ Ahorro de tiempo al evitar el ingreso manual de cada registro.<br> ✅ Reducción de errores en la digitación de datos.<br> ✅ Mayor eficiencia en el cumplimiento de los reportes exigidos por el Ministerio de Salud.<br><br> <b><span style="color:#547CCC;">Usos comunes:</span></b><br> 🔹 Reportar RIPS con factura, relacionando los datos que están dentro de la Factura Electrónica según el escenario correspondiente.<br> 🔹 Reportar RIPS sin factura, vinculando la información con el número de nota.<br> 🔹 Facilitar el envío de grandes volúmenes de información de forma organizada y segura.<br> <br>
En la parte izquierda del menú, se encuentra la sección <b><span style="color:#7AA0FF;">RIPS</span></b>. Desplegamos esta sección y debajo de ella se ven las distintas subsecciones; dentro de ellas está <b><span style="color:#2A6EBB;">Carga Masiva</span></b>, la cual se indica en la imagen de la izquierda ←
    </td>
  </tr>
</table>

<span style="font-size:20px; font-weight:bold; color:#2A6EBB;"> 📂 Descarga de la plantilla para Cargas Masivas</span>
  <hr style="border:1px solid #BBD4FF;">

  <p style="color:#333; font-size:14px; line-height:1.5;">
    Al ingresar al módulo <b style="color:#2A6EBB;">Cargas Masivas</b>, se visualizará una tarjeta como la mostrada en la imagen:  

<div style="text-align:center;">
  <div style="display:inline-block; border: 1px solid #c0dffb; border-radius: 8px; padding:10px; background-color:#f4faff; box-shadow: 2px 2px 8px rgba(0,0,0,0.1);">
    [[Archivo:rips69.png|600px]]
  </div>
</div>



*📌 En el lado izquierdo se encuentra el <b style="color:#2A6EBB;">ícono de descarga</b> y, en el lado derecho, el botón <b style="color:#2A6EBB;">“Descargar Plantilla”</b>.  

*📥 Al seleccionar este botón, se descargara la <b style="color:#2A6EBB;">plantilla oficial</b> en formato <b>.xlsm</b> (libro de Excel habilitado para macros).  

*✅ Esta plantilla ya incluye la <b style="color:#2A6EBB;">columna obligatoria <code>ripsId</code></b>, lo que facilita la consolidación correcta de la información de los RIPS antes de su envío.
  </p>
<br><br>
<table style="border-collapse:collapse; border:none; background:none; margin:auto;">
  <tr>
    <td style="border:none; background:none; text-align:center; vertical-align:middle; padding:0;">
      <div style="display:inline-flex; justify-content:center; align-items:center; width:430px; height:320px; border:1px solid #c0dffb; border-radius:8px; padding:8px; background-color:#f4faff; box-shadow:2px 2px 8px rgba(0,0,0,0.1);">
        [[Archivo:rips71.png|400px|alt=Descripción imagen 1]]
      </div>
    </td>
    <td style="border:none; background:none; text-align:center; vertical-align:middle; padding:0;">
      <div style="display:inline-flex; justify-content:center; align-items:center; width:430px; height:320px; border:1px solid #c0dffb; border-radius:8px; padding:8px; background-color:#f4faff; box-shadow:2px 2px 8px rgba(0,0,0,0.1);">
        [[Archivo:rips70.png|400px|alt=Descripción imagen 2]]
      </div>
    </td>
  </tr>
</table>


<b>📍 Ubicación del archivo descargado:</b><br>
De forma predeterminada, el archivo se almacena en la carpeta <b>Descargas</b> del equipo.  
En caso de que el navegador solicite una ubicación, podrá elegirse cualquier carpeta de preferencia.


  <div style="background-color:#E6F7FF; border:1px dashed #7AA0FF; border-radius:6px; padding:10px; margin-top:10px; font-size:13px; color:#333;">
<b>ℹ️ Nota sobre el formato <span style="color:#2A6EBB;">.xlsm</span>:</b>  
Este formato corresponde a un archivo de <b>Microsoft Excel</b> que, además de hojas y fórmulas, puede                        contener <b>macros</b> 🛠️ (pequeños programas o automatizaciones que agilizan tareas repetitivas).  
Este tipo de archivo resulta útil para validar datos, aplicar formatos predefinidos y asegurar que la información cumpla con la estructura requerida antes de su carga al sistema.
  </div>


<div style="border:2px solid #7AA0FF; border-radius:8px; padding:15px; background-color:#F4FAFF; font-family:Arial, sans-serif; font-size:14px; line-height:1.5;">

<table style="width:100%; border-collapse:collapse; border:none; background:none;">
  <tr>
    <td style="width:50%; vertical-align:top; padding-right:20px;">

<b style="color:#2A6EBB; font-size:16px;">📂 Abrir la plantilla y habilitar macros</b><br><br>

<b>1️⃣ Abrir el archivo:</b><br>
- Localice el archivo descargado <b>.xlsm</b> en su carpeta <b>Descargas</b> (o en la ubicación que haya elegido).<br>
- Puede abrirlo haciendo doble clic sobre el archivo o con <i>clic derecho → Abrir</i>.<br><br>

<b>2️⃣ Habilitar macros para su uso:</b><br>
Al abrirlo, Excel puede mostrar una franja amarilla en la parte superior con el mensaje <i>“Habilitar contenido”</i>.<br>
➡️ Haga clic en <b style="color:#2A6EBB;">Habilitar contenido</b> para activar las macros y permitir que la plantilla funcione correctamente.<br><br>

<b>💡 Nota:</b> Si no aparece la franja amarilla, puede habilitar las macros manualmente:<br>
1. Vaya a <b>Archivo → Opciones</b>.<br>
2. Seleccione <b>Centro de confianza → Configuración del Centro de confianza</b>.<br>
3. Abra <b>Configuración de macros</b> y elija <i>Deshabilitar con notificación</i> o <i>Habilitar todas las macros.</i><br><br>

    </td>
    <td style="width:50%; text-align:center; vertical-align:middle;">
      <div style="display:inline-block; border: 1px solid #c0dffb; border-radius: 8px; padding:8px; background-color:#ffffff; box-shadow: 2px 2px 8px rgba(0,0,0,0.1);">
        [[Archivo:rips72.png|700px|center|alt=Abrir plantilla y habilitar macros]]
      </div>
    </td>
  </tr>
</table>


<div style="border:1px solid #FF9999; border-radius:6px; background-color:#FFF5F5; padding:8px; color:#B22222;">
<b>⚠️ Advertencia de seguridad:</b> Solo habilite macros en archivos provenientes de fuentes confiables. Las macros pueden ejecutar código que modifique o dañe su equipo.
</div>
</div>


= 🏥 Plantilla para la carga masiva de RIPS (TFHKA v1.1) =

La '''Plantilla TFHKA v1.1''' es un archivo de Excel con macros habilitadas (''.xlsm'') diseñado de acuerdo con la '''Resolución 2275 de 2023''' del Ministerio de Salud y Protección Social.  

📌 Esta plantilla funciona como '''herramienta de apoyo para la carga masiva de RIPS''':  
en lugar de registrar uno por uno en el portal, permite consolidar la información en un solo archivo y cargarla de forma más rápida y ordenada.  
<br><br>
{{{!}} style="background:#e8f6ef; border:1px solid #00897b; border-radius:8px; width:100%;"
|-
! ⚠️ Importante
| Por '''cada factura de venta''' se debe diligenciar un archivo de la plantilla.  
En ese archivo se relacionan todos los '''RIPS''' asociados a la factura.  
{{!}}}


=== 📑 Estructura de la plantilla ===

La plantilla contiene '''9 pestañas''', cada una dedicada a un tipo específico de información:  

• <span style="background-color:#bbdefb; color:#0d47a1; font-weight:bold; padding:2px 4px; border-radius:4px;">📄 Transacción</span>: Se registran los datos generales de la factura: NIT de la entidad, número de factura y, si aplica, el tipo y número de nota (crédito, débito o ajuste).  

• <span style="background-color:#dcedc8; color:#1b5e20; font-weight:bold; padding:2px 4px; border-radius:4px;">🧑‍🤝‍🧑 Usuarios</span>: Aquí va la información de los pacientes: tipo y número de identificación, fecha de nacimiento, sexo y condición del usuario.  

• <span style="background-color:#bbdefb; color:#0d47a1; font-weight:bold; padding:2px 4px; border-radius:4px;">👩‍⚕️ Consultas</span>: Se detallan las atenciones médicas, odontológicas, de enfermería y de otros profesionales de la salud.  

• <span style="background-color:#bbdefb; color:#0d47a1; font-weight:bold; padding:2px 4px; border-radius:4px;">🚑 Urgencias</span>: Aquí se registran las atenciones de urgencia que implicaron observación del paciente.  

• <span style="background-color:#c8e6c9; color:#1b5e20; font-weight:bold; padding:2px 4px; border-radius:4px;">🔬 Procedimientos</span>: Se incluyen los procedimientos diagnósticos, terapéuticos, quirúrgicos, no quirúrgicos y la aplicación de vacunas.  

• <span style="background-color:#c8e6c9; color:#1b5e20; font-weight:bold; padding:2px 4px; border-radius:4px;">🏥 Hospitalización</span>: Registra los datos sobre la estancia del usuario en servicios de hospitalización.  

• <span style="background-color:#e1bee7; color:#4a148c; font-weight:bold; padding:2px 4px; border-radius:4px;">👶 Recién Nacidos</span>: Se diligencia cuando se atienden partos o cesáreas, registrando la información del recién nacido vinculada a la factura de la madre.  

• <span style="background-color:#c8e6c9; color:#1b5e20; font-weight:bold; padding:2px 4px; border-radius:4px;">💊 Medicamentos</span>: Aquí se reportan los medicamentos administrados o dispensados, indicando código, cantidad y valor.  

• <span style="background-color:#bbdefb; color:#0d47a1; font-weight:bold; padding:2px 4px; border-radius:4px;">🛠️ Otros Servicios</span>: Se registran los servicios complementarios facturados: dispositivos médicos, insumos, honorarios profesionales, estancias adicionales y traslados.  

<div style="text-align:center; margin:20px 0;">
<div style="display:inline-block; border:1px solid #c0dffb; border-radius:8px; padding:10px; background-color:#f4faff; box-shadow:2px 2px 8px rgba(0,0,0,0.1);">
[[Archivo:rips73.png|800px]]
  </div>
</div>

<div style="border:1px solid #7e57c2; background:#f3e5f5; padding:12px; border-radius:8px; font-size:95%;">
✨ Con esta plantilla, la información de los RIPS queda organizada de forma estandarizada, reduciendo errores y agilizando la validación frente a la normatividad vigente.  
</div>
<p style="margin:9px 0;"></p>


== 📝 Recomendaciones ==

📂 '''Archivo a cargar'''  

• Formato obligatorio: '''XLSM''' (Excel con macros).  

• Tamaño máximo permitido: '''3 MB'''.  


🔑 '''Campo <code>ripsId</code>'''  

• Es una columna adicional que conecta ''Transacción'', ''Usuarios'' y ''Servicios''.  

•'''Crear RIPS nuevos:''' use números consecutivos (1, 2, 3…).  


👉 Cada transacción debe tener al menos un usuario, y cada usuario y servicio debe estar vinculado con el mismo <code>ripsId</code>.  


⚙️ '''Diligenciamiento paso a paso'''  

1️⃣ Inicie en la pestaña '''Transacción''' (factura asociada).  

2️⃣ Complete la pestaña '''Usuarios''' (datos del paciente). 
 
3️⃣ Diligencie las pestañas de '''Servicios''' (consultas, urgencias, medicamentos, hospitalización, etc.).  


🗂️ '''Orden sugerido'''  

• Seleccionar <code>consecutivoUsuario</code>. 

• Diligenciar los demás campos.  

<hr style="border: 0; height: 2px; background: linear-gradient(to right, #2B6CB0, #38A169, #D69E2E, #E53E3E); margin: 1em 0;" />

<div style="font-size: 14px; line-height: 1.6em;">


ℹ️ En las secciones siguientes se presenta la explicación de las tres primeras pestañas de la plantilla —<span style="color:#2B6CB0; font-weight:bold;">Transacciones</span>, <span style="color:#2B6CB0; font-weight:bold;">Usuarios</span> y <span style="color:#2B6CB0; font-weight:bold;">Consultas</span>— junto con cuatro campos de la pestaña de <span style="color:#2B6CB0; font-weight:bold;">Procedimientos</span> que difieren de los de Consultas.  

A continuación, se detallan los campos de estas pestañas, con ejemplos que facilitan su comprensión y diligenciamiento.  

Las demás pestañas conservan la misma dinámica de registro, por lo que su uso resulta <span style="color:#38A169; font-weight:bold;">sencillo e intuitivo</span> siempre que se cuente con la información necesaria.  

<div style="margin:1em 0;"></div>

La plantilla que se utiliza corresponde a la definida por el <span style="color:#805AD5; font-weight:bold;">Ministerio de Salud</span> ([https://fevrips.sispro.gov.co/SPConvertidorJSON plantilla_fev-rips_v 1_0]), con algunas <span style="color:#D69E2E; font-weight:bold;">columnas adicionales</span> que hemos incluido para facilitar la identificación de los datos al momento de realizar la carga en el portal.  

<div style="margin:1em 0;"></div>

Toda la información registrada se basa en el <span style="color:#E53E3E; font-weight:bold;">Anexo Técnico de RIPS</span>:  
''[https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/DIJ/resolucion-2275-de-2023.pdf Resolución 2275 del 28 de diciembre de 2023]'' – ''[https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/DIJ/resolucion-1884-de-2024.pdf Resolución 1884 del 30 de septiembre de 2024]'', conforme al lineamiento oficial más reciente – <span style="color:#2F855A; font-weight:bold;">[https://www.minsalud.gov.co/sites/rid/Lists/BibliotecaDigital/RIDE/DE/OT/lineamientos-generacion-validacion-rips-factura-electronica-fev-doc-electronicos.pdf versión 3.2]</span>.  

<div style="margin:1.5em 0;"></div>

<div style="font-size:16px; font-weight:bold; color:#20C997; margin:0.5em 0;">📑 '''''TRANSACCIÓN'''''</div>

<div style="text-align:center; margin:1em 0;">
<div style="display:inline-block; border:2px solid #20C997; background:#f9fdfb; padding:6px; border-radius:10px; box-shadow:0 2px 6px rgba(0,0,0,0.1);">
[[Archivo:Rips74.png|600px]]
  </div>
</div>
<div style="margin:1.5em 0;"></div>
{| class="mw-collapsible mw-collapsed" style="margin:auto; width:95%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff;"
! style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px;" | Campos de la pestaña Transacciones
|-
| style="padding:5px;" |

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''numDocumentoIdObligado'''</code><br>
  Número de identificación del prestador de servicios de salud. Permite asociar correctamente todas las transacciones con la entidad que reporta.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''numFactura'''</code><br>
  Número de la factura cuando el RIPS está asociado a una Factura Electrónica de Venta (FEV). Ejemplo: `FEV123`. Si no hay factura, no se diligencia.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''tipoNota'''</code><br>
  Se diligencia cuando el RIPS corresponde a un registro sin factura. Opciones disponibles:

{| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:center; width:28%; font-size:85%; border:1.5px solid #2B6CB0; border-radius:6px; background:#fdfefe; border-spacing:0;"
! style="background:#2B6CB0; color:white; padding:3px; width:30%; border-top-left-radius:6px;" | Código 
! style="background:#2B6CB0; color:white; padding:3px; width:70%; border-top-right-radius:6px;" | Descripción
|-
| '''NA''' || Nota de Ajuste
|-
| '''NC''' || Nota Crédito
|-
| '''ND''' || Nota Débito
|-
| '''RS''' || RIPS sin factura
|}

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''numNota'''</code><br>
  Número consecutivo (1,2,3,…) cuando se envían RIPS sin factura electrónica. Aplica en casos de EOSD o Profesionales Independientes que no están obligados a facturar.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''ripsId'''</code><br>
  Identificador que enlaza las pestañas "Transacciones", "Usuarios" y "Servicios". Cada número consecutivo asegura correcta relación entre registros.
|}

<div style="margin:1.5em 0;"></div>
<div style="font-size:16px; font-weight:bold; color:#20C997; margin:0.5em 0;">👤 '''''USUARIOS'''''</div>

En esta pestaña se guardan los datos básicos del usuario: identificación, información personal y administrativa que permiten reconocerlo dentro de los RIPS. Si se llena bien, cada atención quedará vinculada al paciente correcto.

<div style="border:1.5px solid #E6A400; background:#FFF8E5; padding:8px; border-radius:8px; width:60%; margin:auto; text-align:center; font-size:90%;">
⚠️ <b>Nota:</b> Verifique que la fecha de nacimiento coincida con el tipo de documento según la edad del usuario.
</div>

<div style="margin:1.5em 0;"></div>

{| class="mw-collapsible mw-collapsed" style="margin:auto; width:95%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff;"
! style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px;" | Campos de la pestaña Usuarios
|-
| style="padding:5px;" |

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''TipoDocumentoIdentificacion'''</code><br>
  Seleccione el tipo de documento del usuario desde la lista desplegable. Para elegir correctamente, consulte la tabla con cada código y su significado.

{| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:left; width:30%; font-size:80%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff; border-spacing:0;"
! colspan="2" style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px; border:none;" | Tipos de Documento
|-
| style="border:none; padding:3px;" | '''AS''' || style="border:none; padding:3px;" | Adulto sin identificación
|-
| style="border:none; padding:3px;" | '''CC''' || style="border:none; padding:3px;" | Cédula de Ciudadanía
|-
| style="border:none; padding:3px;" | '''CD''' || style="border:none; padding:3px;" | Carnet Diplomático
|-
| style="border:none; padding:3px;" | '''CE''' || style="border:none; padding:3px;" | Cédula de Extranjería
|-
| style="border:none; padding:3px;" | '''CN''' || style="border:none; padding:3px;" | Certificado de nacido vivo
|-
| style="border:none; padding:3px;" | '''DE''' || style="border:none; padding:3px;" | Documento extranjero
|-
| style="border:none; padding:3px;" | '''MS''' || style="border:none; padding:3px;" | Menor sin identificación
|-
| style="border:none; padding:3px;" | '''NI''' || style="border:none; padding:3px;" | Número de Identificación Tributario (NIT)
|-
| style="border:none; padding:3px;" | '''NV''' || style="border:none; padding:3px;" | Certificado nacido vivo
|-
| style="border:none; padding:3px;" | '''PA''' || style="border:none; padding:3px;" | Pasaporte
|}

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''numDocumentoIdentificacion'''</code><br>
  Número de identificación del usuario, según el tipo de documento seleccionado.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''NumDocumentoIdObligado'''</code><br>
  Este campo replica la información registrada en <code>numDocumentoIdObligado</code> de la pestaña ''TRANSACCIÓN''.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''tipoUsuario'''</code><br>
  Seleccione de la lista desplegable el tipo de usuario correspondiente. Las opciones disponibles se encuentran en la tabla siguiente:

{| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:left; width:30%; font-size:80%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff; border-spacing:0;"
! colspan="2" style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px; border:none;" | Tipos de Usuario
|-
| style="border:none; padding:3px; width:20%;" | '''01''' || style="border:none; padding:3px;" | Contributivo cotizante
|-
| style="border:none; padding:3px;" | '''02''' || style="border:none; padding:3px;" | Contributivo beneficiario
|-
| style="border:none; padding:3px;" | '''03''' || style="border:none; padding:3px;" | Contributivo adicional
|-
| style="border:none; padding:3px;" | '''04''' || style="border:none; padding:3px;" | Subsidiado
|-
| style="border:none; padding:3px;" | '''05''' || style="border:none; padding:3px;" | No afiliado
|-
| style="border:none; padding:3px;" | '''06''' || style="border:none; padding:3px;" | Especial o Excepción cotizante
|-
| style="border:none; padding:3px;" | '''07''' || style="border:none; padding:3px;" | Especial o Excepción beneficiario
|-
| style="border:none; padding:3px;" | '''08''' || style="border:none; padding:3px;" | Personas privadas de la libertad a cargo del Fondo Nacional de Salud
|-
| style="border:none; padding:3px;" | '''09''' || style="border:none; padding:3px;" | Tomador / Amparado ARL
|-
| style="border:none; padding:3px;" | '''10''' || style="border:none; padding:3px;" | Tomador / Amparado SOAT
|-
| style="border:none; padding:3px;" | '''11''' || style="border:none; padding:3px;" | Tomador / Amparado Planes voluntarios de salud
|-
| style="border:none; padding:3px;" | '''12''' || style="border:none; padding:3px;" | Particular
|-
| style="border:none; padding:3px;" | '''13''' || style="border:none; padding:3px;" | Especial o Excepción no cotizante Ley 352 de 1997
|}

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''fechaNacimiento'''</code><br>
  Ingrese la fecha en el formato '''AAAA-MM-DD'''. Ejemplo: <code>2002-07-11</code>.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''codSexo'''</code><br>
  Seleccione el sexo de la persona: '''M''' = Masculino · '''F''' = Femenino · '''I''' = Indeterminado / Intersexual

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">CodPaisResidencia</code><br>
  Corresponde al código del país de residencia habitual. Por defecto se puede seleccionar el código '''170 (Colombia)'''. Más info: '''[[Media:Pais.xlsx|País]]''' o '''[https://web.sispro.gov.co/WebPublico/Consultas/ConsultarDetalleReferenciaBasica.aspx?Code=Pais SISPRO: País]'''.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''codMunicipioResidencia'''</code><br>
  Registre el código del municipio donde la persona ha residido la mayor parte del último año. Referencia: '''[[Media:municipio.xlsx|Municipios]]''' o portal SISPRO: [https://web.sispro.gov.co/WebPublico/Consultas/ConsultarDetalleReferenciaBasica.aspx?Code=Municipio Municipio].

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''codZonaTerritorialResidencia'''</code><br>
  Indica la zona de residencia según el DANE. Opciones en tabla:

{| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:left; width:30%; font-size:80%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff; border-spacing:0;"
! colspan="2" style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px; border:none;" | Zona Territorial
|-
| style="border:none; padding:3px;" | '''01''' || style="border:none; padding:3px;" | Rural
|-
| style="border:none; padding:3px;" | '''02''' || style="border:none; padding:3px;" | Urbano
|}

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''Incapacidad'''</code><br>
  Seleccione ''SI'' o ''NO''. Dato soportado en el RIPS.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''codPaisOrigen'''</code><br>
  Código del país de nacimiento, por ejemplo ''170'' = Colombia.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''consecutivo'''</code><br>
  Número que identifica cada registro, inicia en 1 y aumenta de uno en uno.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''nombre'''</code><br>
  Nombre del usuario según documento, sin abreviaturas ni caracteres especiales.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''apellido'''</code><br>
  Apellido según documento.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''ripsId'''</code><br>
  Identificador que enlaza las pestañas "Transacción", "Usuarios" y "Servicios". Cada número consecutivo asegura correcta relación entre registros.
|}

<div style="margin:1.5em 0;"></div>

<div style="font-size:16px; font-weight:bold; color:#20C997; margin:0.5em 0;">🩺 '''''CONSULTAS'''''</div>

{| class="mw-collapsible mw-collapsed" style="margin:auto; width:95%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff;"
! style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px;" | Campos de la pestaña Consultas
|-
| style="padding:5px;" |

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''num_DocumentoIdObligado'''</code><br>
  Este valor se completa con el número de identificación del prestador, traído desde la pestaña '''Transacción'''.  

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''consecutivoUsuario'''</code><br>
  Digite aquí el consecutivo asignado en la pestaña '''Usuarios'''.  
  Al ingresarlo, automáticamente se relaciona con '''num_DocumentoIdObligado''', enlazando ambas pestañas.  

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''CodPrestador'''</code><br>
 Ingrese el código que el Ministerio de Salud y Protección Social asignó al prestador de servicios de salud o al responsable de reportar.
 Este código se vincula automáticamente con '''numDocumentoIdObligado''', asegurando la relación correcta entre la información del prestador y los datos del obligado.

* 📅 → <b>Campo:</b> <code style="color:#B266FF;">'''FechaInicioAtencion'''</code><br>
 Digite la fecha y hora en que se realizó la consulta o atención.
 Esta fecha no puede ser posterior al momento de validación de los RIPS, ni anterior a la fecha de nacimiento del usuario, y debe estar dentro del periodo de facturación registrado en la factura electrónica.
 Formato: '''aaaa-mm-dd hh:mm''' (ejemplo: 2025-07-19 00:00).

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''numAutorizacion'''</code><br>
 Ingrese el número que la entidad responsable de pago asignó para autorizar la prestación del servicio o la provisión de la tecnología de salud.
 Si el servicio no requiere autorización, registre '''NA''' (no aplica).

* 📄 → <b>Campo:</b> <code style="color:#B266FF;">'''codConsulta'''</code><br>
 Digite el código de la consulta según la Clasificación Única de Procedimientos en Salud ⇒ CUPS. Puede consultar la tabla oficial en SISPRO: '''[https://web.sispro.gov.co/WebPublico/Consultas/ConsultarDetalleReferenciaBasica.aspx?Code=CUPSRips CUPSRips]''' O descargarla directamente del archivo:  '''[[Media:CUPSRips.xlsx|CUPSRips]]'''

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''modalidadGrupoServicioTecSalud'''</code><br>
 Digite el código que indica la forma en que se presta el servicio de salud dentro de un grupo de servicios. Puede guiarse con la tabla oficial:
  {| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:left; width:30%; font-size:80%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff; border-spacing:0;"
! colspan="2" style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px;" | Modalidad de Servicio
|-
| style="border:none; padding:5px 10px;" | '''01''' || style="border:none; padding:3px;" | Intramural
|-
| style="border:none; padding:5px 10px;" | '''02''' || style="border:none; padding:3px;" | Extramural unidad móvil
|-
| style="border:none; padding:5px 10px;" | '''03''' || style="border:none; padding:3px;" | Extramural domiciliaria
|-
| style="border:none; padding:5px 10px;" | '''04''' || style="border:none; padding:3px;" | Extramural jornada de salud
|-
| style="border:none; padding:5px 10px;" | '''06''' || style="border:none; padding:3px;" | Telemedicina interactiva
|-
| style="border:none; padding:5px 10px;" | '''07''' || style="border:none; padding:3px;" | Telemedicina no interactiva
|-
| style="border:none; padding:5px 10px;" | '''08''' || style="border:none; padding:3px;" | Telemedicina telexperticia
|-
| style="border:none; padding:5px 10px;" | '''09''' || style="border:none; padding:3px;" | Telemedicina telemonitoreo
|}

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''grupoServicios'''</code><br>
 Digite el código que identifica un conjunto de servicios relacionados entre sí, que comparten similitudes en la forma de prestación y cumplen los mismos estándares.
 Puede guiarse con la tabla:
  {| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:left; width:30%; font-size:80%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff; border-spacing:0;"
! colspan="2" style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px;" | Grupo de Servicios
|-
| style="border:none; padding:5px 10px;" | '''01''' || style="border:none; padding:3px;" | Consulta externa
|-
| style="border:none; padding:5px 10px;" | '''02''' || style="border:none; padding:3px;" | Apoyo diagnóstico y complementación terapéutica
|-
| style="border:none; padding:5px 10px;" | '''03''' || style="border:none; padding:3px;" | Internación
|-
| style="border:none; padding:5px 10px;" | '''04''' || style="border:none; padding:3px;" | Quirúrgico
|-
| style="border:none; padding:5px 10px;" | '''05''' || style="border:none; padding:3px;" | Atención inmediata
|}
<div style="margin:1.5em 0;"></div>

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''codServicio'''</code><br>
 Digite el código que identifica la unidad básica de atención autorizada, incluyendo procesos, actividades, personal, infraestructura y tecnología, todo orientado a garantizar la seguridad del paciente. Puede guiarse con la tabla: '''[[Media:codServicio.xlsx|codServicio]]''' O consultar el registro oficial en SISPRO: '''[https://web.sispro.gov.co/WebPublico/Consultas/ConsultarDetalleReferenciaBasica.aspx?Code=Servicios Servicios]'''

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''finalidadTecnologiaSalud'''</code><br>
 Digite el código que indica la finalidad con la que se realiza la consulta o prestación de la tecnología en salud. Puede guiarse con la tabla: '''[[Media:FinalidadConsulta.xlsx|FinalidadConsulta]]''' O consultar el registro oficial en SISPRO: '''[https://web.sispro.gov.co/WebPublico/Consultas/ConsultarDetalleReferenciaBasica.aspx?Code=RIPSFinalidadConsultaVersion2 FinalidadConsulta]'''

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''causaMotivoAtencion'''</code><br>
 Digite el código que indica la causa o motivo que originó la consulta o prestación del servicio de salud. Puede guiarse con la tabla: '''[[Media:causaMotivoAtencion.xlsx|causaMotivoAtencion]]''' O consultar el registro oficial en SISPRO: '''[https://web.sispro.gov.co/WebPublico/Consultas/ConsultarDetalleReferenciaBasica.aspx?Code=RIPSCausaExternaVersion2 Causa Motivo Atencion]'''

* 📄 → <b>Campo:</b> <code style="color:#B266FF;">'''codDiagnosticoPrincipal'''</code><br>
 Digite el código CIE del diagnóstico principal del paciente, ya sea confirmado o sospechado. Puede guiarse con la tabla: '''[[Media:CIE10.xlsx|CIE10]]''' O consultar el registro oficial en SISPRO: '''[https://web.sispro.gov.co/WebPublico/Consultas/ConsultarDetalleReferenciaBasica.aspx?Code=CIE10 CIE10]'''

* 📄 → <b>Campo:</b> <code style="color:#B266FF;">'''codDiagnosticoRelacionado 1,2,3'''</code><br>
 Digite los códigos CIE de los diagnósticos relacionados con el principal. Pueden estar confirmados o solo sospechados, y su diligenciamiento no siempre es obligatorio.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''tipoDiagnosticoPrincipal'''</code><br>
 Seleccione el identificador que indica si el diagnóstico principal es confirmado o presuntivo. Puede guiarse con la siguiente tabla:
{| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:left; width:30%; font-size:80%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff; border-spacing:0;"
! colspan="2" style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px;" | Tipo de Diagnóstico
|-
| style="border:none; padding:5px 10px;" | '''01''' || style="border:none; padding:3px;" | Impresión diagnóstica
|-
| style="border:none; padding:5px 10px;" | '''02''' || style="border:none; padding:3px;" | Confirmado nuevo
|-
| style="border:none; padding:5px 10px;" | '''03''' || style="border:none; padding:3px;" | Confirmado repetido
|}
<div style="margin:1.5em 0;"></div>

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''tipoDocumentoIdentificacion'''</code><br>
 Indique el tipo de documento de identificación de la persona que realizó la consulta. Seleccione la opción que mejor coincida con su registro, para que la información quede correcta y completa. Puede guiarse con la tabla:
  {| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:left; width:30%; font-size:80%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff; border-spacing:0;"
! colspan="2" style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px;" | Tipo de Documento
|-
| style="border:none; padding:5px 10px;" | '''AS''' || style="border:none; padding:3px;" | Adulto sin identificación
|-
| style="border:none; padding:5px 10px;" | '''CC''' || style="border:none; padding:3px;" | Cédula de Ciudadanía
|-
| style="border:none; padding:5px 10px;" | '''CD''' || style="border:none; padding:3px;" | Carnet Diplomático
|-
| style="border:none; padding:5px 10px;" | '''CE''' || style="border:none; padding:3px;" | Cédula de Extranjería
|-
| style="border:none; padding:5px 10px;" | '''CN''' || style="border:none; padding:3px;" | Certificado nacido vivo
|-
| style="border:none; padding:5px 10px;" | '''DE''' || style="border:none; padding:3px;" | Documento extranjero
|-
| style="border:none; padding:5px 10px;" | '''MS''' || style="border:none; padding:3px;" | Menor sin identificación
|-
| style="border:none; padding:5px 10px;" | '''NI''' || style="border:none; padding:3px;" | Número de identificación tributario NIT
|-
| style="border:none; padding:5px 10px;" | '''NV''' || style="border:none; padding:3px;" | Certificado nacido vivo
|-
| style="border:none; padding:5px 10px;" | '''PA''' || style="border:none; padding:3px;" | Pasaporte
|-
| style="border:none; padding:5px 10px;" | '''PE''' || style="border:none; padding:3px;" | Permiso Especial de Permanencia
|-
| style="border:none; padding:5px 10px;" | '''PT''' || style="border:none; padding:3px;" | Permiso por protección temporal
|-
| style="border:none; padding:5px 10px;" | '''RC''' || style="border:none; padding:3px;" | Registro civil
|-
| style="border:none; padding:5px 10px;" | '''SC''' || style="border:none; padding:3px;" | Salvoconducto
|-
| style="border:none; padding:5px 10px;" | '''SI''' || style="border:none; padding:3px;" | Sin identificación
|-
| style="border:none; padding:5px 10px;" | '''TI''' || style="border:none; padding:3px;" | Tarjeta de Identidad
|}
<div style="margin:1.5em 0;"></div>

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''numDocumentoIdentificacion'''</code><br>
  Digite el número del documento de identificación de la persona que realizó la consulta, asegurándose de que coincida con el tipo de documento seleccionado.

* 💰 → <b>Campo:</b> <code style="color:#B266FF;">'''vrServicio'''</code><br>
  Ingrese el valor de la consulta, de acuerdo con el manual tarifario vigente o la tarifa acordada entre las partes.

* 📄 → <b>Campo:</b> <code style="color:#B266FF;">'''conceptoRecaudo'''</code><br>
 Seleccione el tipo de pago moderador correspondiente, según el plan de beneficios o la póliza adquirida. Puede guiarse con la siguiente tabla:
  {| class="mw-collapsible mw-collapsed" style="margin:auto; text-align:left; width:30%; font-size:80%; border:1.5px solid #4A90E2; border-radius:8px; background:#f9fbff; border-spacing:0;"
! colspan="2" style="background:#4A90E2; color:white; text-align:center; border-top-left-radius:8px; border-top-right-radius:8px;" | Concepto de Recaudo
|-
| style="border:none; padding:5px 10px;" | '''01''' || style="border:none; padding:3px;" | Copago
|-
| style="border:none; padding:5px 10px;" | '''02''' || style="border:none; padding:3px;" | Cuota moderadora
|-
| style="border:none; padding:5px 10px;" | '''03''' || style="border:none; padding:3px;" | Pagos compartidos en planes voluntarios de salud
|-
| style="border:none; padding:5px 10px;" | '''05''' || style="border:none; padding:3px;" | No aplica
|}
<div style="margin:1.5em 0;"></div>

* 💰 → <b>Campo:</b> <code style="color:#B266FF;">'''valorPagoModerador'''</code><br>
  Ingrese el valor del pago moderador correspondiente. Si no aplica pago moderador, registre '''0'''.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''numFEVPagoModerador'''</code><br>
  Digite el número de la factura electrónica de venta emitida al usuario que respalda el valor registrado en '''valorPagoModerador''', o la información proporcionada por la entidad responsable de pago.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''consecutivo'''</code><br>
  Digite el número consecutivo que identifica este registro, asegurando el orden correcto de la información.

* 🟢 → <b>Campo:</b> <code style="color:#B266FF;">'''ripsId'''</code><br>
  Ingrese el identificador que permite relacionar la información de esta consulta con las pestañas de '''Usuarios''' y '''Transacción'''.
|}



</div>



</div>




</div>


</div>