Boletín Claro

Escribe una nota en una de tus entradas: lo que hay que hacer, lo hecho o lo que conviene recordar. Indica 'entrada_id' (de listar_entradas) y 'nota'. Con 'fecha' (AAAA-MM-DD) sale en el calendario y se avisa por email antes; un plazo legal lo calcula la herramienta plazo. Con 'cliente' (modo clientes) queda bajo ese cliente. Es la misma nota que se ve en boletinclaro.es. Requiere iniciar sesión. Coste: 0.

Archiva una entrada del inbox bajo uno o más clientes: es la segunda criba, la decisión de que esa oportunidad es relevante para ese cliente. Indica 'entrada_id' (el 'id' de listar_entradas) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). La entrada pasa al flujo de trabajo de cada cliente y la alerta que la detectó se vincula automáticamente al cliente. Requiere tener el modo clientes activado. Coste: 0.

Borra una de tus alertas de forma PERMANENTE, junto con las entradas que no se hayan archivado (y sus notas y documentos); lo archivado bajo un cliente, con sus notas, se queda, igual que lo que también encontró otra alerta. Indica el 'nombre' de la alerta tal como aparece en listar_mis_alertas. Es IRREVERSIBLE: llama primero con confirmar=false (por defecto) para avisar al usuario de qué se va a borrar, y solo con su visto bueno vuelve a llamar con confirmar=true. Si solo quiere dejar de recibir avisos sin perder el histórico, páusala con editar_alerta (activa=false). Requiere iniciar sesión. Coste: 0.

Borra una nota de una entrada. Indica 'nota_id' (el id que muestra ver_entrada). El borrado es definitivo y solo puedes borrar las notas que escribiste tú; si la nota tenía fecha, deja de aparecer en el calendario y de generar avisos. Requiere iniciar sesión. Coste: 0.

Busca en los boletines oficiales (BOE, DOUE y los diarios oficiales autonómicos y forales) cualquier cosa que NO sea una subvención ni una licitación: normativa, oposiciones, anuncios, nombramientos, edictos, etc. Para subvenciones o licitaciones usa buscar_oportunidades. Devuelve cada resultado con su boletín, fecha, lugar y enlace. Cubre solo los últimos ~180 días: lo publicado antes ya no está (salvo lo que sigue en plazo), así que no sirve para buscar convocatorias o normas de años anteriores. Disponible en todos los planes, también en Gratis. Parámetros: 'boletines' (opcional, acota a códigos de boletín como BOE o BOJA) y 'limite' (1-25, por defecto 10). Coste: 1 crédito.

Busca empresas por nombre (o parte del nombre) y devuelve sus NIF junto al total de dinero público recibido, para poder elegir una y consultar su detalle con perfil_empresa. Úsala cuando el usuario menciona una empresa por su nombre y no por su NIF. Disponible en todos los planes, también en Gratis. Coste: 5 créditos.

Busca subvenciones y licitaciones públicas ABIERTAS que encajen con el perfil de una empresa o autónomo, descritas en lenguaje natural. Es la herramienta estrella para '¿qué ayudas o contratos hay para mí?'. Devuelve cada oportunidad con su importe, plazo, lugar y un enlace a la ficha de Boletín Claro. Disponible en todos los planes, también en Gratis. Parámetros: 'tipo' (subvenciones/licitaciones/ambos), 'zona' (dónde está la empresa) y 'limite' (1-20, por defecto 8). Para que el usuario reciba avisos automáticos de lo nuevo, dirígelo a crear una alerta en boletinclaro.es. Usa solo los datos que devuelve: no completes importes, plazos, fechas ni estados, no digas que algo sigue abierto si su estado no lo dice y cita el enlace a la ficha de cada resultado. Coste: 1 crédito.

Cambia el estado del expediente cuando el usuario lo decida. presentada lleva el registro y la fecha del justificante (o su documento_id); descartada, el motivo, y se borra a los 15 días salvo que se recupere. Primero confirmar=false para enseñarlo; con confirmar=true se aplica. Coste: 0.

Marca que el usuario ha revisado una versión de un documento (encaje.md, un borrador) y la da por buena. Primero confirmar=false para enseñársela; con confirmar=true queda marcada. Coste: 0.

Crea una alerta para que Boletín Claro vigile los boletines oficiales y avise por email de lo nuevo que encaje: subvenciones, licitaciones, oposiciones, normativa o cualquier otro anuncio. Es el paso de la búsqueda puntual a la vigilancia continua. Toma una 'descripcion' en lenguaje natural (tema, sector o actividad, zona e importes si aplican), sin códigos. Las fuentes las propone el sistema por tema y zona y no lee exclusiones de la descripción: para fijarlas usa 'boletines' ('solo BOE y BDNS') y para quitar alguna, 'excluir_boletines' ('sin fondos europeos' → EUFUNDING, TED, DOUE). Los avisos van al email de quien la crea, salvo que 'destinos' diga otros (correos del equipo o de contacto, webhooks, Slack o Teams ya creados). Llama primero con confirmar=false para enseñar el resumen y crea con confirmar=true solo cuando el usuario lo confirme; la respuesta dice cómo ha quedado guardada (boletines, zona, importe, envío e id), que puede diferir del resumen. Coste: 1 crédito; al confirmar, 0.

Quita una entrada del flujo de trabajo de uno o más clientes: es el inverso de asignar_entrada, para deshacer un archivado que no tocaba. Indica 'entrada_id' (el 'id' de la entrada) y 'clientes' (nombre o nombres separados por comas, tal como aparecen en listar_clientes). La entrada pierde el estado que tenía en el flujo de ese cliente; si ya no queda bajo ningún cliente, vuelve al inbox (listar_entradas). Desasignar una entrada que no estaba asignada a ese cliente no es un error. Requiere tener el modo clientes activado. Coste: 0.

Descarta del inbox entradas que no interesan a ningún cliente; no borra nada (se recuperan en boletinclaro.es) y repetirlo no es un error. Indica 'entradas' (ids de listar_entradas, separados por comas) o, en bloque, los filtros de listar_entradas sin ids (p. ej. 'patron'='U.R. SUBASTAS'): confirmar=false muestra qué se descartaría y da un código; con el visto bueno del usuario, repite los filtros con confirmar=true y el código en 'confirmacion' (hasta 200 por llamada; si el inbox cambió, pide otra vista previa). Requiere el modo clientes. Coste: 0.

Devuelve el detalle completo de UNA subvención (BDNS) o licitación (PLACSP) por el enlace de su ficha (el que dan buscar_oportunidades o listar_entradas): organismo, importe, plazo, lugar, tipo y procedimiento, CPV, lotes, concesiones y beneficiarios, o adjudicatarios si ya está adjudicada. Sin enlace, codigo_bdns de una subvención, o nif_organo y expediente de una licitación. Úsala para resumir o comparar sin salir de Boletín Claro. Disponible en todos los planes, también en Gratis. Usa solo los datos que devuelve: no completes importes, plazos, fechas ni estados, no digas que algo sigue abierto si su estado no lo dice y cita el enlace a la ficha de cada resultado. Coste: 5 créditos.

Cambia una de tus alertas, por su 'nombre' actual: lo que vigila ('nueva_descripcion', en lenguaje natural), sus fuentes ('boletines' para fijarlas o 'excluir_boletines' para quitar alguna, por su código), adónde llegan sus avisos ('destinos'), su nombre ('nuevo_nombre'), si avisa ('activa': false la pausa sin borrarla, true la reactiva) y, en modo clientes, a qué clientes nutre ('vincular' o 'desvincular'; asignar_entrada ya vincula la alerta de lo que archiva). Cambiar la descripción, las fuentes o los destinos se enseña antes y después: muéstraselo primero al usuario (confirmar=false) y aplica el cambio solo con confirmar=true; lo demás no necesita confirmación. Requiere iniciar sesión. Coste: 0; aplicar una nueva descripción, 1 crédito.

Lee el expediente de una subvención o licitación que el usuario prepara (lo ve su equipo): estado, lo que falta, pasos, documentos, plazos, importes, lo pedido a terceros e instrucciones para seguir. Con entrada_id (listar_entradas). Sin entrada_id, la ficha del cliente (o la vuestra), sus papeles, lo concedido y presentado y sus expedientes, cada uno con su entrada_id: lo archivado bajo un cliente ya no sale en la bandeja. Para una ficha de buscar_oportunidades, guarda lo primero (guardar_documento, pasos o plazo) con su enlace como entrada_id. No cambia nada. Las notas, con anotar_entrada. Coste: 0.

Crea o cambia un cliente del modo clientes: su descripción (quién es, sector, zona, qué busca), que es el contexto con el que se decide qué entradas le interesan, su NIF y los datos de su ficha (razón social, domicilio, representante, plantilla, facturación…). Mantén la descripción al día: si al triar aprendes algo nuevo de un cliente (ya no le interesa X, ahora busca Y, ha ganado tal contrato), propónle actualizarla; la nueva SUSTITUYE a la anterior, así que parte de la existente. Un nombre que no es de ningún cliente lo crea: primero con confirmar=false para enseñarlo, después con confirmar=true. Con prerrellenar, completa la ficha del Registro Mercantil por su NIF. Sin cliente, guarda la ficha de vuestra entidad. La ficha se lee con expediente sin entrada_id. Coste: 0; prerrellenar, 5 créditos.

Guarda en el expediente un documento en markdown o CSV con el contenido completo (requisitos.md, encaje.md, un borrador), o uno que se queda en local, con donde. de dice de quién es: convocatoria, cliente o expediente. Para cambiar uno, su nombre o documento_id y la version leída. Con documento_id y de=cliente pasa un documento a los papeles del cliente; con documento_id y caduca, anota hasta cuándo vale un papel suyo. Con archivo, la ruta de un archivo del equipo del usuario, da el comando que lo sube; ejecútalo tú en su terminal. Coste: 0.

Guarda el dinero del expediente: lo solicitado u ofertado, lo concedido o adjudicado y el motivo de la diferencia; en una licitación por lotes, uno por lote con su resultado. Sustituye a los anteriores: manda también los que no cambian. Coste: 0.

Lee un documento del expediente por su documento_id (también los PDF y Word subidos; una imagen llega como imagen) o un documento oficial por su enlace, que se guarda una vez en la convocatoria. Si es largo, sigue con desde. Coste: 0; un documento oficial por su enlace, 1 crédito.

Lista tus clientes (modo clientes, para asesorías y gestorías) junto con las alertas que nutren a cada uno: esas alertas describen qué vigila cada cliente, así que son el contexto para decidir a qué cliente pertenece cada entrada del inbox. Úsala para '¿qué clientes tengo?' o antes de asignar entradas. Con más de 5 clientes la lista sale resumida; pasa 'cliente' para ver la ficha completa de uno. Requiere tener el modo clientes activado. Coste: 0.

Devuelve las entradas que encajaron con tus alertas, cada una con su 'id', boletín, fecha, importe, plazo y enlace: '¿qué me ha llegado?' o 'resúmeme la semana'. 'dias' o 'desde' (AAAA-MM-DD) acotan lo nuevo. Sin el modo clientes son tus novedades de los últimos días. En modo clientes es el inbox: lo que aún no has archivado bajo ningún cliente (la primera criba); decide con el contexto de listar_clientes cuáles interesan y a quién (asignar_entrada). Si a un cliente le falta un dato decisivo (municipio, forma jurídica, tamaño, sector), pregúntalo, o búscalo en fuentes públicas y confírmalo con el usuario; antes de dar por buena o descartar una candidata seria, mira su detalle_oportunidad y el documento oficial que enlaza. Filtros del inbox: 'alerta' (nombre), 'cliente_sugerido' (las alertas de ese cliente), 'veredicto' ('encaja' o 'posible'), 'importe_minimo' e 'importe_maximo' (euros; dejan fuera lo que no tiene importe) y 'patron' (texto del título). 'detalle'='minimo' da una línea por entrada y admite hasta 200 por página; 'limite' fija la página (por defecto 25, máximo 60 en detalle completo). Si hay más, pasa el 'cursor' de la respuesta con los mismos filtros. Usa solo los datos que devuelve: no completes importes, plazos, fechas ni estados, no digas que algo sigue abierto si su estado no lo dice y cita el enlace a la ficha de cada resultado. Coste: 0.

Lista tus alertas temáticas y su estado: si están activas, su frecuencia de envío, adónde llegan sus avisos, los boletines que vigilan y si cada uno está al día o pendiente de procesar. Úsala para '¿qué alertas tengo?' o '¿están funcionando mis alertas?'. Coste: 0.

Añade, cambia, reordena o borra los pasos del expediente. anadir: pasos [{titulo, fase, fecha, responsable, propuesto_por_ia, repetir}]; cambiar: paso_id y version, con lo que cambie; reordenar: orden; borrar: paso_id. Las fases: evaluar, preparar, presentar y justificar. Coste: 0.

Los pasos que el espacio guardó de otros expedientes, con sus lecciones, para no empezar de cero: listar, usar (los añade a este expediente), guardar (los de este, generalizados) o borrar, por nombre. Coste: 0.

Crea un enlace para que un tercero (el cliente, su gestoría) suba los documentos que se le piden, y el texto del correo, que el usuario envía desde el suyo: Boletín Claro no escribe al tercero. Lo que suba llega «por revisar». Primero confirmar=false para enseñar el correo; con confirmar=true se crea. Coste: 0.

Devuelve el perfil de dinero público de una empresa (por NIF), cruzando todas las fuentes: subvenciones recibidas (BDNS), licitaciones y contratos públicos GANADOS (PLACSP), proyectos de I+D europeos (CORDIS), contratos UE (TED) y datos mercantiles (BORME), con el total, el número de contratos/concesiones, el periodo y los principales organismos/sectores. Úsala para '¿qué licitaciones o contratos ha ganado X?', '¿qué subvenciones ha recibido X?', '¿cuánto dinero público recibió X?' o due diligence ('háblame de la empresa X'). Da agregados y un enlace a la ficha completa, no el listado contrato a contrato. Si solo tienes el nombre, usa antes buscar_empresa para obtener el NIF. Disponible en todos los planes, también en Gratis. Coste: 5 créditos. Gratis: máximo cinco llamadas al mes por workspace, compartidas con /v1/empresas/{nif}.

Crea un plazo del expediente: fijo, con fecha_fija, o legal, con los hechos en calculo para que Boletín Claro cuente los días con los calendarios oficiales (no los cuentes tú). Primero confirmar=false para enseñar la fecha; con confirmar=true se guarda y avisa por correo antes de que venza. Coste: 0.

Resume lo publicado en un boletín oficial un día concreto: '¿qué ha salido hoy en el BOE?' o '¿qué publicó el BOCM el lunes?'. Devuelve las entradas agrupadas por apartado o tipo (subvenciones, licitaciones, nombramientos, normativa…) con su número y una muestra de títulos, importes y plazos. Parámetros: 'fuente' (código del boletín: BOE, BOCM, BDNS, DOG, BOPV, BOJA…) y 'fecha' (AAAA-MM-DD; vacío = hoy). Es un índice del día; para el detalle de una entrada usa buscar_boletines. Disponible en todos los planes, también en Gratis. Coste: 1 crédito.

Clasifica lo que un tercero subió con el enlace de pedir_documentos, que llega «por revisar»: de=cliente (a sus papeles), de=expediente (se queda en esta solicitud) o de=no_vale (se borra y el enlace lo vuelve a admitir). Coste: 0.

Muestra UNA de tus entradas por su id: lo que ya ves en su página de boletinclaro.es. Devuelve título, boletín, fecha, importe, plazo, lugar y tipo de convocatoria o procedimiento; en qué punto está en tu flujo (en el inbox, archivada bajo qué cliente(s) y con qué estado, o descartada); la alerta que la detectó; sus fechas clave; el IDENTIFICADOR DE ORIGEN (código BDNS o expediente) con la herramienta que sigue desde él (detalle_oportunidad); los datos de su ficha, los enlaces y sus notas, cada una con el id que pide borrar_nota. Con resumen=true añade el resumen que genera Boletín Claro a partir del texto oficial (plazos, beneficiarios, cuantía, cobro…); sin él no se lee. Indica 'entrada_id' (el 'id' de listar_entradas, o el enlace /entradas/… entero) y, opcionalmente, 'cliente' para ver además las notas privadas de ese cliente. Funciona con entradas del inbox, archivadas o descartadas. Requiere iniciar sesión. Usa solo los datos que devuelve: no completes importes, plazos, fechas ni estados, no digas que algo sigue abierto si su estado no lo dice y cita el enlace a la ficha de cada resultado. Coste: 0; con resumen=true, 1 crédito la primera vez que tu espacio ve ese resumen; volver a verlo es gratis.

Crea una vigilancia de una o varias EMPRESAS concretas (competidores, clientes, proveedores) y avisa por email cuando tengan movimientos en el dinero público: contratos, subvenciones o cambios mercantiles. Para vigilar un TEMA (un sector o tipo de ayuda) usa crear_alerta; esta es para empresas con nombre y apellidos. Toma 'empresas' (nombres o NIFs separados por comas; por cada nombre se busca su NIF). IMPORTANTE: llama primero con confirmar=false (por defecto) para mostrar al usuario qué empresas se van a vigilar y pedir su visto bueno; solo cuando lo confirme, vuelve con confirmar=true. Es una función de pago. Requiere iniciar sesión. Coste: 0; por cada nombre que haya que resolver a NIF, 5 créditos. Se mantienen los límites y confirmaciones del plan.