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 Generales y Vida

Request

Obtiene información detallada de las pólizas emitidas, modificadas y/o renovadas.

Este servicio debe ser consumido al final del día para sincronizar la información de las pólizas.

Tipos de Consulta:

  • 0: Todo
  • 1: Emisión
  • 2: Modificación
  • 3: Renovación

Indicador de Certificado:

  • 0: Todo
  • 1: Matriz
  • 2: Certificados (Recomendado)
Security
Ocp-Apim-Subscription-Key and x-user-key and x-codigo-mediador
Query
fechaDesdestring(date)required

Fecha inicial de consulta

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

Fecha final de consulta

Example: fechaHasta=2025-01-31
tpConsultaintegerrequired

Tipo de Consulta:

  • 0 - Todo
  • 1 - Emisión
  • 2 - Modificación
  • 3 - Renovación
Enum0123
cdUsuariostringrequired

Código de usuario (enviar fijo INTINTERMEDIARIO)

Default "INTINTERMEDIARIO"
Example: cdUsuario=INTINTERMEDIARIO
inCertificadointegerrequired

Indicador de certificado:

  • 0 - Todo
  • 1 - Matriz
  • 2 - Certificados (Recomendado)
Enum012
Example: inCertificado=2
curl -i -X GET \
  'https://intermediarios-api.humano.com.do/_mock/apis/poliza/consulta?fechaDesde=2025-01-01&fechaHasta=2025-01-31&tpConsulta=0&cdUsuario=INTINTERMEDIARIO&inCertificado=2' \
  -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(PolizaGeneralVida)
Response
application/json
{
  "payload": [
    { … }
  ]
}

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