API · Tesorería General

La forma moderna
de hablar con la TGSS.

Saltra API conecta tu ERP o asesoría con la Tesorería General de la Seguridad Social mediante REST estándar, autenticación con Bearer token y certificado digital. Altas, bajas, IT, vida laboral, IDC y NAF — todo desde tu backend.

Distribuidor autorizado de Saltra

01 Certificado digital FNMT · PFX · cl@ve
02 Bearer + X-Cert-Secret Authorization · headers
03 API Saltra api.saltra.es/v1
04 TGSS Sistema RED
Estándares
  • TGSS
  • Sistema RED
  • Bearer + X-Cert-Secret
  • RGPD
  • Servidores UE
Endpoints

Toda la TGSS en seis verbos REST.

Los trámites que tu equipo hace cada día en Sistema RED, expuestos como endpoints predecibles. Mismas validaciones, mismo folio oficial, sin tener que abrir SILTRA ni escribir XML a mano.

Movimientos

Altas y bajas

Cursa altas, bajas y modificaciones de afiliación en el régimen general en una sola llamada. Validación previa para cazar errores antes de enviar.

POST /tgss/altas
Incapacidades

Incapacidades temporales

Comunica partes de baja, confirmación y alta de IT al INSS. Adjuntos opcionales y respuestas en JSON con el folio oficial.

POST /tgss/its/comunicar
Histórico

Vida laboral

Solicita el informe oficial de vida laboral del trabajador, lo recoges en PDF o XML y lo devuelves a tu cliente desde tu propio panel.

GET /tgss/informe-vida-laboral
Datos

IDC y modificaciones

Consulta el Informe de Datos de Cotización (IDC), modifica datos bancarios, FIE, A1 o contratos sin abrir el navegador de Sistema RED.

POST /tgss/idc
Régimen Especial

Régimen del hogar

Endpoints específicos para Sistema Especial Empleados del Hogar: altas, bajas, jornada y modificaciones, con las validaciones propias del régimen.

POST /tgss/hogar/altas
Identificación

NAF · consulta y asignación

Consulta el Número de Afiliación de la Seguridad Social o solicita uno nuevo cuando aún no exista. Útil para procesos masivos de contratación.

POST /tgss/naf
Cómo funciona

Cuatro pasos para una integración limpia.

Sin VPN. Sin colas FTP. Sin SOAP. La autenticación se hereda del certificado digital del cliente y todo lo demás es REST estándar.

  1. 01

    Solicita acceso

    Cuéntanos volumen estimado, organismos (TGSS, SEPE, DEHU, AEAT) y entornos. Te damos credenciales sandbox en menos de 48 h.

  2. 02

    Sube el certificado

    Carga el certificado digital del cliente vía endpoint /certificate. Queda cifrado en nuestros servidores UE y se usa automáticamente al firmar cada trámite.

    POST /certificate
    Authorization: Bearer …
    Content-Type: multipart/form-data
    
    { file: cert.pfx, password: ••• }
  3. 03

    Autentica cada llamada

    Cabecera Authorization con tu Bearer y X-Cert-Secret con la clave del certificado del cliente. Listo: la API responde como el propio Sistema RED.

    curl https://api.saltra.es/tgss/altas \
      -H "Authorization: Bearer ey…" \
      -H "X-Cert-Secret: ••••" \
      -d @alta.json
  4. 04

    Recibe respuesta verificable

    Toda respuesta sigue el contrato { success, message, errors } y trae el folio oficial de la TGSS. Cabeceras X-Ratelimit-* exponen tu cuota.

    {
      "success": true,
      "message": "Alta cursada",
      "folio": "AFI-2026-…"
    }
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.

Plan a medida Bajo demanda
Desde propuesta cerrada en 48 h
  • Empresas ilimitadas en sandbox
  • Soporte técnico humano
  • Onboarding con tu equipo
  • Servidores en la UE
  • Cumplimiento RGPD / LOPDGDD

Compartimos la misma tecnología que los productos Saltra Registro Horario y Plataforma: equipo, infraestructura y datos en la UE.

Preguntas frecuentes

Lo que pregunta el equipo técnico antes de integrar.

Si te queda alguna duda, escríbenos. Te contestamos un humano, no un bot.

01 ¿Cómo se autentica una petición a la API?

Con dos cabeceras combinadas. Authorization: Bearer {token} identifica tu integración y X-Cert-Secret: {clave} desbloquea el certificado digital del cliente que firmará el trámite ante la TGSS. El certificado se sube previamente vía /certificate y queda cifrado en nuestros servidores UE — nunca circula en el cuerpo de la petición.

02 ¿Qué se puede automatizar con la API?

Todo el espectro laboral: TGSS (altas, bajas, IT, modificaciones, vida laboral, IDC, datos bancarios, FIE, A1, NAF, régimen del hogar), SEPE (Contrat@, Certific@2, llamamientos), DEHU (notificaciones), AEAT (al corriente, IAE) y operaciones de ETT (cesiones).

03 ¿Hay límites de uso?

Sí, por defecto 200 peticiones por minuto por usuario y ruta. Cada respuesta incluye X-Ratelimit-Limit y X-Ratelimit-Remaining para que tu cliente sepa cuándo respirar. Si sobrepasas, recibes un 429 con la cabecera Retry-After.

04 ¿Hay entorno de pruebas?

Sí. Añade test=1 a cualquier petición y trabajas contra el sandbox de la TGSS sin enviar trámites reales. Te damos acceso a sandbox con empresas ilimitadas desde el primer día.

05 ¿Dónde se alojan los datos y certificados?

En servidores dentro de la Unión Europea, cifrados en reposo y en tránsito. Cumplimos RGPD y LOPDGDD. Los certificados digitales se almacenan con cifrado AES-256 y solo se descifran en el momento de firmar la petición.

06 ¿Cuánto cuesta?

Bajo demanda. Cada integración tiene su propio volumen (TGSS, SEPE, DEHU, AEAT) y dimensionamos la propuesta en función de tus llamadas mensuales esperadas. Solicita acceso y enviamos propuesta cerrada en menos de 48 h.

Listos para integrar

Conecta tu producto con la TGSS
en menos de una semana.

Cuéntanos qué necesitas automatizar. Te damos credenciales sandbox y acompañamiento técnico para que tu primer trámite real esté cursado antes de que termine la semana.

teléfono +34 926 96 66 02 email hola@saltra.es horario Lunes - Viernes · 9:00 - 18:00