# Consultar Facturas de Generales y Vida

Consulta las facturas emitidas para los productos de Seguros Generales y Vida.

Este servicio retorna todas las facturas procesadas en el rango de fechas especificado.

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

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

## Query parameters:

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

  - `fechaHasta` (string, required)
    Fecha hasta (fin 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_CD_RECIBO` (integer, required)
    Código del recibo
    Example: 849999

  - `payload.P_TP_RECIBO` (integer, required)
    Código tipo recibo
    Example: 2

  - `payload.P_DE_TP_RECIBO` (string, required)
    Descripción tipo recibo
    Example: "Nota Crédito"

  - `payload.P_NU_SECUENCIA_RECIBO` (integer, required)
    Número de secuencia del recibo
    Example: 180999

  - `payload.P_CD_AREA` (integer, required)
    Código de ramo
    Example: 35

  - `payload.P_DE_AREA` (string, required)
    Descripción del ramo
    Example: "Automovil"

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

  - `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-82999"

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

  - `payload.P_TP_TRANSACCION` (integer, required)
    Código tipo de transacción
    Example: 6

  - `payload.P_DE_TP_TRANSACCION` (string, required)
    Descripción tipo de transacción
    Example: "Anulación"

  - `payload.P_FE_EMISION_RECIBO` (string, required)
    Fecha de emisión del recibo
    Example: "2025-02-08T00:00:00.000Z"

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

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

  - `payload.P_FE_REGISTRO` (string, required)
    Fecha de registro de la transacción
    Example: "2025-01-17T00:00:00.000Z"

  - `payload.P_TP_COMPROBANTE_FISCAL` (string, required)
    Código del tipo de comprobante fiscal
    Example: "34"

  - `payload.P_DE_TP_COMPROBANTE_FISCAL` (string, required)
    Descripción del tipo de comprobante fiscal
    Example: "Nota de Crédito Electrónica"

  - `payload.P_NU_COMPROBANTE_FISCAL` (string, required)
    Número de comprobante fiscal (NCF)
    Example: "E340000099999"

  - `payload.P_FE_VENCIMIENTO_NUMERADOR` (string)
    Fecha vencimiento numerador comprobante
    Example: "9999-12-31T00:00:00.000Z"

  - `payload.P_CD_PERSONA` (integer, required)
    Código interno del cliente como persona
    Example: 1090349

  - `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: "00123456789"

  - `payload.P_NM_ZONARAZONSOCIAL` (string, required)
    Nombre o razón social del cliente
    Example: "JUAN PEREZ"

  - `payload.P_ST_RECIBO` (integer, required)
    Código de estatus del recibo
    Example: 5

  - `payload.P_DE_ST_RECIBO` (string, required)
    Descripción del estatus del recibo
    Example: "Devuelto"

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

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

  - `payload.P_MT_RECIBO` (number, required)
    Monto del recibo/factura
    Example: -8790.51

  - `payload.P_MT_PRIMA` (number, required)
    Monto prima
    Example: -7578.03

  - `payload.P_MT_TOTAL_COMPONENTE` (number, required)
    Monto total impuesto
    Example: -1212.48

  - `payload.P_MT_COMISION` (number, required)
    Monto comisión
    Example: -1326.16

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

  - `payload.P_FACTURAS_AFECTADAS` (array, required)
    Facturas afectadas por esta transacción

  - `payload.P_FACTURAS_AFECTADAS.P_MT_RECIBO_AFECTADO` (number, required)
    Monto recibo afectado
    Example: -8790.51

  - `payload.P_FACTURAS_AFECTADAS.P_MT_PRIMA_AFECTADO` (number, required)
    Monto prima recibo afectado
    Example: -7578.03

  - `payload.P_FACTURAS_AFECTADAS.P_MT_COMPONENTE_AFECTADO` (number, required)
    Monto impuesto recibo afectado
    Example: -1212.48

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