API para conectar tu correduría

Integra Semmas con tus herramientas mediante una API REST con claves propias: lee y actualiza clientes, pólizas, renovaciones, siniestros, recibos y agenda. Complemento de 99 €/mes, documentado con OpenAPI 3.1.

Terminal — API de Semmas
Ejemplo ilustrativo
$curl -H"Authorization: Bearer smk_…" \
https://www.semmas.es/api/v1/renewals?dias=30
{
"datos": [
{
"id": 1842,
"cliente_nombre": "Laura Martín",
"ramo": "hogar",
"aseguradora": "Aseguradora A",
"proxima_renovacion": "2026-10-24",
"dias_para_renovar": 4,
"prima": { "importe": 412.0, "moneda": "EUR"}
}, …
],
"paginacion": { "pagina": 1, "total": 3},
"dias": 30
}

Lleva los datos de Semmas a tus herramientas

Cualquier aplicación que pueda hacer peticiones HTTP puede trabajar con la API: tu web, tu CRM o ERP, una herramienta de BI, una hoja de cálculo o una plataforma de automatización. Las respuestas son JSON con nombres de campo en español, importes en euros y fechas en formato ISO-8601.

  • Alimenta informes y cuadros de mando con tu cartera
  • Da de alta clientes desde los formularios de tu web
  • Prepara las llamadas de renovación desde otra aplicación
  • Listados paginados de hasta 100 resultados por página
Terminal — API de Semmas
Ejemplo ilustrativo
$curl -H"Authorization: Bearer smk_…" \
https://www.semmas.es/api/v1/renewals?dias=30
{
"datos": [
{
"id": 1842,
"cliente_nombre": "Laura Martín",
"ramo": "hogar",
"aseguradora": "Aseguradora A",
"proxima_renovacion": "2026-10-24",
"dias_para_renovar": 4,
"prima": { "importe": 412.0, "moneda": "EUR"}
}, …
],
"paginacion": { "pagina": 1, "total": 3},
"dias": 30
}
https://www.semmas.es/api/v1
GET
/clients
POST
/clients
PATCH
/clients/{id}
GET
/policies
GET
/renewals
GET
/claims
POST
/claims/{id}/notes
GET
/receipts
GET
/agenda
POST
/tasks · /events
GET
/summary
Lectura
Requiere permiso de escritura

Endpoints disponibles

La URL base es https://www.semmas.es/api/v1. Con permiso de lectura puedes consultar clientes (con sus pólizas y familiares), pólizas, renovaciones de los próximos días, siniestros, recibos, agenda y un resumen de la correduría. Con permiso de escritura, también dar de alta clientes, actualizar sus datos de contacto, crear tareas y eventos y añadir notas a siniestros.

  • Clientes: listar, consultar, crear y actualizar contacto
  • Pólizas y renovaciones de los próximos N días
  • Siniestros con su historial y notas
  • Recibos, agenda, tareas, eventos y resumen

Claves con permisos y límites

El titular de la correduría crea las claves desde la sección API de Semmas. Cada clave se muestra una sola vez, da acceso a los datos de toda la correduría y puede ser de solo lectura o de lectura y escritura. Guárdala como una contraseña y revócala si ya no la usas o crees que se ha filtrado.

  • Autenticación con la cabecera Authorization: Bearer
  • Permiso de solo lectura o de lectura y escritura
  • Revocación inmediata y registro del último uso
  • Límite de 120 peticiones por minuto por clave
Semmas — API
Nueva clave
Web
Permitir escritura
Crear clave
Copia la clave ahora: no se volverá a mostrar
smk_7Qx2…
Ejemplo ilustrativo
ERP
smk_A1b2C3d4… · Lectura y escritura · hace 5 min
Revocar
Informes BI
smk_Z9y8X7w6… · Solo lectura · ayer
Revocar
120 peticiones por minuto por clave
openapi.json
API de Semmas
OpenAPI 3.1
GET
/renewals
Pólizas que renuevan en los próximos días
dias
integer · 1–365 · por defecto 30
pagina
integer · desde 1
por_pagina
integer · máx. 100
Respuestas
200
Listado paginado
401
Clave no válida o revocada
429
Límite de peticiones superado
Extracto ilustrativo de /api/v1/openapi.json

Documentación OpenAPI

La referencia completa está publicada en formato OpenAPI 3.1 en https://www.semmas.es/api/v1/openapi.json. Puedes abrirla con tu visor OpenAPI habitual o usarla para generar un cliente en tu lenguaje de programación.

  • Esquema OpenAPI 3.1 con parámetros y respuestas
  • Errores JSON con código y mensaje en español
  • Guía paso a paso en el centro de ayuda de Semmas

Complemento de 99 €/mes

La API es un complemento de pago de 99 €/mes o 990 €/año que se contrata aparte de los módulos, desde la página de planes. ¿Solo quieres usar Semmas desde un asistente de IA? Para eso no necesitas la API: el conector para Claude y ChatGPT está incluido en todos los planes.

  • 99 €/mes o 990 €/año, IVA incluido
  • Contratación desde la página de planes
  • Crea claves en cuanto se confirme el pago
Semmas — Complementos
API de Semmas
Complemento
99 €
/ mes
o 990 € / año · IVA incluido
API REST documentada con OpenAPI 3.1
Claves de solo lectura o de lectura y escritura
Clientes, pólizas, renovaciones, siniestros, recibos y agenda
El conector para Claude y ChatGPT va incluido en todos los planes

Conecta Semmas con tus herramientas