Changelog
Qué cambió en el catálogo y qué garantiza que construir encima sea seguro.
Esta página registra los cambios visibles del catálogo y de la plataforma. Antes de la lista, la garantía que gobierna todos los cambios.
La garantía de estabilidad
Los ids de tool son estables para siempre. sii.rcv.consultar significa hoy lo que va a significar en cinco años, y el código que escribas contra un id publicado no se rompe con un deploy nuestro.
- Un cambio incompatible nunca muta la tool publicada: se acuña un id nuevo y se bumpea
version(un entero monotónico que viaja en la ficha de cada tool). - Un cambio aditivo (un campo nuevo en la salida, un parámetro opcional) conserva el id y bumpea
version. Tu código existente sigue corriendo igual. deprecated: trueen la ficha significa que la tool sigue funcionando pero tiene sucesora: migra con calma, sin fecha límite sorpresa.
La excepción es una y estrecha: retirar una tool y reutilizar su id para otra de distinta clase se permite solo cuando la bitácora confirma que ese id no tenía consumidores reales, y el cambio queda argumentado por escrito. Ha ocurrido una vez, y está en la tabla de abajo marcada como el único «Sí» de la columna «¿Rompe?».
Cambios
| Fecha | Qué cambió | ¿Rompe? | Docs |
|---|---|---|---|
| 2026-08-16 | Los dos documentos de descubrimiento OAuth (/.well-known/oauth-authorization-server y /.well-known/oauth-protected-resource) dejan de publicar scopes_supported: ["*"] y pasan a listar los permisos reales del catálogo. Los consentimientos ya otorgados no cambian: el próximo consentimiento que un cliente pida recibe la autoridad que permite el rol de quien aprueba. El documento deja de sugerir el comodín; un owner o admin lo puede seguir otorgando, explícito o por omisión, igual que antes. | No | Autenticación |
| 2026-08-06 | La superficie MCP anuncia solo las dos meta-tools: tools/list devuelve search_docs y execute, con cualquier catálogo y cualquier organización. Los nombres nativos (sii__rcv__consultar) siguen despachando por tools/call como puerta de compatibilidad no anunciada. | No | El servidor MCP |
| 2026-08-06 | indicadores.valor.actual y indicadores.valor.consultar pasan a versión 2: la primera suma antiguedadDias (0 = el valor es de hoy, positivo = atrasado, negativo = fechado en el futuro) y la segunda suma fechaSolicitada y esArrastre. Campos nuevos en la salida, ids intactos. | No | indicadores.valor.actual |
| 2026-07-31 | Las tools de consulta de bci_pyme y banco_security dejan de abrir sesión en vivo contra el banco: ahora leen el plano ya sincronizado, igual que las del SII y BICE. Mismos ids re-acuñados para otra clase de tool, con bump de version; la bitácora confirmó cero consumidores del contrato anterior antes de re-acuñarlos. | Sí | Sincronizar y consultar |
| 2026-07-30 | SII: nuevo alcance boletas_honorarios (boletas de honorarios electrónicas, emitidas y recibidas) y la tool sii.boletas_honorarios.consultar. | No | sii.boletas_honorarios.consultar |
| 2026-07-30 | Nuevo conector conexiones: sistemas.listar, enlace.crear y estado.consultar. Un agente puede acuñar el enlace para conectar un sistema y consultar su estado sin salir de MCP. | No | Conectar un sistema |
| 2026-07-28 | SII: nuevo alcance guias (guías de despacho, DTE 52) y la tool sii.guias.consultar. El SII solo retiene el detalle de los últimos 6 meses, así que la historia se construye sincronizando de forma continua, no con un backfill. | No | sii.guias.consultar |
Cómo enterarse
Esta página y el índice /llms.txt reflejan el estado vigente; la referencia por tool y los contratos OpenAPI se regeneran con cada deploy desde el mismo registro que sirve las llamadas, así que no pueden quedarse atrás. Si automatizas contra Connect, GET /v1/tools te da la version y el flag deprecated de cada tool en runtime, sin esperar a que alguien lea una página.
Consultar RCV del SII POST
Lee el Registro de Compra-Venta ya sincronizado para esta conexión, filtrable por período, perspectiva, tipo de documento (tipoDte) y estado del registro. Lectura pura: NO dispara una sincronización nueva ni contacta al SII. Si el período nunca se sincronizó, devuelve una lista vacía y 'sincronizacion: null'. Para traer datos nuevos, use 'sii.conexion.sincronizar' primero. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null, hay más filas. reenvía ese valor tal cual en 'cursor' para pedir la página siguiente; nunca lo construyas a mano.
Política de privacidad
Qué datos trata Emisso Connect, cómo los protege, con quién los comparte y cómo se eliminan.