Skip to content

API Intermediarios (1.0.0)

Bienvenido al API de Intermediarios

El API de Intermediarios ha sido diseñado para que puedas acceder e integrar fácilmente las principales funcionalidades que ofrecemos a nuestros socios y aliados.

Con esta API podrás:

  • Cotizar productos de Salud, Generales y Vida
  • Emitir pólizas de manera digital
  • Consultar tus pólizas, facturas, consumos y más

Todo en un solo lugar, con seguridad, rapidez y disponibilidad 24/7.

¿Qué encontrarás en esta documentación?

En esta página encontrarás toda la información necesaria para comenzar a usar el API, incluyendo:

  • Descripción general del API
  • Especificación OpenAPI en formato YAML, lista para ser utilizada en Postman, Swagger u otras herramientas
  • Ejemplos prácticos de uso para integrarte más rápido
  • Guías paso a paso para autenticación, cotización, emisión y consulta de información

Primeros pasos

  1. Consulta la especificación OpenAPI
  2. Explora los endpoints disponibles en la sección de referencia
  3. Integra las funcionalidades en tus sistemas internos para comenzar a operar

Beneficios clave

🔄 Automatización

Automatización de procesos de cotización y emisión.

🔒 Seguridad

Seguridad con estándares modernos de autenticación.

⚡ Disponibilidad 24/7

Siempre tengas acceso a tu información.

📈 Escalabilidad

Lista para crecer con tus operaciones.

Download OpenAPI description
index.json
index.yaml
Overview
Equipo de APIs Humano Seguros
apis@humano.com.do
License
MIT
Languages
Servers
Mock server
https://intermediarios-api.humano.com.do/_mock/apis/
DEV API
https://devapi.humano.com.do/api/
Production API
https://huapi.humano.com.do/api/

Servicio de Pólizas

Endpoints para consultar información de tus pólizas

Operations

Servicio de Facturas

Endpoints para consultar información de facturas

Operations

Servicio de Comisiones

Endpoints para consultar comisiones generadas

Operations

Servicio de Cobros

Endpoints para consultar cobros e ingresos aplicados a pólizas

Operations

Servicio de Catálogos

Endpoints para consultar catálogos y datos de referencia

Operations

Servicio de Cotizaciones

Endpoints para gestionar cotizaciones

Operations

Cotizar Seguro de Automóvil

Request

Genera una cotización para un seguro de automóvil basándose en las características del vehículo y del asegurado.

Nota importante: La fecha de cotización (fechaDesde) debe ser la fecha del día en que se envía la petición.

Vigencias disponibles:

  • M - Mensual (renueva mensualmente)
  • B - Bimestral (renueva cada dos meses)
  • T - Trimestral (renueva cada tres meses)
  • C - Cuatrimestral (renueva cada cuatro meses)
  • S - Semestral (renueva cada seis meses)
  • N - 9 meses (renueva cada nueve meses)
  • A - Anual (renueva al año) - Recomendado
  • U - Única (renueva al año)
  • BA - Bianual (renueva cada dos años)

Monedas disponibles:

  • 1 - Peso Dominicano (RD$)
  • 2 - Dólar Americano (US$)
  • 3 - Euro (€)
Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Bodyapplication/jsonrequired
codigoMonedaintegerrequired

Código de la moneda:

  • 1 - Peso Dominicano (RD$)
  • 2 - Dólar Americano (US$)
  • 3 - Euro (€)
Enum123
Example: 1
fechaDesdestring(date)required

Fecha en que se realiza la cotización. Debe ser la fecha del día en que se envía la petición

Example: "2025-11-07"
direccionIpstringrequired

Dirección IP de la máquina/cliente desde donde se envía la petición

Example: "172.24.214.139"
codigoVigenciastringrequired

Código de vigencia:

  • M - Mensual, B - Bimestral, T - Trimestral
  • C - Cuatrimestral, S - Semestral, N - 9 meses
  • A - Anual (recomendado), U - Única, BA - Bianual
Enum"M""B""T""C""S""N""A""U""BA"
Example: "A"
datosArray of objects(DatoCotizacion)>= 14 itemsrequired

Datos del vehículo y del asegurado. Todos los objetos en este array son obligatorios

datos[].​codigoDatointegerrequired

Identificador del dato. Códigos fijos:

  • 250091 - Plan
  • 250000 - Marca Vehículo
  • 250001 - Modelo Vehículo
  • 250004 - Versión
  • 250003 - Año de Fabricación
  • 250015 - Uso del Vehículo
  • 250016 - Valor del Vehículo
  • 250069 - Fecha de Nacimiento
  • 250320 - Edad del Asegurado
  • 250321 - Estado Civil
  • 250322 - Sexo
  • 250323 - Zona de Circulación
  • 250105 - R.C. Exceso
  • 250088 - Suma Asegurada Auto Exceso
Example: 250091
datos[].​valorDatostringrequired

Valor del dato (variable según el codigoDato):

Plan (250091):

  • 0 - Mi Auto Premier (Todo Riesgo Cero Deducible)
  • 1 - Mi Auto Full (Todo Riesgo Con Deducible)
  • 2 - Mi Auto Básico (Seguro de Ley)
  • 3 - Mi Auto Flex (Todo Riesgo Perdida Total)
  • 4 - Mi Moto Básico

Uso del Vehículo (250015):

  • 1 - Ambulancia
  • 2 - De Renta (Alquiler)
  • 3 - Placa Exhibición
  • 4 - Privado
  • 5 - Público
  • 6 - Taxi
  • 7 - Transporte Priv. de Personal
  • 8 - Transporte Escolar
  • 9 - Vehículo Fúnebre
  • 10 - Transporte Dinero y Valores
  • 11 - Transporte Turístico
  • 12 - Empresa Contratista
  • 13 - Transporte de Combustible
  • 14 - Transporte Mercancia Inflamable
  • 15 - Transporte Mercancia no Inflamable
  • 16 - Recogida de Basura
  • 17 - Escuela de Aprendizaje

Zona de Circulación (250323):

  • 1 - Santo Domingo
  • 2 - Zona Norte
  • 3 - Zona Este
  • 4 - Zona Sur

Estado Civil (250321):

  • S - Soltero
  • C - Casado

Sexo (250322):

  • M - Masculino
  • F - Femenino
  • N - No Aplica

Otros campos: valores numéricos o alfanuméricos según corresponda

Example: "1"
datos[].​labelstringrequired

Etiqueta para identificar a qué hace referencia el codigoDato

Example: "Plan"
datos[].​numeroBienintegerrequired

Número del bien asegurado (siempre 1 para automóvil)

Example: 1
tipoDocumentoReferidorstring

Tipo de documento de la persona que refiere (opcional)

Enum"CED""RNC""PAS"
Example: "CED"
numeroDocumentoReferidorstring

Número de documento de la persona que refiere (requerido si se especifica tipoDocumentoReferidor)

Example: "22312345678"
curl -i -X POST \
  https://intermediarios-api.humano.com.do/_mock/apis/cotizacion/productos/cotizar \
  -H 'Content-Type: application/json' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY_HERE' \
  -H 'x-codigo-mediador: YOUR_API_KEY_HERE' \
  -H 'x-user-key: YOUR_API_KEY_HERE' \
  -d '{
    "codigoMoneda": 1,
    "fechaDesde": "2025-11-07",
    "direccionIp": "172.24.214.139",
    "codigoVigencia": "A",
    "datos": [
      {
        "codigoDato": 250091,
        "valorDato": "1",
        "label": "Plan",
        "numeroBien": 1
      },
      {
        "codigoDato": 250000,
        "valorDato": "40",
        "label": "Marca Vehículo",
        "numeroBien": 1
      },
      {
        "codigoDato": 250001,
        "valorDato": "4",
        "label": "Modelo Vehículo",
        "numeroBien": 1
      },
      {
        "codigoDato": 250004,
        "valorDato": "1",
        "label": "Versión",
        "numeroBien": 1
      },
      {
        "codigoDato": 250003,
        "valorDato": "2016",
        "label": "Año de Fabricación",
        "numeroBien": 1
      },
      {
        "codigoDato": 250015,
        "valorDato": "4",
        "label": "Uso del Vehículo",
        "numeroBien": 1
      },
      {
        "codigoDato": 250016,
        "valorDato": "750300",
        "label": "Valor del Vehículo",
        "numeroBien": 1
      },
      {
        "codigoDato": 250069,
        "valorDato": "24-08-1993",
        "label": "Fecha de nacimiento",
        "numeroBien": 1
      },
      {
        "codigoDato": 250320,
        "valorDato": "28",
        "label": "Edad del Asegurado",
        "numeroBien": 1
      },
      {
        "codigoDato": 250321,
        "valorDato": "S",
        "label": "Estado Civil",
        "numeroBien": 1
      },
      {
        "codigoDato": 250322,
        "valorDato": "M",
        "label": "Genero",
        "numeroBien": 1
      },
      {
        "codigoDato": 250323,
        "valorDato": "1",
        "label": "Zona de Circulación",
        "numeroBien": 1
      },
      {
        "codigoDato": 250105,
        "valorDato": "1",
        "label": "R.C. Exceso ?",
        "numeroBien": 1
      },
      {
        "codigoDato": 250088,
        "valorDato": "5000000",
        "label": "Suma Asegurada Auto Exceso",
        "numeroBien": 1
      }
    ],
    "tipoDocumentoReferidor": "CED",
    "numeroDocumentoReferidor": "22312345678"
  }'

Responses

Cotización generada (puede incluir errores de negocio en la respuesta)

Bodyapplication/json
codigoErrorstring or nullrequired

Si la petición fue exitosa, devolverá null. Si hay error, contendrá el mensaje de error

Example: null
fechaHastastring or null(date-time)required

Fecha fin de vigencia

Example: "2026-11-07T00:00:00.000-04:00"
datosArray of objects(DatoCotizacion)required

Datos con los que se cotizó, basados en lo enviado en la petición y valores establecidos según el plan

datos[].​codigoDatointegerrequired

Identificador del dato. Códigos fijos:

  • 250091 - Plan
  • 250000 - Marca Vehículo
  • 250001 - Modelo Vehículo
  • 250004 - Versión
  • 250003 - Año de Fabricación
  • 250015 - Uso del Vehículo
  • 250016 - Valor del Vehículo
  • 250069 - Fecha de Nacimiento
  • 250320 - Edad del Asegurado
  • 250321 - Estado Civil
  • 250322 - Sexo
  • 250323 - Zona de Circulación
  • 250105 - R.C. Exceso
  • 250088 - Suma Asegurada Auto Exceso
Example: 250091
datos[].​valorDatostringrequired

Valor del dato (variable según el codigoDato):

Plan (250091):

  • 0 - Mi Auto Premier (Todo Riesgo Cero Deducible)
  • 1 - Mi Auto Full (Todo Riesgo Con Deducible)
  • 2 - Mi Auto Básico (Seguro de Ley)
  • 3 - Mi Auto Flex (Todo Riesgo Perdida Total)
  • 4 - Mi Moto Básico

Uso del Vehículo (250015):

  • 1 - Ambulancia
  • 2 - De Renta (Alquiler)
  • 3 - Placa Exhibición
  • 4 - Privado
  • 5 - Público
  • 6 - Taxi
  • 7 - Transporte Priv. de Personal
  • 8 - Transporte Escolar
  • 9 - Vehículo Fúnebre
  • 10 - Transporte Dinero y Valores
  • 11 - Transporte Turístico
  • 12 - Empresa Contratista
  • 13 - Transporte de Combustible
  • 14 - Transporte Mercancia Inflamable
  • 15 - Transporte Mercancia no Inflamable
  • 16 - Recogida de Basura
  • 17 - Escuela de Aprendizaje

Zona de Circulación (250323):

  • 1 - Santo Domingo
  • 2 - Zona Norte
  • 3 - Zona Este
  • 4 - Zona Sur

Estado Civil (250321):

  • S - Soltero
  • C - Casado

Sexo (250322):

  • M - Masculino
  • F - Femenino
  • N - No Aplica

Otros campos: valores numéricos o alfanuméricos según corresponda

Example: "1"
datos[].​labelstringrequired

Etiqueta para identificar a qué hace referencia el codigoDato

Example: "Plan"
datos[].​numeroBienintegerrequired

Número del bien asegurado (siempre 1 para automóvil)

Example: 1
cotizacionesArray of objects(CotizacionDetalle)

Listado de cotizaciones generadas (usualmente un solo registro)

Response
application/json
{
  "codigoError": null,
  "fechaHasta": "2026-11-07T00:00:00.000-04:00",
  "datos": [
    { … },
    { … },
    { … },
    { … }
  ],
  "cotizaciones": [
    { … }
  ]
}

Consultar Detalle de Cotización Generales y Vida

Request

Obtiene el detalle completo de una cotización de Seguros Generales y Vida.

Este servicio retorna información exhaustiva incluyendo:

  • Datos del asegurado y del intermediario
  • Información del producto y plan
  • Bienes asegurados con todos sus datos
  • Coberturas detalladas con primas y deducibles
  • Estado de inspección

Parámetro obligatorio: nuCotizacion es requerido.

Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Query
nuCotizacionintegerrequired

Número de la cotización

Example: nuCotizacion=2256835231
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/cotizacion/detalle?nuCotizacion=2256835231' \
  -H 'Ocp-Apim-Subscription-Key: YOUR_API_KEY_HERE' \
  -H 'x-codigo-mediador: YOUR_API_KEY_HERE' \
  -H 'x-user-key: YOUR_API_KEY_HERE'

Responses

Consulta exitosa

Bodyapplication/json
codigoErrorstring or null

Código de error, en caso de haber

Example: null
descripcionErrorstring or null

Descripción de error, en caso de haber

Example: null
codigoSucursalinteger

Código de la sucursal

Example: 1
descripcionSucursalstring

Descripción de la sucursal

Example: "OFICINA PRINCIPAL"
codigoPersonaMediadorinteger

Código interno del intermediario

Example: 2487109
codigoMediadorinteger

Código del intermediario

Example: 70803
nombreMediadorstring

Nombre del intermediario

Example: "HIDABAS & ASOCIADOS, SRL"
codigoMonedainteger

Código de la moneda

Example: 1
descripcionMonedastring

Descripción de la moneda

Example: "Peso Dominicano"
tipoDocumentoAseguradostring or null

Tipo de documento del asegurado. Puede ser CED (Cédula), RNC, PAS (Pasaporte)

Example: null
numeroDocumentoAseguradostring or null

Número de documento del asegurado

Example: null
nombreAseguradostring or null

Nombre del asegurado

Example: null
codigoCanalVentainteger

Código del canal de venta

Example: 27
descripcionCanalVentastring

Descripción del canal de venta

Example: "API Integración Intermediarios"
codigoAreainteger

Código del ramo

Example: 35
descripcionAreastring

Descripción del ramo

Example: "Automovil"
codigoProductointeger

Código del producto

Example: 350100
descripcionProductostring

Descripción del producto

Example: "Seguros Vehículos de Motor"
fechaDesdestring(date-time)

Fecha desde vigencia

Example: "2025-11-07T00:00:00.000-04:00"
fechaHastastring(date-time)

Fecha hasta vigencia

Example: "2026-11-07T00:00:00.000-04:00"
codigoCotizacioninteger

Código de la cotización

Example: 1
descripcionCotizacionstring

Descripción de la cotización

Example: "Pendiente Por Procesar Emisión/Endoso"
codigoTipoNegociointeger

Código de tipo negocio

Example: 1
descripcionTipoNegociostring

Descripción de tipo de negocio

Example: "100% Humano Seguro"
numeroInspeccioninteger or null

Número de inspección

Example: null
codigoUsuariostring

Código de usuario

Example: "INTINTERMEDIARIO"
primerNombrestring or null

Primer nombre del asegurado

Example: null
segundoNombrestring or null

Segundo nombre del asegurado

Example: null
primerApellidostring or null

Primer apellido del asegurado

Example: null
segundoApellidostring or null

Segundo apellido del asegurado

Example: null
conduceSalidastring or null

Conduce de salida

Example: null
bienesArray of objects(BienCotizacion)

Bienes asegurados con sus datos

codigoPlaninteger

Código del plan

Example: 100
descripcionPlanstring

Descripción del plan

Example: "Vehículo"
codigoPlanPagointeger

Código del plan de pago

Example: 204
descripcionPlanPagostring

Descripción del plan de pago

Example: "Anual"
montoPrimaAnualnumber(double)

Monto de la prima anual

Example: 43332.36
montoImpuestoAnualnumber(double)

Monto del impuesto anual

Example: 6933.18
montoPrimaProrratanumber(double)

Monto de prima prorrata

Example: 43332.36
montoImpuestoProrratanumber(double)

Monto de impuesto prorrata

Example: 6933.18
coberturasArray of objects(CoberturaCotizacion)

Coberturas de la cotización

estatusInspeccioninteger or null

Estado de inspección

Example: null
descripcionEstatusInspeccionstring or null

Descripción del estado de inspección

Example: null
estatusDictamenInspeccioninteger or null

Estado del dictamen de inspección

Example: null
descripcionEstatusDictamenInspeccionstring or null

Descripción del estado del dictamen de inspección

Example: null
permiteEmitirinteger

Indicador si permite emitir (0 = No, 1 = Sí)

Enum01
Example: 0
indicadorMarbeteProvisionalinteger

Indicador de marbete provisional

Enum01
Example: 0
inHogarEsencialinteger or null

Indicador hogar esencial

Example: null
tipoTransaccioninteger

Tipo de transacción

Example: 1
descripcionTransaccionstring

Descripción de la transacción

Example: "Emisión"
codigoMotivoTransaccioninteger

Código del motivo de transacción

Example: 1
descripcionMotivoTransaccionstring

Descripción del motivo de transacción

Example: "Emision Certificado Multiriesgo"
Response
application/json
{
  "codigoError": null,
  "descripcionError": null,
  "codigoSucursal": 1,
  "descripcionSucursal": "OFICINA PRINCIPAL",
  "codigoPersonaMediador": 2487109,
  "codigoMediador": 70803,
  "nombreMediador": "HIDABAS & ASOCIADOS, SRL",
  "codigoMoneda": 1,
  "descripcionMoneda": "Peso Dominicano",
  "tipoDocumentoAsegurado": null,
  "numeroDocumentoAsegurado": null,
  "nombreAsegurado": null,
  "codigoCanalVenta": 27,
  "descripcionCanalVenta": "API Integración Intermediarios",
  "codigoArea": 35,
  "descripcionArea": "Automovil",
  "codigoProducto": 350100,
  "descripcionProducto": "Seguros Vehículos de Motor",
  "fechaDesde": "2025-11-07T00:00:00.000-04:00",
  "fechaHasta": "2026-11-07T00:00:00.000-04:00",
  "codigoCotizacion": 1,
  "descripcionCotizacion": "Pendiente Por Procesar Emisión/Endoso",
  "codigoTipoNegocio": 1,
  "descripcionTipoNegocio": "100% Humano Seguro",
  "numeroInspeccion": null,
  "codigoUsuario": "INTINTERMEDIARIO",
  "primerNombre": null,
  "segundoNombre": null,
  "primerApellido": null,
  "segundoApellido": null,
  "conduceSalida": null,
  "bienes": [
    { … }
  ],
  "codigoPlan": 100,
  "descripcionPlan": "Vehículo",
  "codigoPlanPago": 204,
  "descripcionPlanPago": "Anual",
  "montoPrimaAnual": 43332.36,
  "montoImpuestoAnual": 6933.18,
  "montoPrimaProrrata": 43332.36,
  "montoImpuestoProrrata": 6933.18,
  "coberturas": [
    { … },
    { … },
    { … }
  ],
  "estatusInspeccion": null,
  "descripcionEstatusInspeccion": null,
  "estatusDictamenInspeccion": null,
  "descripcionEstatusDictamenInspeccion": null,
  "permiteEmitir": 0,
  "indicadorMarbeteProvisional": 0,
  "inHogarEsencial": null,
  "tipoTransaccion": 1,
  "descripcionTransaccion": "Emisión",
  "codigoMotivoTransaccion": 1,
  "descripcionMotivoTransaccion": "Emision Certificado Multiriesgo"
}

Servicio de Vehículos

Endpoints para consultar información de vehículos (marcas, modelos, versiones)

Operations