# 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 [#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í `version` tambié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 misma `version` y quedan anotados en esta tabla.
* `deprecated: true` en 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 [#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](/docs/emitir/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](/docs/emitir/guias)                                                    |
| 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](/docs/emitir/guias)                                                    |
| 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](/docs/emitir/guias)                                                    |
| 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](/docs/emitir/guias)                                                    |
| 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](/docs/emitir/resultados)                                             |
| 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](/docs/referencia/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](/docs/sistemas/tgr)                                                              |
| 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](/docs/emitir/facturas#3-pide-el-xml-después)                              |
| 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](/docs/emitir/boletas)                                                      |
| 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](/docs/conceptos/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](/docs/conceptos/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](/docs/sistemas/banco-estado#movimientos-provisorios-y-cierre-nocturno)         |
| 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](/docs/sistemas/banco-estado#movimientos-provisorios-y-cierre-nocturno)         |
| 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](/docs/emitir/facturas)                                                    |
| 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](/docs/emitir/anular-o-corregir#anular-una-boleta)           |
| 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](/docs/emitir/anular-o-corregir)                             |
| 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](/docs/referencia/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](/docs/referencia/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](/docs/referencia/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](/docs/referencia/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](/docs/sistemas/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](/docs/sistemas/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](/docs/referencia/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](/docs/referencia/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](/docs/referencia/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](/docs/emitir/facturas)                                                    |
| 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](/docs/referencia/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](/docs/emitir); la dirección anterior redirige.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | No                                    | [Anular una factura](/docs/emitir/anular-o-corregir)                                         |
| 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](/docs/emitir/facturas)                                                    |
| 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](/docs/emitir/facturas)                                                    |
| 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](/docs/referencia/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](/docs/referencia/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](/docs/referencia/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](/docs/agentes/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](/docs/empezar/autenticacion)                                                 |
| 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](/docs/agentes/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](/docs/referencia/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](/docs/conceptos/sincronizar-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](/docs/referencia/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](/docs/empezar/conectar)                                                |
| 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](/docs/referencia/sii/guias-consultar)                                  |

## Cómo enterarse [#cómo-enterarse]

Esta página y el índice [`/llms.txt`](https://connect.emisso.ai/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.
