Seguridad Social
Consultas
Datos de la empresa

Datos de la empresa en Sistema RED

⚠️

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

Consulta los datos de una empresa en Sistema RED (transacción AER61) y, opcionalmente, su situación (transacción ACR69: situación del CCC, trabajadores, CNAE, mutua y recaudación). Es una consulta de solo lectura. La empresa se busca por su cif.

Los datos de identificación (identificativos) se devuelven siempre; el resto de bloques se piden con options.

Parámetros

  • test (número (1)) : Para pruebas, añade el parámetro test=1. Para producción se debe omitir. Devuelve datos de ejemplo sin consultar la TGSS.
  • cif (caracteres) : CIF de la empresa (máximo 10 caracteres). Obligatorio.
  • ccc (número entero) : Código de cuenta de cotización (11 dígitos). Obligatorio.
  • regimen (número entero) : Régimen (4 dígitos). Obligatorio.
  • options opcional (arreglo) : Bloques a devolver, además de identificativos (que siempre se incluye). No distingue mayúsculas de minúsculas. Posibles valores:
    • constitucion: añade data.constitucion (constitución e inscripción en el registro mercantil).
    • domicilio: añade data.domicilio.
    • contacto: añade data.contacto (teléfonos y correo).
    • representantes: añade data.representantes (personas vinculadas).
    • cnae: añade data.cnae con los dos primeros dígitos del CNAE vigente. Usa ccc y regimen.
    • situacion: añade data.situacion con la situación completa del CCC (ver más abajo). Usa ccc y regimen. Si options se omite o va vacío se devuelven constitucion, domicilio, contacto y representantes. Si se indica solo cnae y/o situacion, se devuelve identificativos más esos bloques. Pedir cnae y situacion a la vez consulta la situación una sola vez.
GET /enterprise/data
{
    "test": 1,
    "cif": "B00000000",
    "ccc": "28000000001",
    "regimen": "0111",
    "options": [
        "constitucion",
        "domicilio",
        "contacto",
        "representantes",
        "cnae",
        "situacion"
    ]
}

Respuesta OK

Respuesta
{
    "success": true,
    "message": "OK",
    "status": 200,
    "data": {
        "identificativos": {
            "net": "1234567",
            "nif": {
                "tipo": "9",
                "numero": "0B00000000"
            },
            "nacionalidad": {
                "codigo": "724",
                "descripcion": "ESPAÑA"
            },
            "razon_social": "EMPRESA DE PRUEBA SL",
            "forma_juridica": {
                "tipo": "B",
                "tipo_descripcion": "SOCIEDAD DE RESPONSA",
                "subtipo": "001",
                "subtipo_descripcion": "SOCIEDAD DE RESPONSABILI"
            },
            "objeto_social": {
                "codigo": "1",
                "descripcion": "ACTIVID.PROFESIONALES O EMPRESARIALES"
            },
            "fecha_inclusion_bd": "2018-03-01",
            "fecha_inscripcion_ss": "2018-03-08",
            "fecha_inicio_actividad": "2018-03-08",
            "fecha_extincion": null
        },
        "constitucion": {
            "sociedad_regular": "SI",
            "fecha_constitucion": "2018-02-20",
            "fecha_inscripcion_registro": "2018-02-27",
            "tipo_registro": "01",
            "provincia": {
                "codigo": "28",
                "descripcion": "MADRID"
            },
            "registro_mercantil": {
                "numero": "028",
                "tomo": "00123",
                "libro": "",
                "folio": "045",
                "seccion": "",
                "hoja": "123456"
            },
            "anotacion": {
                "codigo": "1",
                "descripcion": "INSCRIPCION"
            },
            "numero_otros_registros": ""
        },
        "domicilio": {
            "tipo_via": "CL",
            "nombre_via": "CALLE DE EJEMPLO",
            "numero": "00001",
            "bis": "",
            "bloque": "",
            "escalera": "",
            "piso": "",
            "puerta": "",
            "codigo_postal": "28001",
            "localidad": {
                "codigo": "28079",
                "descripcion": "MADRID"
            }
        },
        "contacto": [
            {
                "telefono_movil": {
                    "prefijo": "34",
                    "numero": "600000000"
                },
                "email": "CONTACTO@EJEMPLO.ES"
            }
        ],
        "representantes": [
            {
                "identity": "1",
                "nif": "00000000T",
                "nombre": "NOMBRE APELLIDO1 APELLIDO2",
                "fecha_vinculo_desde": "2018-03-08",
                "fecha_vinculo_hasta": null,
                "vin": "001",
                "sit": "VIG"
            }
        ],
        "situacion": {
            "regimen": "0111",
            "ccc": "28000000001",
            "ccc_principal": null,
            "razon_social": "EMPRESA DE PRUEBA SL",
            "net": "1234567",
            "id_empresario": {
                "tipo": "CIF",
                "documento": "B00000000"
            },
            "nss": {
                "provincia": "28",
                "numero": "00000000"
            },
            "ccc_anterior": null,
            "ccc_sucesor": null,
            "situacion": {
                "codigo": "1",
                "descripcion": "ALTA",
                "fecha_situacion": "2018-03-08",
                "fecha_alta_inicial": "2018-03-08"
            },
            "trabajadores": {
                "alta": 5,
                "fecha_alta_primer_trabajador": "2018-03-08",
                "ultima_baja_efecto_cotizacion": null
            },
            "colectivo": {
                "codigo": "000",
                "descripcion": "GENERAL"
            },
            "cnae": {
                "cnae93": "",
                "cnae09": {
                    "codigo": "6201",
                    "descripcion": "ACTIVIDADES DE PROGRAMACION INFORMATICA"
                },
                "cnae25": {
                    "codigo": "",
                    "descripcion": ""
                }
            },
            "cnae_two_digits": "62",
            "ta2": {
                "dias_alta": 5,
                "dias_baja": 0
            },
            "tipos_at_ep_it": {
                "iim": "0,65",
                "ims": "0,35",
                "total": "1,00"
            },
            "mutua": {
                "entidad_at_ep": {
                    "codigo": "151",
                    "nombre": "MUTUA DE PRUEBA",
                    "fecha": "2018-03-08",
                    "mes_vencimiento": "Marzo"
                },
                "mutua_it_cc": {
                    "opcion": "SI",
                    "fecha_opcion": "MAR/2018"
                }
            },
            "recaudacion": {
                "modo_pago": {
                    "codigo": "0",
                    "descripcion": "NORMAL"
                },
                "ingreso_diferido_anticipado": "0 meses",
                "deduccion_diferida_it": "NO AUTORIZADO",
                "pago_directo_it": "NO"
            }
        },
        "cnae": "62"
    }
}

Bloque situacion

  • regimen, ccc, razon_social, net, id_empresario (tipo, documento) y nss (provincia, numero): identificación del CCC consultado.
  • ccc_principal, ccc_anterior y ccc_sucesor: CCC principal de la empresa y CCC anterior / sucesor (provincia, numero, regimen y, en los dos últimos, descripcion). Valen null si no aplican.
  • situacion: codigo, descripcion, fecha_situacion y fecha_alta_inicial (YYYY-MM-DD).
  • trabajadores: alta (número de trabajadores en alta), fecha_alta_primer_trabajador y ultima_baja_efecto_cotizacion.
  • colectivo: codigo y descripcion.
  • cnae: cnae93 y, para cnae09 y cnae25, codigo y descripcion. cnae_two_digits son los dos primeros dígitos del CNAE más reciente disponible.
  • ta2: dias_alta y dias_baja. tipos_at_ep_it: iim, ims y total.
  • mutua: entidad_at_ep (codigo, nombre, fecha, mes_vencimiento) y mutua_it_cc (opcion, fecha_opcion).
  • recaudacion: modo_pago (codigo, descripcion), ingreso_diferido_anticipado, deduccion_diferida_it y pago_directo_it.

mutua y recaudacion proceden de una segunda pantalla de la TGSS (Recaudación). Si la TGSS no la devuelve, la respuesta sigue siendo correcta pero esos dos bloques no aparecen. Igualmente, si la consulta de situación falla, la respuesta incluye los datos de identificación y el resto de bloques pedidos, con success: true y sin situacion ni cnae.

Por compatibilidad, cuando se pide cnae y la TGSS devuelve el CNAE, la respuesta incluye también data.situacion.

Errores

Respuesta status 422 (validación)

Falta alguno de los parámetros obligatorios (cif, ccc, regimen) o tiene un formato no válido (ccc de 11 dígitos, regimen de 4).

Respuesta
{
    "success": false,
    "message": "validation_errors",
    "status": 422,
    "data": [],
    "errors": {
        "ccc": [
            "El campo CCC es obligatorio cuando se pide la opción situacion."
        ],
        "regimen": [
            "El campo régimen es obligatorio cuando se pide la opción situacion."
        ]
    }
}

Respuesta status 404 (empresa no encontrada)

La TGSS no devuelve datos para la empresa indicada. Es una respuesta definitiva: no hace falta reintentar.

Respuesta
{
    "success": false,
    "message": "SISTEMA RED: Datos no encontrados.",
    "status": 404,
    "errors": {
        "tgss": [
            "SISTEMA RED: Datos no encontrados."
        ]
    }
}