A23-Tsi 7

INTERCAMBIO ELECTRÓNICO DE REGISTROS
ENTRE IPS – SALUD TOTAL EPS-S
Reciba un cordial saludo en nombre de Salud Total EPS-S y el agradecimiento por ser un
aliado en la misión de brindar servicios de salud con calidad total a nuestros usuarios y sus
familias.
Gracias a nuestro portal, www.saludtotal.com.co, nuestros procesos se han hecho más

ágiles y presentamos una imagen dinámica, fresca y en sintonía con el modelo de
atención que nos ha ratificado como una de las Entidades Promotoras de salud con
mayor número de afiliados.
Las IPS también podrán disfrutar de las ventajas que brinda Internet. Por eso, tenemos el
gusto de informarles que usted podrá realizar las siguientes transacciones a través de
nuestro portal WEB sin necesidad de acudir a llamadas telefónicas, entrega de soportes,
entrega de resultados que aumenta los costos y tiempos de espera de los pacientes:
1. Transferencia Electrónica de registros de Facturación

2. Transferencia de resultados de apoyo diagnóstico a Historia clínica de Salud
Total.
3. A P I Autorizaciones WEB.
4. Utilización de Servicios a través de Web Service
A continuación se relaciona los objetivos, descripción del proceso y anexo técnico para
poder utilizar cada una de estas opciones que se encuentran ya en funcionamiento en la
comunidad de Profesionales de la Salud e IPS.
1
CONTENIDO
1 TRANSFERENCIA ELECTRÓNICA DE REGISTROS DE FACTURACIÓN...........................................................4

1.1 Objetivos............................................................................................................................................4
1.2 Beneficios para la IPS.........................................................................................................................4
1.3 Proceso..............................................................................................................................................5
2 TRANSFERENCIA DE RESULTADOS DE APOYO DIAGNÓSTICO A LA HISTORIA CLÍNICA DE SALUD TOTAL..8
2.1 Objetivos............................................................................................................................................8
2.2 Beneficios para la IPS.........................................................................................................................8
2.3 Proceso..............................................................................................................................................8
3 API AUTORIZACIONES WEB.....................................................................................................................10
3.1 Objetivos..........................................................................................................................................10
3.2 Beneficios para la IPS.......................................................................................................................10
3.3 Especificaciones Técnicas................................................................................................................10
4 UTILIZACIÓN DE SERVICIOS A TRAVÉS DE WEB SERVICE.........................................................................11
4.1 Objetivo...........................................................................................................................................11
4.2 Beneficios para la IPS.......................................................................................................................11
4.3 Especificaciones Técnicas................................................................................................................11
5 ANEXO No. 1...........................................................................................................................................12
5.1 Prevalidación de NAPS.....................................................................................................................12
5.2 Prevalidación de NAPS.....................................................................................................................17
6 ANEXO No. 2...........................................................................................................................................29
6.1 Método IniciarSesión:......................................................................................................................29
6.2 Método para enviar resultados:......................................................................................................30
6.3 Registro de laboratorios seriados....................................................................................................33
6.4 Estructura del XML a enviar:............................................................................................................34
6.5 Información Técnica para el reporte de ayudas diagnosticas por FTP.............................................38
7 ANEXO No. 3...........................................................................................................................................39
7.1 Token {Get}......................................................................................................................................39
7.2 ConsultaConvenioxIPSWEB {GET}....................................................................................................40
7.3 ConsultaAfiliadoxDocumento {GET}.................................................................................................44
7.4 ConsultaOrigenAtencion {GET}........................................................................................................47
7.5 ConsultaSede {GET}.........................................................................................................................49
2
7.6 SolicitudAutorizacion {GET}.............................................................................................................51
7.7 ConsultaServiciosLiberar {GET}........................................................................................................63
7.8 SolicitudLiberacion {GET}.................................................................................................................65
7.9 ConsultaAccionEntregaParcial {GET}................................................................................................68
7.10 ConsultaMotivoEntregaParcial {GET}.............................................................................................70
7.11 SolicitudLiberacionV1 {GET}...........................................................................................................72
8 ANEXO No. 4...........................................................................................................................................75
8.1 Método IniciarSesión.......................................................................................................................76
8.2 Consultar Autorizaciones por Cédula...............................................................................................77
8.3 Consultar autorizaciones por afiliado..............................................................................................81
8.4 Liberar NAP......................................................................................................................................85
8.5 Consultar por NAP...........................................................................................................................86
8.6 Consultar NAP Entregado................................................................................................................90
8.7 Consultar Prescripción.....................................................................................................................94
8.8 Consultar Acción Entrega Parcial.....................................................................................................98
8.9 Consultar Motivo Entrega Parcial....................................................................................................98
8.10 Liberar NAP V1...............................................................................................................................99
9 Tablas Referencia..................................................................................................................................101
9.1 Tabla 1 – Productos.......................................................................................................................101
9.2 Tabla 2 – Tipo Autorización............................................................................................................102
9.3 Tabla 3 - Unidades de Medida.......................................................................................................103
9.4 Tabla 4 - Unidades de Medida de Tiempo.....................................................................................105
9.5 Tabla 5 - Vías de Administración....................................................................................................105
10 ERRORES.............................................................................................................................................107
3
1 TRANSFERENCIA ELECTRÓNICA DE REGISTROS DE FACTURA-
CIÓN
1.1 Objetivos
 Implementar un sistema que permita la integración del proceso de facturación

entre las IPS y Salud Total EPS.
 Realizar una validación de los servicios autorizados por Salud Total,

permitiendo a la IPS identificar NAPS no válidos.
 La facturación de la IPS se radica y registra electrónicamente a través de

archivos planos tendiendo a la disminución de costos en el proceso de
facturación como entrega de soportes y anexos.
1.2 Beneficios para la IPS
Verificación con el sistema autorizador de Salud Total si los servicios prestados han
sido autorizados por Salud Total.
Disminución de la Glosa por servicios con número de autorización mal digitado o
no válidos.
Disminución de los errores en la digitación de los servicios. Disminución de costos por
administración de cero papeles.
4
1.3 Proceso
Ingreso a opción transaccional de la página WEB salud total donde encontrará

las siguientes opciones:
En el Manual de usuario transferencia electrónica de facturación (MU07-CS), se

encuentra el manual de utilización de la opción y los datos requeridos para solicitar el
usuario y la clave de acceso a las opciones transaccionales de la comunidad
Profesionales de la Salud e IPS.
Este proceso de trasmisión electrónica de registros de facturación está divido en dos

partes:
5
 Prevalidación de Nap
 Facturación de Servicios.
Prevalidación de Nap.
Este proceso recibe un solo archivo con la estructura explicada en el Anexo 1.

(Estructura de Integración Ips-Eps). Permite realizar la validación de los números de
autorización que la IPS ha solicitado para la prestación del servicio. La respuesta
de los Número de autorización que están correctos o no y una breve explicación serán
entregados vía correo electrónico en un archivo.
Este proceso envía 3 archivos de respuesta así:
Archivo en el cual se envían los números de autorizaciones correctos o incorrectos.

Este archivo se identifica porque el nombre termina en: _Rpta.zip.
Los registros que no cumplen con los requerimientos mínimos se envía en un archivo
con terminación: _ErrEst.zip.
Los números de autorización que están correctos se envían en el archivo con
terminación:
_NapOk.zip
La descripción de cada uno de los archivo la encuentra en el anexo 1 (Estructura

de
Integración Ips-Eps)
Es importante que siempre le asigne un nombre diferente al archivo enviado por
Internet, es decir por fecha de validación, concepto o Factura entre otros.
Por Ejemplo. Como sugerencia prenap_Am_10_1_2007_13_15.txt, lo cual describe:
6
prenap : Proceso
Am : Tipo Factura
10_1_2007_13_15 : Fecha, Hora, Minuto
Facturación de Servicios.
Basado en el proceso anterior, la IPS revisa que número(s) de autorización(es) esta(n)

incorrecto(s) y entra a corregirlo(s), posteriormente se generan los archivos.
Este proceso recibe dos archivos explicados en el Anexo 1: Carátula y Detalle.
Es importante, para realizar seguimiento de estos archivos se envíen con
diferente nombre como se sugiere en el proceso anterior.
Por Ejemplo:
CLNSR_70491_archivo_car.txt
CLNSR_70491_archivo_det.txt.
Lo cual describe lo siguiente:
CLNSR : Siglas de la IPS

70491: Número de factura
Archivo_Car: Nombre del tipo de archivo
Posteriormente al cargue de los archivos en la página de Salud Total, se remiten

un correo de respuesta con dos archivos que se describen a continuación:
Nombre Archivo Enviado_ErrEst.txt.zip : Terminación del archivo de errores de
estructura, donde se reporten los errores que se encuentren en el archivo de caratula.
Nombre Archivo Enviado_Rpta.txt.zip: Terminación del archivo de respuesta de la
factura enviadas.
Cuando se ingrese al menú Facturación IPS, podrá ver que existe un campo check
seleccionable llamado Prevalidar Fact. Elect. ; ese campo se debe marcar para
realizar una prevalidación de la información a ser cargada.
7
La opción indicada anteriormente, realizará el proceso inicial de validaciones de fondo,
pero sin realizar inserciones en cuentas medicas. El sistema devolverá un correo en el
que se podrá ver cada error (en caso de que aplique) linea por linea indicando lo
encontrado a nivel de base de datos.
De igual manera se envían dos archivos de validación en detalles.
2 TRANSFERENCIA DE RESULTADOS DE APOYO DIAGNÓSTICO A

LA HISTORIA CLÍNICA DE SALUD TOTAL.
2.1 Objetivos
 Permitir que las IPS, dispongan de resultados de laboratorios clínicos y

exámenes de apoyo diagnóstico (como rayos X, electrocardiogramas…) en la
historia clínica el día siguiente a la toma del laboratorio para aquéllos
laboratorios que su resultado está disponible el mismo días.
 Suministrar a las IPS el almacenamiento de los resultados clínicos, mejorando la
atención del paciente, el cual podrá ir a consulta y el resultado de sus exámenes
estarán directamente en la Historia clínica.
 Permitir que las IPS, puedan realizar seguimiento a los resultados de laboratorio
fuera de rangos definidos para realizar programas de prevención.
 Disminución de costos por administración de cero papeles.

 Disminución de acceso de usuarios a la IPS para reclamar resultados de
laboratorio.
 Mayor integración de servicios entre la IPS y Salud Total EPS.
2.3 Proceso
- Salud Total EPS entrega una autorización al usuario, con los servicios que
requiere sean tomados para definir su diagnóstico.
- El usuario asiste a la IPS para la toma de exámenes de laboratorio solicitados

durante la vigencia de la autorización.
8
- La IPS recauda el copago o cuota moderadora, toma la muestra para los
exámenes, realiza proceso de validación de resultados y envía los resultados
a través de WEB Service de los afiliados de Salud Total.
- Salud Total, valida los resultados enviados y los registra en la Historia
Clínica para posterior consulta por los médicos.
- Cuando la IPS envía el XML (definición de XML en Anexo 2) , entra a

una cola de procesamiento de resultados en el orden de llegada, se hace una
revisión inicial donde válida la estructura del archivo enviado de acuerdo a las
especificaciones entregadas, revisa que cumpla nombre de campos y su longitud,
posteriormente devuelve una respuesta en formato XML, con el código del error y
la descripción del error, si cumple todas las validaciones reporta un archivo XML
con código de error cero (0).
- Si cumple con la estructura del archivo realiza el siguiente proceso:
1. Valida que el usuario este afiliado a Salud Total.

2. Valida que el servicio enviado este homologado en Salud Total.
3. Verifica el NAP con el cual se prestó el servicio.
Una vez cumpla el paso 1 y el paso de 2 se hace el cargue del resultado a

la Historia Clínica.
- La dirección del WEB service se encuentra en:
 Producción:
https://transaccional.saludtotal.com.co/InfoIPSEPS/
 Pruebas:
https://pruebas.saludtotal.com.co/InfoIPSEPS/ITInfoIpsEps.asmx
9
3 API AUTORIZACIONES WEB
3.1 Objetivos
 Brindar a la IPS a través de este WEB Service, la posibilidad de hacer

autorizaciones de usuarios de Salud Total desde su aplicación y evitar la doble
digitación.
 Se hará uso de un formato de respuesta XML creada por la EPS Salud Total, el
cual tiene como objetivo informar el éxito de la transacción o el rechazo de un servicio
solicitado por un usuario afiliado.
 Evitar la doble digitación en el proceso de autorizaciones.

 Evitar mala digitación en el número de autorización en el sistema de la IPS.
 Optimizar el proceso de solicitud de autorización en la IPS para eventos
hospitalarios y de urgencias, teniendo la información integrada a su sistema de
información.
3.3 Especificaciones Técnicas
Ver Anexo No. 3
La dirección del WEB service se encuentra en:
 Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB
10
4 UTILIZACIÓN DE SERVICIOS A TRAVÉS DE WEB SERVICE
4.1 Objetivo
 Brindar a la IPS a través del WEB Service, la posibilidad de solicitar la

autorización de un servicio cuando se envía una pre-autorización y se requiere
contactar a la EPS para obtener el número de autorización (NAP).
 Evitar mala digitación en el número de autorización en el sistema de la IPS.

 Evitar los gastos administrativos en los que incurre la IPS para llamar a la
EPS para obtener el número de autorización cuando el usuario llega a la
prestación del servicio.
4.3 Especificaciones Técnicas
La dirección del WEB service se encuentra en:
 Producción:
https://transaccional.saludtotal.com.co/InfoIPSEPS/
 Pruebas:
https://pruebas.saludtotal.com.co/InfoIPSEPS/ITInfoIpsEps.asmx
Para la documentación de las interfaces ver el Anexo No. 4.
11
5 ANEXO No. 1
ESPECIFICACIÓN ARCHIVO TÉCNICO TRANSFERENCIA ELECTRÓNICA

DE REGISTROS DE FACTURACIÓN
5.1 Prevalidación de NAPS
Para el proceso de prevalidación de NAP se genera un archivo plano que permite hacer la
validación de los NAPS y conocer si están correctos (no reversados ni rechazados), y si ya
fueron cobrados anteriormente. De este proceso se pueden derivar 2 o 3 archivos de respuesta
por parte de la EPS.
Archivo de NAPS
Estructura del archivo que envía la IPS con los NAPS a validar (Archivo Texto con
extensión .TXT SEPARADOS CON COMAS)
Nombre del Campo Tipo Tamaño Descripción

Documento Identidad Varchar 20 El documento de identidad del afiliado.
Nota: En caso de ser menor sin identificación (MS), ingresar el

número de identificación del cotizante, seguido de un guion (-) y el
número de posición del hijo del cotizante.
Ejm: 60829326-1
12
TipoDoc Varchar 2 El tipo de documento del afiliado.
C CEDULA DE CIUDADANIA
TI TARJETA DE IDENTIDAD
RC REGISTRO CIVIL
CE CEDULA DE EXTRANJERIA
ME MENOR DE EDAD
MS MENOR SIN IDENTIFICACION
NIU NUMERO DE IDENTIFICACION UNICO
P PASAPORTE
CD CARNET DIPLOMATICO
SC SALVOCONDUCTO
CN CERTIFICADO DE NACIDO VIVO
PE PERMISO ESPECIAL DE PERMANENCIA
Nap Varchar 16 Número de autorización asignado por Salud Total.
TipoServicio smallint 1. Ambulatorio
2. Urgencias
3. Hospitalario
FechaServicio Varchar 10 Fecha de prestación del servicio del Nap (DD/MM/YYYY).
Nap (DD/MM/YYYY)
Archivos de Respuesta
Archivo 1 de Respuesta de la EPS.
Archivo plano en el cual la EPS envía los NAP Correctos o Incorrectos a las IPS.
Este archivo se puede identificar porque el mismo termina de la siguiente forma: _Rpta.zip.
La estructura de este archivo plano es la siguiente:
NúmeroLínea Int Número de la línea en la que la IPS envió el NAP
13
DocumentoIdentidad Varchar 20 El documento de identidad del afiliado
TipoDoc Varchar 2 C CEDULA DE CIUDADANIA
RC REGISTRO CIVIL
ME MENOR DE EDAD
P PASAPORTE
SC SALVOCONDUCTO
NAP Varchar 16 Número de autorización asignado por Salud Total.
FechaRespuesta Varchar 10 Fecha de respuesta (DD/MM/AAAA)
Código de Validación Smallint - El NAP existe.
- Error: El NAP ya fue cobrado.
- El documento existe.
- El documento y el NAP existen.
- Advertencia: El documento no existe en Salud Total.
- Error: El NAP no existe en Salud Total.
- Error: Estructura del registro no es válida.
- Error: El NAP está revertido.
- Error: El NAP pertenece a otra IPS.
Descripción de Validación Varchar 100 Descripción del resultado de la validación.
Opción1Nap Varchar 16 Solo para hospitalización y urgencias.
Se envía el NAP si no se encontró el primer NAP enviado. Se

busca por documento y fecha servicio
Opción2Nap Varchar 16 Solo para hospitalización y urgencias. Segunda opción de

NAP si no cruzo.
Opción3Nap Varchar 16 Solo para hospitalización y urgencias. Tercera opción de NAP.
14
Archivo 2 de Errores de Estructura
Archivo plano en el que la EPS envía a las IPS los registros que no cumplen con los
requerimientos mínimos. Este archivo se identifica porque el nombre termina en: _ErrEst.zip.
La estructura de este archivo es la siguiente:
NúmeroLínea Int Número de la línea en la que la IPS envió el NAP.
DocumentoIdentidad Varchar 20 El documento de identidad del afiliado.
RC REGISTRO CIVIL
ME MENOR DE EDAD
P PASAPORTE
SC SALVOCONDUCTO
FechaRespuesta Varchar 10 Fecha de Respuesta (DD/MM/AAAA).
DesError Varchar 100 Descripción del error.
15
Archivo 3 con Datos del Servicio Autorizado
Archivo plano donde la EPS reporta a las IPS por NAPS los servicios autorizados. Este archivo
se reconoce porque su nombre termina en: _NapOk.zip
Este solo se enviara cuando el NAP este correcto.
La estructura del archivo es la siguiente:
NomArchEnviado varchar 50 Nombre del archivo enviado.
NumLínea int Indica el número de registro del archivo.
DocumentoIdentidad 20 El documento de identidad de Salud Total.
RC REGISTRO CIVIL
P PASAPORTE
SC SALVOCONDUCTO
FechaRespuesta Varchar 10 Fecha de respuesta (DD/MM/AAAA).
Código de Servicio Varchar 20 Código del servicio de acuerdo a la contratación con la IPS.
Descripción del Servicio varchar 255 Descripción del servicio autorizado.
CodTarifa varchar 25 Código con el cual está pactado (ISS 99 o ISS 2000..... ()
Cantidad int Cantidad del servicio autorizado.
Costo int Se envía el costo de servicio pactado, basado con la fecha del
servicio.
CuotaCobrada int Se indica el valor de cuota cobrada que se debió cobrar al

paciente. Este valor se reporta en el primer registro del nap.
16
5.2 Prevalidación de NAPS
Para el proceso de prevalidación del detalle de la factura, la IPS debe generar dos archivos
planos (Caratula y Detalle) los mismos archivos que se ingresan en el cargue de la factura (ver
numeral 3 del Anexo 1).
Nota: Para la prevalidación de facturas en el archivo Detalle es obligatorio el diligenciamiento

del campo “NAP”, en el cual debe registrarse el número de la autorización del servicio.
Por medio de estos archivos planos, el sistema valida el detalle de la factura, sin tener en
cuenta el número de factura y prefijo.
Los campos Numfac y PrefijoFac relacionados en los archivos .txt (caratula y Detalle), pueden
cargarse en blanco, ya que no son obligatorios para la prevalidación.
De este proceso el sistema de la EPS, genera 3 o 4 archivos de respuestas.
Errores Prevalidación Detalle:
Los errores generados por el sistema son enviados vía correo electrónico a la IPS, en archivo
plano, denominado Det_DetXX_Rta.txt.
Los errores que se relacionan en el archivo de respuesta, son generados por número de
registro o línea. Los cuales se detalla en el numeral 4 del Anexo 1.
17
FACTURACIÓN DE SERVICIOS A LA EPS - ARCHIVOS PLANOS A
DILIGECIAR POR LAS IPS
Una vez se solucionen las inconsistencias se realiza el proceso de facturación en archivo para
lo cual se generan dos archivos planos uno de Carátula y otro de Detalle.
Carátula:
Este archivo plano debe contener los siguientes campos:
TipoDocumento Smallint Identifica el tipo de documento que se radica:
0 FACTURA.
1 OBJECIONES.
2 NOTAS IPS.
Para este proyecto en la primera fase se dejara por default 0.
Numfac Varchar(16) Número de la factura (dado por la IPS)
PrefijoFac Varchar(10) Número de prefijo asignado por la DIAN.
Este campo puede quedar vacío.
Fecfac DateTime Fecha de elaboración de la factura por la IPS DD/MM/YYYY
Servicio INT Define el tipo de la factura. Ver tabla de servicios.
1. Ambulatorio.
2. Hospitalización Médica.
3. Urgencias Evento.
4. Urgencias Paquete.
5. Medicamentos.
6. Ambulatorio Abierto
7. Transportes.
8. Odontología PLUS.
Cuando son facturas MIXTAS, y alguno de los servicios corresponde a

Urgencias, debe relacionarse el código asignado a (Urgencias), cuando son solo
servicios ambulatorios, debe relacionarse el código asignado al servicio
Ambulatorio. Este campo “Servicio”, no debe encontrarse vacío, ni en cero (0),
siempre debe asignarse un número entre 1 a 9, según las opciones descritas
anteriormente.
Valtot INT Valor Bruto de la factura.
18
Incremento INT Incremento de valor que pueda tener el total de la factura.
Descuento INT Descuento que pueda tener el total de la factura por defecto debe ser 0.
Cuota cobrada INT Recaudos por concepto de cuota moderadora o copagos de la factura
presentada.
ValorIVA INT Valor de la factura por concepto de IVA por defecto debe ser 0.
NcIps Numeric Valor de la nota crédito de la IPS aplicable a la factura sobre el valor bruto. Por
defecto debe ser 0.
NdIps Numeric Valor de la nota débito IPS aplicable a la factura sobre el valor bruto. Por defecto
debe ser 0.
VlrNeto Int Es el valor bruto menos todos los descuentos + incrementos.
Nota: El único campo que puede encontrarse vacío en la caratula, es “Prefijo Factura”, los
demás campos siempre deben contener un valor, en los casos donde el campo no presente
valores debe contener el número cero (0).
Detalle:
Este archivo plano debe contener los siguientes campos:
Numfac Varchar (16) Número de la factura (dado por la IPS).
PrefijoFac Varchar (10) Número de prefijo asignado por la DIAN.
FechaServicio datetime Fecha Prestación del Servicio DD/MM/YYYY.
Documento Varchar(20) Documento de Identidad.
Nota: En caso de ser menor sin identificación (MS), ingresar el número de

identificación del cotizante, seguido de un guion (-) y el número de posición del
hijo del cotizante.
Ejm: 60829326-1
TipoDocumento Varchar(2) Tipo de documento de identidad:
RC REGISTRO CIVIL
ME MENOR DE EDAD
19
P PASAPORTE
SC SALVOCONDUCTO
NAP Varchar(20) Número de autorización del servicio.
CódigoServicio Varchar(15) Código del Servicio según tarifario pactado con la IPS.
Diagnóstico Varchar(8) Código del diagnóstico.
Cantidad Int Cantidad de servicio.
VlrServicio Int Valor bruto del servicio.
VlrBruto Int Cantidad * vlrservicio.
Incremento Int Incremento de valor que pueda tener el total del Servicio.
Descuento Int Descuento que pueda tener el total del Servicio
Cuota cobrada Int Recaudos por concepto de cuota moderadora y copagos en la prestación que
pueda tener el servicio por defecto debe ser 0. Enviar el valor cobrado por
NAP en el primer servicio relacionado al NAP o la Hospitalización.
ValorIVA Int Valor del servicio debido a IVA.
NcIps Numeric Valor de la nota crédito de la IPS aplicable del Servicio sobre el valor bruto.
Por defecto debe ser 0.
NdIps Numeric Valor de la nota débito IPS aplicable al servicio sobre el valor bruto. Por
defecto debe ser 0.
VlrNeto Int Es el valor menos todos los descuentos.
Tipo de Servicio Smallint Tipo de servicio que se está facturando:
0. Servicio en tarifario pactado
1. Paquete.
2. Honorario Cirujano.
3. Honorario Anestesiólogo.
4. Honorario Ayudante.
5. Derecho de Sala.
6. Materiales.
7. Servicios Médicos.
8. Medicamentos POS.
9. Insumos.
10. Estancias.
11. Elementos NO POS (Traen NAP).
12. Medicamentos NO POS (Traen NAP).
20
Fecha Egreso Datetime Fecha de Egreso del usuario en caso de Hospitalización y Urgencias.
Para los demás servicios colocar la misma fecha del servicio (campo 3)
DD/MM/YYYY.
Cuando es un cierre parcial ingrese la fecha del corte, de lo contrario, y como

último recurso, la fecha de facturación.
Nombre Servicio Varchar 255 Nombre del servicio Facturado.
Nota: Los únicos campos que pueden encontrarse vacíos en el detalle son: “Prefijo factura”,
“NAP” y “Diagnóstico”, los demás campos siempre deben contener un valor, en los casos
donde el campo no presente valores debe contener el número cero (0).
DETALLE DE ERRORES PARA LA PREVALIDACIÓN DE FACTURAS Y

CARGUE ELECTRÓNICO
Errores validación de Factura:
Error Descripción
Factura ya fue cobrada Se genera cuando se carga un registro con número y prefijo de factura,
que ya se encuentra utilizado y tiene un radicado asignado.
Factura duplicada en archivo. Se genera cuando insertan dos veces la misma información en la caratula.
La Factura no tiene detalles. Se presenta cuando solo se carga la caratula con datos, pero el detalle
viene vacío o la factura relacionada en la caratula no tiene los detalles
correspondientes.
La Factura no tiene carátula. Los detalles se encuentran en el archivo de detalles, pero en la caratula
no se encuentran relacionados.
Los totales de caratula y detalle son diferentes. Se presenta cuando el total de la factura en la caratula tiene un valor y la
suma de los valores de los registros en el detalle para esta factura no
suman lo mismo registrado en la caratula.
Cantidad por valor del servicio no es igual al valor Se genera cuando se ingresa un valor para el servicio que no es el mismo
bruto reportado. al valor bruto, estos valores siempre deben coincidir.
Fecha prestación servicio NO puede ser mayor a Se presenta cuando se ingresa en el archivo una fecha de servicio que es
fecha radicación. superior al día en el que se realiza el cargue.
Registros con valor en cero. Cuando las facturas en la caratula o el detalle vienen en 0.
Ninguna factura debe contener valores en cero.
El número de factura ya se encuentran en proceso Se presenta cuando la IPS nuevamente carga una factura debido a que
de radicación. no recibió correo de respuesta al cargarla por primera vez, sin embargo
esta si fue cargada y ya se encuentra procesando para radicación.
Registro ya se encuentra en proceso de facturación Se presenta cuando la IPS nuevamente carga una factura debido a que
electrónica. no recibió correo de respuesta al cargarla por primera vez, sin embargo
esta si fue cargada y ya se encuentra en proceso de facturación
electrónica.
Registro correcto para radicar, sin afiliado Todos los datos coinciden pero el afiliado no se encuentra.
21
Error Descripción
encontrado.
La fecha de prestación del servicio se encuentra Se presenta cuando no coinciden las fechas con los cortes establecidos
dentro de la fecha actual de radicación o supera la por la EPS.
fecha actual, debe ser facturada en el mes
siguiente. Ejm: El sistema valida que la facturación se encuentra en el corte dos (2),
pero la fecha aplica para el corte tres (3).
Las cuentas enviadas superan el máximo de La cantidad de caratulas es superior a las permitidas por el sistema.
registros permitidos para enviar para esa IPS.
Los servicios enviados superan el máximo de La cantidad de caratulas es la correcta, pero los detalles superan el
registros permitidos para enviar para esa IPS. máximo de registros permitidos en un solo cargue.
NAP en estado no facturable. Se da cuando el NAP tiene algún problema o inconveniente,

ejemplo: reversión, servicio mal autorizado o cualquiera que
pueda llegar a presentarse.
NAP no corresponde a la IPS facturadora. Se presenta cuando el NAP que se relaciona en la factura,
tiene el identificador (dígitos antes de la letra o del guion)
diferente, es porque pertenece a otra IPS.
NAP Inexistente. Se genera cuando el NAP que se ingreso en la factura, no

existe en la base de datos de Salud Total EPS.
Usuario no corresponde al autorizado. Se presenta cuando los datos del usuario relacionados en la
factura, no coinciden con el usuario al que le autorizan los
servicios.
Servicio homologo no corresponde al autorizado. Se presenta cuando el servicio que se autoriza no coincide
con el que debe homologarse.
Errores Validación de Nap:
Error Descripción
El Nap ya fue cobrado Se genera cuando el Nap ya se encuentra relacionado a otro número de
radicado.
El documento no existe en Salud Total. Se presenta cuando el número de documento del usuario, no existe o se
encuentra en un estado que no permitiría atención para luego ser
facturado.
El Nap no existe en Salud Total Se presenta cuando el número de nap no existe en la base de datos de
salud total, se debe validar y de ser necesario modificar.
El Nap no existe pero se sugiere los siguientes El sistema realiza los cruces por el resto de datos, si hay un servicio que
Nap. este en estado facturable pero el nap sea diferente al que se ingresa, se
sugiere para validar e ingresar alguna de las opciones encontradas por el
sistema.
Estructura del registro no es válida. Se presenta cuando se realiza validación de estructura y se encuentra
algún dato errado, o hace falta algún campo en el archivo.
El Nap está Revertido. Se presenta cuando el Nap es no facturable, estado del nap reversado en
la base de datos de Salud Total EPS.
El Nap pertenece a otra IPS. Se genera cuando el identificador del Nap, no corresponde a la Ips que
22
Error Descripción
está realizando el cargue.
NAP Cerrado en Autorizaciones. Se presenta cuando el Nap se encuentra en las bases de datos de Salud
Total EPS, en código de cierre <>0.
NAP Rechazado. Se genera cuando el Nap es no facturable, se encuentra en estado “Nap

rechazado” en la base de datos de Salud Total.
NAP Cerrado por tiempo mayor a 10 meses. Se presenta cuando el Nap no se había facturado y la fecha de prestación
tiene más de 10 meses.
NAP cerrado por Ips no facturable. Se genera cuando la IPS no está activa o no debe generar facturas de
este tipo.
NAP cerrado por objeción de glosa. Se presenta cuando el nap se cerró en algún momento por motor de
glosa.
NAP Cerrado por proceso de conciliación. Se presenta cuando el Nap ya se encuentra en proceso de conciliación,
debió a que la factura fue radicada anteriormente de forma manual.
NAP Cerrado Asociado. Se presenta cuando el nap se encuentra cerrado en la base de datos.
NAP Cerrado con Servicios Adicionales. Se presenta cuando el nap se encuentra cerrado en la base de datos.
NAP Cerrado Asociado con Servicios Adicionales. Se presenta cuando el nap se encuentra cerrado en la base de datos.
ARCHIVOS PLANOS ENTREGADOS A LA IPS DESPUÉS DE LA

VALIDACIÓN ARCHIVOS DE ERRORES ENCONTRADOS
Carátula:
Este archivo plano contiene los siguientes campos:
NumLínea INT Número de línea del archivo de la IPS
0 FACTURA.
1 OBJECIONES.
2 NOTAS IPS.
Numfac Varchar(16) Número de la factura (dado por la IPS).
Fecfac DateTime Fecha de elaboración de la factura por la IPS DD/MM/YYYY.
Servicio INT Define el tipo de la factura. Ver tabla de servicios.
1. Ambulatorio.
23
2. Hospitalización médica.
3. Urgencias evento.
4. Urgencias paquete.
5. Medicamentos.
6. Ambulatorio abierto.
Valtot Int Valor bruto de la factura.
Incremento Int Incremento de valor que pueda tener el total de la factura.
Descuento Int Descuento que pueda tener el total de la factura por defecto debe ser 0.
Cuota cobrada Int Recaudos que pueda tener la factura por defecto debe ser 0.
ValorIVA Int Valor de la factura debido a IVA por defecto debe ser 0.
NcIps Numeric Valor de la nota crédito de la IPS aplicable a la factura sobre el valor bruto.
Por defecto debe ser 0.
NdIps Numeric Valor de la nota débito IPS aplicable a la factura sobre el valor bruto. Por
defecto debe ser 0.
DescripciónError Varchar 255 Descripción del error encontrado en la validación.
Detalle:
NumLínea INT Número de línea del archivo de la IPS.
Numfac VARCHAR (16) Número de la factura (dado por la IPS).
PrefijoFac VARCHAR(10) Número de prefijo asignado por la DIAN.
FechaServicio datetime Fecha prestación del servicio DD/MM/YYYY.
Documento Varchar(20) Documento de identidad.
TipoDocumento Varchar(2) Tipo de documento de identidad.
RC REGISTRO CIVIL
ME MENOR DE EDAD
24
P PASAPORTE
SC SALVOCONDUCTO
Nap Varchar(20) Número de autorización del servicio.
CódigoServicio Varchar(15) Código del servicio según tarifario pactado con la IPS.
Diagnóstico Varchar(8) Código del diagnóstico de acuerdo a CIE 10.
VlrServicio INT Valor bruto del servicio.
VlrBruto Int Cantidad * vlservicio.
Incremento INT Incremento de valor que pueda tener el total del Servicio.
Descuento INT Descuento que pueda tener el total del Servicio.
Cuota cobrada INT Cuota cobrada por recaudos que pueda tener el servicio, por defecto debe
ser (0). Enviar el valor cobrado por NAP en el primer servicio relacionado al
NAP.
ValorIVA INT Valor del Servicio debido a IVA
NcIps Numeric Valor de la nota crédito de la IPS aplicable del Servicio sobre el valor bruto.
Por defecto debe ser (0).
defecto debe ser (0).
VlrNeto int Es el valor menos todos los descuentos
Tipo de Servicio Smallint Tipo de servicio que se está facturando:
0. Servicio en tarifario pactado.
1. Paquete.
2. Honorario cirujano.
3. Honorario anestesiólogo
4. Honorario ayudante.
5. Derecho de sala.
6. Materiales.
7. Servicios médicos.
9. Insumos.
10. Estancias.
Fecha Egreso Datetime Fecha de egreso del usuario en caso de hospitalización y urgencias.
25
Para los demás servicios colocar la misma fecha del servicio (campo 3).
DD/MM/YYYY.
Nombre Servicio Varchar 255 Nombre del servicio facturado.
DescripciónError Varchar 255 Descripción del error encontrado en la validación.
ARCHIVOS DE RESPUESTA CUANDO CARGA EXITOSAMENTE LA

ESTRUCTURA
Carátula:
Nombre Archivo Varchar Nombre del archivo plano enviado.
NumLínea Int Número de línea del archivo de la IPS
0 FACTURA.
1 OBJECIONES.
2 NOTAS IPS.
Numfac Varchar(16) Número de la factura (dado por la IPS).
Fecfac DateTime Fecha de elaboración de la factura por la IPS DD/MM/YYYY.
Servicio Int Define el tipo de la factura. Ver tabla de servicios
1. Ambulatorio.
2. Hospitalización médica.
3. Urgencias evento.
4. Urgencias paquete.
5. Medicamentos.
6. Ambulatorio abierto.
Valtot Int Valor bruto de la factura.
Incremento Int Incremento de valor que pueda tener el total de la factura.
Descuento Int Descuento que pueda tener el total de la factura por defecto debe ser 0.
Cuota cobrada Int Recaudos que pueda tener la factura por defecto debe ser 0.
26
ValorIVA Int Valor de la factura debido a IVA por defecto debe ser 0.
NcIps Numeric Valor de la nota crédito de la IPS aplicable a la factura sobre el valor
bruto. Por defecto debe ser 0.
NdIps Numeric Valor de la nota débito IPS aplicable a la factura sobre el valor bruto. Por
defecto debe ser 0.
ResultadoValidación Int Código del resultado de la validación.
DescripciónValidación Varchar 255 Descripción del resultado de la validación.
Detalle:
Nombre Archivo Varchar Nombre del archivo plano enviado.
NumLínea Int Número de línea del archivo de la IPS.
Numfac VARCHAR(16) Número de la factura (dado por la IPS).
PrefijoFac VARCHAR(10) Número de prefijo asignado por la DIAN.
FechaServicio datetime Fecha Prestación del Servicio DD/MM/YYYY.
Documento Varchar(20) Documento de Identidad.
TipoDocumento Varchar(2) Tipo de documento de identidad.
RC REGISTRO CIVIL
ME MENOR DE EDAD
P PASAPORTE
SC SALVOCONDUCTO
Nap Varchar(20) Número de autorización del servicio.
CódigoServicio Varchar(15) Código del Servicio según tarifario pactado con la IPS.
diagnóstico Varchar(8) Código del diagnóstico.
VlrServicio Int Valor Bruto del Servicio.

27
VlrBruto Int Cantidad * vlservicio.
Incremento Int Incremento de valor que pueda tener el total del Servicio.
Descuento Int Descuento que pueda tener el total del Servicio.
Cuota cobrada Int Cuota cobrada por recaudos que pueda tener el servicio, por defecto
debe ser 0. Enviar el valor cobrado por NAP en el primer servicio
relacionado al NAP.
ValorIVA Int Valor del Servicio debido a IVA.
NcIps Numeric Valor de la nota crédito de la IPS aplicable del Servicio sobre el valor
bruto. Por defecto debe ser 0.
defecto debe ser 0.
VlrNeto int Es el valor menos todos los descuentos
Tipo de Servicio Smallint Tipo de servicio que se esta facturando:
0. Servicio en tarifario pactado.
1. Paquete.
2. Honorario Cirujano.
3. Honorario Anestesiólogo.
4. Honorario Ayudante.
5. Derecho de sala.
6. Materiales.
7. Servicios médicos.
9. Insumos.
10. Estancias.
Fecha Egreso Datetime Fecha de egreso del usuario en caso de hospitalización y urgencias.
Para los demás servicios colocar la misma fecha del servicio (campo 3).
DD/MM/YYYY .
Nombre Servicio Varchar 255 Nombre del servicio facturado.
ResultadoValidación Int Código del resultado de la validación.
DescripciónValidación Varchar 255 Descripción del resultado de la validación.
28
6 ANEXO No. 2
ESPECIFICACIÓN XML TRANSFERENCIA RESULTADO APOYO DIAGNÓS-

TICO A HISTORIA CLÍNICA SALUD TOTAL
Funcionalidades:
1. Iniciar sesión.
2. Enviar resultados.
6.1 Método IniciarSesión:
Se utiliza para autenticar el usuario que desea utilizar los metodos del WebService, para este se
solicitan los siguientes datos:
IniciarSesion (string TipoIdIPS, string IdIPS, string TipoIdUsuario, string IdUsuario, string
Password)
Nombre del Campo Tipo Descripción
TipoIdIPS Varchar Tipo de identificación de la IPS
N Nit
IdIPS Varchar Número de la Identificación de la IPS
TipoIdUsuario Varchar Tipo de documento de identidad.
RC REGISTRO CIVIL
M MENOR DE EDAD
29
N NIT
P PASAPORTE
SC SALVOCONDUCTO
IdUsuario Varchar Número de identificación del usuario.
Password Varchar Password del usuario.
Retorno: Cadena XML con el resultado del método con la siguiente estructura de
tags:
- Error: Indica si hubo un error en el Inicio de sesión; cero indica que el inicio de sesión
fue exitoso, un valor diferente a cero indica que se generó un error.
- DescripciónError: Descripción del error generado, el campo se genera vacío cuando el

código de error es cero.
- ClaveSesión: si el inicio de sesión fue exitoso se retorna una cadena de caracteres

que identifica la sesión actual y se requerirá para ejecutar algún método del
WebService.
6.2 Método para enviar resultados:
Se utiliza para reportar a salud Total el resultado de exámenes de ayudas

Diagnósticas.
String ResultadosLC(string ClaveSesion, string XML).
ClaveSesión: Es la sesión entregada en el método de Iniciar sesión con el cual se

autoriza la utilización del Web Service.
XML: Datos necesarios para realizar el XML a enviar (“Se debe respetar el nombre del
campo en el archivo. No puede cambiar el nombre de los Tags.”)
30
IPS NIT Varchar 15 Nit de la IPS.
NOMBRE Varchar 40 Nombre de la IPS.
FECHAGENERACIÓN Datetime Fecha de generación del XML
FORMATO: DD/MM/YYYY HH:MM.
CÓDIGOIPS Varchar 5 Código IPS asignado por Salud Total.

EMAIL Varchar 100 Email del destino de los mensajes.
DOCUMENTO AFILIADO Varchar 22 Documento de identidad del usuario
TIPODOCUMENTO Varchar 2 Tipo de documento de identidad.
RC REGISTRO CIVIL
ME MENOR DE EDAD
P PASAPORTE
SC SALVOCONDUCTO
NOMBRESUSUARIO Varchar 50 Nombres del usuario.

APELLIDOSUSUARIO Varchar 50 Apellidos del usuario.
ENCABEZADO Varchar 500 Datos generales de los exámenes
Realizados. No obligatorio.
CLASIFICACIÓN Varchar 50 Nombre de la clasificación de
NOMBRE Laboratorio (MICROBIOLOGÍA, MICROSCOPIA,

HORMONAS, etc) a la que pertenece el servicio.
TIPOATENCIÓN Smallint Tipo de atención:
1. Ambulatorio
2. Hospitalario
3. Urgencias
4. Particular
31
NAP Varchar 16 Número de autorización asignado por Salud Total.
Obligatorio SOLO para el tipo de atención

ambulatorio.
TIPOAYUDADX Smallint Tipo de ayuda diagnostica:
1. Laboratorio.
2. Interpretación médica.
3. Reporte de PDF desde FTP
CODSERVICIO Varchar 15 Código del Servicio en CUPS.
NOMBRESERVICIO Varchar 255 Nombre del Servicio.
NOMBREPROFESIONAL Varchar 200 Datos del profesional que analizo la
Ayuda diagnóstica.
FECHASERVICIO Varchar 10 Fecha de prestación del servicio
FORMATO: DD/MM/YYYY HH:MM
RESULTADO Varchar 5000 Si el tipo de ayuda diagnóstica es
Laboratorio, no es requerido su diligenciamiento.
Si es una interpretación médica este campo es de

obligatorio diligenciamiento y envían el resultado del
examen. No se debe enviar los campos de grupo de
laboratorio y los campos de analito.
GRUPOLABORATORIO Varchar 60 Indica el nombre de grupo de analitos de laboratorio. Ej.

NOMBRE Química sanguínea.
ANALITO NOMBRE Varchar 255 Indica el nombre del analito

VALOR Varchar 50 Indica el valor del resultado.
OBSERVACIONES Varchar 2000 Se envían las observaciones aplicadas al analito.
UNIDAD Varchar 50 Indica la unidad de medida del resultado.
DESCRIPCIÓN Varchar 60 Descripción de los valores de referencia.
Ej. Niños 0-5.
Niños 6-10.
Adultos.
Adolescentes.
32
VALORMÍNIMO Decimal Valor Mínimo de referencia.
Numérico con 2 decimales.
VALORMÁXIMO Decimal Valor Máximo de referencia.
Numérico con 2 decimales.
6.3 Registro de laboratorios seriados
Para el envío de resultados de exámenes seriados se debe enviar el código CUPS del servicio
y de acuerdo al resultado que se esté enviando se le adiciona al código del servicio un guion y
el consecutivo.
Ejemplo de envió de códigos de servicio de acuerdo al resultado que se esté enviando
901101 BACILOSCOPIA Resultado de la primera

901101-2 BACILOSCOPIA M#2 Resultado de la segunda
901101-3 BACILOSCOPIA M#3 Resultado de la tercera
Aspectos a tener en cuenta
Cuando requiera enviar alguno de los siguientes caracteres dentro del XML reemplazarlo de
acuerdo al siguiente cuadro:
Caracteres Enviar XML

< <
> >
& &
" "
33
6.4 Estructura del XML a enviar:
<?xml version="1.0" encoding="utf-8"?>

<IPS NIT="" NOMBRE="" FECHAGENERACION="" códigoIPS="" EMAIL="">
<AFILIADO DOCUMENTO=""
TIPODOCUMENTO=""
NOMBRESUSUARIO=""
APELLIDOSUSUARIO=""
ENCABEZADO="">
<CLASIFICACION NOMBRE="">
<SERVICIO TIPOATENCION=""
NAP=""
TIPOAYUDADX=""
CODSERVICIO=""
NOMBRESERVICIO=""
NOMBREPROFESIONAL=""
FECHASERVICIO=""
RESULTADO="" >
<GRUPOLABORATORIO NOMBRE="">
<ANALITO NOMBRE=""
VALOR=""
UNIDAD=""
OBSERVACIONES="">
<REFERENCIA
DESCRIPCION=""
VALORMINIMO=""
VALORmáximo="" />
</ANALITO>
</GRUPOLABORATORIO>
</SERVICIO>
</CLASIFICACION >
</AFILIADO>
</IPS>
EJEMPLO
<?xml version="1.0" encoding="utf-8"?>
34
<IPS NIT="80" NOMBRE="IPS DE PRUEBA" FECHAGENERACION="01/01/2007
23:10">
<AFILIADO DOCUMENTO="1071162445 "
TIPODOCUMENTO="CC"
NOMBRESUSUARIO="PEDRO ANTONIO"
APELLIDOSUSUARIO="PEREZ ROMERO"
ENCABEZADO="FALC @CRE @TBIL @DBOL">
<CLASIFICACION NOMBRE="MICROBIOLOGIA">
<SERVICIO TIPOATENCION="1"
NAP="6948-92780617"
TIPOAYUDADX="1"
CODSERVICIO="16342"
NOMBRESERVICIO="CREATININA"
NOMBREPROFESIONAL="JUAN PEREZ Reg. No 452542 "
FECHASERVICIO="01/01/2007 23:10"
RESULTADO="">
<GRUPOLABORATORIO NOMBRE="QUIMICA SANGUINEA">
<ANALITO NOMBRE="CREATININA "
VALOR="0.72"
UNIDAD="mg/dl"
OBSERVACIONES="">
<REFERENCIA DESCRIPCION="T"
VALORMINIMO="0.5"
VALORmáximo="1.5" />
</ANALITO>
</GRUPOLABORATORIO>
</SERVICIO>
</CLASIFICACION>
<CLASIFICACION NOMBRE="MICROSCOPIA">
NAP="6948-92780618"
TIPOAYUDADX="2"
CODSERVICIO="25624"
NOMBRESERVICIO="CUADRO HEMATICO"
35
NOMBREPROFESIONAL="DIANA ALVAREZ
Reg. No. 256145"
RESULTADO="">
<GRUPOLABORATORIO NOMBRE="HEMATOLOGIA">
<ANALITO NOMBRE="VELOCIDAD SEDIMENTACION 1HORA"
VALOR="16"
UNIDAD="mm/Hora"
OBSERVACIONES="">
<REFERENCIA DESCRIPCION="T"
VALORMINIMO="4.7"
VALORmáximo="6.10" />
</ANALITO>
<ANALITO NOMBRE="M.P.V"
VALOR="7.4"
UNIDAD=""
OBSERVACIONES="">
</ANALITO>
</GRUPOLABORATORIO>
</SERVICIO>
</CLASIFICACION>
</AFILIADO>
<AFILIADO DOCUMENTO="41505990"
TIPODOCUMENTO="CC"
NOMBRESUSUARIO="MARIA ELVIRA"
APELLIDOSUSUARIO="ROJAS CONTRERAS"
ENCABEZADO="">
<CLASIFICACION NOMBRE="UROANALISIS">
NAP="8467-21231239"
TIPOAYUDADX="1"
CODSERVICIO="163005"
NOMBRESERVICIO="UROANALISIS"
NOMBREPROFESIONAL="LINA MEDINA CC. 1132"
36
RESULTADO="">
<GRUPOLABORATORIO NOMBRE="ANALISIS FISICO QUIMICO">
<ANALITO NOMBRE="COLOR"
VALOR="AMARILLO"
UNIDAD=""
OBSERVACIONES="">
</ANALITO>
<ANALITO NOMBRE="ASPECTO"
VALOR="TURBIO"
UNIDAD=""
OBSERVACIONES="">
</ANALITO>
</GRUPOLABORATORIO>
<GRUPOLABORATORIO NOMBRE="MICROSCOPICO">
<ANALITO NOMBRE="LEUCOCITOS"
VALOR="45-50"
UNIDAD="XC"
OBSERVACIONES="">
</ANALITO>
</GRUPOLABORATORIO>
</SERVICIO>
</CLASIFICACION>
</AFILIADO>
</IPS>
37
6.5 Información Técnica para el reporte de ayudas diagnosticas por FTP.
Datos del prestador
Cada prestador que realice el reporte de ayudas diagnosticas por el medio de FTP, debe
entregar ante la EPS la siguiente información técnica que permita la parametrización y correcto
funcionamiento del modelo:
1. Ruta del servidor FTP.

2. Subcarpeta destinada para el reporte por este medio.
3. Usuario para el acceso a este directorio FTP.
4. Contraseña para el acceso a este directorio FTP.
Estructura de los archivos alojados en el FTP del prestador
El archivo que se publicara en el servicio FTP por parte del prestador debe tener la siguiente
estructura, la cual debe coincidir con lo reportado a través del xml:
 NAP_Codigo CUPS del servicio_Fecha del servicio (yyyymmddHhmss).pdf
Ejemplo:
00151-1847431423_482500_20190214115400.pdf
38
7 ANEXO No. 3
ESPECIFICACIONES TÉCNICAS PARA IMPLEMENTAR AUTORIZACIONES

A TRAVÉS LA API DE AUTORIZACIONES WEB
En el siguiente anexo se describen las características de los métodos del Web API, que
van a ser utilizados en la Autorización de Servicios IPS. Los métodos que se entregan son:
1. Token
2. ConsultaConvenioxIPSWEB
3. SolicitudAutorizacion
4. ConsultaServiciosLiberar
5. SolicitudLiberacion
7.1 Token {Get}
En este método se utiliza para generar el token de acceso a los controladores del API en base
al obtenido en el API de seguridad, éste método debe ser consumido vía POST.
Ese token debe ser enviado en el Header de cada petición con el siguiente formato:
Authorization: bearer TOKEN_ASIGNADO

URL:
Desarrollo:
https://desarrollo.saludtotal.com.co/APIAutorizacionesWEB/APIAutorizacionesWEB/token
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/API/token
Token(string Token, string Origen)
39
Entradas
Nombre del Tipo Descripción Requerido

Campo
Token string Es el token que le asignan al usuario SI

cada vez que abre una sesión
Origen string Es el nombre de donde se realiza la SI

petición. AUTORIZACIONESWEB
Retorno
Nombre del Tipo Descripción

Campo
Valido bool True o False de acuerdo a la respuesta
Error string Mensaje de error
Token string Nueva cadena de caracteres que permite al usuario seguir realizando
peticiones.
7.2 ConsultaConvenioxIPSWEB {GET}
Se define como la petición generada desde el Sistema de una IPS hacia el sistema
AutorizacionesIT-ST con el fin de consultar los convenios contratados.
URL:
Desarrollo:
https://desarrollo.saludtotal.com.co/APIAutorizacionesWEB/APIAutorizacionesWEB/
Convenios/ConsultaConveniosxIPSWEB
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/Convenios/
ConsultaConveniosxIPSWEB
40
ConsultaConveniosxIPSWEB([FromBody])
Entradas
Nombre del Campo Tipo Descripción Requerido
DocumentoTer- string Documento Tercero-IPS SI

cero
CodigoSede string Código Sede-IPS SI
TDocumentoPa- string Tipo de documento del paciente SI

ciente
CC Cedula de Ciuda-
danía
TI Tarjeta Identidad
RC Registro Civil
NIT No. Identificación

Tributaria
CE Cedula de Ex-
tranjería
PJ Personería Jurí-
dica
ME Menor de Edad
MS Menor sin Identi-

ficación
NIU Número de Iden-

tificación Único
P Pasaporte
CD Carnet Diplomáti-
co
SC Salvoconducto
CN Certificado Naci-
do Vivo
PE Permiso Especial
Permanencia
NroDocumento- string Documento del Paciente SI

Paciente
41
ClaseServicio Int Clase de Servicio SI
1 Producto Servicio
2 Medicamento
3 Dispositivos Médicos
CodigoServicio string Código del Servicio - Codificación SI

CUPS/CUM (medicamentos) /Dispositivos
Ejemplo Encabezado
[
{
"DocumentoTercero": "9999999999",
"CodigoSede": "12345",
"TDocumentoPaciente": "CC",
"NroDocumentoPaciente": "9999999999",
"ClseServicio": 1,
"CodigoServicio": "123456"
}
]
Retorno
Encabezado
errornum int Número del error 0: No se presentaron errores
errordescripcion string Descripción del error
codigoConvenio string Código del Convenio IPS
codModalidadConvenio int Modalidad Convenio
42
1 Evento
2 Capitación
3 Modelo Honorarios
4 Modelo PGP
productoConvenio string Productos contenidos en el Convenio
1 POS
11 POS SUBSIDIADO
Ejemplo Retorno
[
{
"errornum": 0,
"errordescripcion": "",
"codigoConvenio": "CON-99-BOG8888",
"codModalidadConvenio": 1,
"productoConvenio": "1,11,"
},
{
"errornum": 0,
"codigoConvenio": "CON-99-BOG9999",
"codModalidadConvenio": 1,
"productoConvenio": "1,11,"
}
]
43
7.3 ConsultaAfiliadoxDocumento {GET}
AutorizacionesIT-ST con el fin de consultar los datos de un Afiliado.
URL:
Desarrollo:
Convenios/ConsultaAfiliadoxDocumento
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/Convenios/ ConsultaAfiliadoxDocumento
ConsultaAfiliadoxDocumento([FromBody])
Entradas
NoDocumento string Documento Afiliado SI
TipoDocumento string Tipo de documento del paciente NO
CC Cedula de Ciuda-
danía
RC Registro Civil
NIT No. Identificación

Tributaria
CE Cedula de Ex-
tranjería
PJ Personería Jurí-
dica
ME Menor de Edad
MS Menor sin Identi-

ficación
NIU Número de Iden-
44
tificación Único
P Pasaporte
CD Carnet Diplomáti-
co
SC Salvoconducto
CN Certificado Naci-
do Vivo
PE Permiso Especial
Permanencia
Ejemplo Encabezado
[
{
"NoDocumento": "9999999999",
"TipoDocumento": "CC"
}
]
Retorno
Encabezado
idAfiliado bigint Identificador Afiliado
idTipoDocumento int Identificador Tipo de Documento
tipoDocumento string TipoDocumento
nombreCompleto string Nombre completo del afiliado
45
idProducto Int Identificar del producto del protegido
1 POS
11 POS Subsidiado
producto string Producto del Afiliado
idEstadoAfiliacion int Identificador del estado de afiliación
1 Activo
2 Suspendido por mora
3 Protección Laboral
4 Activo
5 Desafiliado
6 Mora
estadoAfiliacion string Estado afiliación del afiliado
Ejemplo Retorno
[
{
"errornum": 0
"errordescripcion": ""
"idAfiliado": 123456
"idTipoDocumento": 1
"tipoDocumento": "CC"
"nombreCompleto": "PEDRO PEREZ"
"idProducto": 1
"producto": "POS"
"idEstadoAfiliacion": 1
"estadoAfiliacion": "Activo"
},
46
7.4 ConsultaOrigenAtencion {GET}
AutorizacionesIT-ST con el fin de consultar los orígenes de atención.
URL:
Desarrollo:
Convenios/ConsultaOrigenAtencion
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/Convenios/ ConsultaOrigenAtencion
ConsultaOrigenAtencion([FromBody])
Entradas
aplicaExterno bit Identifica si los códigos que se deben NO

mostrar son externos 0-No 1-Si
Ejemplo Encabezado
[
{
"aplicaExterno": 1,
}
]
47
Retorno
Encabezado
idOrigenAtencion int Identificador del origen de atención
codigoExterno string Código externo del origen de atención.
origen string Origen de atención
codigoST string Código ST del origen de atención
restrictivoExterno bit Indica si el código es restrictivo en su utilización 0-No 1-Si
Ejemplo Retorno
[
{
"errornum": 0
"idOrigenAtencion": 1
"codigoExterno": “SOAT”
"origen": "Accidente de tránsito"
"codigoST": "SOAT"
"restrictivoExterno": 0
}
]
48
7.5 ConsultaSede {GET}
AutorizacionesIT-ST con el fin de consultar las sedes.
URL:
Desarrollo:
Convenios/ConsultaSede
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/Convenios/ ConsultaSede
ConsultaSede([FromBody])
Entradas
nit string NIT de la IPS sin dígito de chequeo SI
Ejemplo Encabezado
[
{
"nit": “800130907”,
}
]
49
Retorno
Encabezado
idIps int Identificador de la IPS
nit string NIT de la IPS
idSucursal int Identificador de la Sucursal
sucursal string Nombre de la Sucursal
idCiudad int Identificador de la ciudad
ciudad string Nombre de la Ciudad
idSede int Identificador de la sede
codigoSede String Código de la Sede
sede String Nombre de la Sede
Ejemplo Retorno
[
{
"errornum": 0
"idIPS": 1
"nit": “800130907”
"IPS": "Salud Total"
"idSucursal": 1
"sucursal": “BOGOTA”
"idCiudad": 1
50
"ciudad": “Bogota”
"idSede": 1
"codigoSede": “C1234”
"sede": “BOGOTA ORIENTE”
}
]
7.6 SolicitudAutorizacion {GET}
AutorizacionesIT-ST con el fin de solicitar la autorización de un servicio.
URL:
Desarrollo:
Autorizaciones/SolicitudAutorizacion
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/Autorizaciones/SolicitudAutorizacion
SolicitudAutorizacion([FromBody])
Entradas
La entrada debe ser enviada en el Body de la petición con el siguiente formato:
51
Encabezado
DocumentoTer- string Documento Tercero-IPS SI

cero
CodigoSede string Código Sede-IPS - Código Sede de la SI

IPS-IT
Informar
TDocumentoPa- string Tipo de documento del paciente SI

ciente
CC Cedula de
Ciudadanía
TI Tarjeta Identi-
dad
RC Registro Civil
NIT No. Identifica-

ción Tributaria
CE Cedula de
Extranjería
PJ Personería
Jurídica
ME Menor de
Edad
MS Menor sin
Identificación
NIU Número de
Identificación Úni-
co
P Pasaporte
CD Carnet Diplo-
mático
SC Salvoconduc-
to
CN Certificado
Nacido Vivo
PE Permiso Es-
52
pecial Permanen-
cia
NroDocumento- string Documento del Paciente SI

Paciente
IdAmbito int Ámbito de realización SI
1 Ambulatorio
2 Hospitalario
3 Urgencia
4 Domiciliario
Detalle lstDetalleSolicitud
Nombre del Campo Tipo Descripción Requer

ido
FechaOr- date Fecha de ordenamiento del servicio Fecha SI

denMedica (MM/DD/AAAA) Fecha de la atención
NAPA string Número de Nap Anterior NO
tipoDocu- string Tipo de documento Prestador NO

mentoPresta-
dorOrdena- CC Cedula de Ciudadanía
miento
RC Registro Civil
NIT No. Identificación Tributa-

ria
CE Cedula de Extranjería
PJ Personería Jurídica
ME Menor de Edad
MS Menor sin Identificación
NIU Número de Identificación

Único
P Pasaporte
53
CD Carnet Diplomático
SC Salvoconducto
CN Certificado Nacido Vivo
PE Perm. Esp. Permanencia
nitPresta- string Identificación del Prestador NO

dor
sedeOrde- string Código Sede Ordena NO

na
Codigo- string Código Diagnostico Principal - Código del diag- DE-

Diagnostico nóstico CIE10 PENDE
ORIGEN
CodigoSer- string Código del Servicio - Codificación CUPS/CUM DE-

vicio (medicamentos) /Dispositivos PENDE
ORIGEN
ClaseServi- Int Clase de Servicio SI

cio
1 Producto Servicio
2 Medicamento
3 Dispositivos Médicos
CodigoOri- string Origen del Servicio SI

genSer
EG Enfermedad General
SOAT Accidente de tránsito
ENPR Enfermedad profesional
ACW Accidente de trabajo
MATE Maternidad
CATA Enfermedad Catastrófi-

ca
OTAC Otro Tipo de Accidente
LEAG Lesión por Agresión
LEAU Lesión Autoinfligida
MALT Sospecha de Maltrato
54
físico
ACRA Accidente Rábico
ACOF Accidente Ofídico
ABSE Sospecha de Abuso

Sexual
VISE Sospecha de Violencia

Sexual
MAEM Sospecha de Maltrato

Emocional
OTRA Otra
ENFG Promoción y Preven-

ción
Cantidad int Cantidad del servicio SI
Producto int Id del Producto SI
1 POS
11 POS SUBSIDIADO
18 PLAN GAMA
19 PLAN DELTA
20 PLAN OMEGA
25 FOME
26 FOME SUBSIDIADO
CodConve- string Código del Convenio SI

nio
Dosis int Cantidad de la dosis para servicios clase medi- SI

camento - Se diligencia si se va a autorizar un medi-
camento
UnidadMe- Int Id de la unidad de medida de la dosis NO

didaDosis
6 Aplicacion(es)
7 Centímetro(s) cúbico(s)
8 Elisa unit
9 gramo(s)
55
10 Gigabecquerel
11 Gota(s)
12 Julio(s)
13 kilobecquerel
14 Kilo Caloías
15 Kilo Unidades Internacio-

nales
16 Límite de floculación
17 Megabecquerel
18 microgramo(s)
19 mcg/h
20 mcg/kg
21 mcg/m3
22 milicurio(s)
23 micromol(es)
24 miliequivalente(s)
25 miligramo(s)
26 mililitro(s)
27 milimol(es)
28 Millon(es) de UI
29 nanogramo(s)
30 onza(s)
31 Puff
32 Sobre(s)
33 Unidad(es)
internacional(es)
34 Unidad(es) de Tuberculina
56
35 Tableta(s)
36 Cápsula(s)
38 mg/h
39 mg/kg
Frecuencia int Frecuencia para suministro del medicamento - NO

Se diligencia si se va a autorizar un medicamento
UniMe- Int Id de la unidad de medida de tiempo para la fre- NO

dTiempo cuencia - Se diligencia si se va a autorizar un medi-
camento
1 Hora(s)
2 Día(s)
3 Mes(es)
4 Semana(s)
5 Año(s)
37 Minuto(s)
VíaAdmi- Int Vía de administración del medicamento según la NO

nistracion parametrización - Se diligencia si se va a autorizar
un medicamento
1 Bucal
2 Conjuntival
3 Dental
4 Epidural
5 Hemodiálisis
6 Implante
7 Inhalación
8 Insuflación
9 Intra-Arterial
10 Intra-Articular
11 Intra-Cardiaca
12 Intracavernosa
57
13 Intradermal
14 Intraespinal
15 Intralesional
16 Intralinfatica
17 Intramuscular
18 Intranasal
19 Intraocular
20 Intraperitoneal
21 Intrapleural
22 Intratecal
23 Intratraqueal
24 Intrauterina
25 Intravenosa
26 Intravesical
27 Oral
28 Ótico Auricular
29 Parenteral
30 Rectal
31 Subcutánea
32 Sublingual
33 Tópica(externa)
34 Transdermal
35 Uretral
36 Vaginal
Duracion- Int Tiempo total del tratamiento en días - Se diligen- NO

Dias cia si se va a autorizar un medicamento
58
Ejemplo Entrada
[
{
"documentoTercero": "8888888888",
"codigoSede": "12345",
"tDocumentoPaciente": "CC",
"nroDocumentoPaciente": "9999999999",
"idAmbito": 1,
"lstDetalleSolicitud": [
{
"fechaOrdenMedica": "2020-24-03",
"napa": "12345-999999999",
"tipoDocumentoPrestadorOrdenamiento": "NIT",
"nitPrestador": "1234567890",
"sedeOrdena": "54321",
"codigoDiagnostico": "DX99",
"codigoServicio": "124567890",
"claseServicio": 1,
"codigoOrigenSer": "EG",
"cantidad": 9999,
"producto": 1,
"codConvenio": "CON-99-MEDE999",
"dosis": 1,
"unidadMedidaDosis": 1,
"frecuencia": 1,
"uniMedTiempo": 1,
59
"víaAdministracion": 1,
"duracionDias": 1
},
{
"fechaOrdenMedica": "2020-24-03",
"napa": "",
"tipoDocumentoPrestadorOrdenamiento": "NIT",
"nitPrestador": "1234567890",
"sedeOrdena": "12234",
"codigoDiagnostico": "DX88",
"claseServicio": 1,
"codigoOrigenSer": "EG",
"cantidad": 9999,
"producto": 1,
"codConvenio": "CON-99-MEDE999",
"dosis": 0,
"unidadMedidaDosis": 0,
"frecuencia": 0,
"uniMedTiempo": 0,
"víaAdministracion": 0,
"duracionDias": 0
}
]
}
]
60
Retorno
Encabezado
mensajeRespuesta string Respuesta de proceso finalizado
rptaSolicitud string Número de solicitud generado
Detalle lstrptaDetalleSolicitud
origenError string Origen del error en caso de no presentar se

devuelve vacío
mensajeError string Mensaje de error
estado int Id del estado del servicio
0 Sin Procesar
1 Preautorizada
2 Autorizada
4 Rechazada
6 Requiere validacion
7 Pendiente
descEstado string Descripción del estado del servicio
motivo string Causa que identifica el estado.
CodServicioIPS string Código del servicio IPS
CodServicio string Código del servicio IT-ST
nap string NAP Generado
61
Ejemplo Retorno
[
{
"mensajeRespuesta": "",
"rptaSolicitud": "999999999999",
"lstrptaDetalleSolicitud": [
{
"origenError": "0",
"mensajeError": "",
"estado": 1,
"descEstado": "Autorizada",
"motivo": "",
"CodServicioIPS": "RX99",
"CodServicio": "12456789",
"nap": "12345-999999999"
},
{
"origenError": "0",
"mensajeError": "",
"estado": 4,
"descEstado": "Rechazado",
"motivo": "Motivo Rechazo",
"CodServicioIPS": "RX88",
"CodServicio": "987654321",
"nap": "12345-888888888"
}
]
62
}
]
7.7 ConsultaServiciosLiberar {GET}
AutorizacionesIT-ST con el fin de solicitar la consulta de medicamentos para ser
liberados.
URL:
Desarrollo:
https://desarrollo.saludtotal.com.co/APIAutorizacionesWEB/APIAutorizacionesWEB /
Autorizaciones/SolicitudConsultaMedicamentos
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/Autorizaciones/SolicitudConsultaMedicamentos
SolicitudConsultaMedicamentos([FromBody])
Entradas

Campo
CodigoSede string Código Sede-IPS - Código SI

Sede de la IPS-IT
Informar
TDocumentoPa- string Tipo de documento del pa- SI

ciente ciente
NroDocumentoPa- string Documento del Paciente SI

ciente
63
Ejemplo Entradas
[
{
"TDocumentoPaciente": "CC",
"NroDocumentoPaciente": "999999999999"
}
]
Retorno
Encabezado
numEntregaMed long Numero de entrega del medicamento
codigoServicio string Código servicio IT-ST
tipoUsuario string Combinación entre régimen del producto del nap del
afiliado +espacio+ tipo de afiliado
modContratacionPago string Modalidad de contratación y pago
tipoPresupuesto string Cobertura o plan de beneficios
codigoConvenio string Número de contrato
pagosCompartidos double Pagos compartidos en planes voluntarios de salud
64
Ejemplo Retorno
[
{
"errornum": 0,
"numEntregaMed": 999999999,
"codigoServicio": "123456789"
},
{
"errornum": 0,
"numEntregaMed": 888888888,
"codigoServicio": "987654321"
}
]
7.8 SolicitudLiberacion {GET}
AutorizacionesIT-ST con el fin de solicitar el proceso de liberación de la autorización de
un servicio.
URL:
Desarrollo:
Autorizaciones/SolicitudLiberacion
Pruebas:
65
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/Autorizaciones/SolicitudLiberacion
SolicitudLiberacion([FromBody])
Entradas
Encabezado
DocumentoTercero string Documento Tercero-IPS SI
NumEntregaMed long Número de entrega del SI

medicamento
Ejemplo Entrada
[
{
"NumEntregaMed": 555555555
},
{
}
]
66
Retorno
Encabezado
NumEntregaMed long Número de entrega del medicamento
Detalle lstrptaLiberacion
origenError string Origen del error en caso de no presentar se devuelve

vacío
codigoServicio string Código de servicio IT-ST
nap string NAP Generado con la liberación
67
Ejemplo Retorno
[
{
"NumEntregaMed": 999999999,
"lstrptaLiberacion": [
{
"origenError": "0",
"mensajeError": "",
"nap": "12345-999999999"
},
{
"origenError": "0",
"mensajeError": "",
"nap": "12345-888888888"
}
]
}
]
7.9 ConsultaAccionEntregaParcial {GET}
AutorizacionesIT-ST con el fin de consultar las acciones de entregas parciales.
68
URL:
Desarrollo:
EntregaParcial/ConsultaAccionEntregaParcial
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/EntregaParcial/ConsultaAccionEntregaParcial
ConsultaAccionEntregaParcial()
Retorno

Campo
ID_TM_Se long Identificador de sesión de usuario.

sionUsuario
ID int Identificador de la acción de entrega parcial.
Nombre string Nombre de la acción de entrega parcial.
Libera bool Identifica si la acción libera el servicio 0-No 1-Si
Estado bool Estado del registro 0-Inactivo 1-Activo
Ejemplo Retorno
[
{
"ID_TM_SesionUsuario": 999999999,
"ID": 9,
"Nombre": "Accion",
"Libera": true,
"Estado": true
},
{
69
"ID": 8,
"Nombre": "Accion 2",
"Libera": true,
"Estado": true
}
]
7.10 ConsultaMotivoEntregaParcial {GET}
AutorizacionesIT-ST con el fin de consultar los motivos por acción de entregas parciales.
URL:
Desarrollo:
EntregaParcial/ConsultaMotivoEntregaParcialxAccion
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/EntregaParcial/
ConsultaMotivoEntregaParcialxAccion
ConsultaMotivoEntregaParcialxAccion()
Entradas

Campo
Token string Es el token que le asignan al usuario SI

cada vez que abre una sesión
Origen string Es el nombre de donde se realiza la SI

petición. AUTORIZACIONESWEB
IdAccionEn int Identificador de la acción para SI

tregaParcial
entrega parcial obtenido en el punto
70
7.6
Retorno

Campo
ID_TM_Se long Identificador de sesión de usuario.

sionUsuario
ID int Identificador del motivo de entrega parcial.
ID_TP_Acc int Identificador de la acción de entrega parcial.

ionEntregaPar
cial
Nombre string Nombre del motivo de entrega parcial.
MotivoServ bool Identifica si el motivo es de servicio prestado para poder liberar 0-No
icioPrestado 1-Si
Estado bool Estado del registro 0-Inactivo 1-Activo
Ejemplo Retorno
[
{
"ID": 9,
"ID_TP_AccionEntregaParcial": 1,
"Nombre": "Motivo",
"MotivoServicioPrestado": true,
"Estado": true
},
{
"ID": 9,
"ID_TP_AccionEntregaParcial": 2,
"Nombre": "Motivo 2",
"MotivoServicioPrestado": true,
"Estado": true
}
71
]
7.11 SolicitudLiberacionV1 {GET}
AutorizacionesIT-ST con el fin de solicitar el proceso de liberación de la autorización de
un servicio para entregas parciales.
URL:
Desarrollo:
Autorizaciones/SolicitudLiberacionV1
Pruebas:
https://pruebas.saludtotal.com.co/APIAutorizacionesWEB/Autorizaciones/SolicitudLiberacionV1
SolicitudLiberacionV1([FromBody])
Entradas
Encabezado
DocumentoTercero string Documento Tercero-IPS SI
NumEntregaMed long Número de entrega del SI

medicamento
Cantidad int Cantidad de servicio a libe- NO

rar
IdMotivoEntregaParcial int Identificar del motivo de NO

entrega parcial
72
Ejemplo Entrada
[
{
"Cantidad": 10,
"IdMotivoEntregaParcial": 1
},
{
"Cantidad": 1,
"IdMotivoEntregaParcial": 2
}
]
Retorno
Encabezado
NumEntregaMed long Número de entrega del medicamento
73
Detalle lstrptaLiberacion
origenError string Origen del error en caso de no presentar se devuelve

vacío
codigoServicio string Código de servicio IT-ST
nap string NAP Generado con la liberación
Ejemplo Retorno
[
{
"lstrptaLiberacion": [
{
"origenError": "0",
"mensajeError": "",
"nap": "12345-999999999"
},
{
"origenError": "0",
"mensajeError": "",
"nap": "12345-888888888"
}
]
}
]
74
8 ANEXO No. 4
ESPECIFICACIONES TÉCNICAS PARA IMPLEMENTAR UTILIZACIÓN DE

SERVICIOS A TRAVÉS DE WEB SERVICE
Funcionalidad que se entrega:
1. Inicio de Sesión
2. Consultar servicios por Cedula
3. Liberar NAP
4. Consultar por NAP
En el desarrollo que se realice debe tener en cuenta los siguientes aspectos:
1. Debe hacer un inicio de sesión el cual le entregara una clave que será solicitada en
todos los métodos.
2. Si en el voucher aparece impreso el número de autorización, solo deberá utilizar el

método Consultar por NAP.
3. Si en el voucher NO aparece impreso el número de la autorización e indica que es una

pre-autorización, debe utilizar el método consultar servicios por cedula y este le
retornara un número (NumEntregaMed) con el cual deberá posteriormente utilizar el
método Liberar NAP para que le entregue el número de autorización el cual utilizara
para el proceso de facturación.
75
8.1 Método IniciarSesión
Se utiliza para autenticar el usuario que desea utilizar los métodos del WebService
string IniciarSesion (string TipoIdIPS, string IdIPS, string TipoIdUsuario, string IdUsuario, string
Password).
TipoIdIPS Varchar Tipo de identificación de la IPS N Nit
IdIPS Varchar Número de la Identificación de la IPS
TipoIdUsuario Varchar Tipo de documento de identidad.
RC REGISTRO CIVIL
ME MENOR DE EDAD
P PASAPORTE
SC SALVOCONDUCTO
IdUsuario Varchar Número de Identificación del usuario
Password Varchar Password del usuario
Retorno: Cadena XML con el resultado del método con la siguiente estructura de
tags:
- Error: Indica si hubo un error en el Inicio de sesión; cero indica que el inicio de sesión
fue exitoso, un valor diferente a cero indica que se generó un error.
- DescripciónError: Descripción del error generado, el campo se genera vacío cuando el
código de error es cero.
- ClaveSesion: si el inicio de sesión fue exitoso se retorna una cadena de caracteres
que identifica la sesión actual y se requerirá para ejecutar algún método del
WebService.
76
8.2 Consultar Autorizaciones por Cédula
Este método permite la consulta de los datos del afiliado y los servicios
preautorizados que se le entregaron al usuario para utilización en la IPS.
String ConsultarCedula(string ClaveSesion, String Documento, short
TipoDocumento, String códigoIPS, String Usuario)
Nombre del Campo Tipo Dato Descripción

ClaveSesión Varchar Es la sesión entregada en el método de
IniciarSesión con el cual se autoriza la utilización del

Web Service
Documento Varchar(20) Documento del afiliado

TipoDocumento Entero Tipo Identificación
1 Cédula de Ciudadanía
2 Tarjeta Identidad
3 Registro Civil
4 No.Identificacion Tributaria
5 Cédula de Extranjeria
6 Personeria Juridica
7 Menor de Edad
8 Menor sin Identificacion
9 Numero de Identificacion Unico
10 Pasaporte
11 CARNET DIPLOMATICO
12 Salvoconducto
13 Certificado Nacido Vivo
14 Permiso Especial Permanencia
15 Adulto Sin Identificacion
CódigoIPS Varchar(5) Código de la IPS que solicita la

información, el cual es asignado por Salud Total
Usuario Varchar(50) Usuario de la IPS que solicita la
autorización.
Retorno: Cadena con el resultado XML de la consulta con la siguiente estructura de tags:
Nombre del Campo Descripción
77
Error Indica si hubo un error en la consulta y/o generación del XML; cero indica que la consulta
y el XML se generaron satisfactoriamente, un valor diferente a cero indica que se generó
un error.
DescripcionError Descripción del error generado, el campo se genera vacío cuando el código de error es
cero.
Contrato Número del contrato del afiliado o beneficiario, es un identificador del usuario.
Dociden Número de identificación del afiliado o beneficiario.
Tipodoc Tipo Identificación
2 Tarjeta Identidad
3 Registro Civil
7 Menor de Edad
10 Pasaporte
12 Salvoconducto
Nombre Nombres del afiliado o beneficiario.
Apellidos Apellidos del afiliado o beneficiario.
Codigoips Código de la IPS a la cual se autorizó el servicio, de acuerdo a la codificación Salud

Total.
Subcodigoips Sub código de la IPS.
Nitips Nit de la ips a la cual se le autorizo el servicio
Historia Número de la HC del paciente en Salud Total.
FecNacimiento Fecha de nacimiento del afiliado o beneficiario.
CodDpto Código del departamento de residencia del afiliado o beneficiario de acuerdo a la

codificación DANE.
CodCiudad Código del municipio de residencia del afiliado o beneficiario de acuerdo a la codificación
DANE.
Direccion Dirección de residencia del afiliado o beneficiario.
Telefono Teléfono del afiliado o beneficiario.
78
Sexo Sexo del afiliado 0 Femenino, 1 Masculino
EstadoCivil Estado civil del afiliado o beneficiario.
ZonaResidencia Zona de residencia del afiliado o beneficiario; U Urbana y R Rural.
RangoSalarial Rango en el que se encuentra el afiliado o beneficiario; A,B,C.
PorcentajeDescuento Porcentaje de descuento de cuota moderadora.
MotivoDescuento Motivo del descuento para el afiliado o beneficiario

0 – Ninguno
1 – Usuario Pensionado
TipoAfiliado Tipo de Afiliado:
C=Cotizante
B=Beneficiario
Datos de los Servicios
NumEntregaMed Es un identificador del servicio solicitado para utilizar posteriormente la autorización.
Producto Código del producto con el cual se autorizó el servicio (ver tabla #1 al final del
documento)
TipoAutorizacion Código del Tipo Autorizacion con la que se autorizó el servicio (ver tabla #2 al final del
documento).
Vecesservicio Cantidad de servicios autorizados Ej: Si el servicio es una Loratadina de 10 mg y se

recetaron 30 pastillas el valor de este campo será de 30.
CodigoIT Es el código del servicio según codificación manejada en Salud Total.
NombreServicio Nombre del servicio autorizado según nomenclatura manejada en Salud Total.
Status Estado de la autorización.
1 Preautorizada
2 Autorizada
3 Reversada
4 Rechazada
5 PRE-Autorizado Sin Entregar
7 Pendiente
8 Solicitud reversión
Condcerrado Estado en que se encuentra el NAP de esta transacción.
0 – Abierto
1 – Cerrado
79
Fecha_uso Fecha a partir de la cual puede ser utilizado el NAP
Formato de fecha: yyyy-MM-ss T hh:mm:ss-zonahoraria.
Ej: 2007-07-26T17:03:06-05:00
Fecha_vto Fecha de vencimiento del NAP
Ej: 2007-07-26T17:03:06-05:00
Validez Días de valides del NAP.
Usuarioseleccion Usuario que entrego o libero los servicios autorizados en el NAP.
Pago_final Valor del copago o cuota moderadora que debe cancelar el usuario en la IPS
Porc_cobertura Porcentaje que paga Salud total del servicio.
La diferencia debe ser cancelada por el usuario en la IPS
CodigoServicio Código del servicio de acuerdo a la codificación de la IPS.
MedicoRemite Nombre del médico que remitió el servicio.
DocumentoSolicitante Número de identificación del médico que remite.
CantidadDosis La cantidad de la dosis del medicamento.
MedidaDosis El nombre de la unidad de medida de la cantidad de la Dosis (Ver tabla #3)
Frecuencia Periodo de tiempo en el que se debe suministrar la dosis.
MedidaTiempo El nombre de la unidad de medida de tiempo de la frecuencia (Ver tabla #4)
Duracion El tiempo total de la posología.
ViaAdministracion El nombre de la vía por la cual se debe suministrar el medicamento (Ver tabla #5)
NumPrescripcion Numero de prescripción generado por MIPRES para el servicio. En caso de no existir un
numero de prescripción el campo se retornara vació.
ConOrden Consecutivo de orden generado por MIPRES para el servicio. En caso de no existir un
consecutivo el campo se retornara en 0.
Tecnologia Indica la tecnologia a la que pertenece el medicamento
Empresa Empresa de la autorización, contiene los siguientes valores:
1-> Salud Total EPS
2-> Virrey Solis
8402-> CAPITAL SALUD EPSS SAS
6969932-> CEMEV
8217448-> ASOCIACION MUTUAL SER
8235172-> EMSSANAR
8295676-> CAJA DE COMPENSACION FAMILIAR CAJACOPI ATLANTICO
CodigoConvenio Corresponde al código del convenio por el cual se realizó la autorización.
80
ConvenioVoucher Texto del convenio que aparece en el voucher, se utiliza para identificar convenios
especiales, por ejemplo Vivemas
CodigoProveedor Corresponde al codigo de la sede que va a proveer el servicio.
SedeProveedor Nombre de la sede que va a proveer el servicio.
ID_DireccionamientoMipres Id generado por medio del web service del ministerio correspondiente a lo direccionado
por parte de Salud Total
EstadoDireccionamientoMipres Estado en el cual se encuentra el proceso de Direccionamiento Mipres
PrescripcionTutela Indica si la prescripción corresponde a tutela
SI: Es prescripción tutela
NO: No es prescripción tutela.
ClaseServ Tipo de servicio
P-Procedimiento
M-Medicamento
S-Suministro
TipoUsuario Combinación entre régimen del producto (Contributivo, Subsidiado) del Nap del afiliado +
espacio + tipo de afiliado (Cotizante, Beneficiario)
ModContratacionPago Modalidad de contratación y pago
TipoPresupuesto Cobertura o plan de beneficios
PagosCompartidos Pagos compartidos en planes voluntarios de salud
NOTA: No se va a retornar los campos área, nombre área, concepto, nombre concepto, des-
cripción y nombre descripción para esta consulta. Por estos campos se retornaran: código servi-
cio(Es el código del servicio de acuerdo a la codificación de la IPS), código IT (Es el código del
servicio según codificación manejada en Salud Total) y nombre servicio (Nombre del servicio
autorizado según nomenclatura manejada en Salud Total).
8.3 Consultar autorizaciones por afiliado
Este método permite consultar las autorizaciones de un afiliado en cualquiera de los posibles
estados que este pueda encontrarse, para este se solicitan los siguientes datos:
ConsultarAutorizacionesAfiliado (String ClaveSesion, String Documento, short
TipoDocumento, DateTime FechaInicio, DateTime FechaFin)
ClaveSesion Varchar Es la sesión entregada en el método de IniciarSesion con el cual se

autoriza la utilización del Web Service
81
Documento Varchar(20) Documento del afiliado
TipoDocumento Short Tipo Identificación
2 Tarjeta Identidad
3 Registro Civil
7 Menor de Edad
10 Pasaporte
12 Salvoconducto
FechaInicio DateTime Fecha desde la se desea realizar la consulta de las autorizaciones.
FechaFin DateTime Fecha hasta la cual desea realizar la consulta de las autorizaciones.
Error Indica si hubo un error en la consulta y/o generación del XML; cero indica que la consulta y el
XML se generaron satisfactoriamente, un valor diferente a cero indica que se generó un error.
DescripcionError Descripción del error generado, el campo se genera vacío cuando el código de error es cero.
82
2 Tarjeta Identidad
3 Registro Civil
7 Menor de Edad
10 Pasaporte
12 Salvoconducto
Dociden Número de identificación del afiliado o beneficiario.
NombreProtegido Nombre completo del afiliado o beneficiario.
Nap Número de autorización del voucher.
Napa Número de autorización de la cual se deriva la autorización de este servicio.
CodigoSede Código de la sede a la cual se le autorizo el servicio.
NombreSede Nombre de la sede a la cual se le autorizo el servicio.
NitSede Nit de la sede a la cual se le autorizo el servicio
Usuario Nombre del usuario que radico la autorización.
OrigenServicio Nombre del origen del servicio.
FormaPago Forma en la que se va a realizar el pago por parte del afiliado o beneficiario
1. Cuota Moderadora
2. Copago
83
Estado Estado en el que se encuentra la autorización los cuales pueden ser los siguientes:
 Preautorizada
 Autorizada
 Reversada
 Rechazada
 PRE-Autorizado Sin Entregar
 Requiere validación
 Pendiente
 Solicitud reversión
FechaAprobación Fecha en la que se radicó la autorización.
Ej: 2007-07-26T17:03:06-05:00
FechaUtilización Fecha en la que se prestó el servicio.
Ej: 2007-07-26T17:03:06-05:00
NOTA: No se va a retornar los campos área, nombre área, concepto, nombre concepto, des-
cripción y nombre descripción para esta consulta. Por estos campos se retornaran: código servi-
cio(Es el código del servicio de acuerdo a la codificación de la IPS), código IT (Es el código del
servicio según codificación manejada en Salud Total) y nombre servicio (Nombre del servicio
autorizado según nomenclatura manejada en Salud Total).
84
8.4 Liberar NAP
Este método permite reportar la utilización de los servicios relacionados con un NAP. Para
ejecutar este método se debe haber ejecutado previamente la Consulta NAP o
ConsultarCedula ya que este método reporta un número de entrega que deberá ser entregado
nuevamente al WS.
String LiberarNAP(string ClaveSesion, int númeroEntrega, String Usuario).


Web Service.
NúmeroEntrega Entero Es un identificador del servicio autorizado
Entregado en la interface de consulta.
Autorización.
Retorno: Cadena con el resultado XML de la consulta

Error Indica si hubo un error en la Liberación del NAP; cero indica que el comando y
el XML se generaron satisfactoriamente, un valor diferente a cero indica que se
generó un error.
DescripciónError Descripción del error generado, el campo se genera vacío cuando el código de
error es cero.
NAP Si la liberación fue exitosa se devuelve el número del nap, de lo contrario se devuelve
en blanco.
85
8.5 Consultar por NAP
Este método permite la consulta por número de autorización de los datos del afiliado y los
servicios autorizados que se le entregaron al usuario.
String ConsultarNAP (string ClaveSesion, String NAP, String CodigoIPS, String Usuario).


Web Service.
NAP Varchar(16) Número de autorización del voucher.

información, el cual es asignado por Salud Total.

autorización.

Error Indica si hubo un error en la consulta y/o generación del XML; cero indica que la
consulta y el XML se generaron satisfactoriamente, un valor diferente a cero indica que
se generó un error.
error es cero.
Contrato Número del contrato del afiliado o beneficiario, es un
identificador del usuario.
Dociden Número de identificación del beneficiario.
86
2 Tarjeta Identidad
3 Registro Civil
7 Menor de Edad
10 Pasaporte
12 Salvoconducto
Nombre Nombres del beneficiario.

Apellidos Apellidos del beneficiario.
documento).
Códigoips Código de la IPS a la cual se autorizó, de acuerdo a codificación Salud
Total.
Subcódigoips Sub código de la IPS.
1 Preautorizada
2 Autorizada
3 Reversada
4 Rechazada
7 Pendiente
87
Condcerrado Estado en que se encuentra el Nap de esta transacción.
0 – Abierto; 1 – Cerrado;
fecha_uso Fecha a partir de la cual puede ser utilizado el nap Formato de fecha: yyyy-MM-ss T
hh:mm:ss-zonahoraria.
Ej: 2007-07-26T17:03:06-05:00
fecha_vto Fecha de vencimiento del NAP
Formato de fecha: yyyy-MM-ss T hh:mm:ss-zonahoraria. Ej: 2007-07-26T17:03:06-

05:00
Usuarioselección Usuario le entrego o libero los servicios autorizados en el nap.
pago_final Valor del copago o cuota moderadora que debe cancelar el usuario en la IPS.
porc_cobertura Porcentaje que paga Salud total del servicio.
La diferencia debe ser cancelada por el usuario en la IPS.
Historia Número de la HC del paciente en Salud Total
FecNacimiento Fecha de Nacimiento del usuario.

CodDpto Código del departamento de residencia del paciente de acuerdo a la codificación
CodCiudad Código del municipio de residencia del paciente de acuerdo a la codificación DANE
Dirección Dirección de residencia del afiliado.
Teléfono Numero telefonico residencia del afiliado.

Sexo Sexo del afiliado: 0 Femenino, 1 Masculino.
EstadoCivil Estado civil del afiliado.
NumHistCotizante Número de historia del cotizante.

ZonaResidencia Zona de residencia del usuario: U Urbana y R Rural.
RangoSalarial Rango en el que se encuentra el afiliado. 1 - A; 2 - B; 3 - C.
Porcentaje Descuento Porcentaje de descuento de Cuota Moderadora.
Motivo Descuento Motivo del descuento para el afiliado
0 – Ninguno
NumEntregaMed Es un identificador del servicio autorizado para utilizar posteriormente la autorización.
vecesservicio Cantidad de servicios autorizados.
Ej: Si el servicio es una Loratadina de 10 mg y se recetaron 30 pastillas el valor de

este campo será de 30.
codigoServicio Código del servicio de acuerdo al tarifario base pactado con la IPS ISS 99, SOAT.
MedicoRemitente Nombre del Médico que remitió el servicio
88
CantidadDosis La cantidad de la Dosis del medicamento
Frecuencia Periodo de tiempo en el que se debe suministrar la dosis
MedidaTiempo El nombre de la unidad de medida de tiempo de la Frecuencia (Ver tabla #4)
Duracion El tiempo total de la posología
NumPrescripcion Numero de prescripción generado por MIPRES para el servicio. En caso de no existir
un numero de prescripción el campo se retornara vació.
1-> Salud Total EPS
2-> Virrey Solís
6969932-> CEMEV
8235172-> EMSSANAR

CodigoProveedor Corresponde al código de la sede que va a proveer el servicio.
PrescripcionTutela Indica si la prescripcion corresponde a tutela
TipoUsuario Combinación entre régimen del producto (Contributivo, Subsidiado) del Nap del afiliado
+ espacio + tipo de afiliado (Cotizante, Beneficiario)
89
8.6 Consultar NAP Entregado
Este método permite la consulta por número de autorización de los datos del afiliado y los
String ConsultarNAP (string ClaveSesion, String NAP, String CodigoIPS, String Usuario).


Web Service.
NAP Varchar(16) Número de autorización del voucher.


autorización.

error es cero.
90
2 Tarjeta Identidad
3 Registro Civil
7 Menor de Edad
10 Pasaporte
12 Salvoconducto

documento).
Total.
1 Preautorizada
2 Autorizada
3 Reversada
4 Rechazada
7 Pendiente
91
0 – Abierto; 1 – Cerrado;
hh:mm:ss-zonahoraria.
Ej: 2007-07-26T17:03:06-05:00
fecha_vto Fecha de vencimiento del NAP
Formato de fecha: yyyy-MM-ss T hh:mm:ss-zonahoraria. Ej: 2007-07-26T17:03:06-

05:00
La diferencia debe ser cancelada por el usuario en la IPS.



0 – Ninguno
NumEntregaMed Es un identificador del servicio autorizado para utilizar posteriormente la autorización.

92
CantidadDosis La cantidad de la Dosis del medicamento
1-> Salud Total EPS
2-> Virrey Solís
6969932-> CEMEV
8235172-> EMSSANAR

PrescripcionTutela Indica si la prescripcion corresponde a tutela
93
8.7 Consultar Prescripción
Este método permite la consulta por número de prescripción de los datos del afiliado y los
String ConsultarPrescripcion (string ClaveSesion, String Prescripcion, String Nit, String
Usuario).


Web Service.
Prescripcion Varchar(20) Número de autorización del voucher.
Nit Varchar(20) Código de la IPS que solicita la


autorización.

error es cero.
94
2 Tarjeta Identidad
3 Registro Civil
7 Menor de Edad
10 Pasaporte
12 Salvoconducto

Total.



95
0 – Ninguno
TipoAfiliado Indica el tipo afiliado:
1: Cotizante 2: Beneficiario
documento).
Tipo Autorización Código del Tipo Autorización con la que se autorizó el servicio (ver tabla #2 al final del
documento).

1 Preautorizada
2 Autorizada
3 Reversada
4 Rechazada
7 Pendiente

fecha_vto hh:mm:ss-zonahoraria.
Fecha de vencimiento del NAP
DocumentoSolicitante Numero de documento o registro médico del Especialista que remitió la orden medica
96
Tecnología Indica la tecnología a la que pertenece el medicamento suministrado:
0 Ninguno
N Producto Nutricional
M Medicamento
P Procedimiento
D Dispositivo
S Servicio Complementario
1-> Salud Total EPS
2-> Virrey Solís
6969932-> CEMEV
8235172-> EMSSANAR

ID_Dispensacion Indica el ID con el que se dispenso el medicamento
NoEntrega Indica el número de entrega Medica
PrescripcionTutela Indica si la prescripción corresponde a tutela
97
8.8 Consultar Acción Entrega Parcial
Este método permite la consulta de las acciones para entregas parciales.

String ConsultarAccionEntregaParcial(string ClaveSesion)


Web Service.

ID_TM_SesionUsuario Identificador de sesión de usuario.
ID Identificador de la acción de entrega parcial.
Nombre Nombre de la acción de entrega parcial.
Libera Identifica si la acción libera el servicio 0-No 1-Si
Estado Estado del registro 0-Inactivo 1-Activo
8.9 Consultar Motivo Entrega Parcial
Este método permite la consulta de motivos de entrega parcial por acción.

String ConsultarMotivoEntregaParcialxAccion(string ClaveSesion,int IdAccionEntregaParcial)


Web Service.
IdAccionEntregaParcial Int Identificador de la acción para entrega parcial obtenido en el

punto 8.8
98

ID_TM_SesionUsuario Identificador de sesión de usuario.
ID Identificador del motivo de entrega parcial.
ID_TP_AccionEntregaParcial Identificador de la acción de entrega parcial.
Nombre Nombre del motivo de entrega parcial.
MotivoServicioPrestado Identifica si el motivo es de servicio prestado para poder liberar 0-No 1-Si
Estado Estado del registro 0-Inactivo 1-Activo
8.10 Liberar NAP V1
Este método permite reportar la utilización de los servicios relacionados con un NAP. Para
ejecutar este método se debe haber ejecutado previamente la Consulta NAP o
ConsultarCedula ya que este método reporta un número de entrega que deberá ser entregado
nuevamente al WS.
String LiberarNAPV1(string ClaveSesion, int númeroEntrega, String Usuario, int Cantidad, int
IdMotivoEntregaParcial ).


Web Service.
NúmeroEntrega Entero Es un identificador del servicio autorizado
Entregado en la interface de consulta.
Autorización.
Cantidad int Cantidad del servicio a entregar.
IdMotivoEntregaParcial Int Identificar del motivo de entrega parcial.
99
Retorno: Cadena con el resultado XML de la consulta

Error Indica si hubo un error en la Liberación del NAP; cero indica que el comando y
el XML se generaron satisfactoriamente, un valor diferente a cero indica que se
generó un error.
error es cero.
NAP Si la liberación fue exitosa se devuelve el número del nap, de lo contrario se devuelve
en blanco.
100
9 Tablas Referencia
9.1 Tabla 1 – Productos
ID Nombre
0 Ninguno
1 POS
2 ALIANZA ALLIANZ
3 ALIANZA GENERALI
4 ALIANZA LIBERTY
5 ALIANZA MAPFRE
6 ALIANZA PANAMERICAN
7 DENTOTAL PLUS
8 MAS POS
9 NO POS
10 SALUD DIRECTA
11 POS Subsidiado
12 NO POS Subsidiado
13 PARTICULAR
14 ALIANZA BOLIVAR
15 ALIANZA ESP. MED PLUS
16 ALIANZA COLPATRIA
17 DERMATOLOGIA PLUS
18 PLAN GAMA
19 PLAN DELTA
20 PLAN OMEGA
101
21 GINECOLOGIA LASER
22 PLAN ALFA
23 ALIANZA COOMEVA
25 FOME
26 FOME SUBSIDIADO
27 ALIANZA COLMEDICA
9.2 Tabla 2 – Tipo Autorización
ID NOMBRE
1 ALIANZA
2 ATEP
3 CAPITADO
4 DENTOTAL PLUS
5 FOMENTO
6 NO POS
7 PAD
8 PARTICULAR
9 POS
10 SALUD DIRECTA
11 DERIV. URGENCIAS
12 TUTELA
13 SOAT
14 DERMATOLOGIA PLUS
15 CAPITADO POS
16 NO FACTURABLE
17 PAC
102
18 FOME
9.3 Tabla 3 - Unidades de Medida
CÓDIGO NOMBRE
6 Aplicacion(es)
7 Centímetro(s) cúbico(s)
8 ELISA unit
9 gramo(s)
10 Gigabecquerel
11 Gota(s)
12 Julio(s)
13 kilobecquerel
14 Kilo Calorías
15 Kilo unidades internacionales
16 Límite de floculación
17 Megabecquerel
18 microgramo(s)
19 mcg/h
20 mcg/kg
21 mcg/m3
22 milicurio(s)
23 micromol(es)
24 miliequivalente(s)
25 miligramo(s)
26 mililitro(s)
27 milimol(es)
28 Millon(es) de UI
103
29 Nanogramo(s)
30 onza(s)
31 Puff
32 Sobre(s)
33 Unidad(es) internacional(es)
34 Unidad(es) de Tuberculina
35 Tableta (s)
36 Cápsula (s)
38 mg/h
39 mg/kg
40 Jeringa Prellenada
41 Vial
42 Ampolla
43 Frasco
44 Frasco Ampolla
45 Cartucho
46 Inyector Prellenado
47 Pen
48 Caja
49 Parche
50 Pluma
51 Kwipen
52 Autoinyector
53 Litro
54 Supositorio
55 Dosis
56 Enema
104
9.4 Tabla 4 - Unidades de Medida de Tiempo
CÓDIGO NOMBRE
1 Hora (s)
2 Día (s)
3 Mes (es)
4 Semana (s)
5 Año (s)
37 Minuto (s)
9.5 Tabla 5 - Vías de Administración
CÓDIGO NOMBRE
1 Bucal
2 Conjuntival
3 Dental
4 Epidural
5 Hemodialisis
6 Implante
7 Inhalación
8 Insuflación
9 Intra-Arterial
10 Intra-Articular
11 Intra-Cardiaca
12 Intracavernosa
13 Intradermal
14 Intraespinal
105
15 Intralesional
16 Intralinfatica
17 Intramuscular
18 Intranasal
19 Intraocular
20 Intraperitoneal
21 Intrapleural
22 Intratecal
23 Intratraqueal
24 Intrauterina
25 Intravenosa
26 Intravesical
27 Oral
28 Otico Auricular
29 Parenteral
30 Rectal
31 Subcutanea
32 Sublingual
33 Topica(externa)
34 Transdermal
35 Uretral
36 Vaginal
106
10 ERRORES
A continuación se relacionan los posibles errores que puede mostrar el sistema.

ERROR DESCRIPCIÓN ERROR MOTIVO ERROR
DATOS - USUARIO (Protegido)
Datos incompletos Faltan datos para ejecutar el Este error se genera cuando
procedimiento hace falta algún parametro al
momento de consumir el
metodo.
Error por BD Error en la consulta a la base Se genera cuando se presenta
de datos alguna interrupción en a nivel
de Base de Datos - Servidor
Estado de Usuario El estado del usuario es: XXX Se genera cuando el estado del
Protegido no es alguno de los
habilitados para poder realizar
transacciones.
Datos Inexistentes No se encontraron datos en la Se presenta cuando el
base de datos. documento digitado, no existe
en las bases de datos de Salud
Total.
DATOS - NAP
NAP Inexistente No se encontraron datos del Este error se genera cuando el
nap XXX de la Sede XXX NAP ingresado, no existe en
Salud Total.
Vigencia del NAP (Vencido) El nap XXX no se encuentra Se presenta cuando el NAP es
vigente. posterior a la fecha de
vencimiento del mismo
Vigencia del NAP (Futuro) El uso del nap XXX es futuro. Se presenta cuando el NAP se
encuentra pendiente por ser
Futuro (medicamentos
posfechados)
NAP entregado El nap XXX ya se encuentra Se presenta cuando el NAP ya
entregado. se encuentra liberado
NAP NO Aprobado El nap XXX no se encuentra Se presenta cuando el estado
aprobado. del NAP es diferente a
Aprobado
NAP Cerrado El nap XXX se encuentra Se presenta cuando el estado
cerrado. del NAP es Cerrado
NAP Reversado El nap XXX se encuentra Se presenta cuando el estado
reversado. del NAP es Reversado
TRANSMISIÓN DE DATOS (XML)
107
Envío Correcto <Error> 0 </Error> Indica que los datos se
enviaron sin errores de
estructura
Error Estructura <Error> 98 </Error> Indica que se envió información
errada a nivel de estructura del
XML. El retorno de este error,
muestra en donde se presenta
el inconveniente.
Error Falta de datos <error>99</error> Se presenta cuando se
consume el método sin ingresar
datos a los campos de
ClaveSesión y/o XML
108

A23-Tsi 7

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

A23-Tsi 7

Cargado por

Copyright:

Formatos disponibles

INTERCAMBIO ELECTRÓNICO DE REGISTROS

ENTRE IPS – SALUD TOTAL EPS-S

Gracias a nuestro portal, www.saludtotal.com.co, nuestros procesos se han hecho más

1. Transferencia Electrónica de registros de Facturación

1 TRANSFERENCIA ELECTRÓNICA DE REGISTROS DE FACTURACIÓN...........................................................4

 Implementar un sistema que permita la integración del proceso de facturación

 Realizar una validación de los servicios autorizados por Salud Total,

 La facturación de la IPS se radica y registra electrónicamente a través de

1.2 Beneficios para la IPS

Ingreso a opción transaccional de la página WEB salud total donde encontrará

En el Manual de usuario transferencia electrónica de facturación (MU07-CS), se

Este proceso de trasmisión electrónica de registros de facturación está divido en dos

Este proceso recibe un solo archivo con la estructura explicada en el Anexo 1.

Este proceso envía 3 archivos de respuesta así:

Archivo en el cual se envían los números de autorizaciones correctos o incorrectos.

La descripción de cada uno de los archivo la encuentra en el anexo 1 (Estructura

Por Ejemplo. Como sugerencia prenap_Am_10_1_2007_13_15.txt, lo cual describe:

Basado en el proceso anterior, la IPS revisa que número(s) de autorización(es) esta(n)

Lo cual describe lo siguiente:

CLNSR : Siglas de la IPS

Posteriormente al cargue de los archivos en la página de Salud Total, se remiten

2 TRANSFERENCIA DE RESULTADOS DE APOYO DIAGNÓSTICO A

 Permitir que las IPS, dispongan de resultados de laboratorios clínicos y

2.2 Beneficios para la IPS

 Disminución de costos por administración de cero papeles.

- El usuario asiste a la IPS para la toma de exámenes de laboratorio solicitados

- Cuando la IPS envía el XML (definición de XML en Anexo 2) , entra a

- Si cumple con la estructura del archivo realiza el siguiente proceso:

1. Valida que el usuario este afiliado a Salud Total.

Una vez cumpla el paso 1 y el paso de 2 se hace el cargue del resultado a

- La dirección del WEB service se encuentra en:

 Brindar a la IPS a través de este WEB Service, la posibilidad de hacer

 Evitar la doble digitación en el proceso de autorizaciones.

3.3 Especificaciones Técnicas

Ver Anexo No. 3

La dirección del WEB service se encuentra en:

 Brindar a la IPS a través del WEB Service, la posibilidad de solicitar la

4.2 Beneficios para la IPS

 Evitar mala digitación en el número de autorización en el sistema de la IPS.

4.3 Especificaciones Técnicas

La dirección del WEB service se encuentra en:

Para la documentación de las interfaces ver el Anexo No. 4.

ESPECIFICACIÓN ARCHIVO TÉCNICO TRANSFERENCIA ELECTRÓNICA

5.1 Prevalidación de NAPS

Nombre del Campo Tipo Tamaño Descripción

Nota: En caso de ser menor sin identificación (MS), ingresar el

MS MENOR SIN IDENTIFICACION

NIU NUMERO DE IDENTIFICACION UNICO

CN CERTIFICADO DE NACIDO VIVO

PE PERMISO ESPECIAL DE PERMANENCIA

Nap Varchar 16 Número de autorización asignado por Salud Total.

TipoServicio smallint 1. Ambulatorio

FechaServicio Varchar 10 Fecha de prestación del servicio del Nap (DD/MM/YYYY).

Archivo 1 de Respuesta de la EPS.

Nombre del Campo Tipo Tamaño Descripción

NúmeroLínea Int Número de la línea en la que la IPS envió el NAP

TipoDoc Varchar 2 C CEDULA DE CIUDADANIA

MS MENOR SIN IDENTIFICACION

NIU NUMERO DE IDENTIFICACION UNICO

CN CERTIFICADO DE NACIDO VIVO

PE PERMISO ESPECIAL DE PERMANENCIA

NAP Varchar 16 Número de autorización asignado por Salud Total.

FechaRespuesta Varchar 10 Fecha de respuesta (DD/MM/AAAA)