Docs + API · v1

Una API documentada
en castellano para
todos los trámites del SEPE.

Contrat@, Certific@2, Llamamientos de fijos discontinuos, prórrogas, transformaciones y consulta de empresas autorizadas. Pensada para asesorías, despachos y ERPs — con la misma tecnología que usa Saltra en sus productos.

REST · JSON
Sandbox test=1
Servidores UE · RGPD
Saltra Distribuidor autorizado de Saltra
Usada por equipos de
  • Asesorías
  • Despachos
  • ERPs
  • Software de nóminas
  • Cooperativas de profesionales
Ver referencia técnica
Endpoints

Una API que cubre todo lo que tu equipo hace en el SEPE.

Seis bloques de funcionalidad, todos REST y todos en castellano. Los nombres son los mismos que ya usas con tus gestores — sin crípticos códigos de la sede electrónica.

Contrat@ por XML/JSON

POST /sepe/contrat

Envía cualquier modalidad contractual al SEPE. Tú nos pasas un JSON cómodo, nosotros generamos el XML oficial y devolvemos huella + acuse en PDF.

Certific@2 sin formularios

POST /sepe/certific2

Comunicación de finiquito y motivos de cese 100% automatizada. Adiós a rellenar a mano el formulario del SEPE cada vez que finaliza un contrato.

Llamamientos a fijos discontinuos

POST /sepe/llamamientos

Llama, suspende o cesa fijos discontinuos en una sola petición. Diseñado para empresas con campañas estacionales (agro, hostelería, retail).

Prórroga + transformación

POST /sepe/prorroga · /sepe/transformacion

Prorroga un contrato temporal o transfórmalo a indefinido sin volver a entrar en la sede del SEPE. Una llamada y listo.

Copia básica

POST /sepe/copia-basica

Genera la copia básica del contrato lista para entregar a la representación legal de los trabajadores. Sale firmada y conservada con su huella.

Consulta de empresas autorizadas

GET /sepe/empresas-autorizadas

Verifica en tiempo real qué empresas figuran como autorizadas en el SEPE. Útil antes de iniciar trámites masivos o cesiones de ETT.

Más allá del SEPE, la misma API cubre TGSS (Sistema RED), DEHU, AEAT y cesiones de ETTs. Lo encontrarás todo en docs.saltra.es.

Cómo funciona

Del token a la huella del SEPE en cuatro pasos.

Lo entiende tu desarrollador y lo entienden tus gestores. Ese es el punto.

  1. Solicita tus credenciales

    Hablamos 15 min con tu equipo IT (o con tu desarrollador externo). Te damos un token de sandbox y otro de producción.

    Bash
    # Tu token llegará por emailexport TOKEN="ey...JhcmciLCJpc3MiOiJzYWx0cmEifQ"
  2. Configura tu certificado

    Sube el certificado digital del cliente desde el panel o vía endpoint /certificate. Cada llamada incluye la clave secreta en X-Cert-Secret.

    Bash
    curl -X POST https://api.saltra.es/certificate \  -H "Authorization: Bearer $TOKEN" \  -F "file=@cliente.pfx" \  -F "secret=********"
  3. Llama a la API REST

    Una sola URL base, una respuesta consistente { success, message, errors }. Modo prueba con test=1 cuando integres.

    Bash
    curl -X POST "https://api.saltra.es/sepe/contrat?test=1" \  -H "Authorization: Bearer $TOKEN" \  -H "X-Cert-Secret: ********" \  -H "Content-Type: application/json" \  -d @contrato.json
  4. Recibe la huella y archivos

    El SEPE devuelve la huella oficial y el acuse en PDF (base64). Lo guardamos en tu cuenta y te lo entregamos en la respuesta.

    200 OK · application/json
    {  "success": true,  "huella": "3F9A-CBD2-4A18-...-8C21",  "acuse": "data:application/pdf;base64,JVBERi0..."}
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 horas.

Custom · A medida

Bajo demanda

Una propuesta cerrada, ajustada a las llamadas mensuales que realmente necesitas. Sin paquetes ni tramos artificiales.

desde 48 h

Propuesta sin compromiso

  • Empresas ilimitadas en sandbox
  • Soporte técnico humano
  • Onboarding con tu equipo
  • Servidores en la UE · cumplimiento RGPD / LOPDGDD
  • Sin permanencia
CONTACTO hola@saltra.es
TELÉFONO +34 926 96 66 02
SIGNUP Crear cuenta
FAQ

Preguntas que recibimos a menudo.

Si te queda alguna duda, escríbenos a hola@saltra.es — respondemos en horas, no en días.

01 ¿Qué se puede automatizar con esta API?

Prácticamente todo lo que hoy tu equipo gestiona a mano en la sede del SEPE: Contrat@ (alta de cualquier modalidad contractual), Certific@2, llamamientos a fijos discontinuos, prórrogas, transformaciones a indefinido, copia básica y consulta de empresas autorizadas. Además, en la misma API tienes TGSS (Sistema RED), DEHU y AEAT.

02 ¿Cómo se autentica? ¿Es seguro?

Cada petición lleva un Authorization: Bearer con tu token y un header X-Cert-Secret con la clave secreta del certificado digital del cliente. El certificado lo subes una sola vez al panel (o vía endpoint /certificate) y nunca circula por la red en cada llamada.

03 ¿Hay límites de uso?

Sí, por usuario y por ruta. Por defecto, 200 peticiones por minuto. En cada respuesta verás los headers X-Ratelimit-Limit y X-Ratelimit-Remaining para que puedas controlarlo. Si te sobrepasas, recibes un 429 y simplemente reintentas.

04 ¿Puedo probar antes sin afectar al SEPE?

Sí. Añade test=1 a cualquier petición y entras en modo sandbox: validamos la estructura, generamos respuestas realistas y no se envía nada al organismo. Ideal para integrar con calma antes de pasar a producción.

05 ¿Dónde se guardan los datos?

En servidores dentro de la Unión Europea, con cifrado en tránsito y en reposo. Cumplimos RGPD y LOPDGDD. Las huellas, acuses y archivos quedan asociados a tu cuenta y los puedes descargar cuando quieras.

06 ¿Cuánto cuesta?

El precio es bajo demanda y depende del volumen mensual de llamadas. Hablamos con tu equipo, vemos qué endpoints vas a usar (SEPE, TGSS, DEHU, AEAT...) y te enviamos una propuesta cerrada en menos de 48 h. Sin permanencia.

Listos cuando vosotros lo estéis

Conecta tu ERP al SEPE
esta misma semana.

Una llamada de 15 min, un token de sandbox y un onboarding sencillo. Lo mismo que ya hacen asesorías, despachos y software de nóminas con la tecnología de Saltra.