Boletín Claro

{'type': 'object', 'required': ['entrada_id', 'nota'], 'properties': {'nota': {'type': 'string', 'description': "Texto de la nota: qué hay que hacer, qué se ha hecho o qué recordar sobre esta oportunidad. Ej: 'Presentada la solicitud, falta el certificado de la Seguridad Social'."}, 'fecha': {'type': 'string', 'description': 'Opcional. Fecha del vencimiento o evento en formato AAAA-MM-DD (ej: 2026-09-15). Si la pones, la nota aparece en el calendario y se avisa por email 7 dÃ\xadas antes y el dÃ\xada antes.'}, 'cliente': {'type': 'string', 'description': 'Opcional (solo modo clientes). Nombre del cliente bajo el que archivar la nota, tal como aparece en listar_clientes. Sin este campo la nota es de la entrada y la ve todo tu espacio de trabajo.'}, 'entrada_id': {'type': 'string', 'description': "Id de la entrada a anotar, tal como aparece en listar_entradas o mis_novedades (campo 'id')."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['entrada_id', 'clientes'], 'properties': {'clientes': {'type': 'string', 'description': "Cliente o clientes bajo los que archivar la entrada, por su nombre y separados por comas (tal como aparecen en listar_clientes). Ej: 'Acme S.L.' o 'Acme S.L., Beta Consulting'."}, 'entrada_id': {'type': 'string', 'description': "Id de la entrada a archivar, tal como aparece en listar_entradas (campo 'id')."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['nombre'], 'properties': {'nombre': {'type': 'string', 'description': 'Nombre de la alerta a borrar, tal como aparece en listar_mis_alertas.'}, 'confirmar': {'type': 'boolean', 'description': 'Déjalo en false (por defecto) para ver primero qué alerta se va a borrar; el borrado es permanente, asÃ\xad que vuelve a llamar con true para confirmarlo.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['nota_id'], 'properties': {'nota_id': {'type': 'string', 'description': "Id de la nota a borrar, tal como aparece en listar_notas (campo 'nota')."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['consulta'], 'properties': {'zona': {'type': 'string', 'description': "Filtra por zona geográfica: nombre de CCAA, provincia o municipio (ej. 'AndalucÃ\xada', 'Bizkaia', 'Getxo'). Incluye también lo de ámbito nacional. Ã\x9asalo SIEMPRE que el usuario mencione un sitio, en vez de escribirlo en la consulta: escrito en 'consulta' no filtra nada."}, 'tipos': {'type': ['null', 'array'], 'items': {'type': 'string'}, 'description': "Opcional: acota a tipos de boletÃ\xadn concretos por su código (ej. 'BOE', 'BOJA', 'DOGC', 'BORME'). VacÃ\xado = busca en todos los boletines oficiales (BOE, BORME y autonómicos)."}, 'limite': {'type': 'integer', 'description': 'Número máximo de resultados (1-25). Por defecto 10.'}, 'consulta': {'type': 'string', 'description': "Qué buscar en los boletines oficiales, en lenguaje natural. Ej: 'oposiciones de auxiliar administrativo', 'subvención de cultura', 'cambios en el reglamento de extranjerÃ\xada'. NO metas aquÃ\xad la zona: para eso está 'zona'."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['nombre'], 'properties': {'nombre': {'type': 'string', 'description': 'Nombre o parte del nombre de la empresa a buscar.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['consulta'], 'properties': {'tipo': {'type': 'string', 'description': "Qué tipo de oportunidad buscar: 'subvenciones', 'licitaciones' o 'ambos'. Por defecto 'ambos'."}, 'zona': {'type': 'string', 'description': "Filtra por zona geográfica: nombre de CCAA, provincia o municipio (ej. 'Burgos', 'PaÃ\xads Vasco', 'Madrid'). Incluye también las de ámbito nacional. VacÃ\xado = sin filtro de zona."}, 'limite': {'type': 'integer', 'description': 'Número máximo de resultados (1-20). Por defecto 8.'}, 'consulta': {'type': 'string', 'description': "Descripción en lenguaje natural de la empresa y lo que busca. Ej: 'empresa de desarrollo de software en Bilbao, 10 empleados, hace apps para administraciones públicas'."}, 'importe_max': {'type': 'number', 'description': 'Opcional: descarta las oportunidades cuyo importe publicado supere esta cifra en euros. Ã\x9asalo cuando el usuario diga que solo puede optar a contratos pequeños (ej. 60000 para una microempresa). Las que no publican importe SÃ\x8d se devuelven: la mayorÃ\xada de subvenciones y muchas licitaciones no lo indican, y descartarlas esconderÃ\xada oportunidades válidas.'}, 'incluir_cerradas': {'type': 'boolean', 'description': "Por defecto la búsqueda solo devuelve oportunidades en plazo (no vencidas). Pon true SOLO si el usuario pide histórico o estudio de mercado de un TEMA o sector (p. ej. '¿qué licitaciones de limpieza de edificios ha habido este año?'), para incluir también las de plazo ya vencido. OJO: esto busca por tema, no por quién ganó; para las licitaciones o subvenciones que ha ganado una EMPRESA concreta usa perfil_empresa."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['descripcion'], 'properties': {'cliente': {'type': 'string', 'description': 'Opcional (modo clientes). Nombre del cliente al que vincular la alerta desde su creación, tal como aparece en listar_clientes; si no lo indicas, la alerta cuelga solo del cliente principal hasta la primera asignación.'}, 'confirmar': {'type': 'boolean', 'description': 'Déjalo en false (por defecto) para ver primero un resumen de la alerta que se va a crear; vuelve a llamar con true para crearla de verdad.'}, 'descripcion': {'type': 'string', 'description': "Descripción en lenguaje natural de lo que quieres vigilar: sector o actividad, zona y, si aplica, importes. Ej: 'subvenciones de digitalización para pymes en Galicia' o 'licitaciones de catering de más de 50.000â\x82¬ en Madrid'."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['nombre'], 'properties': {'nombre': {'type': 'string', 'description': "Nombre del nuevo cliente (empresa u organización). Ej: 'Acme S.L.'."}, 'descripcion': {'type': 'string', 'description': "Opcional. Descripción del cliente: quién es, sector, ubicación, qué busca y en qué estado está. Es el contexto que se usa después para decidir qué entradas le interesan. Ej: 'Constructora de obra civil en Murcia, ~20 empleados; le interesan licitaciones de obra pública de menos de 500kâ\x82¬'."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['entrada_id', 'clientes'], 'properties': {'clientes': {'type': 'string', 'description': "Cliente o clientes de cuyo flujo de trabajo quitar la entrada, por su nombre y separados por comas (tal como aparecen en listar_clientes). Ej: 'Acme S.L.' o 'Acme S.L., Beta Consulting'."}, 'entrada_id': {'type': 'string', 'description': "Id de la entrada a desasignar, tal como aparece en listar_entradas (campo 'id')."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['entradas'], 'properties': {'entradas': {'type': 'string', 'description': "Id o ids de las entradas a descartar, separados por comas, tal como aparecen en listar_entradas (campo 'id'). Ej: 'abc123' o 'abc123, def456'."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['alerta', 'clientes'], 'properties': {'alerta': {'type': 'string', 'description': 'Nombre de la alerta a desvincular, tal como aparece en listar_mis_alertas.'}, 'clientes': {'type': 'string', 'description': "Cliente o clientes de los que desvincular la alerta, por su nombre y separados por comas (tal como aparecen en listar_clientes). Ej: 'Acme S.L.' o 'Acme S.L., Beta Consulting'."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['codigo'], 'properties': {'codigo': {'type': 'string', 'description': 'Código de la convocatoria BDNS. Lo obtienes del enlace /subvencion/{codigo} que devuelve buscar_oportunidades.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'id': {'type': 'string', 'description': "Identificador de la licitación: el último tramo del enlace /licitacion/â\x80¦ que devuelven buscar_oportunidades, mis_novedades o listar_entradas (también puedes pegar el enlace entero). OJO: no es el campo 'id' de la entrada del inbox, que solo sirve para anotar_entrada, asignar_entrada o descartar_entrada. Es la forma recomendada y la que funciona para todas las licitaciones."}, 'expediente': {'type': 'string', 'description': "Alternativa, solo si no tienes el enlace: código de expediente (ContractFolderID), p. ej. '3/2026'. Ã\x9asalo junto a nif_organo."}, 'nif_organo': {'type': 'string', 'description': 'Alternativa, solo si no tienes el enlace: NIF del órgano de contratación. Ã\x9asalo junto a expediente.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['nombre'], 'properties': {'nombre': {'type': 'string', 'description': 'Nombre actual de la alerta a editar, tal como aparece en listar_mis_alertas.'}, 'confirmar': {'type': 'boolean', 'description': 'Necesario (true) para aplicar un cambio de descripción; con false se muestra primero un resumen del nuevo alcance. No hace falta para renombrar.'}, 'nuevo_nombre': {'type': 'string', 'description': 'Opcional. Nuevo nombre para la alerta.'}, 'nueva_descripcion': {'type': 'string', 'description': 'Opcional. Nueva descripción en lenguaje natural de lo que debe vigilar; reemplaza lo que buscaba. Cambiar esto requiere confirmar=true.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['cliente', 'descripcion'], 'properties': {'cliente': {'type': 'string', 'description': 'Nombre del cliente a editar, tal como aparece en listar_clientes.'}, 'descripcion': {'type': 'string', 'description': 'Nueva descripción completa del cliente. SUSTITUYE a la anterior: parte de la existente (listar_clientes), conserva lo que siga siendo válido e incorpora lo nuevo.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': False}

{'type': 'object', 'properties': {'alerta': {'type': 'string', 'description': 'Opcional. Acota el inbox a las entradas de una alerta concreta, por su nombre (tal como aparece en listar_clientes o listar_mis_alertas).'}, 'limite': {'type': 'integer', 'description': 'Número máximo de entradas a devolver (por defecto 25, máximo 60).'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': False}

{'type': 'object', 'required': ['entrada_id'], 'properties': {'cliente': {'type': 'string', 'description': 'Opcional (solo modo clientes). Nombre del cliente cuyas notas privadas quieres ver además de las de la entrada, tal como aparece en listar_clientes.'}, 'entrada_id': {'type': 'string', 'description': "Id de la entrada cuyas notas quieres ver, tal como aparece en listar_entradas o mis_novedades (campo 'id')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'dias': {'type': 'integer', 'description': 'Ventana hacia atrás en dÃ\xadas (por defecto 7, máximo 31).'}, 'limite': {'type': 'integer', 'description': 'Número máximo de novedades a devolver (por defecto 15, máximo 40).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['nombre'], 'properties': {'nombre': {'type': 'string', 'description': 'Nombre de la alerta a pausar, tal como aparece en listar_mis_alertas.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['nif'], 'properties': {'nif': {'type': 'string', 'description': "NIF/CIF de la empresa, ej. 'A28017895'. Si no lo conoces, usa antes buscar_empresa para obtenerlo a partir del nombre."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['nombre'], 'properties': {'nombre': {'type': 'string', 'description': 'Nombre de la alerta a reactivar, tal como aparece en listar_mis_alertas.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['fuente'], 'properties': {'fecha': {'type': 'string', 'description': 'Fecha en formato AAAA-MM-DD. Si lo dejas vacÃ\xado, se usa el dÃ\xada de hoy.'}, 'fuente': {'type': 'string', 'description': 'Código del boletÃ\xadn a resumir: BOE, BOCM, BDNS, DOG, BOPV, BOJAâ\x80¦ tal como aparece en los enlaces.'}}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': False}

{'type': 'object', 'required': ['entrada_id'], 'properties': {'cliente': {'type': 'string', 'description': 'Opcional (solo modo clientes). Nombre del cliente cuyas notas privadas quieres ver además de las de la entrada, tal como aparece en listar_clientes.'}, 'entrada_id': {'type': 'string', 'description': "Id de la entrada a ver, tal como aparece en listar_entradas o mis_novedades (campo 'id'), o el enlace /entradas/{id} de boletinclaro.es (puedes pegarlo entero)."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['empresas'], 'properties': {'empresas': {'type': 'string', 'description': "Empresa(s) a vigilar, separadas por comas: nombres (ej. 'Telefónica, Acme S.L.') o NIFs (ej. 'A82018474'). Por cada nombre se busca su NIF."}, 'confirmar': {'type': 'boolean', 'description': 'Déjalo en false (por defecto) para ver primero qué empresas se van a vigilar; vuelve a llamar con true para crear la vigilancia.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['alerta', 'clientes'], 'properties': {'alerta': {'type': 'string', 'description': 'Nombre de la alerta a vincular, tal como aparece en listar_mis_alertas.'}, 'clientes': {'type': 'string', 'description': "Cliente o clientes a los que vincular la alerta, por su nombre y separados por comas (tal como aparecen en listar_clientes). Ej: 'Acme S.L.' o 'Acme S.L., Beta Consulting'."}}, 'additionalProperties': False}