Consultar Datos Bancarios

⚠️

Añade test=1 para realizar pruebas sin efectos reales. En producción, omite este parámetro.

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

test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir.
regimen (número entero) : Régimen, 4 dígitos. Posibles valores:
- 0111: Régimen general
- Tabla con los códigos de régimen (opens in a new tab)
ccc (número entero) : Cuenta de cotización, 11 dígitos.
authorized_num (número entero) : Opcional, 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

{
  "test": 1,
  "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.
- 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" }
        ]
    }
}