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

Consultar Pólizas de Salud

Request

Obtiene información de los movimientos de las pólizas de Salud según los parámetros indicados.

Tipos de Movimiento:

  • 0: Todos
  • 1: Inclusión
  • 2: Cambio de Póliza
  • 3: Cambio de Plan Categoría
  • 4: Cambio Tipo Dependiente
  • 5: Exclusión

Parámetros opcionales: compania, ramo y secuencial

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

Tipo de movimiento:

  • 0 - Todos
  • 1 - Inclusión
  • 2 - Cambio de Póliza
  • 3 - Cambio de Plan Categoría
  • 4 - Cambio Tipo Dependiente
  • 5 - Exclusión
Enum012345
fechaIniciostring(date)required

Fecha de inicio (Formato año-mes-día)

Example: fechaInicio=2025-01-01
fechaFinstring(date)required

Fecha de fin (Formato año-mes-día)

Example: fechaFin=2025-01-31
companiainteger

Código de la compañía (opcional)

Example: compania=30
ramointeger

Código del ramo (opcional)

Example: ramo=95
secuencialinteger

Secuencial de la póliza (opcional)

Example: secuencial=177999
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/poliza/consulta-polizas?tipoMovimiento=0&fechaInicio=2025-01-01&fechaFin=2025-01-31&compania=30&ramo=95&secuencial=177999' \
  -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
polizasArray of objects(PolizaSalud)
Response
application/json
{
  "polizas": [
    { … },
    { … }
  ]
}

Cargar Archivo de Inspección de Automóvil

Request

Permite cargar documentos de inspección de automóvil para una cotización específica.

Los archivos deben enviarse codificados en Base64.

Campos obligatorios: Todos los campos son requeridos.

Nota: Se requiere especificar al menos un documento en el array.

Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Bodyapplication/jsonrequired
cdEntidadintegerrequired

Código de la aseguradora. Valor fijo 30 (Humano Seguros)

Value30
Example: 30
nuCotizacionintegerrequired

Número de la cotización

Example: 2240799996
documentsArray of objects(Documento)non-emptyrequired

Lista de documentos a cargar (se requiere al menos uno)

documents[].​nmArchivostringrequired

Nombre del archivo con su extensión

Example: "2007-mazda3-owners-manual.pdf"
documents[].​docBytesstring(byte)required

Representación en Base64 del archivo a cargar

Example: "SGVsbG8sIHdvcmxkIQ=="
curl -i -X POST \
  https://intermediarios-api.humano.com.do/_mock/apis/poliza/inspeccion/cargar-documento \
  -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 '{
    "cdEntidad": 30,
    "nuCotizacion": 2240799996,
    "documents": [
      {
        "nmArchivo": "2007-mazda3-owners-manual.pdf",
        "docBytes": "SGVsbG8sIHdvcmxkIQ=="
      }
    ]
  }'

Responses

Carga exitosa

Bodyapplication/json
respuestaobjectrequired
respuesta.​codigointegerrequired

Código de respuesta (0 = exitoso)

Example: 0
respuesta.​descripcionstringrequired

Descripción del resultado

Example: "Completado de manera satisfactoria"
Response
application/json
{
  "respuesta": {
    "codigo": 0,
    "descripcion": "Completado de manera satisfactoria"
  }
}

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

Servicio de Vehículos

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

Operations