Saltar a contenido

Estado de una declaración

GET /apientidades/v1/declaraciones/{iddeclaracion}

Devuelve el estado actual de una declaración concreta. Permite verificar en qué fase se encuentra la declaración antes de realizar operaciones sobre ella.

Parámetros de ruta

Parámetro Tipo Descripción
iddeclaracion int ID de la declaración

Ejemplo de petición

curl -s "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/declaraciones/5001" \
  -H "Authorization: Bearer $TOKEN" | jq .

import requests

BASE_URL = "https://apientidades-pro.transparenciacanarias.org/apientidades/v1"
headers = {"Authorization": f"Bearer {token}"}

response = requests.get(f"{BASE_URL}/declaraciones/5001", headers=headers)
declaracion = response.json()

print(f"Estado: {declaracion['estado']} ({declaracion['estadoCodigo']})")
print(f"Puntuación: {declaracion['ultimaPuntuacion']}")

var response = await client.GetAsync($"{baseUrl}/declaraciones/5001");
var json = await response.Content.ReadAsStringAsync();
var declaracion = JsonConvert.DeserializeObject<DeclaracionEstado>(json);

Console.WriteLine($"Estado: {declaracion.Estado} ({declaracion.EstadoCodigo})");

Respuesta exitosa (200)

{
  "declaracionId": 5001,
  "evaluacionId": 10,
  "evaluacion": "",
  "estado": "NoPresentada",
  "estadoCodigo": 1,
  "ultimaPuntuacion": 0
}

Campos de la respuesta

Campo Tipo Descripción
declaracionId int Identificador de la declaración
evaluacionId int Identificador de la evaluación a la que pertenece
evaluacion string Título de la evaluación (puede estar vacío)
estado string Estado descriptivo de la declaración
estadoCodigo int Código numérico del estado (0-6)
ultimaPuntuacion decimal Última puntuación obtenida (0 si no hay calificación aún)

Tabla de estados

Código Estado Permite escritura
0 SinAbrir No (solo inicializar)
1 NoPresentada Sí
2 PendienteRevision No
3 Revisada No
4 AlegacionesAbiertas Sí (alegaciones)
5 PendienteRevisionAlegaciones No
6 Finalizada No

Verificar antes de escribir

Antes de enviar datos (PA, cuestionarios, DA), verifique que la declaración está en un estado que permite escritura. Si intenta escribir en un estado no permitido, la API devolverá un error 400.

Errores posibles

Código Descripción
401 Token ausente, expirado o inválido
404 La declaración no existe o no pertenece a la entidad autenticada

Seguridad

Solo puede consultar declaraciones de la entidad autenticada. Si intenta acceder a una declaración de otra entidad, recibirá un error 404 (no 403) para no revelar la existencia del recurso.