Skip to Content

Consultar Datos Bancarios

Para probar sin efectos reales, envía la cabecera X-Saltra-Mode: test: no se comunica nada al organismo y la respuesta trae datos de ejemplo. En producción, sin la cabecera, el trámite es real. Detalle en Entornos y modo prueba.

Devuelve los datos bancarios que la TGSS tiene comunicados para una cuenta de cotización (servicio SLD «Comunicación de datos bancarios» del Sistema RED) y el titular de cada cuenta: la cuenta para el saldo acreedor y la de cargo en cuenta. Solo consulta: no modifica nada. Para cambiarlos, usa Comunicar Datos Bancarios.

Parámetros

  • regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
  • ccc (número entero) : Cuenta de cotización, 11 dígitos.
  • authorized_num opcional (número entero) : Número de autorizado RED. Es obligatorio cuando el certificado tiene más de un autorizado RED; si no lo conoces, envía la petición sin él y captura data.authorized_list de la respuesta 422. Luego, reenvíala con él.
GET /datos-bancarios
{ "regimen": "0111", "ccc": "28123456789" }

Respuesta OK

  • saldo_acreedor / cargo_en_cuenta (objeto o null) : Cada cuenta ya normalizada. null si la cuenta de cotización no la tiene comunicada; al menos una de las dos viene siempre (si no tiene ninguna, la respuesta es un 404).
    • iban (caracteres) : IBAN completo (24 caracteres).
    • pais_dc, entidad, sucursal, dc, cuenta (caracteres) : Las partes del IBAN por separado.
    • titular (objeto) : Titular de la cuenta.
      • tipo (caracteres) : Tipo de documento (1 DNI, 2 Pasaporte, 3 Tarjeta de Residente Comunitario, 4 Permiso de Residencia y Trabajo, 6 NIE, 9 Sin documento / NIF persona jurídica, L, M, T).
      • identificacion (caracteres) : Documento del titular, tal como lo devuelve la TGSS.
      • nombre (caracteres) : Nombre o razón social del titular.
  • datos_bancarios (objeto) : La pantalla de la TGSS completa, con sus nombres de campo originales (razón social del autorizado y de la empresa, tablas CrtrTbSaldoAcreedor y CrtrTbCargoEnCuenta, indicadores S/N…).
Respuesta
{ "success": true, "message": "", "status": 200, "data": { "saldo_acreedor": { "iban": "ES9121000418450200051332", "pais_dc": "ES91", "entidad": "2100", "sucursal": "0418", "dc": "45", "cuenta": "0200051332", "titular": { "tipo": "9", "identificacion": "0B12345678", "nombre": "EMPRESA DE PRUEBA SL" } }, "cargo_en_cuenta": { "iban": "ES9121000418450200051332", "pais_dc": "ES91", "entidad": "2100", "sucursal": "0418", "dc": "45", "cuenta": "0200051332", "titular": { "tipo": "9", "identificacion": "0B12345678", "nombre": "EMPRESA DE PRUEBA SL" } }, "datos_bancarios": { "nombreAutorizado": "AUTORIZADO DE PRUEBA", "razonSocialAut": "DESPACHO DE PRUEBA SL", "razonSocialEmp": "EMPRESA DE PRUEBA SL", "ipfEmp": "90B123456780100", "CrtrTbSaldoAcreedor": { "codPaisDcAcreedor": "ES91", "codSucursalAcreedor": "0418", "codEntidadAcreedor": "2100", "digControlCuentaAcreedor": "45", "numCuentaAcreedor": "0200051332", "tipoAcreedor": "9", "titularCuentaAcreedor": "0B12345678", "nombreTitularAcreedor": "EMPRESA DE PRUEBA SL" }, "CrtrTbCargoEnCuenta": { "codPaisDcCargoEnCuenta": "ES91", "codSucursalCargoEnCuenta": "0418", "codEntidadCargoEnCuenta": "2100", "digControlCuentaCargoEnCuenta": "45", "numCuentaCargoEnCuenta": "0200051332", "tipoCargoEnCuenta": "9", "titularCuentaCargoEnCuenta": "0B12345678", "nombreTitularCargoEnCuenta": "EMPRESA DE PRUEBA SL" }, "indicadorSaldoAcreedor": "S", "indicadorCargoCuenta": "S" } } }

Respuesta status 422 (varios autorizados)

Respuesta
{ "success": false, "message": "Es obligatorio introducir el autorizado {authorized_num}", "status": 422, "data": { "authorized_list": [ { "numero": "1020", "razSoc": "EMPRESA SL" }, { "numero": "1021", "razSoc": "OTRA EMPRESA SL" } ] } }

Respuesta status 404 (sin datos bancarios)

La cuenta de cotización no tiene comunicada ni la cuenta de saldo acreedor ni la de cargo en cuenta. Es una respuesta definitiva, no un fallo de la TGSS: no la reintentes.

Respuesta
{ "success": false, "message": "SISTEMA RED: No hay datos bancarios comunicados para esta cuenta de cotización.", "status": 404, "data": [], "errors": { "tgss": [ "SISTEMA RED: No hay datos bancarios comunicados para esta cuenta de cotización." ] } }
Actualizado el