API · SEPE

La API de SEPE
para developers.

Contrat@, Certific@2 y llamamientos en una sola request. REST + JSON, autenticación Bearer + certificado, respuesta con huella en tiempo real. La misma tecnología que mueve los trámites de Saltra, expuesta como API.

  • REST + JSON
  • Bearer + X-Cert-Secret
  • Sandbox test=1

Saltra Distribuidor autorizado de Saltra

La misma tecnología que firma trámites para asesorías, ERPs laborales y despachos de toda España.

RGPD · LOPDGDD
  • REST
  • JSON
  • XML cuando lo exige el SEPE
  • Bearer + X-Cert-Secret
  • Rate-limit 200/min
  • Servidores UE
Endpoints

Todo el SEPE
detrás de una sola API.

REST limpio, JSON dentro y XML solo cuando el SEPE lo exige. Cada endpoint devuelve la huella oficial del trámite — guárdala en tu ERP y olvídate del portal.

01 · Contratos

Contrat@ por XML

Envía el XML del contrato y recibe la huella de comunicación al SEPE en una sola llamada. Validación previa, errores estructurados.

POST /sepe/contrat
02 · Certificados

Certific@2

Comunicación de certificados de empresa por baja, fin de contrato o cualquier supuesto que Certific@2 contemple — sin pelearte con la web.

POST /sepe/certific2
03 · Fijos discontinuos

Llamamientos

Alta y consulta de llamamientos para fijos discontinuos. Ideal para campañas, hostelería y agro: bursts grandes sin tocar el portal del SEPE.

POST /sepe/llamamientos
04 · Ciclo del contrato

Prórroga y transformación

Prorroga un contrato temporal o transfórmalo en indefinido desde la API. Mismo endpoint, mismo formato, mismo flujo que tu equipo conoce.

POST /sepe/contrat/prorroga
05 · Documentación

Copia básica

Genera y comunica la copia básica del contrato al SEPE / autoridad laboral. Audit-trail con huella, fecha y código de estado por trámite.

POST /sepe/copia-basica
06 · Validación

Empresas autorizadas

Consulta si una empresa está autorizada para operar con el SEPE antes de lanzar el resto del flujo. Una verificación, cero rechazos sorpresa.

GET /sepe/empresas-autorizadas
Quickstart · 5 min

De cero a Contrat@ en cuatro pasos.

Sin webhooks raros, sin SDKs propietarios. Solo HTTP. Si tu lenguaje habla REST, ya habla con el SEPE.

  1. 01

    Solicita tu Bearer

    Mándanos un correo, te activamos un token de sandbox y otro de live. Sin permanencia.

    env
    # .env
    SALTRA_API_TOKEN=sk_test_8f3a…2c1
  2. 02

    Sube tu certificado

    El certificado digital del cliente se sube una vez. Pasa a referenciarse por X-Cert-Secret en cada llamada.

    http
    POST /certificate
    Authorization: Bearer $SALTRA_API_TOKEN
    Content-Type: multipart/form-data
    
    { "cert": @cliente.p12, "password": "••••" }
  3. 03

    Lanza una petición

    Cualquier endpoint del SEPE: Contrat@, Certific@2, llamamientos, prórroga, transformación. Añade test=1 para sandbox.

    http
    POST /sepe/contrat
    Authorization: Bearer $SALTRA_API_TOKEN
    X-Cert-Secret: $CERT_SECRET
    
    { "client_id": "8821", "test": 1, "xml": "<Contrat@>…</Contrat@>" }
  4. 04

    Recibe huella + estado

    Respuesta JSON estándar con success, fingerprint del organismo, id interno y array de errors. Listo para auditoría.

    json
    200 OK
    
    {
      "success": true,
      "fingerprint": "f3a9c2…8d10b4",
      "id": "ctr_3JxPq71KvA",
      "errors": []
    }
Ver documentación completa o curl https://docs.saltra.es
Precios

Precios bajo demanda.

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

Contact only TGSS · SEPE · DEHU · AEAT

Hablemos del volumen
y montamos un plan a medida.

Comunicación de Contrat@, Certific@2, llamamientos, prórroga, transformaciones y todo el ciclo del contrato — dimensionado a las llamadas que realmente haces.

  • Empresas ilimitadas en sandbox
  • Soporte técnico humano
  • Onboarding con tu equipo
  • Servidores en la UE
  • Cumplimiento RGPD · LOPDGDD

Respuesta en <48 h Sandbox gratis Cero permanencia

FAQ

Preguntas de developers.

Si lo tuyo no está aquí, abre una conversación con el equipo técnico.

hola@saltra.es
01 ¿Qué trámites del SEPE se pueden automatizar?

Contrat@ (XML + transformación), Copia básica, Certific@2, Llamamientos para fijos discontinuos, Prórroga, Transformación a indefinido y consulta de Empresas Autorizadas. Todo desde la misma API REST.

02 ¿Cómo se autentica la API?

Cabecera Authorization: Bearer {token} para identificar tu cuenta y X-Cert-Secret para referenciar el certificado digital del cliente (subido una vez al endpoint /certificate). El certificado se almacena cifrado en servidores UE.

03 ¿Hay límites de uso?

Cada respuesta incluye las cabeceras X-Ratelimit-Limit y X-Ratelimit-Remaining. Por defecto 200 req/min por usuario y ruta. Al superarlo recibes un 429 con retry-after. Para volúmenes mayores ajustamos el plan en contrato.

04 ¿Hay sandbox para pruebas?

Sí. Añade el parámetro test=1 en cualquier llamada y se procesa contra el entorno de pruebas del SEPE — sin afectar al expediente real del trabajador.

05 ¿Dónde se alojan los datos?

Servidores en la Unión Europea, cifrado en tránsito y en reposo, audit log por trámite. Cumplimos RGPD y LOPDGDD. Firmamos contrato de encargado del tratamiento con cada cliente.

06 ¿Hay SDKs oficiales?

No los necesitas: la API es REST estándar (JSON, y XML únicamente cuando lo exige el SEPE). Cualquier lenguaje que hable HTTP — Node, Python, PHP, Ruby, Go, Java, .NET — la consume en cinco líneas.

Listos cuando lo estéis

Deja de pelearte con
el portal del SEPE.

Te activamos un token de sandbox en minutos y revisamos el flujo de integración con tu equipo técnico. Si en 48 h no tienes una propuesta cerrada, te invitamos a un café.