API · SEPE

Una sola API para todos los trámites del SEPE.

Contrat@, Certific@2, llamamientos de fijos discontinuos y más. Le envías un JSON, transformamos al XML que pide cada organismo y te devolvemos una respuesta limpia con success, huella e id.

Distribuidor autorizado de Saltra
  • Servidores UE
  • RGPD · LOPDGDD
  • Soporte humano
POST /sepe/contrat
200
XML al SEPE Contrat@
<contrato>
  <empresa cif="B12345678"/>
  <trabajador naf="281234567890"/>
  <tipoContrato>100</tipoContrato>
  <fechaInicio>2026-06-01</fechaInicio>
</contrato>
JSON de respuesta 200 OK
{
  "success": true,
  "huella": "7f4a9c2e1b8d…",
  "id": "ctt_01H8XYZ42K",
  "organismo": "SEPE",
  "fecha": "2026-05-27T11:08:22Z"
}
X-Ratelimit-Remaining: 199 EU · Madrid
  • REST
  • JSON
  • XML donde lo pide el SEPE
  • Bearer + X-Cert-Secret
  • 200 req/min
  • Servidores UE
Endpoints

Cada trámite del SEPE, un endpoint REST.

Cobertura completa de Contrat@, Certific@2 y llamamientos, además del resto del catálogo SEPE. Llamadas idempotentes, errores estructurados y la huella oficial en cada respuesta.

POST /sepe/contrat

Contrat@

Envía contratos al SEPE con transformación XML automática y firma con el certificado del cliente.

POST /sepe/certific2

Certific@2

Certificados de empresa por fin de contrato, suspensión o reducción de jornada. Confirmación en segundos.

POST /sepe/llamamientos

Llamamientos

Alta de llamamientos para fijos discontinuos, incluida la comunicación al SEPE y la copia básica.

POST /sepe/copia-basica

Copia básica

Tramita la copia básica del contrato y obtén la huella de validación para tu expediente.

POST /sepe/prorroga

Prórrogas y conversiones

Prórroga, transformación a indefinido y horas complementarias — un solo endpoint por trámite.

GET /sepe/empresas-autorizadas

Empresas autorizadas

Consulta el estado de tu empresa como autorizada SEPE antes de mandar trámites en lote.

Misma tecnología que Saltra usa en sus productos RH y Plataforma. Ver catálogo completo →
Cómo funciona

De cero a primer trámite en una tarde.

Cuatro pasos. Sin SDKs propietarios, sin colas opacas, sin permanencia. Cualquier cliente HTTP sirve.

01

Pides acceso

Activamos un usuario sandbox y validamos los datos del despacho o ERP en menos de 24 h.

POST /auth/token
02

Subes el certificado

El certificado digital del cliente vive cifrado en nuestros servidores. Lo administras desde un endpoint.

POST /certificate
03

Envías el trámite

Una llamada JSON. Nosotros transformamos al XML del SEPE y firmamos con el certificado correcto.

POST /sepe/contrat
04

Recibes la huella

Respuesta sincrónica con success, id y huella oficial. Listo para archivar en tu expediente.

200 OK · huella
Precios

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.

FAQ

Preguntas habituales.

Lo que nos preguntan asesorías y equipos de producto antes de firmar la integración.

¿Qué se puede automatizar con la API?
Todos los trámites del SEPE — Contrat@, Certific@2, llamamientos de fijos discontinuos, copia básica, prórrogas, transformaciones a indefinido y horas complementarias. También consultas como empresas autorizadas. Si te interesan TGSS, DEHU o AEAT, están en el mismo catálogo.
¿Cómo se autentica una petición?
Cabecera Authorization: Bearer {token} más X-Cert-Secret, la clave secreta asociada al certificado digital del cliente. El token y el secreto se rotan desde tu panel.
¿Hay límites de uso?
Por defecto 200 peticiones/minuto por usuario+ruta. Cada respuesta expone X-Ratelimit-Limit y X-Ratelimit-Remaining. Si lo superas, recibes un 429 estructurado. Volúmenes mayores se acuerdan en la propuesta.
¿Hay modo de pruebas?
Sí. Añade el parámetro test=1 a cualquier petición y el trámite se ejecuta contra el sandbox del SEPE — misma respuesta, sin efectos reales. Ideal para CI.
¿Cómo se firman los trámites?
Con el certificado digital del cliente. Lo subes una vez vía el endpoint /certificate, queda cifrado en servidores UE y se usa automáticamente al firmar Contrat@, Certific@2 y similares.
¿Hay SDKs oficiales?
No los necesitas. Es REST puro con JSON, y XML solo donde el SEPE lo exige (te lo transformamos nosotros). Se integra desde cualquier lenguaje vía HTTP.
Empieza

Una sola API.
Todos los trámites del SEPE.

Activamos un sandbox, te enviamos credenciales y la primera llamada sale hoy. La integración real, en cuestión de días.