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. - La excepción son las tools que emiten ante el SII con
Idempotency-Key(sii.dte.emitir,sii.anulacion.emitir,sii.boleta.emitir): ahíversiontambién identifica la operación en curso, entre la vista previa, la emisión y sus reintentos. Bumpearla por un campo opcional nuevo en la salida invalidaría las vistas previas vigentes y los reintentos de emisiones ya hechas, así que esos campos llegan con la mismaversiony quedan anotados en esta tabla. 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 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, con las tools bancarias. La tabla de abajo tiene un segundo «Sí» de otra naturaleza: el paso de folio a texto conservó los ids y sí tenía consumidores; se decidió con el dato a la vista, porque la alternativa era un sync que no persistía nada, y el cliente afectado recibió aviso directo. El 2026-09-27 se sumó una tercera de la misma clase: los totales del mes que salieron de sii.rcv.consultar. El mismo día, sii.rcv_totales.consultar (v2) cambió el valor de sumable en los pagos con tarjeta, cuando todavía no tenía consumidores fuera de Emisso. Son las cuatro filas marcadas como «Sí» en la columna «¿Rompe?».
Cambios
| Fecha | Qué cambió | ¿Rompe? | Docs |
|---|---|---|---|
| 2026-10-06 | Nueva herramienta sii.dte.descargar: el PDF oficial de una factura 33 o 34, guía de despacho 52 o nota 56 o 61 emitida con el Facturador Gratuito del SII, por tipo, folio y fecha de emisión, en base64 con su SHA-256. Sirve para lo emitido por Connect y para lo emitido directo en el portal. Requiere el permiso sii:write. | No | Descargar el PDF |
| 2026-10-06 | La guía de despacho 52 exige el transporte completo cuando lo mandas: transportistaRut, patente, choferRut y choferNombre juntos, como el formulario del portal del SII. Antes aceptaba datos sueltos que el portal no deja armar. Una guía sin transporte se arma igual que antes. La version de las dos tools no cambia. | Sí, si mandabas transporte incompleto | Guía de despacho 52 |
| 2026-10-06 | La guía de despacho 52 admite receptor.contacto, hasta 80 caracteres. Además aplica las reglas de largo del formulario del portal: descripcion de hasta 999 caracteres sin palabras de más de 30, y una guía que cabe en una página impresa (17 renglones entre líneas, descripciones y referencias). Lo que el portal no deja armar, la vista previa lo rechaza antes de ir al SII. La version de las dos tools no cambia. | No | Guía de despacho 52 |
| 2026-10-06 | La guía de despacho 52 de sii.dte.previsualizar y sii.dte.emitir admite de una a diez líneas con unidad, codigo (tipo y valor) y descripcion opcionales, hasta tres referencias, solicitanteRut y transporte (transportistaRut, patente, choferRut y choferNombre). Todo es opcional: una guía de una línea sin extras se arma igual que antes. La version de las dos tools no cambia. | No | Guía de despacho 52 |
| 2026-10-06 | sii.dte.previsualizar y sii.dte.emitir admiten la guía de despacho 52 con sus nueve motivos de traslado: además de constituye_venta, motivoTraslado acepta ventas_por_efectuar, consignacion, entrega_gratuita, traslado_interno, otro_traslado_no_venta, devolucion, traslado_exportacion_no_venta y venta_exportacion. Cada motivo es su propia variante (52:<motivo>) en la salida. La forma del candidato y la version de las dos tools no cambian. | No | Guía de despacho 52 |
| 2026-10-05 | sii.dte.emitir ya no deja para siempre como resultado_desconocido una factura que no se emitió. La reconciliación la cierra como rechazado con codigo sii_emission_not_sent cuando el intento se cortó antes del envío, y con sii_emission_not_in_rcv cuando se envió, el portal no la lista y una sincronización completa del RCV de ese mes, hecha al menos 12 horas después, no tiene el folio. La salida ya admitía rechazado; la version no cambia. | No | Resultados de emisión |
| 2026-10-05 | conexiones.estado.consultar (v4) agrega tiposDte a cada conexión: qué tipos de documento (33, 34, 52, 56, 61) le permite emitir el SII a la persona de esa conexión en esa empresa, cuáles le rechazó y cuándo se comprobó. El SII lo decide por persona y por empresa, y su menú muestra todos los tipos aunque no estén autorizados, así que Connect lo comprueba al activar la emisión abriendo cada formulario con el mismo login. Vale mientras no cambie la credencial; antes de la primera comprobación, y después de cambiarla, vale null. Previsualizar o emitir un tipo rechazado responde el nuevo error sii_dte_type_not_authorized sin entrar al SII. Si el SII rechaza un tipo que no se había comprobado, la vista previa responde el mismo error. Antes llegaba como un error del conector. Las conexiones que ya emitían lo comprueban desde el panel, con «Volver a comprobar en el SII». | No | conexiones.estado.consultar |
| 2026-10-04 | Nueva herramienta tgr.convenios_detalle.consultar: el detalle de cada convenio de pago con la Tesorería. Trae cada cuota con su vencimiento, monto y si está pagada, la próxima cuota por pagar, cuántas van pagadas, el total del convenio, la cuota contado y las deudas acogidas con su condonación. tgr.conexion.sincronizar lo lee en la misma sesión, desde el enlace de cada fila; las conexiones existentes lo tienen desde su sincronización siguiente, y hasta entonces la herramienta responde vacía con pantallaLeidaEn en null. La cuota de ajuste sale con monto: null mientras la Tesorería no la liquida. Las otras tres consultas de tgr no cambian. | No | Tesorería |
| 2026-10-02 | sii.dte.emitir y sii.anulacion.emitir devuelven xmlFirmado en el resultado emitido/emitida: el XML que Connect firmó y el SII aceptó, con su timbre (TED), para generar la representación impresa y el PDF417 sin otra llamada. Repetir la emisión con la misma clave lo devuelve. Nueva herramienta sii.dte_xml.consultar: entrega ese XML después, por el operacionId de la emisión, desde lo que Connect guardó al emitir, sin consultar al SII; sirve también para documentos emitidos antes de este cambio. Nuevo error sii_emission_not_found. Campo opcional nuevo con el mismo id y la misma version (ver la excepción de arriba). | No | Facturas 33 y 34 |
| 2026-10-02 | sii.boleta.emitir devuelve resultado.pdfUrl, el enlace oficial de E-Boleta al PDF de la boleta (el mismo de «Ver PDF» en eboleta.sii.cl), para imprimir sin llamar a sii.boleta.descargar. Repetir la emisión con la misma clave lo devuelve. sii.boleta.descargar (v2) también entrega pdfUrl y deja de fallar con upstream_unexpected_response justo después de emitir: una boleta recién emitida dejaba el listado de E-Boleta con una forma que Connect rechazaba entera. Previsualizar y emitir hacen menos consultas al SII y responden antes. Campos nuevos, mismos ids; sii.boleta.emitir conserva su version (ver la excepción de arriba). | No | Boletas 39 y 41 |
| 2026-10-02 | El menú lateral muestra inicialmente hasta cinco conexiones activas. «Mostrar más» despliega las demás activas en el mismo menú y «Mostrar menos» vuelve a cinco. El título «Conexiones» abre la lista completa, incluidas las pendientes y deshabilitadas. | No | Conexiones |
| 2026-10-02 | El menú lateral del panel muestra el RUT debajo del nombre de cada conexión, cuando está disponible, para distinguir conexiones del mismo sistema. La demo muestra su RUT ficticio. Los nombres de las conexiones se conservan. | No | Conexiones |
| 2026-10-01 | banco_estado.movimientos.consultar (v2) agrega estado a cada movimiento: provisorio si es la versión del día que el banco todavía no contabiliza (puede cambiar de glosa o de documento, o desaparecer, en el cierre nocturno) o definitivo si ya la contabilizó. En los dos casos el movimiento ocurrió. También agrega el filtro opcional estado. En chequera lo marca el banco; en cuenta corriente, que no trae marca, un movimiento sigue provisorio mientras su fecha sea hoy o posterior. Los movimientos ya guardados parten como definitivo y la sincronización siguiente marca los del día. Campo nuevo, mismo id. | No | BancoEstado |
| 2026-10-01 | banco_estado.movimientos.consultar refleja la cartola del banco. BancoEstado publica de día algunos movimientos provisorios y en el cierre nocturno los reemplaza por su versión definitiva, a veces con otra glosa u otro documento; Connect guardaba las dos versiones y el movimiento aparecía repetido. Ahora, en los días que la sincronización leyó completos, un movimiento que el banco ya no muestra deja de aparecer y uno que vuelve a mostrar reaparece. Entre la medianoche y cerca de las 04:00 un movimiento del día puede no aparecer, igual que en el portal del banco. La forma de la respuesta no cambia. Si guardas los movimientos en tu sistema, vuelve a leer al menos el mes en curso y el anterior y reemplaza esos meses en tu copia, en vez de solo agregar filas nuevas. También se corrige la descripción de periodo: es el mes de la fecha del movimiento, no el período con que se pidió la sincronización. | No | BancoEstado |
| 2026-10-01 | sii.dte.previsualizar (v5): el precioUnitario de las facturas 33 y 34 admite hasta dos decimales, como el Facturador Gratuito (8402.49). El subtotal de cada línea sigue siendo round(cantidad × precioUnitario) en pesos enteros. Una línea en la que esa cuenta cae justo en medio peso se rechaza con validation_error en precioUnitario, porque el portal puede redondearla distinto que la cuenta exacta. Las guías y notas siguen con precio entero. | No | Facturas 33 y 34 |
| 2026-09-30 | sii.anulacion.previsualizar (v3) también anula boletas exentas 41 emitidas por Connect: pide documento.tipoDte: "41". La nota va sin IVA y la preparación devuelve el monto en totales.exento, con neto e IVA en cero. | No | Anular o corregir un documento |
| 2026-09-30 | sii.anulacion.previsualizar (v2) también anula boletas afectas 39 emitidas por Connect en la misma conexión: pide documento.tipoDte: "39" con su folio y fecha. La nota va por el total de la boleta, con referencia a ella y a su receptor o, si no tenía, a la propia empresa. sii.anulacion.emitir no cambia. Nuevo error sii_anulacion_no_admitida para las boletas que el portal no deja anular tal como están. | No | Anular o corregir un documento |
| 2026-09-29 | Nuevas herramientas conexiones.conexion.deshabilitar y conexiones.conexion.habilitar: pausan y reanudan una conexión por API o MCP, con las mismas reglas que el dashboard. Pausar no borra nada y la conexión deja de sumarse al cobro; reanudarla la vuelve a sumar, y la respuesta trae costoAdicional cuando la organización ya usa las conexiones de su plan. Exigen los permisos nuevos conexiones:disable y conexiones:enable, que ninguna clave existente tiene salvo las de autoridad total. | No | conexiones.conexion.deshabilitar |
| 2026-09-29 | Nueva herramienta conexiones.conexion.eliminar: borra una conexión por API o MCP con las mismas reglas que el dashboard. Pide el conexionId y el nombre exacto de la conexión como confirmación, y responde cuántos registros, sincronizaciones y webhooks se borraron. Exige el permiso nuevo conexiones:delete, que ninguna clave existente tiene salvo las de autoridad total: agrégalo en la clave que administra conexiones. Es irreversible. | No | conexiones.conexion.eliminar |
| 2026-09-29 | perspectivasFallidas también se llena en guías de despacho: en sii.conexion.sincronizar y en sincronizacion de sii.guias.consultar dice qué dirección (emitidas o recibidas) no se pudo traer y con qué código. Antes solo lo hacían las boletas de honorarios. | No | sii.guias.consultar |
| 2026-09-29 | conexiones.estado.consultar (v3): nuevo bloque historico con los meses cargados y si cargar más requiere un plan activo. | No | conexiones.estado.consultar |
| 2026-09-29 | El canal público GET /public/v1/indicadores/{codigo} sin fecha responde el valor vigente hoy en America/Santiago, en vez del último guardado. La UF y la UTM se publican por adelantado, así que la ruta devolvía la UF de un día futuro: consultada el 29 de septiembre, respondía la del 9 de octubre. En el dólar, el euro y el IPC la respuesta no cambia. La forma del JSON, la ruta con ?fecha= y la serie siguen igual. Si necesitas los valores ya publicados hacia adelante, pídelos con la serie. Las tools indicadores.valor.* no cambian. | No | Indicadores |
| 2026-09-27 | sii.rcv_totales.consultar (v2): los comprobantes de pago con tarjeta (48) pasan a sumable: false. Los informa al SII quien procesa el pago y pueden repetir ventas por las que la empresa también emitió boleta o factura; se midió en producción, con facturas del mismo mes que suman peso a peso el total 48. Si se suman depende del caso: sí, cuando la empresa no emite otro documento por esas ventas o corrigió la duplicidad con una nota de crédito; no, cuando la duplicidad sigue sin corregir. La guía del SII tiene los cuatro casos. Las boletas (39) siguen con sumable: true. La versión 1 estuvo publicada unas horas y solo la consultó Emisso. | Sí | sii.rcv_totales.consultar |
| 2026-09-27 | Nueva herramienta sii.rcv_totales.consultar: los totales del mes que el SII informa en el Registro de Compra-Venta sin detalle por documento, como las boletas electrónicas (39) y los comprobantes de pago con tarjeta (48). Trae un registro por mes y tipo, con la cantidad de documentos, sus montos y sumable, que indica si el total se suma a las ventas del mes (hoy, boletas y comprobantes de pago en ventas). Las ventas del mes son los documentos de sii.rcv.consultar más estos totales con sumable: true. El total se lee del resumen del SII, así que también llega completo en los meses con más de 1.000 boletas, en los que antes quedaba detenido en la última cifra que entregó el detalle. | No | sii.rcv_totales.consultar |
| 2026-09-27 | sii.rcv.consultar (v7) deja de incluir en documentos las filas de ventas de tipo 39 y 48 sin fecha de emisión. No eran documentos, sino el total acumulado del mes, con la cantidad en folio. Además, un mismo mes podía aparecer en más de una fila, una por cada cantidad que tuvo el total mientras el mes avanzaba. Ahora esos totales se leen, uno por mes, con sii.rcv_totales.consultar. Si tomabas boletas o pagos con tarjeta de sii.rcv.consultar, cambia a la herramienta nueva. Se conserva el id con aumento de version, con el uso real a la vista, y las organizaciones que consultan conexiones con esos totales reciben aviso directo. | Sí | sii.rcv.consultar |
| 2026-09-25 | Un validation_error de sii.dte.previsualizar trae en error.details solo los errores del documento que pediste. Antes, si fallaba un valor fijo (por ejemplo formaPago), faltaba un campo o sobraba uno, llegaba un único invalid_union que repetía la validación contra todos los tipos de documento: el error real quedaba entre avisos de la guía de despacho y de las notas. Ahora Connect elige el documento por tipoDte y devuelve cada error en su ruta, como candidato.condicionPago.formaPago. Si el tipoDte no existe, un solo error lista los que sí. Qué se acepta no cambia: un candidato válido sigue siéndolo y uno inválido sigue rechazándose. | No | Facturas 33 y 34 |
| 2026-09-22 | bice_empresas.movimientos.consultar (v5) agrega counterparty con name, rut, bank y account, más counterpartySource. Los cuatro campos se llaman igual que en bci_pyme, bch_empresas y banco_security, así que el código que ya escribiste para otro banco sirve tal cual. El RUT sale sin puntos y con guión, en la misma forma con que lo entregan las tools del SII: cruzar un movimiento del banco contra el documento tributario que lo origina pasa a ser un join por RUT, y ya no hay que parsear la glosa. Se extrae del texto que el banco ya mandaba y que Connect ya tenía guardado, así que aplica a todo el historial ya sincronizado: no hace falta volver a sincronizar ni se gasta un login. descripcion sigue viajando entera. Dos asimetrías que el banco impone y el contrato documenta: la cuenta de la contraparte solo viene en los cargos (un abono nombra a quién y desde qué institución, nunca la cuenta de origen), y en los cargos el banco abrevia y trunca el nombre de la institución a diez caracteres. counterpartySource en null significa que el banco NO informó contraparte, que es lo normal en pagos de impuestos, de la tarjeta propia y comisiones; no es un dato que falte por un problema de Connect. | No | bice_empresas.movimientos.consultar |
| 2026-09-15 | Anulación de facturas en el Facturador Gratuito: sii.anulacion.previsualizar recibe el tipo (33), el folio y la fecha de emisión de una factura emitida con ese portal y devuelve la nota de crédito 61 que arma el SII, con su referencia y sus totales; sii.anulacion.emitir la firma y la envía con previewRef e Idempotency-Key obligatoria, igual que sii.dte.emitir. Connect no propone líneas ni montos. La guía de emisión pasa a su propia sección, Emitir en el SII; la dirección anterior redirige. | No | Anular una factura |
| 2026-09-15 | Las facturas 33 y 34 del Facturador Gratuito admiten entre una y diez líneas en detalles, cada una con nombre, cantidad y precioUnitario. Connect redondea el subtotal de cada línea y suma esos subtotales para el neto; el IVA se calcula una vez sobre el total. sii.dte.previsualizar pasa a v4 y sii.dte.emitir a v5, porque el documento que se firma lleva una línea de detalle por cada una. Una factura de una línea se valida y se emite igual que antes. Una vista previa hecha antes del cambio vence en 15 minutos: si emites con ella después del deploy, vuelve a previsualizar. | No | Facturas 33 y 34 |
| 2026-09-14 | Las facturas 33 y 34 del Facturador Gratuito admiten referencias: entre una y tres, a una orden de compra (801), una HES, una guía de despacho u otro documento del selector del portal. Cada una lleva tipoDocumento, folio, fecha y una razon opcional. sii.dte.previsualizar pasa a v3 y sii.dte.emitir a v4, porque el documento que se firma incluye esas referencias. Un candidato sin referencias se valida y se emite igual que antes. Una vista previa hecha antes del cambio vence en 15 minutos: si emites con ella después del deploy, vuelve a previsualizar. | No | Facturas 33 y 34 |
| 2026-09-10 | indicadores.valor.actual e indicadores.valor.consultar declaran en el contrato el formato de sus campos de fecha (fecha y fechaSolicitada): AAAA-MM-DD, con el patrón publicado en el OpenAPI. Los valores no cambian: siempre salieron en ese formato, porque vienen de una columna de fecha. Lo que cambia es que ahora el contrato lo dice. Si generas tu cliente desde el spec, esos tres campos pasan a validarse; una respuesta nuestra nunca los va a incumplir. El resto de las fechas del catálogo ya lo declaraba. | No | indicadores.valor.actual |
| 2026-09-10 | Los cuatro campos de fecha que el SII manda en DD/MM/AAAA (fechaEmision en sii.rcv.consultar y sii.guias.consultar, fechaBoleta y fechaEventoEstado en sii.boletas_honorarios.consultar) quedan marcados como deprecados a favor de su hermano *Date en AAAA-MM-DD, que pasa a ir primero en el schema y en los ejemplos. Ningún valor cambia: los cuatro siguen viajando tal cual, y fechaEmision del RCV sigue admitiendo "" cuando el DTE 48 llega sin fecha. Lo que sí cambia es el orden de claves del JSON: si exportas con Object.keys o escribes columnas en el orden en que llegan, fechaEmisionDate ahora aparece antes que fechaEmision. Motivo: new Date("07/09/2026") es el 9 de julio y new Date("28/08/2026") es Invalid Date; un integrador ordenó meses enteros contra fechas equivocadas sin que nada fallara. | No | sii.rcv.consultar |
| 2026-08-22 | folio pasa de número a texto en la salida de sii.rcv.consultar (v6), sii.guias.consultar (v4) y sii.documentos.consultar (v2), y en la entrada de sii.documentos.detallar (v2). Un folio superó el techo de int32 y el sync de una organización nueva abortó entero; un folio es un identificador y no admite aritmética. Los ids se conservan con bump de version aunque había consumidores reales: el cambio se decidió con el dato a la vista y se avisó al cliente afectado. Si comparabas folio contra un número, ahora es un string en decimal canónico, sin ceros a la izquierda. | Sí | sii.rcv.consultar |
| 2026-08-22 | search_docs declara en cada ficha por qué puerta la ejecuta: execute para las herramientas de solo lectura, execute_write para las que escriben (sincronizar, verificar, emitir, crear un enlace de conexión). Si mandas una herramienta que escribe por execute, el error trae armada la llamada correcta por execute_write. | No | El servidor MCP |
| 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.