Movimientos en RED, sin portal
Alta de trabajadores con todos los datos del contrato (tipo, jornada, coeficiente) y baja con causa. El sistema firma con el certificado del cliente y devuelve el justificante de TGSS.
- POST /tgss/altas
- POST /tgss/bajas
API · TGSS · Sistema RED
Una API de tiempo real con la Tesorería.
Altas, bajas, ITs, IDC y vida laboral por HTTP. Construye nóminas, ERPs
y RRHH SaaS contra Sistema RED sin tocar el portal de TGSS. Autenticación
Bearer + certificado del cliente. Modo sandbox con test=1.
Distribuidor autorizado de Saltra
Endpoints TGSS
Todo lo que pasa por el Sistema RED, ahora como HTTP.
Seis verticales para cubrir el día a día de cualquier integración con Tesorería.
Mismas reglas en sandbox y en producción — solo cambia test=1.
Comunicar y consultar ITs
Comunica partes de baja, confirmación y alta. Consulta el estado de cualquier proceso de IT por NAF o por número de parte. Sincroniza con tu módulo de nómina.
- POST /tgss/its/comunicar
- GET /tgss/its/consultar
Informe oficial bajo demanda
Solicita el Informe de Vida Laboral del trabajador o de la empresa. Respuesta firmada por TGSS, lista para adjuntar a contratos, auditorías o trámites.
- GET /tgss/vida-laboral
- GET /tgss/informe-vida-laboral
Informe de Datos de Cotización
Consulta el IDC de cualquier trabajador para detectar discrepancias antes de cerrar la nómina. Modifica condiciones contractuales (jornada, grupo, salario) sin esperar al portal.
- GET /tgss/idc
- POST /tgss/modificaciones
Sistema Especial completo
Altas, bajas y consultas del Sistema Especial de Empleados del Hogar. Ideal para gestorías especializadas y plataformas que digitalizan al sector doméstico.
- POST /tgss/regimen-del-hogar/alta
- POST /tgss/regimen-del-hogar/baja
Convenios, NAF y cuentas
Asigna convenio colectivo, gestiona el NAF y actualiza datos bancarios del trabajador en TGSS. Todo lo que necesitas para que la nómina no se rompa.
- POST /tgss/convenios
- POST /tgss/datos-bancarios
Workflow
De cero a producción en cuatro pasos.
Mismas reglas para todos los integradores: ERPs laborales, asesorías y despachos. Sin SDKs propietarios, sin colas, sin tickets.
- 01
Solicita credenciales
Te damos un Bearer token y subes el certificado digital de tu cliente al endpoint /certificate. Lo administras como cualquier otro recurso.
Authorization: Bearer sk_live_x9q… X-Cert-Secret: •••••••••••• - 02
Prueba en sandbox
Cada llamada acepta el parámetro test=1. Las peticiones llegan a un entorno espejo de TGSS — sin tocar producción y sin riesgo de errores reales.
curl -X POST https://api.saltra.es/tgss/altas?test=1 \ -H "Authorization: Bearer $TOKEN" \ -H "X-Cert-Secret: $SECRET" \ -d @alta.json - 03
Conecta tu producción
Cuando todo cuadra, quitas el flag. La respuesta es estable: success, message y errors. Los headers X-Ratelimit-* te dicen cuántas te quedan.
{ "success": true, "message": "Alta procesada", "errors": [] } - 04
Escala y monitoriza
200 req/min por usuario y ruta. Si los superas, devolvemos 429 con Retry-After. Soporte técnico humano y onboarding con tu equipo, sin permanencia.
HTTP/1.1 200 OK X-Ratelimit-Limit: 200 X-Ratelimit-Remaining: 194
Pricing
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.
Plan a medida
Bajo demanda — depende del volumen mensual.
$ talk / to us
- Empresas ilimitadas en sandbox
- Soporte técnico humano
- Onboarding con tu equipo
- Servidores en la UE
- Cumplimiento RGPD / LOPDGDD
- Sin permanencia
FAQ
Preguntas que siempre nos hacen.
Para preguntas más técnicas, abre la documentación o escribe a hola@saltra.es.
01 ¿Qué trámites de TGSS puedo automatizar?
Altas, bajas, ITs (comunicar y consultar), modificaciones, IDC, vida laboral, convenios, datos bancarios, NAF, Régimen Especial del Hogar y Formulario A1. Y, vía el resto de la API Saltra, también SEPE (Contrat@, Certific@2, llamamientos), DEHU, AEAT y ETTs.
02 ¿Cómo se autentica una petición?
Dos cabeceras: Authorization: Bearer {token} con tu clave de API y X-Cert-Secret con la clave secreta del certificado digital del cliente. El certificado lo subes y administras vía los endpoints /certificate.
03 ¿Cuál es el límite de uso?
Por defecto 200 peticiones por minuto, por usuario y por ruta. Cada respuesta incluye X-Ratelimit-Limit y X-Ratelimit-Remaining; al sobrepasar, devolvemos 429 con Retry-After. Límites específicos se pactan en el contrato.
04 ¿Tenéis modo de pruebas?
Sí. Cualquier endpoint acepta el parámetro test=1 para impactar el entorno sandbox de TGSS — mismas validaciones, sin movimientos reales en Tesorería. Lo usas durante la integración sin pagar tarifa.
05 ¿Dónde se alojan los datos?
Servidores 100% en la Unión Europea. Cumplimiento RGPD y LOPDGDD, contrato de encargado de tratamiento incluido. Los certificados se almacenan cifrados y se firman las peticiones en memoria.
06 ¿Hay SDKs o solo REST?
API REST sobre HTTPS con JSON (y XML cuando lo exige el organismo, como Contrat@). Se integra desde cualquier lenguaje — Node, Python, PHP, .NET, Go, Java — porque solo hablas HTTP.
Construye contra TGSS
Empieza a llamar a la Tesorería esta misma semana.
Pídenos acceso, te damos credenciales en menos de 48 h, integras en sandbox y pasas a producción en cuanto cuadre tu equipo. Sin permanencia, servidores en la UE, soporte humano en castellano.
API live · hola@saltra.es · +34 926 96 66 02