API · SEPE · Contrat@

Envía un Contrat@ al SEPE en una request HTTP.

Una API REST. Un POST /sepe/contrat. La huella te llega de vuelta. Sin colas, sin XML manual, sin abrir el navegador del SEPE.

Bearer + cert · 200 req/min
Modo prueba ?test=1
RGPD · servidores UE
Distribuidor autorizado de Saltra
curl · ApiSEPE POST
curl -X POST https://api.saltra.es/sepe/contrat \
  -H "Authorization: Bearer sk_live_••••" \
  -H "X-Cert-Secret: ••••" \
  -H "Content-Type: application/json" \
  -d '{
    "ccc": "28/1234567/89",
    "naf": "281234567890",
    "tipo_contrato": "100",
    "fecha_inicio": "2026-06-01",
    "jornada": "100",
    "horas_semanales": 40,
    "ocupacion": "2421",
    "convenio": "9905105"
  }'
Contrat@ #SEPE-2026-0712-1A enviado
Huella verificada 312 ms · sandbox
REST Contrat@ XML/JSON Certific@2 Llamamientos Prórroga Transformaciones
Endpoints

Seis verbos. Todo el flujo del SEPE.

Las llamadas más usadas del SEPE expuestas como endpoints REST limpios. Mismos campos que en el navegador, sin el navegador.

Contrat@

Envío del contrato al SEPE en JSON (lo convertimos al XML del organismo). Te devolvemos la huella y el identificador del registro.

POST /sepe/contrat

Copia básica

Genera y envía la copia básica vinculada al Contrat@. Sin pasos extra: una sola llamada y queda registrada.

POST /sepe/copia-basica

Certific@2

Comunica el cese de actividad o suspensión al SEPE. Soporta retornos asíncronos y descarga del resguardo.

POST /sepe/certific2

Llamamientos

Alta de llamamientos de fijos discontinuos en bloque. Pensado para campañas agrícolas, hostelería y comercio estacional.

POST /sepe/llamamientos

Prórroga

Prorroga un contrato temporal sin re-introducir todos los datos. Solo el NAF y la nueva fecha de fin.

POST /sepe/prorroga

Transformación

Pasa un contrato temporal a indefinido y notifícalo al SEPE. Compatible con bonificaciones e incentivos.

POST /sepe/transformacion
Quickstart

De cero a tu primer Contrat@ en cuatro pasos.

Sin SDK. Cualquier lenguaje que hable HTTP vale. Estos cuatro pasos son lo único que un equipo necesita para empezar.

  1. 01

    Solicita acceso y sube tu certificado

    Te damos un token Bearer y un endpoint para subir el certificado digital del cliente. Lo administramos vía /certificate.

    POST /certificate
    Authorization: Bearer sk_live_••••
    Content-Type: multipart/form-data
    
    cert=@cliente.p12
    password=••••
  2. 02

    Lanza tu primera llamada en sandbox

    Añade ?test=1 a cualquier petición para usar el entorno de pruebas. Mismas respuestas, sin tocar el SEPE real.

    curl -X POST \
      "https://api.saltra.es/sepe/contrat?test=1" \
      -H "Authorization: Bearer sk_live_••••" \
      -H "X-Cert-Secret: ••••" \
      -d @contrato.json
  3. 03

    Recibe la huella firmada

    Respuesta JSON estándar con la huella SEPE, el identificador del trámite y los errores normalizados si los hay.

    {
      "success": true,
      "message": "Contrat@ aceptado",
      "data": {
        "huella": "SEPE-2026-0712-1A",
        "ms": 312
      },
      "errors": []
    }
  4. 04

    Monitoriza tu rate limit

    Cada respuesta trae cabeceras X-Ratelimit-Limit y X-Ratelimit-Remaining. 200 req/min por defecto, 429 al sobrepasar.

    HTTP/1.1 200 OK
    X-Ratelimit-Limit: 200
    X-Ratelimit-Remaining: 187
    X-Ratelimit-Reset: 1719399120
    Content-Type: application/json
Precio

Precios bajo demanda.

Cada integración tiene su propio volumen. Hablamos con tu equipo, dimensionamos las llamadas (TGSS, SEPE, DEHU, AEAT) y te enviamos una propuesta cerrada en menos de 48 h. Sin permanencia.

CONTACTO

Una sola propuesta, hecha para tu volumen.

No publicamos tarifas porque no las hay genéricas. Cuéntanos cuántas altas, contratos y consultas mueves al mes y te lo cerramos en 48 h.

  • Empresas ilimitadas en sandbox
  • Soporte técnico humano
  • Onboarding con tu equipo
  • Servidores en la UE
  • Cumplimiento RGPD / LOPDGDD
Sandbox incluido
SLA 99,9%
Permanencia ninguna
Respuesta < 48 h
Solicitar acceso Ver documentación →
FAQ

Lo que más nos preguntan los devs.

Si tu pregunta no está aquí, escríbenos a hola@saltra.es y te responde el equipo técnico, no un bot.

  • 01 ¿Qué se puede automatizar con la API?

    Lo principal del SEPE: Contrat@ (envío y huella), copia básica, Certific@2, llamamientos de fijos discontinuos, prórrogas y transformaciones a indefinido. Y de regalo, si lo necesitas, TGSS (altas/bajas/IT), DEHU (notificaciones) y AEAT (al corriente).

  • 02 ¿Cómo se autentica?

    Bearer token en la cabecera Authorization + X-Cert-Secret con la clave del certificado digital del cliente. El certificado se sube una vez vía /certificate y queda asociado al cliente para todas sus llamadas.

  • 03 ¿Hay límites de uso?

    Por defecto 200 peticiones por minuto, por usuario y por ruta. Cada respuesta incluye las cabeceras X-Ratelimit-Limit y X-Ratelimit-Remaining; si sobrepasas, recibes un 429 limpio. Volúmenes mayores se acuerdan en la propuesta.

  • 04 ¿Hay sandbox para probar antes de ir a producción?

    Sí. Añade ?test=1 a cualquier petición y la llamada va al entorno de pruebas en vez de al SEPE real. Mismos endpoints, mismas respuestas, sin riesgo.

  • 05 ¿Dónde se alojan los datos?

    En servidores dentro de la Unión Europea, con copia de seguridad diaria y cifrado en tránsito y reposo. Cumplimos RGPD y LOPDGDD, mismo cumplimiento que el resto de productos Saltra.

  • 06 ¿Cuánto cuesta?

    Bajo demanda. Cada integración tiene su propio volumen de llamadas, así que cerramos un precio en menos de 48 h después de hablar con tu equipo. Sin permanencia y con propuesta por escrito.

Empieza hoy

Tu primer Contrat@ firmado en menos de una tarde.

Te abrimos el sandbox, te damos credenciales y te acompañamos en la primera llamada real. Sin permanencia.

hola@saltra.es · +34 926 96 66 02 · Respuesta < 48 h