From 26243aa2bcdb57da00c73c833f9c4628356aec2c Mon Sep 17 00:00:00 2001 From: Lizandro Guarnizo <77708265+lizandrogd@users.noreply.github.com> Date: Thu, 25 Jun 2026 16:34:12 -0500 Subject: [PATCH] =?UTF-8?q?docs:=20agregar=20documentaci=C3=B3n=20endpoint?= =?UTF-8?q?s=20API=20y=20actualizar=20BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Sonnet 4.6 --- Documentacion Endpoints API.html | 408 +++++++++++++++++++++++++++++++ rips_manager.db | Bin 40960 -> 40960 bytes 2 files changed, 408 insertions(+) create mode 100644 Documentacion Endpoints API.html diff --git a/Documentacion Endpoints API.html b/Documentacion Endpoints API.html new file mode 100644 index 0000000..d01e70c --- /dev/null +++ b/Documentacion Endpoints API.html @@ -0,0 +1,408 @@ + + + + + +Documentación Endpoints API + + + + +

Documentación Endpoints API

+ +

1. Crear Tercero

+ +
POST /v{version}/tablas/Tercero/Crear
+ +

Campos Generales

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CampoTipoReqDescripción
CodigostringCódigo del tercero
NatJuridicacharN=Natural, J=Jurídica
TipoDocumentocharC=Cédula, N=NIT, etc.
NitstringNúmero de documento
NombrestringNombre completo
DireccionstringNoDirección de residencia
CodigoCiudadstringCódigo de ciudad (default "00")
NombreCiudadstringNombre de ciudad (default "SIN CIUDAD")
Zona1stringCódigo de zona (default "00")
ClasificacionstringCódigo de clasificación (default "00")
TelefonostringNúmero de teléfono
EmailstringCorreo electrónico
Inactivoboolfalse
Privadachar"N"
Mixtachar"N"
CodigoBarriostringCódigo de barrio (default "00")
ComisiondoublePorcentaje de comisión (default 0)
CiudadExpstringNoCiudad de expedición del documento
FechaExpstringNoFecha de expedición
NomRegTristringNoNombre tributario
Nombre1stringNoPrimer nombre
Nombre2stringNoSegundo nombre
Apellido1stringNoPrimer apellido
Apellido2stringNoSegundo apellido
CodigoVendedorstringNoCódigo del vendedor asignado
CodigoCobradorstringNoCódigo del cobrador asignado
FechaNacimientostringNodd/MM/yyyy
CodigoEstaCivilstringNoCódigo de estado civil
CodigoClasifica2stringNoCódigo de clasificación 2
CodigoCuentaAuxiliarstringNoCuenta auxiliar deudor
InquilinocharNo"S" / "N"
ClientecharNo"S" / "N"
ProveedcharNo"S" / "N"
VendedcharNo"S" / "N"
CobracharNo"S" / "N"
AccionistacharNo"S" / "N"
AsociadocharNo"S" / "N"
OtrocharNo"S" / "N"
MostradorcharNo"S" / "N"
FiadorcharNo"S" / "N"
PropietariocharNo"S" / "N"
EmpleadocharNo"S" / "N"
ListaPreciostringNoCódigo de lista de precios
EmailDosstringNoCorreo electrónico secundario
+ +

Campos de Salud

+ + + + + + + + + + + + + + + + + + + + +
CampoTipoReqValores
ZonastringNo"01"=Urbana, "02"=Rural
SexostringNo"M"=Hombre, "F"=Mujer, "O"=Indeterminado
EstadoCivilstringNo"1"=Soltero, "2"=Casado, "3"=Unión Libre, "4"=Viudo, "5"=Separado
EtniastringNo"1"=Indígena, "2"=ROM, "3"=Raizal, "4"=Palenquero, "5"=Negro/mulato/afro, "6"=Otras, "99"=Ninguna
NivelEscolaridadstringNo"NO"=No Aplica, "PR"=Preescolar, "BA"=Básica Primaria, "BS"=Básica Secundaria, "ME"=Media, "TE"=Técnica, "TC"=Tecnológica, "UN"=Universitaria, "PO"=Posgrado
IdentidadGenerostringNo"01"=Masculino, "02"=Femenino, "03"=Transgénero, "04"=Neutro, "05"=No lo declara
GestantestringNo"T1"=1er Trimestre, "T2"=2do Trimestre, "T3"=3er Trimestre, "PU"=Puerperio
DuracionLactanciastringNo"M1"=<1 mes, "M3"=1-3 meses, "M6"=3-6 meses, "MA"=>6 meses, "A1"=>1 año
DuracionLactanciaExclusivastringNo"M1"=<1 mes, "M3"=1-3 meses, "M6"=3-6 meses
InicioAlimentacionComplementariastringNo"M1"=<1 mes, "M3"=1-3 meses, "M6"=3-6 meses
VictimaViolenciastringNo"MA"=Mina Antipersona, "DS"=Desmovilizado, "RI"=Reinsertado, "IF"=Intrafamiliar
EnfermedadCronicaboolNotrue / false
NoEnviarMinSaludboolNotrue / false
FechaFallecimientostringNoFormato: dd/MM/yyyy HH:mm:ss
NumeroPolizastringNoTexto libre, máximo 20 caracteres
DiscapacidadstringNoCódigos separados por coma (ver tabla abajo)
LugarNacimientostringNoCódigo de ciudad (catálogo ciudane)
+ +

Discapacidad

+ +

Códigos separados por coma (ej: "01,02" para múltiples).

+ + + + + + + + + + + +
CódigoDescripción
"01"Discapacidad Física
"02"Discapacidad Visual
"03"Discapacidad Auditiva
"04"Discapacidad Intelectual
"05"Discapacidad Sicosocial (Mental)
"06"Sordoceguera
"07"Discapacidad Múltiple
"08"Sin Discapacidad
+ +

Ejemplo JSON

+
{
+  "Codigo": "12345",
+  "NatJuridica": "N",
+  "TipoDocumento": "C",
+  "Nit": "1234567890",
+  "Nombre": "Juan Pérez",
+  "Direccion": "Calle 123 # 45-67",
+  "CodigoCiudad": "00",
+  "NombreCiudad": "SIN CIUDAD",
+  "Zona1": "00",
+  "Clasificacion": "00",
+  "Telefono": "3001234567",
+  "Email": "juan@correo.com",
+  "Inactivo": false,
+  "Privada": "N",
+  "Mixta": "N",
+  "CodigoBarrio": "00",
+  "Comision": 0,
+  "Sexo": "M",
+  "Zona": "01",
+  "Etnia": "5",
+  "EstadoCivil": "1",
+  "NivelEscolaridad": "UN",
+  "IdentidadGenero": "01",
+  "FechaNacimiento": "01/01/1990",
+  "EnfermedadCronica": false,
+  "NoEnviarMinSalud": false
+}
+ +
+ +

2. Insertar RDA Paciente

+ +
POST /v{version}/rda/RdaPaciente/Insertar?codigosucursal={codigo}
+ +

Campos Header

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
CampoTipoReqDescripción
CodigoPrefijostringPrefijo del documento (default "00")
NumerostringNoNúmero del registro (vacío = auto-generado)
FechastringFecha del registro, formato dd/MM/yyyy
CodTercerostringCódigo del paciente (tercero)
CodVendedorstringNoCódigo del vendedor (default "00")
CodFormaPagostringCódigo de forma de pago (default "CO")
CodBancostringNoCódigo del banco (default "00")
FechaVencestringNoFecha de vencimiento, formato dd/MM/yyyy
PlazoDiasintNoDías de plazo
CodigoCentroCostostringNoCódigo del centro de costo (default "00")
CodigoAreastringNoCódigo del área
ObservacionstringNoObservación del documento
tipoIngresostringNoVer tabla de tipos de ingreso
fechaHoraIngresostringNoFormato dd/MM/yyyy HH:mm:ss
fechaHoraEgresostringNoFormato dd/MM/yyyy HH:mm:ss
modalidadAtencionstringNoVer tabla de modalidades de atención
numeroContratostringNoCódigo del contrato (catálogo de la empresa)
diagnosticoprincipalstringNoCódigo CIE-10 (catálogo hosp_diagnosticos)
tipousuariostringNoVer tabla de tipos de usuario
viaIngresostringNoVer tabla de vías de ingreso
esTerapiaboolNotrue / false
esProcedimientoboolNotrue / false
numeroAutorizacionstringNoNúmero de autorización
fechaAutorizacionstringNoFormato dd/MM/yyyy
vigenciaAutorizacionintNoDías de vigencia de la autorización
+ +

Tipo de Ingreso (tipoIngreso)

+ + + + + + +
CódigoDescripción
"1"Ambulatorio
"2"Hospitalario
"3"Urgencias
+ +

Vía de Ingreso (viaIngreso)

+ + + + + + + + + + + + + + + + + +
CódigoDescripción
"01"Demanda Espontánea
"02"Derivado de Consulta Externa
"03"Derivado de Urgencias
"04"Derivado de Hospitalización
"05"Derivado de Sala de Cirugía
"06"Derivado de Sala de Partos
"07"Recién Nacido en la Institución
"08"Recién Nacido en Otra Institución
"09"Derivado o Referido de Hospitalización Domiciliaria
"10"Derivado de Atención Domiciliaria
"11"Derivado de Telemedicina
"12"Derivado de Jornada de Salud
"13"Referido de Otra Institución
"14"Contrareferido de Otra Institución
+ +

Modalidad de Atención (modalidadAtencion)

+ + + + + + + + + + + +
CódigoDescripción
"01"Intramural
"02"Extramural Unidad Móvil
"03"Extramural Domiciliaria
"04"Extramural Jornada de Salud
"06"Telemedicina Interactiva
"07"Telemedicina No Interactiva
"08"Telemedicina Telexperticia
"09"Telemedicina Telemonitoreo
+ +

Tipo de Usuario (tipousuario)

+ + + + + + + + + + + + + + + +
CódigoDescripción
"01"Contributivo Cotizante
"02"Contributivo Beneficiario
"03"Contributivo Adicional
"04"Subsidiado
"05"Sin Régimen
"06"Especiales o de Excepción Cotizante
"07"Especiales o de Excepción Beneficiario
"Pe"Particular
"09"Tomador/Amparado ARL
"10"Tomador/Amparado SOAT
"11"Tomador/Amparado Planes Voluntarios de Salud
"12"Particular
+ +
Importante: El campo tipousuario se consulta por el código string (ej: "01", "Pe"), no por ID numérico.
+ +

Contrato (numeroContrato)

+ +

El código del contrato corresponde a la tabla contratosips. Es un catálogo configurado por cada empresa.

+ +

Diagnóstico Principal (diagnosticoprincipal)

+ +

Código CIE-10. Se consulta en la tabla hosp_diagnosticos.

+ +

Campos del Detalle (DetallePedido)

+ +

Cada elemento del arreglo DetallePedido:

+ + + + + + + + + + + + + + + + + + + + + +
CampoTipoReqDescripción
CodigoMaterialstringCódigo del artículo/servicio
CodigoBodegastringCódigo de bodega (default "00")
CantidaddoubleCantidad del servicio
TipoUnidadstring"D"=Unidad, "M"=Mayor (default "D")
ValordoubleValor unitario
DescuentodoubleNoPorcentaje de descuento
PorcentajeIvadoubleNoPorcentaje de IVA
ImpConsumodoubleNoImpuesto al consumo
ObservacionstringNoObservación del detalle
profesionalstringNoNombre de usuario del profesional
profesionalRemisionantestringNoCódigo del tercero remisionante
especialidadstringNoCódigo de especialidad (catálogo de la empresa)
diagnosticoprincipalstringNoCódigo CIE-10 del detalle
idMipresstringNoID MIPRES
fechaHoraRealizacionstringFormato dd/MM/yyyy HH:mm:ss
numeroAutorizacionstringNoNúmero de autorización del detalle
fechaAutorizacionstringNoFormato dd/MM/yyyy
vigenciaAutorizacionintNoDías de vigencia
+ +
Importante: especialidad usa el código configurado por cada empresa en la tabla especialidad. profesional usa el nombre de usuario del sistema (tabla usuarios). profesionalRemisionante usa el código del tercero (tabla terceros).
+ +

Campos Detalle Forma de Pago (DetalleFormaPago)

+ + + + + + + +
CampoTipoReqDescripción
CodigoFormaPagostringCódigo de la forma de pago
PlazoDiasstringDías de plazo
FechaVencimientostringFecha de vencimiento
ValorstringValor de la forma de pago
+ +

Ejemplo JSON

+
{
+  "CodigoPrefijo": "00",
+  "Numero": "",
+  "Fecha": "19/06/2026",
+  "CodTercero": "12345",
+  "CodVendedor": "00",
+  "CodFormaPago": "CO",
+  "CodBanco": "00",
+  "CodigoCentroCosto": "00",
+  "tipoIngreso": "1",
+  "fechaHoraIngreso": "19/06/2026 08:00:00",
+  "fechaHoraEgreso": "19/06/2026 10:00:00",
+  "modalidadAtencion": "01",
+  "numeroContrato": "CT-001",
+  "diagnosticoprincipal": "J00",
+  "tipousuario": "01",
+  "viaIngreso": "01",
+  "esProcedimiento": false,
+  "esTerapia": false,
+  "DetallePedido": [
+    {
+      "CodigoMaterial": "890201",
+      "CodigoBodega": "00",
+      "Cantidad": 1,
+      "TipoUnidad": "D",
+      "Valor": 50000,
+      "Descuento": 0,
+      "PorcentajeIva": 0,
+      "ImpConsumo": 0,
+      "Observacion": "",
+      "profesional": "juan.medico",
+      "especialidad": "ESP001",
+      "diagnosticoprincipal": "J00",
+      "fechaHoraRealizacion": "19/06/2026 09:00:00",
+      "idMipres": ""
+    }
+  ],
+  "DetalleFormaPago": [
+    {
+      "CodigoFormaPago": "CO",
+      "PlazoDias": "0",
+      "FechaVencimiento": "19/06/2026",
+      "Valor": "50000"
+    }
+  ]
+}
+ +
+ +

Notas Generales

+ + + + + \ No newline at end of file diff --git a/rips_manager.db b/rips_manager.db index 8e7ced6303055b1e3f73408ee446c3a0a42eeda4..0ca5a67cea7fe5e6827bbe1d0c91fbfcb95458bc 100644 GIT binary patch delta 126 zcmZoTz|?SnX+wy-se5*KM0rqtae1bxYqD`@m`9#lfO~1Wx4wB=YI$+FM?`v1c$8;w ePGD4_cTuKaVo647O8DeXd42M9Zhk8-+yDSRBQ3H3 delta 126 zcmZoTz|?SnX+wy-sbhw_YeYqvi$}0oMOjE{X=-|;Uy`1lk#SCjxksp@le1~1dwFSv zi@9%xM?sKJVx*t5oBQNWd3{qeXCJS^RHI5i$0EIwkO+(X3a8BE)C%*8WPNk@V$Wjt d@RHo{!axh3R3{^SZ^z)Ig7Cz`&2Qy}8vvo_D+&Mr