Saltar a contenido

Informes PDF

Los informes son documentos PDF oficiales generados por el Comisionado de Transparencia: justificantes de presentación, informes provisionales e informes definitivos con la calificación final.

Diferencia con documentos

Este endpoint (/declaraciones/{id}/informes) devuelve los informes oficiales generados por el Comisionado. Es distinto de GET /documentos/declaracion/{id}, que lista los documentos de la declaración en general.

Disponibilidad

Los informes solo son accesibles cuando se cumple alguna de estas condiciones:

  • La declaración está en estado Finalizada (6): siempre disponibles.
  • La evaluación está en fase EvaluandoLaDeclaracion (3), EvaluandoLasAlegaciones (5) o Cerrada (6): disponibles independientemente del estado de la declaración.

En cualquier otro caso el endpoint devuelve 400.

Listar informes disponibles

GET /apientidades/v1/declaraciones/{iddeclaracion}/informes

Respuesta exitosa (200)

[
  {
    "id": 14,
    "tipo": 3,
    "tipoDescripcion": "Justificante de presentación de declaración",
    "registro": "DECL-2024-1001",
    "descripcion": "Justificante de presentación",
    "tamanoBytes": 145280,
    "fechaSubida": "2024-03-15T18:42:00Z"
  },
  {
    "id": 27,
    "tipo": 0,
    "tipoDescripcion": "Informe provisional",
    "registro": "EVAL-2024-1001-PROV",
    "descripcion": "Informe provisional de evaluación",
    "tamanoBytes": 512640,
    "fechaSubida": "2024-09-20T10:15:00Z"
  }
]
Campo Tipo Descripción
id int ID del informe. Usar en GET /informes/{id} para descargarlo
tipo int Tipo de documento (ver tabla de tipos)
tipoDescripcion string Descripción legible del tipo
registro string Número de registro oficial
descripcion string Descripción del documento
tamanoBytes int Tamaño del fichero en bytes
fechaSubida datetime Fecha y hora de publicación (UTC)

Tipos de informe

Código Descripción Cuándo aparece
0 Informe provisional Tras la primera revisión del Comisionado
1 Informe definitivo Tras cerrar la evaluación
2 Informe definitivo detallado Junto al informe definitivo
3 Justificante de presentación de declaración Inmediatamente tras presentar
4 Justificante de presentación de alegaciones Inmediatamente tras presentar alegaciones

Si aún no hay informes disponibles para la declaración, la respuesta es un array vacío [].

Descargar informe

GET /apientidades/v1/declaraciones/{iddeclaracion}/informes/{id}

Descarga el fichero PDF del informe indicado.

Parámetro Tipo Descripción
iddeclaracion int ID de la declaración
id int ID del informe (obtenido de GET /informes)

Respuesta exitosa (200)

Content-Type: application/pdf
Content-Disposition: attachment; filename="Informe_provisional_2024.pdf"

El cuerpo de la respuesta es el fichero PDF en binario.

Firma digital

Los informes definitivos incluyen sello electrónico PAdES del Comisionado de Transparencia. Puede verificar la firma con Adobe Acrobat Reader o cualquier validador de firma PDF.

Ejemplo de descarga

curl -s \
  "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/declaraciones/5001/informes/27" \
  -H "Authorization: Bearer $TOKEN" \
  --output "informe_provisional.pdf"

resp = requests.get(
    f"{API_URL}/declaraciones/{id_declaracion}/informes/{id_informe}",
    headers={"Authorization": f"Bearer {token}"}
)

if resp.status_code == 200:
    with open("informe.pdf", "wb") as f:
        f.write(resp.content)
    print("Informe descargado correctamente")

var response = await client.GetAsync($"{baseUrl}/declaraciones/{id}/informes/{idInforme}");
if (response.IsSuccessStatusCode)
{
    var bytes = await response.Content.ReadAsByteArrayAsync();
    await File.WriteAllBytesAsync("informe.pdf", bytes);
}

Errores posibles

Código Tipo Descripción
400 peticion-incorrecta La declaración/evaluación no está en un estado que permita ver informes
401 no-autorizado Token ausente, expirado o inválido
404 recurso-no-encontrado La declaración o el informe no existe, o no pertenece a la entidad

Flujo recomendado

  1. Llame a GET /declaraciones/{id}/informes para obtener la lista de informes disponibles y sus IDs.
  2. Use el id de cada informe para descargarlo con GET /declaraciones/{id}/informes/{id}.