# Consultar Pólizas de Salud

Obtiene información de los movimientos de las pólizas de Salud según los parámetros indicados.

Tipos de Movimiento:
- 0: Todos
- 1: Inclusión
- 2: Cambio de Póliza
- 3: Cambio de Plan Categoría
- 4: Cambio Tipo Dependiente
- 5: Exclusión

Parámetros opcionales: compania, ramo y secuencial

Endpoint: GET /poliza/consulta-polizas
Version: 1.0.0
Security: Ocp-Apim-Subscription-Key, x-user-key, x-codigo-mediador

## Query parameters:

  - `tipoMovimiento` (integer, required)
    Tipo de movimiento:
* 0 - Todos
* 1 - Inclusión
* 2 - Cambio de Póliza
* 3 - Cambio de Plan Categoría
* 4 - Cambio Tipo Dependiente
* 5 - Exclusión
    Enum: 0, 1, 2, 3, 4, 5

  - `fechaInicio` (string, required)
    Fecha de inicio (Formato año-mes-día)
    Example: "2025-01-01"

  - `fechaFin` (string, required)
    Fecha de fin (Formato año-mes-día)
    Example: "2025-01-31"

  - `compania` (integer)
    Código de la compañía (opcional)
    Example: 30

  - `ramo` (integer)
    Código del ramo (opcional)
    Example: 95

  - `secuencial` (integer)
    Secuencial de la póliza (opcional)
    Example: 177999

## Response 200 fields (application/json):

  - `polizas` (array)

  - `polizas.compania` (integer, required)
    Código de la compañía
    Example: 30

  - `polizas.ramo` (integer, required)
    Código del ramo
    Example: 95

  - `polizas.secuencial` (integer, required)
    Secuencial de la póliza
    Example: 177999

  - `polizas.tipoMovimiento` (string, required)
    Tipo de movimiento realizado
    Enum: "Todos", "Inclusión", "Cambio de Póliza", "Cambio de Plan Categoría", "Cambio Tipo Dependiente", "Exclusión"

  - `polizas.producto` (string, required)
    Nombre del producto
    Example: "SALUD LOCAL"

  - `polizas.codigoPlan` (integer, required)
    Código del plan
    Example: 18

  - `polizas.descripcionPlan` (string, required)
    Descripción del plan
    Example: "Royal"

  - `polizas.fechaVigencia` (string, required)
    Fecha de vigencia
    Example: "2025-02-01T00:00:00.000-04:00"

  - `polizas.fechaRealizacion` (string, required)
    Fecha de realización del movimiento
    Example: "2025-01-13T09:37:09.000-04:00"

  - `polizas.fechaEfectiva` (string, required)
    Fecha de efectividad del movimiento
    Example: "2025-02-01T00:00:00.000-04:00"

  - `polizas.persona` (object, required)
    Información de la persona asegurada

  - `polizas.persona.nombreAsegurado` (string, required)
    Nombre completo de la persona asegurada
    Example: "Juan Pérez"

  - `polizas.persona.numeroAsegurado` (string, required)
    Número del asegurado
    Example: "1047123-003"

  - `polizas.persona.numeroDocumentoAsegurado` (string, required)
    Número de documento del asegurado
    Example: "00112345678"

  - `polizas.persona.categoria` (string, required)
    Categoría del asegurado
    Example: "Familiar"

  - `polizas.persona.tipoAsegurado` (string, required)
    Tipo de asegurado
    Enum: "Titular", "Dependiente"

## Response 400 fields (application/json):

  - `statusCode` (integer, required)
    Código de estado HTTP que se aplica a este problema
    Example: 401

  - `message` (string, required)
    Explicación específica y detallada de esta ocurrencia del problema
    Example: "La fecha de inicio debe ser posterior a la fecha actual"

## Response 401 fields (application/json):

  - `statusCode` (integer, required)
    Código de estado HTTP que se aplica a este problema
    Example: 401

  - `message` (string, required)
    Explicación específica y detallada de esta ocurrencia del problema
    Example: "La fecha de inicio debe ser posterior a la fecha actual"

## Response 404 fields (application/json):

  - `statusCode` (integer)

  - `message` (string)