Informe de trabajadores con altas en una cuenta de cotización (C.C.C.) [ITA]

Parámetros

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.
format (texto, opcional) : Formato de la respuesta. Posibles valores:
- pdf (por defecto): el informe PDF original de TGSS.
- json: el informe parseado como datos estructurados.
- excel: el informe convertido a un fichero Excel (.xlsx).

GET /informe-ita

{
  "regimen": "0111",
  "ccc": "12345678901",
  "format": "pdf"
}

Respuesta

Con format=pdf (por defecto):

Respuesta (format=pdf)

{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/pdf",
      "name": "document.pdf",
      "content": "base64"
    }
  }
}

Con format=excel cambia el fichero devuelto:

Respuesta (format=excel)

{
  "success": true,
  "message": "OK",
  "data": {
    "file": {
      "contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
      "name": "ITA_Report.xlsx",
      "content": "base64"
    }
  }
}

Con format=json se devuelve el informe parseado en data.list: un elemento por cuenta de cotización, con los datos de empresa y el listado de trabajadores en alta.

Respuesta (format=json)

{
  "success": true,
  "message": "OK",
  "data": {
    "list": [
      {
        "razonSocial": "EMPRESA S.L.",
        "regime": "0111",
        "ccc": "12345678901",
        "employees": [
          {
            "name": "NOMBRE",
            "surname": "APELLIDOS",
            "nss": "123456789012",
            "startDate": "2026-01-15",
            "contractType": "100"
          }
        ]
      }
    ]
  }
}

ℹ️ El parámetro option=excel se mantiene por compatibilidad como alias de format=excel.