# Consultar Cobros de Generales y Vida

Consulta los cobros de un rango de fecha para productos de Seguros Generales y Vida.

Este servicio retorna información detallada de los ingresos/pagos aplicados a las pólizas.

Identificador único de ingreso: P_CD_ENTIDAD + P_CD_SUCURSAL + P_NU_INGRESO

Parámetros obligatorios: todos los parámetros son requeridos.

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

## Query parameters:

  - `fechaDesde` (string, required)
    Fecha inicial del período a consultar
    Example: "2025-01-01"

  - `fechaHasta` (string, required)
    Fecha final del período a consultar
    Example: "2025-01-31"

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

## Response 200 fields (application/json):

  - `payload` (array)

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

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

  - `payload.P_CD_SUCURSAL` (integer, required)
    Código de sucursal donde se aplicó pago
    Example: 52

  - `payload.P_DE_SUCURSAL` (string, required)
    Descripción de sucursal donde se aplicó pago
    Example: "Depositos y transferencias Bancarias"

  - `payload.P_NU_INGRESO` (integer, required)
    Número del ingreso
    Example: 37999

  - `payload.P_FE_INGRESO` (string, required)
    Fecha del ingreso
    Example: "2025-10-08T00:00:00.000Z"

  - `payload.P_CD_MONEDA_INGRESO` (integer, required)
    Código de moneda de ingreso
    Example: 1

  - `payload.P_DE_SIGLAS_MONEDA_INGRESO` (string, required)
    Siglas de la moneda de ingreso
    Example: "RD$"

  - `payload.P_CD_CANAL_COBRO` (integer, required)
    Código del canal de cobro
    Example: 34

  - `payload.P_DE_CANAL_COBRO` (string, required)
    Descripción del canal de cobro
    Example: "Deposito/Transferencia Banco"

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

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

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

  - `payload.P_NU_CERTIFICADO` (integer, required)
    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.

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

  - `payload.P_NM_CLIENTE` (string, required)
    Nombre completo del cliente
    Example: "JUAN PEREZ"

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

  - `payload.P_NU_DOCUMENTO` (string, required)
    Número de documento de identificación del cliente
    Example: "40212345678"

  - `payload.P_DE_INGRESO1` (string, required)
    Descripción del ingreso
    Example: " Pol 30-35-21999-0 Rec 913194 Rec 913194"

  - `payload.P_CD_CAUSA_ANULACION` (integer,null)
    Código causa de anulación

  - `payload.P_DE_CAUSA_ANULACION` (string,null)
    Descripción de la anulación

  - `payload.P_NU_CONSECUTIVO_MOV_CUENTA` (integer, required)
    Número consecutivo movimiento cuenta
    Example: 28

  - `payload.P_CD_RECIBO` (integer, required)
    Código interno del recibo
    Example: 913194

  - `payload.P_TP_RECIBO` (integer, required)
    Código tipo de factura
    Example: 1

  - `payload.P_DE_TP_RECIBO` (string, required)
    Descripción tipo de factura
    Example: "Factura"

  - `payload.P_NU_SECUENCIA_RECIBO` (integer, required)
    Número de factura
    Example: 718805

  - `payload.P_NU_CONVENIO_PAGO` (integer, required)
    Número de convenio de pago
    Example: 9

  - `payload.P_NU_CUOTA` (integer, required)
    Número de la cuota
    Example: 3

  - `payload.P_CD_PLAN_PAGO` (integer, required)
    Código plan de pago
    Example: 204

  - `payload.P_DE_PLAN_PAGO` (string, required)
    Descripción del plan de pago
    Example: "Anual"

  - `payload.P_CD_FRECUENCIA_PAGO_CUOTA` (integer,null)
    Código frecuencia de pago de cuota

  - `payload.P_DE_FRECUENCIA_PAGO_CUOTA` (string,null)
    Descripción frecuencia de pago de cuota

  - `payload.P_CA_CUOTA` (integer,null)
    Cantidad de cuotas

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

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

  - `payload.P_MT_RECIBO_COBRO` (number, required)
    Monto factura cobro
    Example: 2228.89

  - `payload.P_MT_PRIMA_COBRO` (number, required)
    Monto prima cobro
    Example: 1921.45

  - `payload.P_MT_COMPONENTE_COBRO` (number, required)
    Monto del impuesto
    Example: 307.44

  - `payload.P_MT_COMISION_COBRO` (number, required)
    Monto comisión
    Example: 336.26

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

  - `payload.P_FE_PROXIMO_COBRO` (string,null)
    Fecha en que se efectuará próximo cobro

  - `payload.P_FACTURAS_AFECTADAS` (array, required)
    Facturas afectadas por este cobro

  - `payload.P_NU_INGRESO_ORIGINAL` (integer,null)
    Número de ingreso original

  - `payload.P_FE_DESDE` (string, required)
    Fecha desde vigencia
    Example: "2025-07-04T00:00:00.000Z"

  - `payload.P_FE_HASTA` (string, required)
    Fecha hasta vigencia
    Example: "2026-07-04T00:00:00.000Z"

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