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

Consultar Facturas de Salud

Request

Retorna las facturas de salud que han sido procesadas por Humano en el rango de fechas indicado.

Este servicio soporta paginación para manejar grandes volúmenes de datos.

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

Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Query
fechaIniciostring(date)required

Fecha de inicio del período a consultar

Example: fechaInicio=2024-12-01
fechaFinstring(date)required

Fecha de fin del período a consultar

Example: fechaFin=2024-12-31
paginainteger>= 1required

Número de página a consultar

Example: pagina=1
tamanoPaginainteger[ 1 .. 100 ]required

Cantidad de registros por página

Example: tamanoPagina=50
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/facturas/consulta/salud?fechaInicio=2024-12-01&fechaFin=2024-12-31&pagina=1&tamanoPagina=50' \
  -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
One of:
payloadArray of objects(FacturaSalud)
Response
application/json
{
  "payload": [
    { … },
    { … }
  ]
}

Consultar Facturas de Generales y Vida

Request

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.

Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Query
fechaDesdestring(date)required

Fecha desde (inicio del período a consultar)

Example: fechaDesde=2025-01-01
fechaHastastring(date)required

Fecha hasta (fin del período a consultar)

Example: fechaHasta=2025-01-31
cdUsuariostringrequired

Código de usuario (enviar fijo INTINTERMEDIARIO)

Default "INTINTERMEDIARIO"
Example: cdUsuario=INTINTERMEDIARIO
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/facturas/consulta?fechaDesde=2025-01-01&fechaHasta=2025-01-31&cdUsuario=INTINTERMEDIARIO' \
  -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
payloadArray of objects(FacturaGeneralesVida)
Response
application/json
{
  "payload": [
    { … }
  ]
}

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

Servicio de Vehículos

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

Operations