> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tukanmx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Excel

> Conecta tus consultas guardadas de Tukan a Excel con Power Query para mantener tus reportes siempre actualizados.

export const Annotation = ({children}) => <span style={{
  color: '#6b7280',
  fontSize: '0.9em'
}}>
    {children}
  </span>;

Con **Power Query** puedes conectar tus consultas de Tukan directamente a Excel.

Genera un *stream* de datos directo con nuestras bases, para que tus modelos y archivos se actualicen automáticamente.

## Requisitos

* **Excel 365** con **Power Query** (disponible en Windows y Mac).
* Una [consulta guardada](/es/tip/consultas/sql_editor) en tu usuario de Tukan.
* Créditos de consumo en tu cuenta para ejecutar la consulta.

<Note icon="info">
  Si planeas conectar Tukan a Excel, asegúrate de que tu consulta esté hecha con **fechas dinámicas**, para que cada actualización te entregue los datos más recientes.
</Note>

## Obtener el código de tu consulta

Cuando guardas una consulta, Tukan te lleva a tu **panel de consultas**, donde cada consulta ofrece su código de conexión para distintas herramientas.

<Steps>
  <Step title="Abre tu panel de consultas">
    Inicia sesión en la plataforma y entra a tu panel de [consultas](https://app.tukanmx.com/visualizations/queries).
  </Step>

  <Step title="Copia el código de conexión para Excel">
    En la consulta que quieras conectar, elige la opción de descarga. El panel te mostrará todas las integraciones disponibles y las formas de conectarte:

    * Un **URL** lista para usar con *Desde la Web* en Excel para Windows.
    * Un **código de Power Query (M)** listo para pegar en Excel para Mac.

    <video autoPlay muted loop playsInline className="w-full aspect-video rounded-xl" src="https://s3.us-east-1.amazonaws.com/public.tukanmx.com/images_for_documentation/integraciones/download_query.mp4" />
  </Step>
</Steps>

<Warning>
  La URL y el código de Power Query incluyen una **llave de acceso a tu consulta**. Trátalos como información confidencial, ya que cada vez que se ejecute la consulta en ese stream se consumirán créditos de tu cuenta.
</Warning>

## Conectar la consulta a Excel

Elige tu sistema operativo y el método que prefieras. Ambos dejan la consulta conectada y actualizable.

<Tabs>
  <Tab title="Windows" icon="windows">
    <Steps>
      <Step title="Abrir el conector web">
        En Excel, ve a la pestaña **Datos** → **Obtener datos** → **Desde otras fuentes** → **Desde la Web**.
      </Step>

      <Step title="Pegar la URL de tu consulta">
        Pega la URL que copiaste del panel de consultas:

        ```text theme={null}
        <URL_DE_TU_CONSULTA>
        ```
      </Step>

      <Step title="Conectarte como anónimo">
        Como la llave de acceso ya viene dentro de la URL, cuando Excel te pregunte el método de autenticación selecciona **Anónimo** y haz clic en **Conectar**.
      </Step>

      <Step title="Cargar a la hoja">
        Power Query mostrará una vista previa de los datos. Haz clic en **Cargar** para traerlos a tu hoja de Excel.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Mac" icon="apple">
    <Note icon="info">
      En macOS, Power Query requiere **Excel 365 en una versión reciente**. Si no ves la opción **Obtener datos (Power Query)**, actualiza Excel a la última versión disponible.
    </Note>

    <Steps>
      <Step title="Crear una consulta en blanco">
        En Excel, ve a **Datos** → **Obtener datos (Power Query)** → **Consulta en blanco**.
      </Step>

      <Step title="Abrir el Editor avanzado">
        En el Editor de Power Query, haz clic en **Editor avanzado**.
      </Step>

      <Step title="Pegar el código de tu consulta">
        Borra el contenido y pega el código de Power Query que copiaste del panel de consultas. Tendrá una forma similar a esta:

        ```powerquery-m theme={null}
        let
            Origen = Csv.Document(
                Web.Contents("<URL_DE_TU_CONSULTA>"),
                [Delimiter = ",", Encoding = 65001]
            ),
            Encabezados = Table.PromoteHeaders(Origen, [PromoteAllScalars = true])
        in
            Encabezados
        ```

        <Annotation>Copia el código tal cual lo muestra el panel: ya incluye la URL y la llave de acceso correctas para tu consulta.</Annotation>
      </Step>

      <Step title="Aplicar y cargar">
        Haz clic en **Listo** y luego en **Cerrar y cargar** para traer los datos a tu hoja.
      </Step>
    </Steps>
  </Tab>
</Tabs>

## Mantener los datos actualizados

Una vez cargada la consulta, puedes refrescarla cuando quieras o configurar que se actualice sola:

1. Selecciona la tabla cargada en tu hoja.
2. Ve a **Consulta** → **Propiedades** (o haz clic derecho en la consulta → **Propiedades**).
3. Activa **Actualizar al abrir el archivo** y/o **Actualizar cada N minutos**.

Para una actualización manual, haz clic en **Datos** → **Actualizar todo** (`Ctrl + Alt + F5`).

<Note icon="info">
  Cada vez que Excel actualiza la consulta, se ejecuta sobre las bases de Tukan y **consume créditos** de tu cuenta. Evita intervalos de actualización muy cortos si tu consulta es pesada.
</Note>

## Solución de problemas

<AccordionGroup>
  <Accordion title="Excel me pide credenciales y no avanza" icon="lock">
    La llave de acceso ya está embebida en la URL/código, así que el método de autenticación debe ser **Anónimo**. Si elegiste otro método por error, ve a **Datos** → **Obtener datos** → **Configuración de origen de datos**, selecciona la URL de tu consulta, haz clic en **Editar permisos** y cámbialo a **Anónimo**.
  </Accordion>

  <Accordion title="Los datos no se actualizan" icon="arrows-rotate">
    Verifica que tengas activada la actualización automática en **Consulta** → **Propiedades**, o fuerza un refresco con **Datos** → **Actualizar todo**. Recuerda que la consulta debe tener **fechas dinámicas** para que traiga datos más recientes en cada ejecución.
  </Accordion>

  <Accordion title="No encuentro Power Query en mi Excel" icon="circle-question">
    Power Query viene integrado en Excel 365 y en las versiones recientes de Excel para Mac. Si no ves la opción **Obtener datos**, actualiza Excel a la última versión disponible.
  </Accordion>

  <Accordion title="La consulta viene vacía" icon="circle-question">
    Suele deberse a que la consulta guardada no devuelve filas para el rango de fechas actual. Vuelve al [editor SQL](/es/tip/consultas/sql_editor), ejecútala y confirma que regresa datos antes de conectarla a Excel.
  </Accordion>
</AccordionGroup>