API docs by Redocly

MinSalud.SIIFA.API.Factura (v1.0.4)

Download OpenAPI specification:Download

EmpresaCuentaBancaria

Crea una nueva cuenta bancaria para una empresa.

Este endpoint permite registrar una nueva cuenta bancaria asociada a una empresa.

Información requerida:

  • Nit: NIT de la empresa propietaria de la cuenta
  • CodigoBanrep: Código del banco de la República (FK a REFERENCIA_BANCO)
  • CodigoTipoCuenta: Tipo de cuenta del dominio 12 (1201-AHORROS, 1202-CORRIENTE, 1203-NOMINA)
  • NumeroCuenta: Número de cuenta bancaria
  • Titular: Nombre del titular de la cuenta
  • EsCuentaPrincipal: Indica si es la cuenta principal de la empresa
  • Observaciones: Notas adicionales (opcional)

Seguridad y roles:

  • SIIFA_Admin: Puede crear cuentas para cualquier empresa
  • SIIFA_ERP, SIIFA_ERP_Gestor, SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS y SIIFA_FITS_Gestor: Solo pueden crear cuentas para su propia empresa (NitEntidad del JWT)

Validaciones:

  • El NIT debe existir en la tabla EMPRESA
  • El banco (CodigoBanrep) debe existir en REFERENCIA_BANCO
  • El tipo de cuenta debe ser del dominio 12 (TIPO_CUENTA_BANCARIA)
  • No puede haber cuentas duplicadas (mismo NIT + banco + número de cuenta)
  • Si se marca como cuenta principal, no puede haber otra cuenta principal activa para el mismo NIT
  • El número de cuenta no puede exceder 50 caracteres
  • El titular no puede exceder 300 caracteres
  • Las observaciones no pueden exceder 500 caracteres

Sample request:

POST /api/EmpresaCuentaBancaria
{
    "nit": 900123456,
    "codigoBanrep": 1,
    "codigoTipoCuenta": 1202,
    "numeroCuenta": "1234567890",
    "titular": "EMPRESA EJEMPLO S.A.S.",
    "esCuentaPrincipal": true,
    "observaciones": "Cuenta para pagos principales"
}
Authorizations:
Bearer
Request Body schema:

Objeto con los datos de la nueva cuenta bancaria.

nit
integer <int32>
codigoBanrep
integer <int32>
codigoTipoCuenta
integer <int32>
numeroCuenta
string or null
titular
string or null
esCuentaPrincipal
boolean
observaciones
string or null

Responses

Request samples

Content type
{
  • "nit": 0,
  • "codigoBanrep": 0,
  • "codigoTipoCuenta": 0,
  • "numeroCuenta": "string",
  • "titular": "string",
  • "esCuentaPrincipal": true,
  • "observaciones": "string"
}

Response samples

Content type
application/json
{
  • "idEmpresaCuentaBancaria": 0,
  • "nit": 0,
  • "codigoBanrep": 0,
  • "codigoTipoCuenta": 0,
  • "numeroCuenta": "string",
  • "titular": "string",
  • "codigoEstado": 0,
  • "esCuentaPrincipal": true,
  • "observaciones": "string",
  • "usuarioRegistro": "f86b90be-beab-434d-8ec1-f39f2d36b029",
  • "fechaRegistro": "2019-08-24T14:15:22Z"
}

Obtiene la lista de todas las cuentas bancarias de una empresa por su NIT con paginación.

Este endpoint retorna todas las cuentas bancarias asociadas a un NIT específico con soporte de paginación. Opcionalmente se puede filtrar por estado de cuenta.

Parámetros de consulta:

  • Nit (opcional): NIT de la empresa a consultar. Dependiendo del rol, puede ser requerido u opcional
  • CodigoEstado (opcional): Filtrar por estado (1301-ACTIVO, 1302-INACTIVO, 1303-BLOQUEADO, 1304-CERRADO)
  • NumeroPagina (opcional): Número de página (por defecto: 1)
  • RegistrosPorPagina (opcional): Cantidad de registros por página (por defecto: 10, máximo: 100)

Información retornada:

  • Lista paginada ordenada por cuenta principal primero, luego por fecha de registro descendente
  • Incluye información del banco, tipo de cuenta, estado y empresa como objetos anidados
  • Metadatos de paginación: total de registros, página actual, registros por página, total de páginas

Seguridad y roles:

  • SIIFA_Admin: Puede consultar cuentas de cualquier NIT o todas si no especifica NIT
  • SIIFA_MSPS: Puede consultar cuentas de cualquier NIT o todas si no especifica NIT
  • SIIFA_ERP y variantes: Solo pueden consultar su propio NIT (forzado desde el JWT, ignora parámetro Nit)
  • SIIFA_IPS, SIIFA_FITS y variantes: Solo pueden consultar su propio NIT (forzado desde el JWT, ignora parámetro Nit)

Sample requests:

GET /api/EmpresaCuentaBancaria
GET /api/EmpresaCuentaBancaria?nit=900123456
GET /api/EmpresaCuentaBancaria?nit=900123456&codigoEstado=1301
GET /api/EmpresaCuentaBancaria?numeroPagina=1&registrosPorPagina=20
GET /api/EmpresaCuentaBancaria?nit=900123456&codigoEstado=1301&numeroPagina=2&registrosPorPagina=10
Authorizations:
Bearer
query Parameters
Nit
integer <int32>
CodigoEstado
integer <int32>
NumeroPagina
integer <int32>
RegistrosPorPagina
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "paginaActual": 0,
  • "registrosPorPagina": 0,
  • "totalRegistros": 0,
  • "totalPaginas": 0,
  • "resultado": [
    ]
}

Actualiza los datos de una cuenta bancaria existente.

Este endpoint permite modificar la información de una cuenta bancaria. No se puede cambiar el NIT de la empresa, solo los datos de la cuenta.

Campos actualizables:

  • CodigoBanrep: Código del banco
  • CodigoTipoCuenta: Tipo de cuenta
  • NumeroCuenta: Número de cuenta
  • Titular: Titular de la cuenta
  • EsCuentaPrincipal: Si es cuenta principal
  • Observaciones: Notas adicionales

Seguridad y roles:

  • SIIFA_Admin: Puede actualizar cualquier cuenta
  • SIIFA_ERP, SIIFA_ERP_Gestor, SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS y SIIFA_FITS_Gestor: Solo pueden actualizar cuentas de su propia empresa

Validaciones:

  • La cuenta debe existir
  • El banco y tipo de cuenta deben ser válidos
  • No puede crear duplicados con el cambio
  • Si se marca como principal, no puede haber otra cuenta principal activa

Sample request:

PUT /api/EmpresaCuentaBancaria/1
{
    "idEmpresaCuentaBancaria": 1,
    "codigoBanrep": 2,
    "codigoTipoCuenta": 1201,
    "numeroCuenta": "9876543210",
    "titular": "EMPRESA EJEMPLO S.A.S.",
    "esCuentaPrincipal": false,
    "observaciones": "Cuenta actualizada"
}
Authorizations:
Bearer
path Parameters
id
required
integer <int64>

ID de la cuenta bancaria a actualizar.

Request Body schema:

Objeto con los nuevos datos de la cuenta.

idEmpresaCuentaBancaria
integer <int64>
codigoBanrep
integer <int32>
codigoTipoCuenta
integer <int32>
numeroCuenta
string or null
titular
string or null
esCuentaPrincipal
boolean
observaciones
string or null

Responses

Request samples

Content type
{
  • "idEmpresaCuentaBancaria": 0,
  • "codigoBanrep": 0,
  • "codigoTipoCuenta": 0,
  • "numeroCuenta": "string",
  • "titular": "string",
  • "esCuentaPrincipal": true,
  • "observaciones": "string"
}

Response samples

Content type
application/json
{
  • "idEmpresaCuentaBancaria": 0,
  • "nit": 0,
  • "codigoBanrep": 0,
  • "codigoTipoCuenta": 0,
  • "numeroCuenta": "string",
  • "titular": "string",
  • "codigoEstado": 0,
  • "esCuentaPrincipal": true,
  • "observaciones": "string",
  • "usuarioActualizacion": "358dad68-1ceb-4a86-a812-ee7d1eb66182",
  • "fechaActualizacion": "2019-08-24T14:15:22Z"
}

Obtiene el detalle completo de una cuenta bancaria específica.

Este endpoint retorna información detallada de una cuenta bancaria, incluyendo:

  • Datos de la cuenta (número, titular, tipo, estado)
  • Información del banco (nombre, código Superfinanciera, convenio ADRES)
  • Información de la empresa propietaria
  • Auditoría (fechas y usuarios de registro/actualización)

Seguridad y roles:

  • SIIFA_Admin: Puede consultar cualquier cuenta
  • SIIFA_ERP y variantes: Solo cuentas de su propia empresa
  • SIIFA_IPS, SIIFA_FITS y variantes: Solo cuentas de su propia empresa

Sample request:

GET /api/EmpresaCuentaBancaria/1
Authorizations:
Bearer
path Parameters
id
required
integer <int64>

ID de la cuenta bancaria.

Responses

Response samples

Content type
application/json
{
  • "idEmpresaCuentaBancaria": 0,
  • "nit": 0,
  • "nombreEmpresa": "string",
  • "codigoBanrep": 0,
  • "nombreBanco": "string",
  • "codigoSuperfinancieraBanco": 0,
  • "convenioAdresBanco": "string",
  • "codigoTipoCuenta": 0,
  • "descripcionTipoCuenta": "string",
  • "numeroCuenta": "string",
  • "titular": "string",
  • "codigoEstado": 0,
  • "descripcionEstado": "string",
  • "esCuentaPrincipal": true,
  • "observaciones": "string",
  • "usuarioRegistro": "f86b90be-beab-434d-8ec1-f39f2d36b029",
  • "fechaRegistro": "2019-08-24T14:15:22Z",
  • "usuarioActualizacion": "358dad68-1ceb-4a86-a812-ee7d1eb66182",
  • "fechaActualizacion": "2019-08-24T14:15:22Z"
}

Cambia el estado de una cuenta bancaria.

Este endpoint permite cambiar el estado de una cuenta bancaria. Los estados posibles provienen del dominio 13 (ESTADO_CUENTA_BANCARIA):

  • 1301: ACTIVO
  • 1302: INACTIVO
  • 1303: BLOQUEADO
  • 1304: CERRADO

Validaciones especiales:

  • No se puede inactivar/bloquear/cerrar una cuenta principal si es la única cuenta activa de la empresa
  • Se debe proporcionar observaciones opcionales del cambio de estado

Seguridad y roles:

  • SIIFA_Admin: Puede cambiar el estado de cualquier cuenta
  • SIIFA_ERP, SIIFA_ERP_Gestor, SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS y SIIFA_FITS_Gestor: Solo pueden cambiar estado de cuentas de su propia empresa

Sample request:

PATCH /api/EmpresaCuentaBancaria/1/Estado
{
    "idEmpresaCuentaBancaria": 1,
    "codigoEstado": 1302,
    "observaciones": "Cuenta inactivada temporalmente"
}
Authorizations:
Bearer
path Parameters
id
required
integer <int64>

ID de la cuenta bancaria.

Request Body schema:

Objeto con el nuevo estado y observaciones.

idEmpresaCuentaBancaria
integer <int64>
codigoEstado
integer <int32>
observaciones
string or null

Responses

Request samples

Content type
{
  • "idEmpresaCuentaBancaria": 0,
  • "codigoEstado": 0,
  • "observaciones": "string"
}

Response samples

Content type
application/json
{
  • "idEmpresaCuentaBancaria": 0,
  • "nit": 0,
  • "codigoEstado": 0,
  • "numeroCuenta": "string",
  • "observaciones": "string",
  • "usuarioActualizacion": "358dad68-1ceb-4a86-a812-ee7d1eb66182",
  • "fechaActualizacion": "2019-08-24T14:15:22Z"
}

Elimina una cuenta bancaria por su identificador.

Este endpoint permite eliminar una cuenta bancaria existente, identificándola por su ID único.

Seguridad y roles:

  • SIIFA_Admin: Puede eliminar cualquier cuenta
  • SIIFA_ERP, SIIFA_ERP_Gestor, SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS y SIIFA_FITS_Gestor: Solo pueden eliminar cuentas de su propia empresa
Authorizations:
Bearer
path Parameters
IdEmpresaCuentaBancaria
required
integer <int64>

Identificador de la cuenta bancaria a eliminar.

Responses

Response samples

Content type
application/json
{
  • "idEmpresaCuentaBancaria": 0
}

Factura

Obtiene una lista paginada de facturas con filtros opcionales.

Este endpoint permite consultar facturas electrónicas aplicando múltiples filtros opcionales:

Filtros disponibles:

  • IdFactura: Filtro por identificador específico de la factura
  • NumeroFactura: Filtro por número de factura
  • NitEmisor: Filtro por NIT del emisor (prestador de servicios)
  • NitAdquiriente: Filtro por NIT del adquiriente (entidad que recibe el servicio)
  • FechaEmisionInicio: Fecha inicial del rango de emisión de facturas
  • FechaEmisionFinal: Fecha final del rango de emisión de facturas
  • TieneRadicado: Filtro booleano para facturas con/sin radicado (true=con radicado, false=sin radicado, null=todas)
  • FechaCargue: Filtro por fecha de cargue de la factura (solo año, mes y día)
  • NumeroPagina: Número de página para paginación (debe ser mayor a 0, default: 1)
  • RegistrosPorPagina: Cantidad de registros por página (debe ser mayor a 0 y menor o igual a 1500, default: 10)

Seguridad y roles:

  • SIIFA_Admin: Acceso a todas las facturas sin restricciones
  • SIIFA_ERP, SIIFA_ERP_Gestor, SIIFA_ERP_Consulta: Solo pueden consultar facturas donde sean el adquiriente (NitAdquiriente filtrado automáticamente desde el JWT)
  • SIIFA_IPS, SIIFA_IPS_Consulta, SIIFA_IPS_Gestor: Solo pueden consultar facturas donde sean el emisor (NitEmisor filtrado automáticamente desde el JWT)
  • SIIFA_FITS, SIIFA_FITS_Consulta, SIIFA_FITS_Gestor: Solo pueden consultar facturas donde sean el emisor (NitEmisor filtrado automáticamente desde el JWT)

Información retornada por cada factura:

  • Identificadores de factura, emisor y adquiriente
  • Datos generales: número, CUFE, fechas, tipo, divisa
  • Valores financieros: bruto, base imponible, descuentos, cargos, anticipos, valor total
  • Información del emisor: tipo persona, razón social, NIT
  • Información del adquiriente: tipo persona, razón social, NIT

Optimización y ordenamiento: Los resultados se devuelven en el orden natural de la base de datos (por IdFactura) sin ordenamiento adicional. Esto optimiza el rendimiento de la consulta al manejar grandes volúmenes de datos (millones de registros). Si requiere un orden específico, puede aplicarlo en el cliente después de recibir los datos.

Los resultados se devuelven paginados con metadatos que incluyen:

  • Total de registros encontrados
  • Total de páginas disponibles
  • Página actual
  • Registros por página

Validaciones:

  • NumeroPagina debe ser mayor a 0
  • RegistrosPorPagina debe ser mayor a 0 y no superar 1500
  • FechaEmisionFinal debe ser mayor o igual a FechaEmisionInicio (si ambas están presentes)

Sample request:

GET /api/Factura?NumeroPagina=1&RegistrosPorPagina=10&TieneRadicado=true
GET /api/Factura?NitEmisor=800123456&FechaEmisionInicio=2025-01-01&FechaEmisionFinal=2025-12-31
GET /api/Factura?NumeroFactura=FACT-001&NitAdquiriente=900654321
Authorizations:
Bearer
query Parameters
IdFactura
integer <int64>
NumeroFactura
string
NitEmisor
string
NitAdquiriente
string
FechaEmisionInicio
string <date-time>
FechaEmisionFinal
string <date-time>
TieneRadicado
boolean
FechaCargue
string <date-time>
NumeroPagina
integer <int32>
RegistrosPorPagina
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "paginaActual": 0,
  • "registrosPorPagina": 0,
  • "totalRegistros": 0,
  • "totalPaginas": 0,
  • "resultado": [
    ]
}

Obtiene los detalles completos de una factura específica por su identificador.

Este endpoint devuelve información detallada y completa de una factura específica, incluyendo:

Información básica:

  • Identificadores de factura (IdFactura, IdFacturaEmisor, IdFacturaAdquiriente)
  • Datos generales: indicador tipo operación, número de factura, CUFE
  • Fechas: emisión, vencimiento
  • Tipo de factura y divisa
  • Número de elementos incluidos

Valores financieros:

  • Total valor bruto
  • Total valor base imponible
  • Total valor bruto atributos
  • Descuento total
  • Cargo total
  • Anticipo total
  • Valor final de la factura

Información del emisor (prestador):

  • Tipo de persona
  • Nombre comercial
  • Razón social
  • NIT del emisor
  • Dirección fiscal completa:
    • Código de municipio
    • Código postal
    • Código de departamento
    • Dirección
    • Código de país

Información del adquiriente:

  • Tipo de persona
  • Nombre comercial
  • Razón social
  • NIT del adquiriente
  • Dirección fiscal completa

Información de resolución de salud:

  • Código prestador servicio salud
  • Modalidad de pago
  • Cobertura plan beneficios
  • Número de contrato
  • Número de póliza
  • Periodo de facturación (fecha inicio y fin)

Líneas de factura (detalle de servicios/productos):

  • Cantidad
  • Unidad de medida
  • Valor total de línea
  • Código moneda
  • Descripción del artículo o servicio
  • Marca del artículo
  • Valor del artículo/servicio

Validaciones:

  • El IdFactura debe ser un número positivo mayor a 0
  • La factura debe existir en la base de datos

Sample request:

GET /api/Factura/1
GET /api/Factura/150
Authorizations:
Bearer
path Parameters
IdFactura
required
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "idFactura": 0,
  • "idFacturaEmisor": 0,
  • "idFacturaAdquiriente": 0,
  • "idFacturaFevRips": 0,
  • "idContrato": 0,
  • "fad02IndicadorTipoOperacion": "string",
  • "fad04Profileexecutionid2": 0,
  • "fad05NumeroFactura": "string",
  • "fad06Cufe": "string",
  • "fad09FechaEmision": "2019-08-24T14:15:22Z",
  • "fad10HoraEmision": "14:15:22Z",
  • "fad11FechaVencimiento": "2019-08-24T14:15:22Z",
  • "fad12TipoFactura": "string",
  • "fad15DivisaFactura": "string",
  • "fad16NumeroElementos": 0,
  • "fau02TotalValorBruto": 0,
  • "fau04TotalValorBaseImponible": 0,
  • "fau06TotalValorBrutoAtributos": 0,
  • "fau08DescuentoTotal": 0,
  • "fau10CargoTotal": 0,
  • "fau12AnticipoTotal": 0,
  • "fau14ValorFactura": 0,
  • "numeroGlosas": 0,
  • "numeroGlosasRespondidas": 0,
  • "numeroReiteraciones": 0,
  • "numeroReiteracionesRespondidas": 0,
  • "numeroDevoluciones": 0,
  • "numeroDevolucionesRespondidas": 0,
  • "numeroReiteracionesDevoluciones": 0,
  • "emisor": {
    },
  • "adquiriente": {
    },
  • "resolucionSalud": {
    },
  • "facturaLinea": [
    ]
}

Obtiene las alertas asociadas a una factura específica.

Este endpoint retorna una lista de alertas o validaciones relacionadas con una factura específica. Las alertas pueden incluir información sobre:

  • Inconsistencias en los datos de la factura
  • Validaciones de negocio que no se cumplieron
  • Advertencias sobre información faltante o incompleta
  • Notificaciones sobre el estado de procesamiento

Validaciones:

  • El IdFactura debe ser un número positivo mayor a 0
  • La factura debe existir en la base de datos

Sample request:

GET /api/Factura/Alerta/1
GET /api/Factura/Alerta/150
Authorizations:
Bearer
path Parameters
IdFactura
required
integer <int32>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

FacturaRadicado

Obtiene los detalles completos de un radicado de factura por su identificador.

Este endpoint devuelve información detallada de un radicado específico de factura, incluyendo:

Información del radicado:

  • IdFacturaRadicado: Identificador único del radicado
  • IdFactura: Identificador de la factura asociada
  • Radicado: Número de radicado asignado
  • FechaRadicado: Fecha en que se realizó el radicado
  • UsuarioRegistro: Usuario que registró el radicado (GUID del JWT)
  • FechaRegistro: Fecha y hora de registro en el sistema

Información de la factura asociada:

  • NumeroFactura: Número de la factura radicada
  • NitAdquiriente: NIT de la entidad adquiriente
  • NitEmisor: NIT de la entidad emisora

Seguridad y roles:

  • SIIFA_Admin: Puede consultar cualquier radicado sin restricciones
  • SIIFA_ERP, SIIFA_ERP_Gestor, SIIFA_ERP_Consulta: Solo pueden consultar radicados donde el NitAdquiriente de la factura coincida con su NitEntidad del JWT
  • SIIFA_IPS, SIIFA_IPS_Consulta, SIIFA_IPS_Gestor: Solo pueden consultar radicados donde el NitEmisor de la factura coincida con su NitEntidad del JWT
  • SIIFA_FITS, SIIFA_FITS_Consulta, SIIFA_FITS_Gestor: Solo pueden consultar radicados donde el NitEmisor de la factura coincida con su NitEntidad del JWT

Validaciones:

  • IdFacturaRadicado debe ser un número positivo mayor a 0
  • El radicado debe existir en la base de datos
  • El usuario debe tener permisos para consultar el radicado según su rol y NIT

Sample request:

GET /api/FacturaRadicado/1
GET /api/FacturaRadicado/150
Authorizations:
Bearer
path Parameters
IdFacturaRadicado
required
integer <int64>

Responses

Response samples

Content type
application/json
{
  • "idFacturaRadicado": 0,
  • "idFactura": 0,
  • "radicado": "string",
  • "fechaRadicado": "2019-08-24T14:15:22Z",
  • "numeroFactura": "string",
  • "nitAdquiriente": "string",
  • "nitEmisor": "string",
  • "usuarioRegistro": "string",
  • "fechaRegistro": "2019-08-24T14:15:22Z"
}

Obtiene una lista de radicados asociados a una factura específica.

Este endpoint permite consultar todos los radicados que tiene una factura específica. Es útil para verificar el historial de radicaciones de una factura.

Información retornada por cada radicado:

  • IdFacturaRadicado: Identificador único del radicado
  • IdFactura: Identificador de la factura
  • Radicado: Número de radicado
  • FechaRadicado: Fecha del radicado
  • NumeroFactura: Número de la factura
  • NitAdquiriente: NIT de la entidad adquiriente
  • NitEmisor: NIT de la entidad emisora
  • UsuarioRegistro: Usuario que registró el radicado
  • FechaRegistro: Fecha y hora de registro

Seguridad y roles:

  • SIIFA_Admin: Puede consultar radicados de cualquier factura
  • SIIFA_ERP (y variantes): Solo pueden consultar si el NitAdquiriente de la factura coincide con su NitEntidad del JWT
  • SIIFA_IPS y SIIFA_FITS (y variantes): Solo pueden consultar si el NitEmisor de la factura coincide con su NitEntidad del JWT

Validaciones:

  • IdFactura debe ser mayor a 0
  • La factura debe existir en la base de datos
  • El usuario debe tener permisos según su rol y NIT

Sample request:

GET /api/FacturaRadicado/ByIdFactura/1
GET /api/FacturaRadicado/ByIdFactura/150
Authorizations:
Bearer
path Parameters
IdFactura
required
integer <int64>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Crea un nuevo radicado para una factura específica.

Este endpoint permite radicar una factura individual, asignándole un número de radicado y fecha.

Datos requeridos:

  • IdFactura: Identificador de la factura a radicar
  • Radicado: Número de radicado a asignar
  • FechaRadicado: Fecha del radicado

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden radicar facturas
  • Para roles ERP (no Admin), el NitAdquiriente de la factura debe coincidir con el NitEntidad del JWT
  • El sistema registra automáticamente el GUID del usuario desde el JWT como UsuarioRegistro

Validaciones automáticas:

  • La factura debe existir en el sistema
  • La factura no debe tener ya un radicado asignado (prevención de duplicados)
  • El usuario debe tener el NIT correcto según su rol (para no Admin)
  • El usuario debe tener GUID válido en el JWT

Información retornada:

  • IdFacturaRadicado: ID del radicado creado
  • IdFactura: ID de la factura
  • Radicado: Número de radicado asignado
  • FechaRadicado: Fecha del radicado
  • NumeroFactura: Número de la factura
  • NitAdquiriente: NIT del adquiriente
  • NitEmisor: NIT del emisor

Sample request:

POST /api/FacturaRadicado
{
  "idFactura": 1,
  "radicado": "RAD-2026-001",
  "fechaRadicado": "2026-02-03T10:30:00Z"
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos del radicado a crear.

idFactura
integer <int64>
radicado
string or null
fechaRadicado
string <date-time>

Responses

Request samples

Content type
{
  • "idFactura": 0,
  • "radicado": "string",
  • "fechaRadicado": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "idFacturaRadicado": 0,
  • "idFactura": 0,
  • "numeroFactura": "string",
  • "nitAdquiriente": "string",
  • "nitEmisor": "string",
  • "radicado": "string",
  • "fechaRadicado": "2019-08-24T14:15:22Z"
}

Crea radicados masivos para múltiples facturas en una única operación.

Este endpoint permite radicar múltiples facturas de forma masiva, proporcionando eficiencia al procesar grandes volúmenes de radicaciones en una sola petición.

Datos requeridos (por cada factura):

  • NumeroFactura: Número de la factura a radicar
  • NitAdquiriente: NIT del adquiriente de la factura
  • NitEmisor: NIT del emisor de la factura
  • Radicado: Número de radicado a asignar
  • FechaRadicado: Fecha del radicado

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden radicar
  • Para roles ERP (no Admin), todas las facturas deben tener NitAdquiriente igual al NitEntidad del JWT
  • Si alguna factura no cumple con los permisos, se lanza excepción y no se procesa ninguna

Validaciones automáticas (por cada factura):

  • La factura debe existir (se busca por NumeroFactura, NitAdquiriente y NitEmisor)
  • La factura no debe tener radicado previo (se salta si ya existe, no se procesa)
  • El usuario debe tener permisos según su rol y NIT
  • Si la factura no existe, se salta (no se agrega al resultado)

Comportamiento:

  • Procesa cada factura de forma secuencial
  • Si una factura ya tiene radicado, se salta (continue) sin error
  • Si una factura no existe, se salta sin error
  • Solo se agregan al resultado las facturas radicadas exitosamente
  • Se registra el GUID del usuario JWT como UsuarioRegistro

Información retornada (por cada radicado creado):

  • IdFacturaRadicado: ID del radicado creado
  • IdFactura: ID de la factura
  • Radicado: Número de radicado
  • FechaRadicado: Fecha del radicado
  • NumeroFactura: Número de la factura
  • NitAdquiriente: NIT del adquiriente
  • NitEmisor: NIT del emisor

Sample request:

POST /api/FacturaRadicado/Masivo
{
  "listaRadicado": [
    {
      "radicado": "RAD-2026-001",
      "fechaRadicado": "2026-02-03T10:30:00Z",
      "numeroFactura": "FACT-001",
      "nitAdquiriente": "900123456",
      "nitEmisor": "800654321"
    },
    {
      "radicado": "RAD-2026-002",
      "fechaRadicado": "2026-02-03T10:35:00Z",
      "numeroFactura": "FACT-002",
      "nitAdquiriente": "900123456",
      "nitEmisor": "800654321"
    }
  ]
}
Authorizations:
Bearer
Request Body schema:

Comando con la lista de facturas a radicar.

Array of objects or null (Minsalud_SIIFA_API_Features_FacturaRadicado_Commands_AddFacturaRadicadoMasivo_Objeto)

Responses

Request samples

Content type
{
  • "listaRadicado": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Crea radicados masivos para múltiples facturas en una única operación.

Este endpoint permite radicar múltiples facturas de forma masiva, proporcionando eficiencia al procesar grandes volúmenes de radicaciones en una sola petición.

Datos requeridos (por cada factura):

  • IdFactura: ID de la factura
  • NumeroFactura: Número de la factura a radicar
  • NitAdquiriente: NIT del adquiriente de la factura
  • NitEmisor: NIT del emisor de la factura
  • Radicado: Número de radicado a asignar
  • FechaRadicado: Fecha del radicado

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden radicar
  • Para roles ERP (no Admin), todas las facturas deben tener NitAdquiriente igual al NitEntidad del JWT
  • Si alguna factura no cumple con los permisos, se lanza excepción y no se procesa ninguna

Validaciones automáticas (por cada factura):

  • La factura debe existir (se busca por NumeroFactura, NitAdquiriente y NitEmisor)
  • La factura no debe tener radicado previo (se salta si ya existe, no se procesa)
  • El usuario debe tener permisos según su rol y NIT
  • Si la factura no existe, se salta (no se agrega al resultado)

Comportamiento:

  • Procesa cada factura de forma secuencial
  • Si una factura ya tiene radicado, se salta (continue) sin error
  • Si una factura no existe, se salta sin error
  • Solo se agregan al resultado las facturas radicadas exitosamente
  • Se registra el GUID del usuario JWT como UsuarioRegistro

Información retornada (por cada radicado creado):

  • IdFacturaRadicado: ID del radicado creado
  • IdFactura: ID de la factura
  • Radicado: Número de radicado
  • FechaRadicado: Fecha del radicado
  • NumeroFactura: Número de la factura
  • NitAdquiriente: NIT del adquiriente
  • NitEmisor: NIT del emisor

Sample request:

POST /api/FacturaRadicado/Masivo
{
  "listaRadicado": [
    {
      "idFactura": 1,
      "radicado": "RAD-2026-001",
      "fechaRadicado": "2026-02-03T10:30:00Z",
      "numeroFactura": "FACT-001",
      "nitAdquiriente": "900123456",
      "nitEmisor": "800654321"
    },
    {
      "idFactura": 2,
      "radicado": "RAD-2026-002",
      "fechaRadicado": "2026-02-03T10:35:00Z",
      "numeroFactura": "FACT-002",
      "nitAdquiriente": "900123456",
      "nitEmisor": "800654321"
    }
  ]
}
Authorizations:
Bearer
Request Body schema:

Comando con la lista de facturas a radicar.

Array of objects or null (Minsalud_SIIFA_API_Features_FacturaRadicado_Commands_AddFacturaRadicadoIdMasivo_Objeto)

Responses

Request samples

Content type
{
  • "listaRadicado": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

ReferenciaBanco

Obtiene la lista de todos los bancos disponibles en el sistema con paginación.

Este endpoint retorna todos los bancos registrados en la tabla REFERENCIA_BANCO. Soporta filtros por código, estado y nombre, además de paginación.

Parámetros de consulta:

  • CodigoBanrep (opcional): Filtrar por código específico del banco
  • Estado (opcional): Filtrar por estado (ACTIVO, INACTIVO)
  • Nombre (opcional): Buscar bancos que contengan el texto especificado en el nombre
  • NumeroPagina (opcional): Número de página (por defecto: 1)
  • RegistrosPorPagina (opcional): Cantidad de registros por página (por defecto: 10, máximo: 100)

Información retornada:

  • Lista paginada ordenada alfabéticamente por nombre
  • Incluye código Banrep, código Superfinanciera, NIT, razón social, convenio ADRES
  • Fechas de registro, actualización y convenio ADRES
  • Metadatos de paginación: total de registros, página actual, registros por página

Casos de uso:

  • Llenar catálogos/listas desplegables de bancos en el frontend
  • Consultar información de bancos para validaciones
  • Obtener información del convenio ADRES de un banco
  • Listar bancos con paginación para tablas

Sample requests:

GET /api/ReferenciaBanco
GET /api/ReferenciaBanco?estado=ACTIVO
GET /api/ReferenciaBanco?nombre=Bancolombia
GET /api/ReferenciaBanco?codigoBanrep=1
GET /api/ReferenciaBanco?estado=ACTIVO&numeroPagina=1&registrosPorPagina=20
GET /api/ReferenciaBanco?nombre=Banco&numeroPagina=2&registrosPorPagina=10
Authorizations:
Bearer
query Parameters
CodigoBanrep
integer <int32>
Estado
string
Nombre
string
NumeroPagina
integer <int32>
RegistrosPorPagina
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "paginaActual": 0,
  • "registrosPorPagina": 0,
  • "totalRegistros": 0,
  • "totalPaginas": 0,
  • "resultado": [
    ]
}

RipsTransaccion

/api/RipsTransaccion

Authorizations:
Bearer
query Parameters
idFactura
integer <int64>
numeroDocumentoIdObligado
number <double>
numeroFactura
string
numeroPagina
integer <int32>
registrosPorPagina
integer <int32>

Responses

Response samples

Content type
No sample

RipsUsuarios

/api/RipsUsuarios

Authorizations:
Bearer
query Parameters
idTransaccion
integer <int64>
numeroDocumentoIdentificacion
string
numeroPagina
integer <int32>
registrosPorPagina
integer <int32>

Responses

Response samples

Content type
No sample

/api/RipsUsuarios/{IdUsuario}

Authorizations:
Bearer
path Parameters
IdUsuario
required
integer <int64>

Responses

Response samples

Content type
No sample

SeguimientoFactura

Obtiene una lista paginada consolidada de seguimientos (Glosas y Devoluciones) asociados a una factura específica o de forma general.

Este endpoint permite consultar todos los seguimientos (glosas y devoluciones) de forma unificada, con la capacidad de filtrar por factura específica o consultar todos los registros del sistema. Incluye información detallada de la factura asociada cuando aplique.

Seguridad y control de acceso basado en roles:

El endpoint aplica filtros automáticos según el rol del usuario autenticado:

  • SIIFA_Admin: Sin restricciones. Puede consultar todos los seguimientos del sistema.

  • SIIFA_IPS, SIIFA_IPS_Consulta, SIIFA_IPS_Gestor: Solo pueden ver seguimientos de facturas donde su entidad (identificada por el claim NitEntidad del JWT) es el Emisor. El filtro se aplica automáticamente.

  • SIIFA_FITS, SIIFA_FITS_Consulta, SIIFA_FITS_Gestor: Solo pueden ver seguimientos de facturas donde su entidad (identificada por el claim NitEntidad del JWT) es el Emisor. El filtro se aplica automáticamente.

  • SIIFA_ERP, SIIFA_ERP_Consulta, SIIFA_ERP_Gestor: Solo pueden ver seguimientos de facturas donde su entidad (identificada por el claim NitEntidad del JWT) es el Adquiriente. El filtro se aplica automáticamente.

Importante: Los usuarios IPS/FITS/ERP deben tener el claim "NitEntidad" en su token JWT. Si el claim no está presente, se devolverá error 401 Unauthorized.

Parámetros de consulta:

  • IdFactura: ID de la factura (opcional - si no se proporciona trae todos los seguimientos según permisos del usuario)
  • NumeroFactura: Número de factura para filtrar (opcional - búsqueda exacta)
  • IdEmisor: ID del emisor (FacturaEmisor) para filtrar (opcional - búsqueda exacta, se combina con filtros de seguridad por rol)
  • IdAdquiriente: ID del adquiriente (FacturaAdquiriente) para filtrar (opcional - búsqueda exacta, se combina con filtros de seguridad por rol)
  • IdSeguimientoFactura: Filtrar por ID específico de seguimiento
  • TipoSeguimiento: Filtrar por tipo ("GLOSA" o "DEVOLUCION")
  • IdSeguimientoTipoCodigo: Filtrar por tipo de código de seguimiento
  • IdSeguimientoTipoCodigoRespuesta: Filtrar por tipo de código de respuesta
  • Observacion: Buscar en observaciones (búsqueda parcial)
  • FechaCreacionInicio: Filtrar por fecha de creación desde
  • FechaCreacionFinal: Filtrar por fecha de creación hasta
  • TieneRespuesta: Filtrar por seguimientos con o sin respuesta (true/false)
  • NumeroPagina: Número de página (default: 1)
  • RegistrosPorPagina: Registros por página (default: 10, max: 1500)

Información retornada por cada seguimiento:

Información básica del seguimiento:

  • IdSeguimientoFactura: Identificador único del seguimiento
  • TipoSeguimiento: Indica si es "GLOSA" o "DEVOLUCION"
  • IdFactura, IdConsulta, IdHospitalizacion, etc.: Referencias a entidades asociadas
  • Valor: Valor económico de la glosa o devolución
  • Observacion: Observación del seguimiento
  • FechaFormulacion, FechaReporte: Fechas de formulación y reporte
  • UsuarioReporte: Usuario que reportó (GUID)
  • Anexo: Tipo de anexo ("Factura", "Consulta", "Hospitalización", etc.)

Información de respuesta:

  • IdSeguimientoTipoCodigoRespuesta: Tipo de respuesta
  • DescripcionSeguimientoTipoCodigoRespuesta: Descripción del tipo de respuesta
  • ObservacionRespuesta: Observación de la respuesta
  • FechaRespuesta, FechaReporteRespuesta: Fechas relacionadas con la respuesta
  • UsuarioReporteRespuesta: Usuario que respondió

Información de reiteración:

  • IdSeguimientoTipoCodigoReiteracion: Tipo de código de reiteración
  • DescripcionSeguimientoTipoCodigoReiteracion: Descripción del tipo
  • ObservacionReiteracion: Observación de reiteración
  • FechaFormulacionReiteracion, FechaReporteReiteracion: Fechas de reiteración
  • UsuarioReporteReiteracion: Usuario que realizó la reiteración

Información de reiteración respuesta:

  • IdSeguimientoTipoCodigoReiteracionRespuesta: Tipo de código de respuesta a reiteración
  • DescripcionSeguimientoTipoCodigoReiteracionRespuesta: Descripción del tipo
  • ObservacionReiteracionRespuesta: Observación de respuesta a reiteración
  • FechaFormulacionReiteracionRespuesta, FechaReporteReiteracionRespuesta: Fechas relacionadas
  • UsuarioReporteReiteracionRespuesta: Usuario que respondió la reiteración

Información de la factura (FacturaInfo): Cuando el seguimiento está asociado a una factura, se incluye información completa:

  • IdFactura: Identificador de la factura
  • NumeroFactura: Número de la factura
  • ValorBruto: Valor bruto total de la factura
  • Emisor:
    • NitEmisor: NIT del emisor
    • RazonSocial: Razón social del emisor
  • Adquiriente:
    • NitAdquiriente: NIT del adquiriente
    • RazonSocial: Razón social del adquiriente

Paginación: El resultado incluye metadatos de paginación:

  • Resultado: Lista de seguimientos con datos completos
  • TotalRegistros: Total de registros que coinciden con los filtros
  • PaginaActual: Página actual
  • RegistrosPorPagina: Registros por página
  • TotalPaginas: Total de páginas disponibles

Validaciones:

  • IdFactura debe ser mayor a 0 (si se proporciona)
  • TipoSeguimiento debe ser "GLOSA" o "DEVOLUCION" (si se proporciona)
  • NumeroPagina debe ser mayor a 0 (si se proporciona)
  • RegistrosPorPagina debe estar entre 1 y 1500 (si se proporciona)
  • FechaCreacionFinal debe ser mayor o igual a FechaCreacionInicio

Sample requests:

GET /api/SeguimientoFactura/List
GET /api/SeguimientoFactura/List?IdFactura=1
GET /api/SeguimientoFactura/List?NumeroFactura=FACT-2024-001
GET /api/SeguimientoFactura/List?IdEmisor=123
GET /api/SeguimientoFactura/List?IdAdquiriente=456
GET /api/SeguimientoFactura/List?IdFactura=1&TipoSeguimiento=GLOSA
GET /api/SeguimientoFactura/List?IdFactura=1&TipoSeguimiento=DEVOLUCION&TieneRespuesta=false
GET /api/SeguimientoFactura/List?TipoSeguimiento=GLOSA&NumeroPagina=2&RegistrosPorPagina=50
GET /api/SeguimientoFactura/List?FechaCreacionInicio=2024-01-01&FechaCreacionFinal=2024-12-31
GET /api/SeguimientoFactura/List?IdEmisor=123&TipoSeguimiento=GLOSA&TieneRespuesta=false
Authorizations:
Bearer
query Parameters
IdFactura
integer <int64>
NumeroFactura
string
NitEmisor
string
NitAdquiriente
string
IdSeguimientoFactura
integer <int64>
TipoSeguimiento
string
IdSeguimientoTipoCodigo
string
IdSeguimientoTipoCodigoRespuesta
string
Observacion
string
FechaCreacionInicio
string <date-time>
FechaCreacionFinal
string <date-time>
TieneRespuesta
boolean
NumeroPagina
integer <int32>
RegistrosPorPagina
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "paginaActual": 0,
  • "registrosPorPagina": 0,
  • "totalRegistros": 0,
  • "totalPaginas": 0,
  • "resultado": [
    ]
}

SeguimientoFacturaDevolucion

Obtiene los detalles completos de un seguimiento de factura con devolución por su identificador.

Devuelve información detallada de un seguimiento específico de factura con devolución, incluyendo información de la devolución, respuesta, reiteración y respuesta a la reiteración.

Validaciones:

  • IdSeguimientoFacturaDevolucion debe ser mayor a 0

Sample request:

GET /api/SeguimientoFacturaDevolucion/1
Authorizations:
Bearer
path Parameters
IdSeguimientoFacturaDevolucion
required
integer <int64>

Responses

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0,
  • "idFactura": 0,
  • "valorDevolucion": 0,
  • "observacion": "string",
  • "idSeguimientoTipoCodigoDevolucion": "string",
  • "descripcionSeguimientoTipoCodigoDevolucion": "string",
  • "fechaFormulacion": "2019-08-24T14:15:22Z",
  • "fechaReporte": "2019-08-24T14:15:22Z",
  • "usuarioReporte": "56bcfe14-9897-4cee-8fe6-25054e577d65",
  • "idSeguimientoTipoCodigoRespuesta": "string",
  • "descripcionSeguimientoTipoCodigoRespuesta": "string",
  • "observacionRespuesta": "string",
  • "fechaRespuesta": "2019-08-24T14:15:22Z",
  • "usuarioReporteRespuesta": "7b477552-e9c5-4e0e-879e-06a8db609137",
  • "fechaReporteRespuesta": "2019-08-24T14:15:22Z",
  • "idSeguimientoTipoCodigoDevolucionReiteracion": "string",
  • "descripcionSeguimientoTipoCodigoDevolucionReiteracion": "string",
  • "observacionReiteracion": "string",
  • "fechaFormulacionDevolucionReiteracion": "2019-08-24T14:15:22Z",
  • "fechaReporteDevolucionReiteracion": "2019-08-24T14:15:22Z",
  • "usuarioReporteDevolucionReiteracion": "3c70a783-5a89-4380-91c1-03f4281ef5d1",
  • "idSeguimientoTipoCodigoDevolucionReiteracionRespuesta": "string",
  • "descripcionSeguimientoTipoCodigoDevolucionReiteracionRespuesta": "string",
  • "observacionReiteracionRespuesta": "string",
  • "fechaFormulacionDevolucionReiteracionRespuesta": "2019-08-24T14:15:22Z",
  • "fechaReporteDevolucionReiteracionRespuesta": "2019-08-24T14:15:22Z",
  • "usuarioReporteDevolucionReiteracionRespuesta": "d90f1985-ff85-4930-8671-5f55e5bb3e19",
  • "anexo": "string"
}

Obtiene una lista paginada de seguimientos de factura con devolución asociados a una factura específica.

Permite consultar todos los seguimientos de devolución de una factura con opciones de filtrado y paginación.

Parámetros de consulta:

  • IdFactura: ID de la factura (obligatorio)
  • IdSeguimientoFacturaDevolucion: Filtrar por ID específico de seguimiento
  • IdSeguimientoTipoCodigoDevolucion: Filtrar por tipo de código de devolución
  • IdSeguimientoTipoCodigoRespuesta: Filtrar por tipo de código de respuesta
  • TieneRespuesta: Filtrar por seguimientos con o sin respuesta (true/false)
  • NumeroPagina: Número de página (default: 1)
  • RegistrosPorPagina: Registros por página (default: 10, max: 1500)

Sample request:

GET /api/SeguimientoFacturaDevolucion/ByIdFactura?IdFactura=1
GET /api/SeguimientoFacturaDevolucion/ByIdFactura?IdFactura=1&TieneRespuesta=false
Authorizations:
Bearer
query Parameters
IdFactura
integer <int64>
IdSeguimientoFacturaDevolucion
integer <int64>
IdSeguimientoTipoCodigoDevolucion
string
IdSeguimientoTipoCodigoRespuesta
string
Observacion
string
FechaCreacionInicio
string <date-time>
FechaCreacionFinal
string <date-time>
TieneRespuesta
boolean
NumeroPagina
integer <int32>
RegistrosPorPagina
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "paginaActual": 0,
  • "registrosPorPagina": 0,
  • "totalRegistros": 0,
  • "totalPaginas": 0,
  • "resultado": [
    ]
}

Obtiene un resumen consolidado de los seguimientos de devoluciones asociados a una factura específica.

Proporciona un resumen estadístico de las devoluciones de una factura específica.

Sample request:

GET /api/SeguimientoFacturaDevolucion/Resumen/ByIdFactura/1
Authorizations:
Bearer
path Parameters
IdFactura
required
integer <int64>

Responses

Response samples

Content type
application/json
{
  • "conteoIdSeguimientoFacturaDevolucion": 0,
  • "conteoRespuestas": 0
}

Crea un nuevo seguimiento de factura con devolución.

Crea un nuevo seguimiento de devolución asociado a una factura.

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden crear devoluciones.

Validaciones automáticas:

  • IdFactura debe existir en el sistema
  • IdSeguimientoTipoCodigoDevolucion debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO
  • IdSeguimientoTipoCodigoDevolucion debe pertenecer al grupo DEVOLUCION
  • IdSeguimientoTipoCodigoDevolucion debe estar activo

Sample request:

POST /api/SeguimientoFacturaDevolucion
{
  "idFactura": 1,
  "idSeguimientoTipoCodigoDevolucion": "DEV01",
  "fechaFormulacion": "2026-02-10T10:30:00Z",
  "valorDevolucion": 150000.50,
  "observacion": "Devolución por servicios no prestados"
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos del seguimiento a crear.

idFactura
integer <int64>
valorDevolucion
number or null <double>
idSeguimientoTipoCodigoDevolucion
string or null
observacion
string or null
fechaFormulacion
string <date-time>

Responses

Request samples

Content type
{
  • "idFactura": 0,
  • "valorDevolucion": 0,
  • "idSeguimientoTipoCodigoDevolucion": "string",
  • "observacion": "string",
  • "fechaFormulacion": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0
}

Crea múltiples seguimientos de factura con devolución de forma masiva.

Crea múltiples seguimientos de devolución en una sola operación batch (máximo 1000 elementos).

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden crear devoluciones masivas.

Validaciones automáticas:

  • Cada IdFactura debe existir en el sistema
  • Cada IdSeguimientoTipoCodigoDevolucion debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO
  • Cada IdSeguimientoTipoCodigoDevolucion debe pertenecer al grupo DEVOLUCION
  • Cada IdSeguimientoTipoCodigoDevolucion debe estar activo
  • La lista no puede exceder 1000 elementos

Sample request:

POST /api/SeguimientoFacturaDevolucion/Masivo
{
  "listaDevoluciones": [
    {
      "idFactura": 1,
      "idSeguimientoTipoCodigoDevolucion": "DEV01",
      "fechaFormulacion": "2026-02-10T10:30:00Z",
      "valorDevolucion": 150000.50,
      "observacion": "Devolución en consulta"
    },
    {
      "idFactura": 2,
      "idSeguimientoTipoCodigoDevolucion": "DEV02",
      "fechaFormulacion": "2026-02-10T11:00:00Z",
      "valorDevolucion": 250000.00,
      "observacion": "Devolución en hospitalización"
    }
  ]
}
Authorizations:
Bearer
Request Body schema:

Comando con la lista de devoluciones a crear.

Array of objects or null (Minsalud_SIIFA_API_Features_SeguimientoFacturaDevolucion_Commands_AddSeguimientoFacturaDevolucionMasivo_Objeto)

Responses

Request samples

Content type
{
  • "listaDevoluciones": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Agrega una respuesta a un seguimiento de factura con devolución existente.

Permite responder a una devolución previamente creada.

Seguridad y roles:

  • Usuarios con roles SIIFA_Admin, SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS o SIIFA_FITS_Gestor.

Validaciones automáticas:

  • IdSeguimientoFacturaDevolucion debe existir en el sistema
  • IdSeguimientoTipoCodigoRespuesta debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO
  • IdSeguimientoTipoCodigoRespuesta debe pertenecer al grupo RESPUESTA_DEV_PTS_PSS
  • IdSeguimientoTipoCodigoRespuesta debe estar activo
  • FechaRespuesta debe ser posterior a la fecha de formulación de la devolución

Sample request:

PUT /api/SeguimientoFacturaDevolucion/Respuesta
{
  "idSeguimientoFacturaDevolucion": 1,
  "idSeguimientoTipoCodigoRespuesta": "RESP01",
  "fechaRespuesta": "2026-02-12T14:00:00Z",
  "observacionRespuesta": "La devolución ha sido aceptada"
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos de la respuesta.

idSeguimientoFacturaDevolucion
integer <int64>
observacionRespuesta
string or null
fechaRespuesta
string <date-time>
idSeguimientoTipoCodigoRespuesta
required
string or null

Responses

Request samples

Content type
{
  • "idSeguimientoFacturaDevolucion": 0,
  • "observacionRespuesta": "string",
  • "fechaRespuesta": "2019-08-24T14:15:22Z",
  • "idSeguimientoTipoCodigoRespuesta": "string"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0
}

Agrega una reiteración a un seguimiento de factura con devolución existente.

Permite reiterar una devolución previamente creada y respondida.

Seguridad y roles:

  • Usuarios con roles SIIFA_Admin, SIIFA_EPS, SIIFA_EPS_Gestor, SIIFA_ERP o SIIFA_ERP_Gestor.

Validaciones automáticas:

  • IdSeguimientoFacturaDevolucion debe existir en el sistema
  • IdSeguimientoTipoCodigoDevolucionReiteracion debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO
  • IdSeguimientoTipoCodigoDevolucionReiteracion debe pertenecer al grupo RESPUESTA_DEV_ERP
  • IdSeguimientoTipoCodigoDevolucionReiteracion debe estar activo
  • FechaFormulacionDevolucionReiteracion debe ser posterior a la fecha de formulación original
  • FechaFormulacionDevolucionReiteracion debe ser posterior a la fecha de respuesta (si existe)

Sample request:

PUT /api/SeguimientoFacturaDevolucion/Reiteracion
{
  "idSeguimientoFacturaDevolucion": 1,
  "idSeguimientoTipoCodigoDevolucionReiteracion": "DEVREIT1",
  "fechaFormulacionDevolucionReiteracion": "2026-02-15T10:00:00Z",
  "observacionReiteracion": "Se reitera la devolución"
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos de la reiteración.

idSeguimientoFacturaDevolucion
integer <int64>
observacionReiteracion
string or null
fechaFormulacionDevolucionReiteracion
string <date-time>
idSeguimientoTipoCodigoDevolucionReiteracion
required
string or null

Responses

Request samples

Content type
{
  • "idSeguimientoFacturaDevolucion": 0,
  • "observacionReiteracion": "string",
  • "fechaFormulacionDevolucionReiteracion": "2019-08-24T14:15:22Z",
  • "idSeguimientoTipoCodigoDevolucionReiteracion": "string"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0
}

Agrega una respuesta a la reiteración de un seguimiento de factura con devolución existente.

Permite responder a una reiteración de devolución previamente creada.

Seguridad y roles:

  • Usuarios con roles SIIFA_Admin, SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS o SIIFA_FITS_Gestor.

Validaciones automáticas:

  • IdSeguimientoFacturaDevolucion debe existir en el sistema
  • IdSeguimientoTipoCodigoDevolucionReiteracionRespuesta debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO (si se proporciona)
  • IdSeguimientoTipoCodigoDevolucionReiteracionRespuesta debe pertenecer al grupo RESPUESTA_PTS_PTS
  • IdSeguimientoTipoCodigoDevolucionReiteracionRespuesta debe estar activo
  • FechaFormulacionDevolucionReiteracionRespuesta debe ser posterior a todas las fechas anteriores (si se proporciona)

Sample request:

PUT /api/SeguimientoFacturaDevolucion/ReiteracionRespuesta
{
  "idSeguimientoFacturaDevolucion": 1,
  "idSeguimientoTipoCodigoDevolucionReiteracionRespuesta": "RRSP01",
  "observacionReiteracionRespuesta": "La reiteración ha sido evaluada",
  "fechaFormulacionDevolucionReiteracionRespuesta": "2026-02-16T14:00:00Z"
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos de la respuesta a la reiteración.

idSeguimientoFacturaDevolucion
integer <int64>
idSeguimientoTipoCodigoDevolucionReiteracionRespuesta
string or null
observacionReiteracionRespuesta
string or null
fechaFormulacionDevolucionReiteracionRespuesta
string or null <date-time>

Responses

Request samples

Content type
{
  • "idSeguimientoFacturaDevolucion": 0,
  • "idSeguimientoTipoCodigoDevolucionReiteracionRespuesta": "string",
  • "observacionReiteracionRespuesta": "string",
  • "fechaFormulacionDevolucionReiteracionRespuesta": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0
}

SeguimientoFacturaGlosa

Obtiene los detalles completos de un seguimiento de factura con glosa por su identificador.

Este endpoint devuelve información detallada de un seguimiento específico de factura con glosa, incluyendo:

Información de la glosa:

  • IdSeguimientoFacturaGlosa: Identificador único del seguimiento
  • Información de la factura y anexos asociados (Consulta, Hospitalización, Medicamento, etc.)
  • ValorGlosa: Valor económico de la glosa
  • Observacion: Observación de la glosa
  • FechaFormulacion, FechaReporte: Fechas de formulación y reporte
  • UsuarioReporte: Usuario que reportó la glosa (GUID)

Información de respuesta:

  • IdSeguimientoTipoCodigoRespuesta: Tipo de respuesta
  • ObservacionRespuesta: Observación de la respuesta
  • FechaRespuesta, FechaReporteRespuesta: Fechas relacionadas con la respuesta
  • UsuarioReporteRespuesta: Usuario que respondió

Información de reiteración y reiteración respuesta:

  • Campos de glosa reiteración y respuesta a reiteración cuando apliquen

Validaciones:

  • IdSeguimientoFacturaGlosa debe ser mayor a 0
  • El seguimiento debe existir en la base de datos

Sample request:

GET /api/SeguimientoFacturaGlosa/1
GET /api/SeguimientoFacturaGlosa/150
Authorizations:
Bearer
path Parameters
IdSeguimientoFacturaGlosa
required
integer <int64>

Responses

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0,
  • "idFactura": 0,
  • "idConsulta": 0,
  • "idHospitalizacion": 0,
  • "idMedicamento": 0,
  • "idOtroServicio": 0,
  • "idProcedimiento": 0,
  • "idRecienNacido": 0,
  • "idUrgencia": 0,
  • "idUsuario": 0,
  • "valorGlosa": 0,
  • "observacion": "string",
  • "idSeguimientoTipoCodigoGlosa": "string",
  • "descripcionSeguimientoTipoCodigoGlosa": "string",
  • "fechaFormulacion": "2019-08-24T14:15:22Z",
  • "fechaReporte": "2019-08-24T14:15:22Z",
  • "usuarioReporte": "56bcfe14-9897-4cee-8fe6-25054e577d65",
  • "idSeguimientoTipoCodigoRespuesta": "string",
  • "descripcionSeguimientoTipoCodigoRespuesta": "string",
  • "observacionRespuesta": "string",
  • "fechaRespuesta": "2019-08-24T14:15:22Z",
  • "usuarioReporteRespuesta": "7b477552-e9c5-4e0e-879e-06a8db609137",
  • "fechaReporteRespuesta": "2019-08-24T14:15:22Z",
  • "idSeguimientoTipoCodigoGlosaReiteracion": "string",
  • "descripcionSeguimientoTipoCodigoGlosaReiteracion": "string",
  • "observacionReiteracion": "string",
  • "fechaFormulacionGlosaReiteracion": "2019-08-24T14:15:22Z",
  • "fechaReporteGlosaReiteracion": "2019-08-24T14:15:22Z",
  • "usuarioReporteGlosaReiteracion": "b9cc9d22-0033-4512-8edf-f768fc14e401",
  • "idSeguimientoTipoCodigoGlosaReiteracionRespuesta": "string",
  • "descripcionSeguimientoTipoCodigoGlosaReiteracionRespuesta": "string",
  • "observacionReiteracionRespuesta": "string",
  • "fechaFormulacionGlosaReiteracionRespuesta": "2019-08-24T14:15:22Z",
  • "fechaReporteGlosaReiteracionRespuesta": "2019-08-24T14:15:22Z",
  • "usuarioReporteGlosaReiteracionRespuesta": "879781fb-2b62-4cb7-801b-9030d653fd98",
  • "anexo": "string"
}

Obtiene una lista paginada de seguimientos de factura con glosa asociados a una factura específica.

Este endpoint permite consultar todos los seguimientos de glosa de una factura con opciones de filtrado y paginación.

Parámetros de consulta:

  • IdFactura: ID de la factura (obligatorio)
  • IdSeguimientoFacturaGlosa: Filtrar por ID específico de seguimiento
  • IdSeguimientoTipoCodigoGlosa: Filtrar por tipo de código de glosa
  • IdSeguimientoTipoCodigoRespuesta: Filtrar por tipo de código de respuesta
  • Observacion: Buscar en observaciones (búsqueda parcial)
  • FechaCreacionInicio: Filtrar por fecha de creación desde
  • FechaCreacionFinal: Filtrar por fecha de creación hasta
  • TieneRespuesta: Filtrar por seguimientos con o sin respuesta (true/false)
  • NumeroPagina: Número de página (default: 1)
  • RegistrosPorPagina: Registros por página (default: 10, max: 1500)

Información retornada:

  • Resultado: Lista de seguimientos con datos completos incluyendo reiteraciones
  • TotalRegistros: Total de registros que coinciden con los filtros
  • PaginaActual: Página actual
  • RegistrosPorPagina: Registros por página
  • TotalPaginas: Total de páginas disponibles

Validaciones:

  • IdFactura debe ser mayor a 0
  • NumeroPagina debe ser mayor a 0 (si se proporciona)
  • RegistrosPorPagina debe estar entre 1 y 1500 (si se proporciona)
  • FechaCreacionFinal debe ser mayor o igual a FechaCreacionInicio

Sample request:

GET /api/SeguimientoFacturaGlosa/ByIdFactura?IdFactura=1
GET /api/SeguimientoFacturaGlosa/ByIdFactura?IdFactura=1&TieneRespuesta=false
GET /api/SeguimientoFacturaGlosa/ByIdFactura?IdFactura=1&NumeroPagina=2&RegistrosPorPagina=20
Authorizations:
Bearer
query Parameters
IdFactura
integer <int64>
IdSeguimientoFacturaGlosa
integer <int64>
IdSeguimientoTipoCodigoGlosa
string
IdSeguimientoTipoCodigoRespuesta
string
Observacion
string
FechaCreacionInicio
string <date-time>
FechaCreacionFinal
string <date-time>
TieneRespuesta
boolean
NumeroPagina
integer <int32>
RegistrosPorPagina
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "paginaActual": 0,
  • "registrosPorPagina": 0,
  • "totalRegistros": 0,
  • "totalPaginas": 0,
  • "resultado": [
    ]
}

Obtiene un resumen consolidado de los seguimientos de glosas asociados a una factura específica.

Este endpoint proporciona un resumen estadístico de las glosas de una factura específica.

Información retornada:

  • Resumen estadístico de glosas por estado
  • Totales y contadores consolidados
  • Información agregada de seguimientos

Validaciones:

  • IdFactura debe ser un número positivo
  • La factura debe existir en el sistema

Sample request:

GET /api/SeguimientoFacturaGlosa/Resumen/ByIdFactura/1
GET /api/SeguimientoFacturaGlosa/Resumen/ByIdFactura/150
Authorizations:
Bearer
path Parameters
IdFactura
required
integer <int64>

Responses

Response samples

Content type
application/json
{
  • "conteoIdSeguimientoFacturaGlosa": 0,
  • "conteoIdFactura": 0,
  • "conteoIdConsulta": 0,
  • "conteoIdHospitalizacion": 0,
  • "conteoIdMedicamento": 0,
  • "conteoIdOtroServicio": 0,
  • "conteoIdProcedimiento": 0,
  • "conteoIdRecienNacido": 0,
  • "conteoIdUrgencia": 0,
  • "conteoIdUsuario": 0,
  • "conteoRespuestas": 0
}

Crea un nuevo seguimiento de factura con glosa.

Este endpoint permite crear un nuevo seguimiento de glosa asociado a una factura.

Datos requeridos:

  • IdFactura: Identificador de la factura (obligatorio)
  • IdSeguimientoTipoCodigoGlosa: Tipo de código de glosa (obligatorio)
  • FechaFormulacion: Fecha de formulación de la glosa (obligatorio)
  • ValorGlosa: Valor económico de la glosa (opcional)
  • Observacion: Observaciones sobre la glosa (opcional)
  • Uno de los siguientes campos opcionales (máximo uno): IdConsulta, IdHospitalizacion, IdMedicamento, IdOtroServicio, IdProcedimiento, IdRecienNacido, IdUrgencia o IdUsuario

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden crear glosas
  • El sistema registra automáticamente el GUID del usuario desde el JWT como UsuarioReporte
  • FechaReporte se genera automáticamente

Validaciones automáticas:

  • La factura debe existir en el sistema
  • IdSeguimientoTipoCodigoGlosa debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO
  • IdSeguimientoTipoCodigoGlosa debe pertenecer al grupo GLOSA
  • IdSeguimientoTipoCodigoGlosa debe estar activo
  • Si se proporciona algún ID de anexo (Consulta, Hospitalización, etc.), debe existir
  • Solo se puede diligenciar máximo uno de los campos opcionales de anexos
  • IdFactura debe ser mayor a 0
  • El usuario debe tener GUID válido en el JWT

Sample request:

POST /api/SeguimientoFacturaGlosa
{
  "idFactura": 1,
  "idSeguimientoTipoCodigoGlosa": "GLOSA1",
  "fechaFormulacion": "2026-02-10T10:30:00Z",
  "valorGlosa": 150000.50,
  "observacion": "Glosa por servicios no autorizados",
  "idConsulta": 25
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos del seguimiento a crear.

idFactura
integer <int64>
idConsulta
integer or null <int64>
idHospitalizacion
integer or null <int64>
idMedicamento
integer or null <int64>
idOtroServicio
integer or null <int64>
idProcedimiento
integer or null <int64>
idRecienNacido
integer or null <int64>
idUrgencia
integer or null <int64>
idUsuario
integer or null <int64>
valorGlosa
number or null <double>
idSeguimientoTipoCodigoGlosa
string or null
observacion
string or null
fechaFormulacion
string <date-time>

Responses

Request samples

Content type
{
  • "idFactura": 0,
  • "idConsulta": 0,
  • "idHospitalizacion": 0,
  • "idMedicamento": 0,
  • "idOtroServicio": 0,
  • "idProcedimiento": 0,
  • "idRecienNacido": 0,
  • "idUrgencia": 0,
  • "idUsuario": 0,
  • "valorGlosa": 0,
  • "idSeguimientoTipoCodigoGlosa": "string",
  • "observacion": "string",
  • "fechaFormulacion": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0
}

Crea múltiples seguimientos de factura con glosa de forma masiva.

Este endpoint permite crear múltiples seguimientos de glosa en una sola operación batch.

Datos requeridos:

  • ListaGlosas: Array de objetos con los datos de cada glosa (máximo 1000 elementos)
  • Cada objeto debe contener los mismos campos que el endpoint de creación individual

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden crear glosas masivas
  • El sistema registra automáticamente el GUID del usuario desde el JWT para todos los registros
  • FechaReporte se genera automáticamente para cada registro

Validaciones automáticas:

  • La lista no puede estar vacía
  • La lista no puede contener más de 1000 elementos
  • Cada IdFactura debe existir en el sistema
  • Cada IdSeguimientoTipoCodigoGlosa debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO
  • Cada IdSeguimientoTipoCodigoGlosa debe pertenecer al grupo GLOSA
  • Cada IdSeguimientoTipoCodigoGlosa debe estar activo
  • Todas las validaciones del endpoint individual aplican para cada elemento
  • La operación es transaccional: si un elemento falla, todos fallan

Ventajas de procesamiento batch:

  • Una sola transacción de base de datos para todos los registros
  • Mejor rendimiento que múltiples llamadas individuales
  • Auditoría consolidada con un mismo usuario y fechas similares

Sample request:

POST /api/SeguimientoFacturaGlosa/Masivo
{
  "listaGlosas": [
    {
      "idFactura": 1,
      "idSeguimientoTipoCodigoGlosa": "GLOSA1",
      "fechaFormulacion": "2026-02-10T10:30:00Z",
      "valorGlosa": 150000.50,
      "observacion": "Glosa 1"
    },
    {
      "idFactura": 2,
      "idSeguimientoTipoCodigoGlosa": "GLOSA2",
      "fechaFormulacion": "2026-02-10T10:35:00Z",
      "valorGlosa": 200000.00,
      "observacion": "Glosa 2"
    }
  ]
}
Authorizations:
Bearer
Request Body schema:

Comando con la lista de glosas a crear.

Array of objects or null (Minsalud_SIIFA_API_Features_SeguimientoFacturaGlosa_Commands_AddSeguimientoFacturaGlosaMasivo_Objeto)

Responses

Request samples

Content type
{
  • "listaGlosas": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

Agrega una respuesta a un seguimiento de factura con glosa existente.

Este endpoint permite responder a una glosa previamente creada, actualizando el seguimiento con la información de respuesta.

Datos requeridos:

  • IdSeguimientoFacturaGlosa: ID del seguimiento a responder (obligatorio)
  • IdSeguimientoTipoCodigoRespuesta: Tipo de código de respuesta (obligatorio)
  • FechaRespuesta: Fecha de la respuesta (obligatorio)
  • ObservacionRespuesta: Observaciones de la respuesta (opcional)

Seguridad y roles:

  • Usuarios con roles SIIFA_Admin, SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS o SIIFA_FITS_Gestor pueden responder glosas
  • El sistema registra automáticamente el GUID del usuario desde el JWT como UsuarioReporteRespuesta
  • FechaReporteRespuesta se genera automáticamente

Validaciones automáticas:

  • El seguimiento debe existir en el sistema
  • IdSeguimientoFacturaGlosa debe ser mayor a 0
  • IdSeguimientoTipoCodigoRespuesta debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO
  • IdSeguimientoTipoCodigoRespuesta debe pertenecer al grupo RESPUESTA
  • IdSeguimientoTipoCodigoRespuesta debe estar activo
  • FechaRespuesta debe ser posterior a la fecha de formulación de la glosa
  • El usuario debe tener GUID válido en el JWT

Sample request:

PUT /api/SeguimientoFacturaGlosa/Respuesta
{
  "idSeguimientoFacturaGlosa": 1,
  "idSeguimientoTipoCodigoRespuesta": "RESP01",
  "fechaRespuesta": "2026-02-12T14:00:00Z",
  "observacionRespuesta": "La glosa ha sido aceptada y se procederá con el ajuste correspondiente"
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos de la respuesta.

idSeguimientoFacturaGlosa
integer <int64>
observacionRespuesta
string or null
fechaRespuesta
string <date-time>
idSeguimientoTipoCodigoRespuesta
required
string or null

Responses

Request samples

Content type
{
  • "idSeguimientoFacturaGlosa": 0,
  • "observacionRespuesta": "string",
  • "fechaRespuesta": "2019-08-24T14:15:22Z",
  • "idSeguimientoTipoCodigoRespuesta": "string"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0
}

Agrega una reiteración a un seguimiento de factura con glosa existente.

Este endpoint permite reiterar una glosa previamente creada y respondida, actualizando el seguimiento con información de reiteración.

Datos requeridos:

  • IdSeguimientoFacturaGlosa: ID del seguimiento a reiterar (obligatorio)
  • IdSeguimientoTipoCodigoGlosaReiteracion: Tipo de código de glosa reiteración (obligatorio)
  • FechaFormulacionGlosaReiteracion: Fecha de formulación de la reiteración (obligatorio)
  • ObservacionReiteracion: Observaciones de la reiteración (opcional)

Seguridad y roles:

  • Usuarios con roles SIIFA_Admin, SIIFA_EPS, SIIFA_EPS_Gestor, SIIFA_ERP o SIIFA_ERP_Gestor pueden reiterar glosas
  • El sistema registra automáticamente el GUID del usuario desde el JWT como UsuarioReporteGlosaReiteracion
  • FechaReporteGlosaReiteracion se genera automáticamente

Validaciones automáticas:

  • El seguimiento debe existir en el sistema
  • IdSeguimientoFacturaGlosa debe ser mayor a 0
  • IdSeguimientoTipoCodigoGlosaReiteracion debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO
  • IdSeguimientoTipoCodigoGlosaReiteracion debe pertenecer al grupo GLOSA
  • IdSeguimientoTipoCodigoGlosaReiteracion debe estar activo
  • FechaFormulacionGlosaReiteracion debe ser posterior a la fecha de formulación original de la glosa
  • FechaFormulacionGlosaReiteracion debe ser posterior a la fecha de respuesta de la glosa (si existe)
  • El usuario debe tener GUID válido en el JWT

Sample request:

PUT /api/SeguimientoFacturaGlosa/Reiteracion
{
  "idSeguimientoFacturaGlosa": 1,
  "idSeguimientoTipoCodigoGlosaReiteracion": "GLREIT1",
  "fechaFormulacionGlosaReiteracion": "2026-02-15T10:00:00Z",
  "observacionReiteracion": "Se reitera la glosa debido a que persiste la inconsistencia en la documentación"
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos de la reiteración.

idSeguimientoFacturaGlosa
integer <int64>
observacionReiteracion
string or null
valorReiteracion
number or null <double>
fechaFormulacionGlosaReiteracion
string <date-time>
idSeguimientoTipoCodigoGlosaReiteracion
required
string or null

Responses

Request samples

Content type
{
  • "idSeguimientoFacturaGlosa": 0,
  • "observacionReiteracion": "string",
  • "valorReiteracion": 0,
  • "fechaFormulacionGlosaReiteracion": "2019-08-24T14:15:22Z",
  • "idSeguimientoTipoCodigoGlosaReiteracion": "string"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0
}

Agrega una respuesta a la reiteración de un seguimiento de factura con glosa existente.

Este endpoint permite responder a una reiteración de glosa previamente creada, actualizando el seguimiento con la información de respuesta a la reiteración.

Datos requeridos:

  • IdSeguimientoFacturaGlosa: ID del seguimiento a responder (obligatorio)
  • IdSeguimientoTipoCodigoGlosaReiteracionRespuesta: Tipo de código de respuesta a la reiteración (opcional, máximo 6 caracteres)
  • ObservacionReiteracionRespuesta: Observaciones de la respuesta a la reiteración (opcional, máximo 450 caracteres)
  • FechaFormulacionGlosaReiteracionRespuesta: Fecha de formulación de la respuesta a la reiteración (opcional)

Seguridad y roles:

  • Usuarios con roles SIIFA_Admin, SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS o SIIFA_FITS_Gestor pueden responder a reiteraciones de glosas
  • El sistema registra automáticamente el GUID del usuario desde el JWT como UsuarioReporteReiteracionRespuesta
  • FechaReporteReiteracionRespuesta se genera automáticamente

Validaciones automáticas:

  • El seguimiento debe existir en el sistema
  • IdSeguimientoFacturaGlosa debe ser mayor a 0
  • IdSeguimientoTipoCodigoGlosaReiteracionRespuesta debe existir en el catálogo SEGUIMIENTO_TIPO_CODIGO (si se proporciona)
  • IdSeguimientoTipoCodigoGlosaReiteracionRespuesta debe pertenecer al grupo RESPUESTA
  • IdSeguimientoTipoCodigoGlosaReiteracionRespuesta debe estar activo
  • IdSeguimientoTipoCodigoGlosaReiteracionRespuesta no puede exceder 6 caracteres
  • ObservacionReiteracionRespuesta no puede exceder 450 caracteres
  • FechaFormulacionGlosaReiteracionRespuesta debe ser posterior a la fecha de formulación de la glosa original (si se proporciona)
  • El usuario debe tener GUID válido en el JWT

Sample request:

PUT /api/SeguimientoFacturaGlosa/ReiteracionRespuesta
{
  "idSeguimientoFacturaGlosa": 1,
  "idSeguimientoTipoCodigoGlosaReiteracionRespuesta": "RRSP01",
  "observacionReiteracionRespuesta": "La reiteración ha sido evaluada y se acepta parcialmente el ajuste solicitado",
  "fechaFormulacionGlosaReiteracionRespuesta": "2026-02-16T14:00:00Z"
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos de la respuesta a la reiteración.

idSeguimientoFacturaGlosa
integer <int64>
idSeguimientoTipoCodigoGlosaReiteracionRespuesta
string or null
observacionReiteracionRespuesta
string or null
fechaFormulacionGlosaReiteracionRespuesta
string or null <date-time>

Responses

Request samples

Content type
{
  • "idSeguimientoFacturaGlosa": 0,
  • "idSeguimientoTipoCodigoGlosaReiteracionRespuesta": "string",
  • "observacionReiteracionRespuesta": "string",
  • "fechaFormulacionGlosaReiteracionRespuesta": "2019-08-24T14:15:22Z"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaGlosa": 0
}

SeguimientoFacturaPago

Obtiene los detalles completos de un seguimiento de pago de factura por su identificador.

Este endpoint devuelve información detallada de un seguimiento específico de pago de factura, incluyendo:

Información del pago:

  • IdSeguimientoFacturaPago: Identificador único del seguimiento
  • Información de la factura y contrato anticipo asociados
  • CodigoFuente, CodigoSubFuente, CodigoTipoGiro: Códigos de referencia
  • Descripciones completas de cada código
  • Valor: Monto del pago
  • FechaPago, FechaReporte: Fechas de pago y reporte
  • UsuarioReporte: Usuario que reportó el pago (GUID)
  • ReferenciaBancaria: Referencia bancaria del pago

Validaciones:

  • IdSeguimientoFacturaPago debe ser mayor a 0
  • El seguimiento debe existir en la base de datos

Sample request:

GET /api/SeguimientoFacturaPago/1
GET /api/SeguimientoFacturaPago/150
Authorizations:
Bearer
path Parameters
IdSeguimientoFacturaPago
required
integer <int64>

Responses

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaPago": 0,
  • "idFactura": 0,
  • "idContratoAnticipo": 0,
  • "codigoFuente": 0,
  • "fuente": {
    },
  • "codigoSubFuente": 0,
  • "subFuente": {
    },
  • "valor": 0,
  • "fechaPago": "2019-08-24T14:15:22Z",
  • "fechaReporte": "2019-08-24T14:15:22Z",
  • "usuarioReporte": "56bcfe14-9897-4cee-8fe6-25054e577d65",
  • "referenciaBancaria": "string",
  • "idCuentaOrigen": 0,
  • "cuentaOrigen": {
    },
  • "idCuentaDestino": 0,
  • "cuentaDestino": {
    },
  • "estado": "string",
  • "codigoEstado": 0
}

Obtiene una lista paginada de seguimientos de pagos con información detallada de las facturas.

Este endpoint permite consultar pagos de facturas con opciones avanzadas de filtrado y paginación. Incluye información completa de la factura, emisor y adquiriente en cada resultado.

Parámetros de consulta - Seguimiento de pago:

  • IdFactura: Filtrar por ID de la factura (opcional)
  • IdSeguimientoFacturaPago: Filtrar por ID específico de seguimiento
  • CodigoFuente: Filtrar por código de fuente
  • CodigoSubFuente: Filtrar por código de sub-fuente
  • ReferenciaBancaria: Buscar en referencias bancarias (búsqueda parcial)
  • FechaPagoInicio: Filtrar por fecha de pago desde
  • FechaPagoFinal: Filtrar por fecha de pago hasta
  • ValorMinimo: Filtrar por valor mínimo del pago
  • ValorMaximo: Filtrar por valor máximo del pago

Parámetros de consulta - Información de factura:

  • NumeroFactura: Filtrar por número de factura (búsqueda exacta)
  • NitEmisor: Filtrar por NIT del emisor de la factura
  • NitAdquiriente: Filtrar por NIT del adquiriente de la factura
  • FechaEmisionInicio: Filtrar por fecha de emisión de factura desde
  • FechaEmisionFinal: Filtrar por fecha de emisión de factura hasta

Paginación:

  • NumeroPagina: Número de página (default: 1)
  • RegistrosPorPagina: Registros por página (default: 10, max: 1500)

Información de factura incluida en cada resultado:

  • Número de factura
  • Fecha de emisión
  • Valor total de la factura
  • Datos del emisor (NIT, razón social, tipo de persona)
  • Datos del adquiriente (NIT, razón social, tipo de persona)

Validaciones:

  • NumeroPagina debe ser mayor a 0 (si se proporciona)
  • RegistrosPorPagina debe estar entre 1 y 1500 (si se proporciona)
  • FechaPagoFinal debe ser mayor o igual a FechaPagoInicio
  • ValorMaximo debe ser mayor o igual a ValorMinimo
  • FechaEmisionFinal debe ser mayor o igual a FechaEmisionInicio

Sample request:

GET /api/SeguimientoFacturaPago
GET /api/SeguimientoFacturaPago?IdFactura=1
GET /api/SeguimientoFacturaPago?CodigoFuente=111001
GET /api/SeguimientoFacturaPago?NitEmisor=900123456
GET /api/SeguimientoFacturaPago?NumeroFactura=FACT001&NitAdquiriente=900654321
GET /api/SeguimientoFacturaPago?FechaEmisionInicio=2026-01-01&FechaEmisionFinal=2026-03-31
GET /api/SeguimientoFacturaPago?IdFactura=1&NumeroPagina=2&RegistrosPorPagina=20
Authorizations:
Bearer
query Parameters
IdFactura
integer <int64>
IdSeguimientoFacturaPago
integer <int64>
CodigoFuente
integer <int32>
CodigoSubFuente
integer <int32>
ReferenciaBancaria
string
FechaPagoInicio
string <date-time>
FechaPagoFinal
string <date-time>
ValorMinimo
number <double>
ValorMaximo
number <double>
NumeroFactura
string
NitEmisor
string
NitAdquiriente
string
FechaEmisionInicio
string <date-time>
FechaEmisionFinal
string <date-time>
NumeroPagina
integer <int32>
RegistrosPorPagina
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "paginaActual": 0,
  • "registrosPorPagina": 0,
  • "totalRegistros": 0,
  • "totalPaginas": 0,
  • "resultado": [
    ]
}

Crea un nuevo seguimiento de pago de factura.

Este endpoint permite crear un nuevo registro de pago asociado a una factura.

Datos requeridos:

  • IdFactura: Identificador de la factura (obligatorio)
  • CodigoFuente: Código de fuente de recursos (obligatorio, dominio 9)
  • CodigoSubFuente: Código de sub-fuente (obligatorio, dominio 10)
  • CodigoTipoGiro: Código de tipo de giro (obligatorio, dominio 11)
  • Valor: Monto del pago (obligatorio, mayor a 0)
  • FechaPago: Fecha del pago (obligatorio)
  • ReferenciaBancaria: Referencia bancaria del pago (obligatorio, max 30 caracteres)
  • IdCuentaOrigen: ID de la cuenta bancaria de origen (obligatorio)
  • IdCuentaDestino: ID de la cuenta bancaria de destino (obligatorio)

Datos opcionales:

  • IdContratoAnticipo: ID del contrato anticipo asociado (opcional)

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden crear pagos
  • El sistema registra automáticamente el GUID del usuario desde el JWT como UsuarioReporte
  • FechaReporte se genera automáticamente

Validaciones automáticas:

  • La factura debe existir en el sistema
  • La factura debe tener una radicación previa
  • Los códigos deben existir en CODIGO_REFERENCIA y estar activos
  • CodigoFuente debe pertenecer al dominio 9 (FUENTE_RECURSOS)
  • CodigoSubFuente debe pertenecer al dominio 10 (SUB_FUENTE)
  • CodigoTipoGiro debe pertenecer al dominio 11 (TIPO_GIRO)
  • FechaPago debe ser mayor o igual a la fecha de radicación
  • IdCuentaOrigen debe corresponder a una cuenta bancaria existente y activa
  • IdCuentaDestino debe corresponder a una cuenta bancaria existente y activa
  • Si se proporciona IdContratoAnticipo, debe existir
  • El usuario debe tener GUID válido en el JWT

Sample request:

POST /api/SeguimientoFacturaPago
{
  "idFactura": 1,
  "codigoFuente": 111001,
  "codigoSubFuente": 112001,
  "codigoTipoGiro": 113001,
  "valor": 5000000.00,
  "fechaPago": "2026-03-15T10:30:00Z",
  "referenciaBancaria": "REF-2026-001234",
  "idCuentaOrigen": 10,
  "idCuentaDestino": 20
}
Authorizations:
Bearer
Request Body schema:

Comando con los datos del pago a crear.

idFactura
integer <int64>
idContratoAnticipo
integer or null <int64>
codigoFuente
integer <int32>
codigoSubFuente
integer <int32>
valor
number <double>
fechaPago
string <date-time>
referenciaBancaria
string or null
idCuentaOrigen
integer <int64>
idCuentaDestino
integer <int64>

Responses

Request samples

Content type
{
  • "idFactura": 0,
  • "idContratoAnticipo": 0,
  • "codigoFuente": 0,
  • "codigoSubFuente": 0,
  • "valor": 0,
  • "fechaPago": "2019-08-24T14:15:22Z",
  • "referenciaBancaria": "string",
  • "idCuentaOrigen": 0,
  • "idCuentaDestino": 0
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaPago": 0
}

Obtiene una lista paginada de seguimientos de pagos asociados a una factura específica.

Este endpoint permite consultar todos los pagos de una factura con opciones de filtrado y paginación.

Parámetros de consulta:

  • IdFactura: ID de la factura (obligatorio)
  • IdSeguimientoFacturaPago: Filtrar por ID específico de seguimiento
  • CodigoFuente: Filtrar por código de fuente
  • CodigoSubFuente: Filtrar por código de sub-fuente
  • CodigoTipoGiro: Filtrar por código de tipo de giro
  • ReferenciaBancaria: Buscar en referencias bancarias (búsqueda parcial)
  • FechaPagoInicio: Filtrar por fecha de pago desde
  • FechaPagoFinal: Filtrar por fecha de pago hasta
  • ValorMinimo: Filtrar por valor mínimo
  • ValorMaximo: Filtrar por valor máximo
  • NumeroPagina: Número de página (default: 1)
  • RegistrosPorPagina: Registros por página (default: 10, max: 1500)

Información retornada:

  • Resultado: Lista de pagos con datos completos incluyendo descripciones de códigos
  • TotalRegistros: Total de registros que coinciden con los filtros
  • PaginaActual: Página actual
  • RegistrosPorPagina: Registros por página
  • TotalPaginas: Total de páginas disponibles

Validaciones:

  • IdFactura debe ser mayor a 0
  • NumeroPagina debe ser mayor a 0 (si se proporciona)
  • RegistrosPorPagina debe estar entre 1 y 1500 (si se proporciona)
  • FechaPagoFinal debe ser mayor o igual a FechaPagoInicio
  • ValorMaximo debe ser mayor o igual a ValorMinimo

Sample request:

GET /api/SeguimientoFacturaPago/ByIdFactura?IdFactura=1
GET /api/SeguimientoFacturaPago/ByIdFactura?IdFactura=1&CodigoFuente=111001
GET /api/SeguimientoFacturaPago/ByIdFactura?IdFactura=1&NumeroPagina=2&RegistrosPorPagina=20
Authorizations:
Bearer
query Parameters
IdFactura
integer <int64>
IdSeguimientoFacturaPago
integer <int64>
CodigoFuente
integer <int32>
CodigoSubFuente
integer <int32>
CodigoTipoGiro
integer <int32>
ReferenciaBancaria
string
FechaPagoInicio
string <date-time>
FechaPagoFinal
string <date-time>
ValorMinimo
number <double>
ValorMaximo
number <double>
NumeroPagina
integer <int32>
RegistrosPorPagina
integer <int32>

Responses

Response samples

Content type
application/json
{
  • "paginaActual": 0,
  • "registrosPorPagina": 0,
  • "totalRegistros": 0,
  • "totalPaginas": 0,
  • "resultado": [
    ]
}

Obtiene un resumen consolidado de los pagos asociados a una factura específica.

Este endpoint proporciona un resumen estadístico de los pagos de una factura específica.

Información retornada:

  • TotalPagos: Cantidad total de pagos registrados
  • TotalValorPagado: Suma de todos los pagos
  • ValorFactura: Valor total de la factura
  • SaldoPendiente: Saldo pendiente de pago
  • PorcentajePagado: Porcentaje pagado del total
  • PagosPorFuente: Agrupación de pagos por fuente de recursos
  • PagosPorTipoGiro: Agrupación de pagos por tipo de giro

Validaciones:

  • IdFactura debe ser un número positivo
  • La factura debe existir en el sistema

Sample request:

GET /api/SeguimientoFacturaPago/Resumen/ByIdFactura/1
GET /api/SeguimientoFacturaPago/Resumen/ByIdFactura/150
Authorizations:
Bearer
path Parameters
IdFactura
required
integer <int64>

Responses

Response samples

Content type
application/json
{
  • "idFactura": 0,
  • "totalPagos": 0,
  • "totalValorPagado": 0,
  • "valorFactura": 0,
  • "saldoPendiente": 0,
  • "porcentajePagado": 0,
  • "pagosPorFuente": [
    ]
}

Crea múltiples seguimientos de pagos de facturas en una sola operación (cargue masivo).

Este endpoint permite crear múltiples registros de pagos de facturas de manera optimizada mediante cargue masivo. Utiliza optimizaciones de base de datos para procesar grandes volúmenes de pagos en una sola transacción.

Ventajas del cargue masivo:

  • Alto rendimiento: Todas las validaciones y consultas se ejecutan en operaciones bulk (IN clauses)
  • Una sola transacción: Todos los pagos se insertan con AddRangeAsync en una sola operación
  • Validación eficiente: Las facturas y códigos de referencia se cargan una sola vez y se indexan en memoria
  • Rollback automático: Si alguna validación falla, ningún pago se guarda

Datos requeridos por cada pago:

  • IdFactura: Identificador de la factura (obligatorio)
  • CodigoFuente: Código de fuente de recursos (obligatorio, dominio 9)
  • CodigoSubFuente: Código de sub-fuente (obligatorio, dominio 10)
  • CodigoTipoGiro: Código de tipo de giro (obligatorio, dominio 11)
  • Valor: Monto del pago (obligatorio, mayor a 0)
  • FechaPago: Fecha del pago (obligatorio, no puede ser futura)
  • ReferenciaBancaria: Referencia bancaria del pago (obligatorio, max 30 caracteres)
  • IdCuentaOrigen: ID de la cuenta bancaria de origen (obligatorio)
  • IdCuentaDestino: ID de la cuenta bancaria de destino (obligatorio)
  • IdContratoAnticipo: ID del contrato anticipo asociado (opcional)

Seguridad y roles:

  • Solo usuarios con roles SIIFA_Admin, SIIFA_ERP o SIIFA_ERP_Gestor pueden crear pagos masivos
  • El sistema registra automáticamente el GUID del usuario desde el JWT como UsuarioReporte
  • FechaReporte se genera automáticamente para todos los pagos

Validaciones automáticas (aplicadas a todos los pagos):

  • Todas las facturas deben existir en el sistema
  • Todos los códigos de referencia deben existir y pertenecer a los dominios correctos:
    • CodigoFuente → Dominio 9 (FUENTE_RECURSOS)
    • CodigoSubFuente → Dominio 10 (SUB_FUENTE)
    • CodigoTipoGiro → Dominio 11 (TIPO_GIRO)
  • IdCuentaOrigen debe corresponder a una cuenta bancaria existente y activa
  • IdCuentaDestino debe corresponder a una cuenta bancaria existente y activa
  • FechaPago no puede ser mayor a la fecha actual
  • El usuario debe tener GUID válido en el JWT
  • Para usuarios no Admin: el NIT del adquiriente debe coincidir con el NIT de la empresa del usuario

Manejo de errores:

  • Si alguna validación falla, se devuelve error 400 con detalles específicos
  • No se guardan pagos parciales - es todo o nada

Sample request:

POST /api/SeguimientoFacturaPago/Masivo
{
  "listaPagos": [
    {
      "idFactura": 1,
      "codigoFuente": 111001,
      "codigoSubFuente": 112001,
      "codigoTipoGiro": 113001,
      "valor": 5000000.00,
      "fechaPago": "2026-03-15T10:30:00Z",
      "referenciaBancaria": "REF-2026-001234",
      "idCuentaOrigen": 10,
      "idCuentaDestino": 20
    },
    {
      "idFactura": 2,
      "idContratoAnticipo": 100,
      "codigoFuente": 111002,
      "codigoSubFuente": 112005,
      "codigoTipoGiro": 113002,
      "valor": 3000000.00,
      "fechaPago": "2026-03-14T15:00:00Z",
      "referenciaBancaria": "REF-2026-001235",
      "idCuentaOrigen": 15,
      "idCuentaDestino": 25
    }
  ]
}
Authorizations:
Bearer
Request Body schema:

Comando con la lista de pagos a crear masivamente.

Array of objects or null (MinSalud_SIIFA_API_Factura_Features_SeguimientoFacturaPago_Command_AddSeguimientoFacturaPagoMasivo_Objeto)

Responses

Request samples

Content type
{
  • "listaPagos": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

SeguimientoFacturaPagoEstado

Obtiene el historial completo de estados asociados a un seguimiento de pago de factura específico.

Este endpoint devuelve todos los cambios de estado registrados para un seguimiento de pago, ordenados cronológicamente. Cada registro incluye información detallada del estado, fechas y observaciones.

Información retornada para cada estado:

  • IdSeguimientoFacturaPagoEstado: Identificador único del registro de estado
  • IdSeguimientoFacturaPago: Identificador del seguimiento de pago
  • CodigoEstado: Código del estado (1402, 1404, 1405)
  • NombreEstado: Descripción completa del estado
  • FechaEstado: Fecha y hora en que ocurrió el cambio de estado
  • FechaRegistro: Fecha y hora de registro en el sistema
  • Observacion: Observaciones adicionales sobre el cambio

Estados posibles (dominio 14 - ESTADO_PAGO):

  • 1402: Pago consignado por la entidad pagadora (ERP)
  • 1404: Pago recibido - Confirmado por IPS/Prestador
  • 1405: Pago no recibido - IPS/Prestador indica no haber recibido

Flujo de estados:

  • Estado inicial: 1402 (registrado por ERP)
  • Desde 1402 puede cambiar a: 1404 o 1405 (registrado por IPS/Prestador)
  • Estados 1404 y 1405 son estados finales

Validaciones:

  • IdSeguimientoFacturaPago debe ser mayor a 0
  • El seguimiento de pago debe existir en el sistema

Sample request:

GET /api/SeguimientoFacturaPagoEstado/ByIdSeguimientoPago/1
GET /api/SeguimientoFacturaPagoEstado/ByIdSeguimientoPago/250
Authorizations:
Bearer
path Parameters
IdSeguimientoFacturaPago
required
integer <int64>

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Registra un nuevo cambio de estado para un seguimiento de pago de factura.

Este endpoint permite crear un nuevo registro de cambio de estado asociado a un seguimiento de pago de factura, siguiendo un flujo definido de transiciones de estado para el ciclo de vida del pago.

Estados permitidos (dominio 14 - ESTADO_PAGO):

  • 1402: Pago consignado por la entidad pagadora (ERP)
  • 1404: Pago recibido - Confirmado por IPS/Prestador
  • 1405: Pago no recibido - IPS/Prestador indica no haber recibido

Flujo de transiciones de estado:

  1. Estado inicial (cuando no existe estado previo):

    • Solo se puede crear con estado 1402 (Pago consignado)
    • Solo usuarios con roles SIIFA_ERP, SIIFA_ERP_Gestor o SIIFA_Admin
    • El NIT del usuario ERP debe corresponder al NIT contratante de la factura

  2. Desde 1402 (Pago consignado) puede cambiar a:

    • 1404 (Pago recibido) - IPS/Prestador confirma recepción del pago
    • 1405 (Pago no recibido) - IPS/Prestador indica no haber recibido el pago
    • Solo usuarios con roles SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS, SIIFA_FITS_Gestor o SIIFA_Admin
    • El NIT del usuario IPS/FITS debe corresponder al NIT contratista de la factura

  3. Estados 1404 y 1405 son finales:

    • No se permiten más cambios de estado una vez alcanzados
    • Representan el cierre del ciclo de conciliación del pago

Datos del comando:

  • IdSeguimientoFacturaPago: ID del seguimiento de pago (requerido)
  • CodigoEstado: Código del nuevo estado (1402, 1404 o 1405)
  • Observacion: Detalles adicionales sobre el cambio de estado (opcional, max 1000 caracteres)

Validaciones:

  • IdSeguimientoFacturaPago debe ser un número positivo y existir en el sistema
  • CodigoEstado debe ser 1402, 1404 o 1405
  • La transición de estado debe seguir el flujo permitido
  • El usuario debe tener el rol apropiado para el estado que desea registrar
  • El NIT del usuario debe corresponder a la entidad apropiada según el estado

Validaciones de roles y permisos:

  • Estado 1402: Roles SIIFA_ERP/SIIFA_ERP_Gestor (NIT = contratante) o SIIFA_Admin
  • Estados 1404/1405: Roles SIIFA_IPS/SIIFA_IPS_Gestor/SIIFA_FITS/SIIFA_FITS_Gestor (NIT = contratista) o SIIFA_Admin
  • Los administradores (SIIFA_Admin) pueden registrar cualquier estado sin restricción de NIT

Sample request:

POST /api/SeguimientoFacturaPagoEstado
Content-Type: application/json

{
  "idSeguimientoFacturaPago": 1,
  "codigoEstado": 1402,
  "observacion": "Pago consignado en la cuenta del prestador según comprobante de transferencia"
}

{
  "idSeguimientoFacturaPago": 1,
  "codigoEstado": 1404,
  "observacion": "Confirmamos la recepción del pago en nuestra cuenta bancaria"
}

{
  "idSeguimientoFacturaPago": 2,
  "codigoEstado": 1405,
  "observacion": "No hemos recibido el pago en nuestra cuenta. Solicitamos verificación"
}
Authorizations:
Bearer
Request Body schema:

Datos del cambio de estado a registrar.

idSeguimientoFacturaPago
integer <int64>
codigoEstado
integer <int32>
observacion
string or null

Responses

Request samples

Content type
{
  • "idSeguimientoFacturaPago": 0,
  • "codigoEstado": 0,
  • "observacion": "string"
}

Response samples

Content type
application/json
{
  • "idSeguimientoFacturaPagoEstado": 0,
  • "idSeguimientoFacturaPago": 0
}

Registra múltiples cambios de estado para seguimientos de pagos de facturas en una sola operación (cargue masivo).

Este endpoint permite registrar múltiples registros de cambios de estado asociados a seguimientos de pago de factura siguiendo un flujo definido de transiciones de estado para el ciclo de vida del pago, todo de manera optimizada. Utiliza operaciones bulk para minimizar los round-trips a la base de datos.

Estados permitidos (dominio 14 - ESTADO_PAGO):

  • 1402: Pago consignado por la entidad pagadora (ERP)
  • 1404: Pago recibido - Confirmado por IPS/Prestador
  • 1405: Pago no recibido - IPS/Prestador indica no haber recibido

Flujo de transiciones de estado (aplicado por ítem):

  1. Estado inicial (cuando no existe estado previo):

    • Solo se puede crear con estado 1402 (Pago consignado)
    • Solo usuarios con roles SIIFA_ERP, SIIFA_ERP_Gestor o SIIFA_Admin
    • El NIT del usuario ERP debe corresponder al NIT contratante de la factura

  2. Desde 1402 (Pago consignado) puede cambiar a:

    • 1404 (Pago recibido) - IPS/Prestador confirma recepción del pago
    • 1405 (Pago no recibido) - IPS/Prestador indica no haber recibido el pago
    • Solo usuarios con roles SIIFA_IPS, SIIFA_IPS_Gestor, SIIFA_FITS, SIIFA_FITS_Gestor o SIIFA_Admin
    • El NIT del usuario IPS/FITS debe corresponder al NIT contratista de la factura

  3. Estados 1404 y 1405 son finales:

    • No se permiten más cambios de estado una vez alcanzados
    • Representan el cierre del ciclo de conciliación del pago

Datos del comando (aplicado por ítem):

  • IdSeguimientoFacturaPago: ID del seguimiento de pago (requerido)
  • CodigoEstado: Código del nuevo estado (1402, 1404 o 1405)
  • Observacion: Detalles adicionales sobre el cambio de estado (opcional, max 1000 caracteres)

Validaciones (aplicado por ítem):

  • IdSeguimientoFacturaPago debe ser un número positivo y existir en el sistema
  • CodigoEstado debe ser 1402, 1404 o 1405
  • La transición de estado debe seguir el flujo permitido
  • El usuario debe tener el rol apropiado para el estado que desea registrar
  • El NIT del usuario debe corresponder a la entidad apropiada según el estado

Validaciones de roles y permisos (aplicado por ítem):

  • Estado 1402: Roles SIIFA_ERP/SIIFA_ERP_Gestor (NIT = contratante) o SIIFA_Admin
  • Estados 1404/1405: Roles SIIFA_IPS/SIIFA_IPS_Gestor/SIIFA_FITS/SIIFA_FITS_Gestor (NIT = contratista) o SIIFA_Admin
  • Los administradores (SIIFA_Admin) pueden registrar cualquier estado sin restricción de NIT

Sample request:

POST /api/SeguimientoFacturaPagoEstado/Masivo
"listaEstados": [
    {
        "idSeguimientoFacturaPago": 1,
        "codigoEstado": 1404,
        "observacion": "Pago recibido satisfactorio"
    },
    {
        "idSeguimientoFacturaPago": 2,
        "codigoEstado": 1405,
        "observacion": "No se encontró el pago"
    }
]
Authorizations:
Bearer
Request Body schema:

Comando con la lista de cambios de estado a registrar.

Array of objects or null (MinSalud_SIIFA_API_Factura_Features_SeguimientoFacturaPagoEstado_Commands_AddSeguimientoFacturaPagoEstadoMasivo_Objeto)

Responses

Request samples

Content type
{
  • "listaEstados": [
    ]
}

Response samples

Content type
application/json
[
  • {
    }
]

SeguimientoTipoCodigo

/api/SeguimientoTipoCodigo/ByGrupo

Authorizations:
Bearer
query Parameters
Grupo
string
Nivel
integer <int32>
IdSeguimientoTipoCodigoPadre
string

Responses

Response samples

Content type
No sample

WeatherForecast

GetWeatherForecast

Authorizations:
Bearer

Responses

Response samples

Content type
No sample