Actualizar datos generales

PUT /apientidades/v1/declaraciones/{iddeclaracion}/derecho-acceso/general

Actualiza los datos generales de derecho de acceso: existencia de formulario de solicitud, URL, plazo medio de resolución y aclaraciones.

Parámetros de ruta

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

Body de la petición

{
  "existeFormulario": true,
  "urlFormulario": "https://sede.entidad.es/derecho-acceso",
  "plazoMedioDias": 15,
  "aclaraciones": "Formulario disponible en sede electrónica desde 2023"
}

Campo	Tipo	Obligatorio	Descripción
existeFormulario	bool	Sí	Si la entidad tiene formulario de solicitud de acceso disponible
urlFormulario	string	Condicional	URL del formulario. Obligatoria si existeFormulario es true
plazoMedioDias	int	No	Plazo medio de resolución en días (0–9.999)
aclaraciones	string	No	Texto libre de aclaraciones (máx. 5.000 caracteres)

Ejemplo de petición

curlPythonC#

curl -s -X PUT \
  "https://apientidades-pro.transparenciacanarias.org/apientidades/v1/declaraciones/5001/derecho-acceso/general" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "existeFormulario": true,
    "urlFormulario": "https://sede.entidad.es/derecho-acceso",
    "plazoMedioDias": 15,
    "aclaraciones": "Formulario disponible en sede electrónica desde 2023"
  }' | jq .

import requests

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

payload = {
    "existeFormulario": True,
    "urlFormulario": "https://sede.entidad.es/derecho-acceso",
    "plazoMedioDias": 15,
    "aclaraciones": "Formulario disponible en sede electrónica desde 2023"
}

response = requests.put(
    f"{BASE_URL}/declaraciones/5001/derecho-acceso/general",
    headers=headers,
    json=payload
)
print(response.json())

var payload = new
{
    existeFormulario = true,
    urlFormulario = "https://sede.entidad.es/derecho-acceso",
    plazoMedioDias = 15,
    aclaraciones = "Formulario disponible en sede electrónica desde 2023"
};

var content = new StringContent(
    JsonConvert.SerializeObject(payload),
    Encoding.UTF8,
    "application/json"
);

var response = await client.PutAsync(
    $"{baseUrl}/declaraciones/5001/derecho-acceso/general", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Respuesta exitosa (200)

{
  "message": "Datos generales de derecho de acceso actualizados."
}

Validaciones

Validación	Límite	Error
URL obligatoria con formulario	Si existeFormulario=true, urlFormulario no puede estar vacía	400
Formato URL	Debe empezar por http:// o https://, máx. 750 chars	400
Plazo medio	Entre 0 y 9.999 días	400
Aclaraciones	Máx. 5.000 caracteres	400

URL obligatoria con formulario

Si existeFormulario es true, el campo urlFormulario es obligatorio. Si existeFormulario es false, la URL puede omitirse o enviarse vacía.

Errores posibles

Código	Descripción
400	Validación fallida (ver tabla)
401	Token ausente, expirado o inválido
404	La declaración no existe o no pertenece a la entidad

Estado de la declaración

Solo funciona cuando la declaración está en estado NoPresentada (1) o AlegacionesAbiertas (4).