# API Servicio Empleo · 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.

- **Tipo:** API REST · JSON
- **Sandbox:** añade `test=1` a cualquier petición
- **Infraestructura:** servidores en la UE · RGPD / LOPDGDD
- **Distribuidor:** distribuidor autorizado y Partner de [Saltra](https://saltra.es)
- **Documentación técnica:** https://docs.saltra.es/
- **Solicitar acceso:** https://saltra.es/api-page
- **Crear cuenta:** https://app.saltra.es/general/subscription-register
- **Contacto:** hola@saltra.es · +34 926 96 66 02

Usada por equipos de asesorías, despachos, ERPs, software de nóminas y cooperativas de profesionales.

## ¿Qué es Saltra?

**La API que conecta tu software con la Seguridad Social y el SEPE.** Saltra es la plataforma cloud de gestión laboral que integra, mediante una única API REST, los trámites con los organismos públicos españoles. Sin SILTRA, sin certificados manuales y sin pelearte con las webs de la Administración: automatizas altas, contratos y prestaciones desde tu propio sistema.

- **Saltra · API REST — Un único punto de integración.** Autenticación por token y certificado, entorno sandbox, control de rate-limit y respuestas JSON consistentes. Conecta tu ERP, software de nóminas o aplicación en horas.
- **TGSS · Sistema RED — Tesorería General de la Seguridad Social.** El organismo que gestiona la afiliación. A través del Sistema RED tramitamos altas, bajas y variaciones, vida laboral, IDC, NAF y datos bancarios de cualquier régimen.
- **SEPE — Servicio Público de Empleo Estatal.** El organismo que gestiona contratación y prestaciones. Comunicamos contratos por Contrat@, copia básica, Certific@2, llamamientos, prórrogas y transformaciones a indefinido.

## 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.

| Trámite | Endpoint (base `https://api.saltra.es/api/v4`) | Qué hace |
| --- | --- | --- |
| Contrat@ por XML/JSON | `POST /sepe/contrata` | Envía cualquier modalidad contractual al SEPE. Tú pasas un JSON cómodo, Saltra genera el XML oficial y devuelve huella + acuse en PDF. |
| Certific@2 sin formularios | `POST /sepe/certifica` | Comunicación de finiquito y motivos de cese 100 % automatizada. |
| Llamamientos a fijos discontinuos | `POST /sepe/llamamientos` | Llama, suspende o cesa fijos discontinuos en una sola petición. Diseñado para campañas estacionales (agro, hostelería, retail). |
| Prórroga + transformación | `POST /sepe/prorroga` · `POST /sepe/contrata/transformation/xml` | Prorroga un contrato temporal o transfórmalo a indefinido sin volver a entrar en la sede del SEPE. |
| Copia básica | `POST /sepe/copy-basic` | Genera la copia básica del contrato lista para entregar a la representación legal de los trabajadores, firmada y conservada con su huella. |
| Consulta de empresas autorizadas | `GET /sepe/authorization-management/enterprises` | Verifica en tiempo real qué empresas figuran como autorizadas en el SEPE. |

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

## Cómo funciona: del token a la huella del SEPE en cuatro pasos

1. **Solicita tus credenciales.** Una llamada de 15 min con tu equipo IT. Recibes un token de sandbox y otro de producción por email.
2. **Configura tu certificado.** Sube el certificado digital del cliente desde el panel o vía `POST /certificate` (`file` P12/PFX, `password`, `type=2` para SEPE). Cada llamada incluye la clave secreta en la cabecera `X-Cert-Secret`.
3. **Llama a la API REST.** Una sola URL base y una respuesta consistente `{ success, message, errors }`. Modo prueba con `test=1` mientras integras.
4. **Recibe la huella y archivos.** El SEPE devuelve la huella oficial y el acuse en PDF (base64). Queda guardado en tu cuenta y se entrega en la respuesta.

```bash
curl -X POST "https://api.saltra.es/api/v4/sepe/contrata?test=1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Cert-Secret: $CERT_SECRET" \
  -H "Content-Type: application/json" \
  -d @contrato.json
```

```json
{
  "success": true,
  "huella": "3F9A-CBD2-4A18-...-8C21",
  "acuse": "data:application/pdf;base64,JVBERi0..."
}
```

## Precio: bajo demanda

Cada integración tiene su propio volumen. Saltra habla con tu equipo, dimensiona las llamadas (TGSS, SEPE, DEHU, AEAT) y envía una propuesta cerrada en menos de 48 horas. Sin paquetes ni tramos artificiales.

- Empresas ilimitadas en sandbox
- Soporte técnico humano
- Onboarding con tu equipo
- Servidores en la UE · cumplimiento RGPD / LOPDGDD
- Sin permanencia

## Preguntas frecuentes

**¿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.

**¿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 se sube una sola vez al panel o vía endpoint `/certificate` y nunca circula por la red en cada llamada.

**¿Hay límites de uso?**
Sí, por certificado (o usuario) y por ruta: 80 peticiones/min en consultas (`GET`) y 120/min en escrituras (`POST`). En cada respuesta verás las cabeceras `X-Ratelimit-Limit`, `X-Ratelimit-Remaining` y `X-Ratelimit-Reset`. Si te sobrepasas, recibes un `429` con `Retry-After` y simplemente reintentas.

**¿Puedo probar antes sin afectar al SEPE?**
Sí. Añade `test=1` a cualquier petición y entras en modo sandbox: se valida la estructura, se generan respuestas realistas y no se envía nada al organismo.

**¿Dónde se guardan los datos?**
En servidores dentro de la Unión Europea, con cifrado en tránsito y en reposo. Cumplimiento RGPD y LOPDGDD. Las huellas, acuses y archivos quedan asociados a tu cuenta.

**¿Cuánto cuesta?**
El precio es bajo demanda y depende del volumen mensual de llamadas. Propuesta cerrada en menos de 48 horas. Sin permanencia.

## 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.

- Solicitar acceso: https://saltra.es/api-page
- Ver documentación: https://docs.saltra.es/
- Teléfono: +34 926 96 66 02 · Email: hola@saltra.es

## Recursos para agentes

- Catálogo de APIs (RFC 9727): https://apiservicioempleo.es/.well-known/api-catalog
- Manifiesto ARD: https://apiservicioempleo.es/.well-known/ai-catalog.json
- Agent Skills: https://apiservicioempleo.es/.well-known/agent-skills/index.json
- MCP Server Card: https://apiservicioempleo.es/.well-known/mcp/server-card.json
- Autenticación para agentes: https://apiservicioempleo.es/auth.md
- Servidor MCP público: https://api.saltra.es/api/v4/mcp (OAuth 2.1 · scope `mcp:use`)

---

API Servicio Empleo es una marca de Saltra Aplicaciones, S.L. · Camino de Ciudad Real, 8 · 13680 Fuente el Fresno (Ciudad Real) · [Aviso legal](https://saltra.es/aviso-legal) · [Privacidad](https://saltra.es/politica-de-privacidad)