Entornos y modo prueba
Cómo probar tu integración sin comunicar nada a los organismos, y cómo hacerlo de verdad cuando estés listo.
Entornos
La API tiene dos entornos con los mismos endpoints. Solo cambia el dominio, y con él lo que pasa por defecto:
| Entorno | Por defecto | Para cambiarlo |
|---|---|---|
Producción https://api.saltra.es | Real: se comunica al organismo | X-Saltra-Mode: test → ficticio |
Pruebas https://dev-api.saltra.es | Ficticio: no se comunica nada | X-Saltra-Mode: live → real |
En modo ficticio no se comunica nada al organismo y la respuesta trae datos de ejemplo. La cabecera vale para los trámites con la Seguridad Social (Sistema RED) y el SEPE. DEHU, AEAT y Hacienda de Navarra no tienen modo ficticio: sus peticiones se hacen siempre de verdad, con o sin cabecera.
Valores admitidos: solo test y live. Cualquier otro valor responde 422 sin hacer el trámite.
En el entorno de pruebas, sin la cabecera todo es ficticio. Con X-Saltra-Mode: live el trámite se comunica de verdad al organismo con el certificado del cliente (el de X-Cert-Secret), también desde dev-api.saltra.es: un alta o una baja enviadas así son reales.
Ejemplo
Una baja ficticia en producción: la petición es la misma que la real, con la cabecera X-Saltra-Mode: test.
curl -X POST https://api.saltra.es/api/v4/seg-social/baja \
-H 'Authorization: Bearer *token*' \
-H 'X-Cert-Secret: *secret*' \
-H 'X-Saltra-Mode: test' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{"regimen": "0111", "ccc": 12345678901, "nss": "123456789012", "identificacion": 1, "dni": "12345678A", "situacion": 93, "fecha_real": "2023-11-01"}'Para hacerla real en producción basta con quitar la cabecera (o enviar X-Saltra-Mode: live).
Servidor MCP
En el servidor MCP público (https://api.saltra.es/api/v4/mcp) la cabecera X-Saltra-Mode se configura en la conexión MCP (las cabeceras que tu cliente MCP envía en cada petición), no en los argumentos de cada herramienta. Se aplica a todas las herramientas de esa conexión con la misma tabla; un valor distinto de test o live devuelve un error de la conexión MCP en lugar del 422.