# Consultar Pólizas de Generales y Vida

Obtiene información detallada de las pólizas emitidas, modificadas y/o renovadas.

Este servicio debe ser consumido al final del día para sincronizar la información de las pólizas.

Tipos de Consulta:
- 0: Todo
- 1: Emisión
- 2: Modificación
- 3: Renovación

Indicador de Certificado:
- 0: Todo
- 1: Matriz
- 2: Certificados (Recomendado)

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

## Query parameters:

  - `fechaDesde` (string, required)
    Fecha inicial de consulta
    Example: "2025-01-01"

  - `fechaHasta` (string, required)
    Fecha final de consulta
    Example: "2025-01-31"

  - `tpConsulta` (integer, required)
    Tipo de Consulta:
* 0 - Todo
* 1 - Emisión
* 2 - Modificación
* 3 - Renovación
    Enum: 0, 1, 2, 3

  - `cdUsuario` (string, required)
    Código de usuario (enviar fijo INTINTERMEDIARIO)
    Example: "INTINTERMEDIARIO"

  - `inCertificado` (integer, required)
    Indicador de certificado:
* 0 - Todo
* 1 - Matriz
* 2 - Certificados (Recomendado)
    Enum: 0, 1, 2

## Response 200 fields (application/json):

  - `payload` (array)

  - `payload.P_CD_ENTIDAD` (integer)
    Código de la aseguradora. Valor siempre fijo 30
    Example: 30

  - `payload.P_CD_AREA` (integer)
    Código del ramo al cual pertenece la póliza
    Example: 35

  - `payload.P_NU_POLIZA` (integer)
    Número de la póliza, perteneciente al cd_area correspondiente
    Example: 9999

  - `payload.P_NU_CERTIFICADO` (integer)
    Valor 0 corresponde a la póliza matriz y el resto de los valores constituye los certificados. Certificado representa lo que se está asegurando, dependiendo el producto puede ser un auto, un núcleo familiar, etc.
    Example: 2

  - `payload.P_DE_POLIZA` (string)
    Concatenación de los campos p_cd_entidad, p_cd_area, p_nu_poliza y p_nu_certificado
    Example: "30-35-9999"

  - `payload.P_NU_ENDOSO` (integer)
    Endoso es cualquier movimiento que se le hace a póliza/certificado. Número de endoso identifica ese movimiento

  - `payload.P_ST_CERTIFICADO` (integer)
    Código del estatus del certificado. Representado en valor numérico. 1, 11...
    Example: 1

  - `payload.P_DE_ST_CERTIFICADO` (string)
    Descripción del estatus del certificado. Vigente, Anulado, etc.
    Example: "Vigente"

  - `payload.P_CD_MONEDA` (integer)
    Código de la moneda de la póliza
    Example: 1

  - `payload.P_DE_MONEDA` (string)
    Descripción de la moneda de la póliza
    Example: "Peso Dominicano"

  - `payload.P_DE_SIGLAS_MONEDA` (string)
    Siglas de la moneda de la póliza
    Example: "RD$"

  - `payload.P_FE_EMISION_CERTIFICADO` (string)
    Fecha en que se emitió certificado
    Example: "2018-10-30T00:00:00.000Z"

  - `payload.P_INFO_PARTICULAR` (string)
    Información particular del certificado. En caso de automóvil muestra marca / modelo / año / chasis y placa
    Example: "HYUNDAI / TUCSON / 2015 / SQRPL90DDRT352941 / G123456 / No Aplica / Prepago No"

  - `payload.P_FE_REGISTRO` (string)
    Fecha en que se registró/realizó el movimiento (emisión/endoso/renovación)
    Example: "2018-10-30T00:00:00.000Z"

  - `payload.P_FE_DESDE` (string)
    Fecha efectividad e inicio vigencia de póliza/certificado. Esta fecha varía por cada renovación de la póliza
    Example: "2018-10-30T00:00:00.000Z"

  - `payload.P_FE_HASTA` (string)
    Fecha término vigencia póliza/certificado. Esta fecha varía por cada renovación de la póliza
    Example: "2019-10-30T00:00:00.000Z"

  - `payload.P_DE_ENTIDAD` (string)
    Descripción del código de entidad (cd_entidad). 30 -> Humano Seguros
    Example: "Humano Seguros"

  - `payload.P_DE_AREA` (string)
    Descripción del código de ramo (cd_area). 35 -> Automóvil
    Example: "Automovil"

  - `payload.P_IN_MULTIRIESGO` (integer,null)
    Es un indicador, sobre si la póliza es individual o no. Valores esperados 1, 0 o null

  - `payload.P_DE_IN_MULTIRIESGO` (string)
    Descripción del indicador (in_multiriesgo). Valores esperados Individual, Colectivo
    Example: "Colectivo"

  - `payload.P_CD_FORMA_DE_PAGO` (integer)
    Código que representa la forma de pago de la póliza. Valores esperados 1, 2, 3 o 4
    Example: 1

  - `payload.P_DE_FORMA_DE_PAGO` (string)
    Descripción del código (cd_forma_de_pago). Valores esperados Pago Directo, Domiciliación Tarjeta, Domiciliación Cuenta, Nómina
    Example: "Pago Directo"

  - `payload.P_MT_PRIMA_NETA` (number)
    Monto neto de la prima
    Example: 6562.06

  - `payload.P_MT_PRIMA_BRUTA` (number)
    Monto bruto de la prima
    Example: 7611.99

  - `payload.P_MT_COMPONENTE` (number)
    Monto impuesto
    Example: 1049.93

  - `payload.P_MT_COMISION` (number)
    Monto comisión
    Example: 1148.36

  - `payload.P_PO_PARTICIPACION_MEDIADOR` (number)
    Porcentaje de participación del intermediario
    Example: 100

  - `payload.P_PO_COMISION` (number)
    Porcentaje de comisión
    Example: 17.5

  - `payload.P_CD_PERSONA_CONTRATANTE` (integer)
    Código único interno del cliente que corresponde al contratante de la póliza
    Example: 2726806

  - `payload.P_NM_CONTRATANTE` (string)
    Nombre del contratante
    Example: "CORREDOR & ASOCIADOS"

  - `payload.P_TP_DOCUMENTO_CONTRATANTE` (string)
    Tipo de documento de identificación del contratante. Valores esperados CED, RNC, PAS (Cédula, RNC, Pasaporte)
    Example: "RNC"

  - `payload.P_NU_DOCUMENTO_CONTRATANTE` (string)
    Número de documento de identificación del contratante
    Example: "101733111"

  - `payload.P_CD_PERSONA_ASEGURADO` (integer)
    Código único interno del cliente que corresponde al asegurado del certificado
    Example: 2726806

  - `payload.P_NM_ASEGURADO` (string)
    Nombre del asegurado
    Example: "JUAN PEREZ"

  - `payload.P_TP_DOCUMENTO` (string)
    Tipo de documento de identificación del asegurado. Valores esperados CED, RNC, PAS (Cédula, RNC, Pasaporte)
    Example: "RNC"

  - `payload.P_NU_DOCUMENTO` (string)
    Número de documento de identificación del asegurado
    Example: "101939333"

  - `payload.P_FE_VENCIMIENTO_DOCUMENTO` (string,null)
    Fecha de vencimiento del documento de identificación del asegurado

  - `payload.P_FE_NACIMIENTO` (string,null)
    Fecha de nacimiento del asegurado

  - `payload.P_CD_SEXO` (string,null)
    Código de sexo del asegurado. Valores esperados M o F

  - `payload.P_CD_OCUPACION` (string,null)
    Código de la ocupación del asegurado

  - `payload.P_DE_OCUPACION` (string,null)
    Descripción de la ocupación (cd_ocupacion) del asegurado

  - `payload.P_CD_PAIS` (integer)
    Código del país del asegurado
    Example: 809

  - `payload.P_DE_PAIS` (string)
    Descripción del código (cd_pais) del asegurado
    Example: "República Dominicana"

  - `payload.P_CD_PROVINCIA` (integer)
    Código de la provincia donde reside asegurado
    Example: 1

  - `payload.P_DE_PROVINCIA` (string)
    Descripción del código (cd_provincia) del asegurado
    Example: "DISTRITO NACIONAL"

  - `payload.P_CD_CIUDAD` (integer)
    Código de ciudad donde reside el asegurado
    Example: 1

  - `payload.P_DE_CIUDAD` (string)
    Descripción del código (cd_ciudad) del asegurado
    Example: "SANTO DOMINGO"

  - `payload.P_DI_COMPLETA` (string)
    Dirección completa del asegurado
    Example: "Avenida Abraham Lincoln No.7 Edificio Humano Piso 19 Apto/Oficina 999 Piantini Distrito Nacional República Dominicana"

  - `payload.P_NU_AREA` (integer)
    Número del área del teléfono del asegurado
    Example: 809

  - `payload.P_NU_TELEFONO` (string)
    Número de teléfono del asegurado (sin el número de área incluido)
    Example: "4763535"

  - `payload.P_DE_EMAIL` (string)
    Dirección de correo electrónico del asegurado
    Example: "juanperez@gmail.com"

  - `payload.P_CD_PRODUCTO` (integer)
    Código del producto al que pertenece la póliza
    Example: 350100

  - `payload.P_DE_PRODUCTO` (string)
    Descripción/Nombre del producto de la póliza
    Example: "Seguros Vehículos de Motor"

  - `payload.P_MT_SUMA_ASEGURADA` (number)
    Monto de la suma asegurada de la póliza

  - `payload.P_CD_CAUSA_ANULACION` (string,null)
    Código de la causa de anulación de póliza o certificado, en caso de estar anulada

  - `payload.P_DE_CAUSA_ANULACION` (string,null)
    Descripción de la causa de anulación de póliza o certificado

  - `payload.P_FE_EXCLUSION` (string,null)
    Fecha de exclusión de certificado, en caso de estar excluido

  - `payload.P_CD_PERSONA_MEDIADOR` (integer)
    Código único interno de cliente que corresponde al intermediario
    Example: 2999999

  - `payload.P_CD_MEDIADOR` (integer)
    Código del intermediario. Este código es el conocido por el intermediario
    Example: 79999

  - `payload.P_NM_MEDIADOR` (string)
    Nombre del intermediario
    Example: "CORREDOR & ASOCIADOS, SRL"

  - `payload.P_TP_DOCUMENTO_MEDIADOR` (string)
    Tipo de documento de identificación del intermediario. Valores esperados CED, RNC, PAS (Cédula, RNC, Pasaporte)
    Example: "RNC"

  - `payload.P_NU_DOCUMENTO_MEDIADOR` (string)
    Número de documento de identificación del intermediario
    Example: "150202563"

  - `payload.P_TP_TRANSACCION` (integer)
    Tipo de transacción que representa el movimiento/endoso
    Example: 1

  - `payload.P_CD_MOTIVO_TRANSACCION` (integer)
    Código del motivo de la transacción que representa el movimiento/endoso
    Example: 2

  - `payload.P_DE_TRANSACCION` (string)
    Descripción del tipo de transacción (tp_transaccion)
    Example: "Emisión"

  - `payload.P_DE_MOTIVO_TRANSACCION` (string)
    Descripción del motivo de transacción
    Example: "Emision De Certificado De Colectivos"

  - `payload.P_TP_NEGOCIO` (integer)
    Indica el tipo de negocio de la póliza. 100% Humano Seguro, Coaseguro Líder o Coaseguro Minoritario
    Example: 1

  - `payload.P_DE_TP_NEGOCIO` (string)
    Descripción del campo de tipo de negocio
    Example: "100% Humano Seguro"

  - `payload.P_CUR_BIENES` (array)
    Lista de bienes asegurados

  - `payload.P_CUR_BIENES.P_NU_BIEN` (integer)
    Número identificador del bien asegurado
    Example: 1

  - `payload.P_CUR_BIENES.P_DE_BIEN` (string)
    Descripción del tipo de bien asegurado
    Enum: "Auto", "Vivienda", "Comercio", "Equipo", "Otro"

  - `payload.P_CUR_COBERTURAS` (array)
    Lista de coberturas de la póliza

  - `payload.P_CUR_COBERTURAS.P_CD_ENTIDAD` (integer, required)
    Código de la aseguradora
    Example: 30

  - `payload.P_CUR_COBERTURAS.P_CD_AREA` (integer, required)
    Código del ramo de la póliza
    Example: 35

  - `payload.P_CUR_COBERTURAS.P_NU_POLIZA` (integer, required)
    Número de la póliza
    Example: 9999

  - `payload.P_CUR_COBERTURAS.P_NU_CERTIFICADO` (integer, required)
    Número del certificado
    Example: 2

  - `payload.P_CUR_COBERTURAS.P_CD_PRODUCTO` (integer)
    Código del producto
    Example: 350100

  - `payload.P_CUR_COBERTURAS.P_DE_PLAN` (string)
    Descriptivo del plan que agrupa la cobertura
    Example: "Mi Auto Básico (Seguro de Ley)"

  - `payload.P_CUR_COBERTURAS.P_CD_GARANTIA` (integer, required)
    Código único de la cobertura/garantía
    Example: 1512

  - `payload.P_CUR_COBERTURAS.P_DE_GARANTIA` (string, required)
    Nombre de la cobertura/garantía
    Example: "Daños a la Propiedad de Terceros"

  - `payload.P_CUR_COBERTURAS.P_DE_SERVICIO` (string)
    Descripción del servicio asociado a la cobertura
    Example: "Daños a la Propiedad de Terceros"

  - `payload.P_CUR_COBERTURAS.P_DE_DETALLE` (string)
    Detalle completo de la cobertura (incluye suma asegurada, deducibles, etc.)
    Example: "Suma Asegurada: 500,000.00"

  - `payload.P_CUR_COBERTURAS.P_MT_SUMA_ASEGURADA` (number)
    Monto de la suma asegurada para esta cobertura
    Example: 500000

  - `payload.P_CUR_COBERTURAS.P_VA_DEDUCIBLE` (number,null)
    Monto fijo del deducible
    Example: 5000

  - `payload.P_CUR_COBERTURAS.P_PO_DEDUCIBLE` (number,null)
    Porcentaje del deducible sobre la suma asegurada
    Example: 10

  - `payload.P_CUR_COBERTURAS.P_IN_INCLUIDO` (integer)
    Indicador de inclusión de la cobertura:
* 0 - Cobertura con suma asegurada específica
* 1 - Cobertura incluida sin suma asegurada definida
    Enum: 0, 1

  - `payload.P_CUR_DATOS` (array)
    Datos particulares del producto

  - `payload.P_CUR_DATOS.P_NU_BIEN` (integer, required)
    Número del bien asegurado al que pertenece este dato
    Example: 1

  - `payload.P_CUR_DATOS.P_CD_DATO` (integer, required)
    Código único del dato particular
    Example: 250000

  - `payload.P_CUR_DATOS.P_VALOR` (string)
    Valor del dato (usar si P_DE_VALOR está vacío)
    Example: "42"

  - `payload.P_CUR_DATOS.P_NU_CONSECUTIVO` (integer)
    Orden de visualización del dato
    Example: 20

  - `payload.P_CUR_DATOS.P_LABEL` (string, required)
    Etiqueta descriptiva del dato
    Example: "Marca Vehículo"

  - `payload.P_CUR_DATOS.P_DE_VALOR` (string)
    Descripción del valor (usar preferentemente sobre P_VALOR si no está vacío)
    Example: "HYUNDAI"

  - `payload.P_CUR_ANEXOS` (array)
    Anexos de la póliza

  - `payload.P_CUR_ANEXOS.P_NU_BIEN_ASEGURADO` (integer,null)
    Número del bien asegurado al que aplica el anexo (null si aplica a toda la póliza)
    Example: 1

  - `payload.P_CUR_ANEXOS.P_CD_GARANTIA` (integer,null)
    Código de la cobertura a la que aplica el anexo (null si aplica a toda la póliza)
    Example: 1512

  - `payload.P_CUR_ANEXOS.P_CD_ANEXO` (integer,null)
    Código único del anexo
    Example: 100

  - `payload.P_CUR_ANEXOS.P_NU_CONSECUTIVO_ANEXO` (integer,null)
    Orden de visualización del anexo
    Example: 1

  - `payload.P_CUR_ANEXOS.P_TX_ANEXO` (string,null)
    Texto completo del anexo o cláusula
    Example: "El asegurado deberá notificar cualquier siniestro dentro de las 48 horas siguientes al evento."

  - `payload.P_CUR_ANEXOS.P_FE_INCLUSION_ANEXO` (string,null)
    Fecha en que se incluyó el anexo
    Example: "2018-10-30T00:00:00.000Z"

  - `payload.P_CUR_ANEXOS.P_TP_INCLUSION_ANEXO` (string,null)
    Tipo de inclusión del anexo:
* F - Anexo fijo (permanente en la póliza)
* E - Anexo por periodo de renovación
    Enum: "F", "E", null

  - `payload.P_CUR_BENEFICIARIOS` (array)
    Beneficiarios de la póliza

  - `payload.P_CUR_BENEFICIARIOS.P_NU_BIEN_ASEGURADO` (integer, required)
    Número del bien asegurado al que está asociado el beneficiario
    Example: 1

  - `payload.P_CUR_BENEFICIARIOS.P_NU_CONSECUTIVO_BENEFICIARIO` (integer, required)
    Número consecutivo del beneficiario en la lista
    Example: 1

  - `payload.P_CUR_BENEFICIARIOS.P_CD_PERSONA` (integer,null)
    Código interno de la persona beneficiaria en el sistema
    Example: 123456

  - `payload.P_CUR_BENEFICIARIOS.P_NU_CONSECUTIVO_TP_DOCUMENTO` (integer,null)
    Número consecutivo del tipo de documento
    Example: 1

  - `payload.P_CUR_BENEFICIARIOS.P_TP_DOCUMENTO` (string,null)
    Tipo de documento de identificación del beneficiario
    Enum: "CED", "RNC", "PAS", null

  - `payload.P_CUR_BENEFICIARIOS.P_NU_DOCUMENTO` (string,null)
    Número de documento de identificación del beneficiario
    Example: "001-1234567-8"

  - `payload.P_CUR_BENEFICIARIOS.P_NM_ZONARAZONSOCIAL` (string,null)
    Nombre completo de la persona o razón social
    Example: "Juan Pérez Gómez"

  - `payload.P_CUR_BENEFICIARIOS.P_CD_SEXO` (string,null)
    Código del sexo del beneficiario
    Enum: "M", "F", null

  - `payload.P_CUR_BENEFICIARIOS.P_DE_SEXO` (string,null)
    Descripción del sexo del beneficiario
    Enum: "Masculino", "Femenino", null

  - `payload.P_CUR_BENEFICIARIOS.P_CD_PARENTESCO` (integer, required)
    Código del parentesco con el asegurado
    Example: 90

  - `payload.P_CUR_BENEFICIARIOS.P_DE_PARTENTESCO` (string, required)
    Descripción del parentesco con el asegurado
    Enum: "Herederos Legales", "Cónyuge", "Hijo/a", "Padre/Madre", "Hermano/a", "Otro"

  - `payload.P_CUR_BENEFICIARIOS.P_FE_NACIMIENTO` (string,null)
    Fecha de nacimiento del beneficiario
    Example: "1990-05-15T00:00:00.000Z"

  - `payload.P_CUR_BENEFICIARIOS.P_FE_INCLUSION` (string, required)
    Fecha en que el beneficiario fue incluido en la póliza
    Example: "2018-10-30T00:00:00.000Z"

  - `payload.P_CUR_BENEFICIARIOS.P_PO_PARTICIPACION` (number, required)
    Porcentaje de participación del beneficiario en la indemnización
    Example: 100

## 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)