---
title: XLS Read
description: "##### Descripción General El comando **Xls Read** forma parte de la categoría de**[comandos RPA](https://www.stela.ai/wiki-categoria/rpa/)** (Documentos) y permite extraer información leída desde una celda puntual o un rango de celdas dentro de una planilla de Excel o archivo CSV. La información…"
url: "https://www.stela.ai/wiki/xls-read/"
updated: "2026-07-17"
category: Comandos RPA
---

# XLS Read

##### Descripción General

El comando **Xls Read** forma parte de la categoría de**[comandos RPA](https://www.stela.ai/wiki-categoria/rpa/)** (Documentos) y permite extraer información leída desde una celda puntual o un rango de celdas dentro de una planilla de Excel o archivo CSV. La información obtenida se consolida y almacena en variables de STELA para ser reutilizada en los pasos posteriores del flujo de trabajo.

##### Ejemplo de Uso Rápido

Imagina que dispones de una hoja de cálculo con una lista de contactos y necesitas obtener una dirección de correo electrónico en particular^. Con **Xls Read**, indicas la ruta del archivo y la celda objetivo (por ejemplo, `B2`), y el valor leído se guardará en una variable que tu robot podrá utilizar para enviar un correo automático^.

##### Parámetros y Opciones

Para configurar el comando **Xls Read**, debes detallar los siguientes parámetros^:

![Parámetros comando xls read STELA](https://www.stela.ai/wp-content/uploads/2026/07/image-77.png)

- **Archivo (requerido):**Ruta de acceso local o de red hacia el archivo Excel o CSV a consultar (ejemplo: `C:Mis DocumentosContactos.xlsx`).
- **Celda | Rango (requerido):**Especifica la ubicación del dato a leer. Puede ser una celda individual (ejemplo: `B2`) o un rango completo de celdas (ejemplo: `A2:D20`).
- **Hoja (opcional):**Nombre de la hoja de cálculo que se desea consultar. Si se omite, se tomará por defecto la primera hoja del archivo.
- **Recargar (opcional):**Controla el comportamiento de lectura.
  - Si se especifica `VERDADERO`, el robot forzará la recarga de los datos directamente desde el archivo guardado en el disco.
  - Si se especifica `FALSO` (o se deja vacío), reutilizará la copia actual del documento cargada previamente en la memoria.
- **Contraseña (opcional):**Clave de acceso requerida si la hoja o el libro de Excel están protegidos.
- **Encoding (CSV) (opcional):**Define el tipo de codificación para archivos en formato CSV. Si no se especifica, se aplicará `UTF-8` por defecto.
- **Guardar Resultado** (opcional): Nombre de la variable principal donde se almacenará el resultado consolidado de la lectura:
  - Si se lee una **única celda**, la variable guardará el valor directo de dicha celda.
  - Si se lee un **rango de celdas**, la variable registrará un texto formateado con comas (`,`) separando las columnas y saltos de línea separando cada fila.
  - Adicionalmente, STELA almacenará siempre en memoria la referencia de cada celda individual leída (ejemplo: `A2`, `B2`, `C2`).

##### Ejemplos de Uso Avanzado

- **Lectura de parámetros para ingreso a sistemas:** Puedes utilizar **Xls Read** para extraer credenciales o datos de negocio desde una planilla y utilizarlos secuencialmente en un formulario web.
- **Validación de datos e importes:** Puedes leer un valor específico desde Excel y combinarlo con el comando `comparar` o `si` para validar que los datos leídos coincidan con la información en una base de datos o pantalla.
- **Consolidación de bloques de datos:** Al especificar un rango como `A2:D10`, puedes extraer de una sola acción un bloque completo de información para luego procesarlo o dividirlo mediante el comando `split`.

##### Errores Comunes y Soluciones

- **Error: El archivo Excel está abierto.**
  - **Solución:** Cierra el archivo de Excel en el sistema operativo antes de lanzar la automatización para evitar conflictos de bloqueo.
- **Error: No se encuentra el archivo Excel.**
  - **Solución:** Asegúrate de que la ruta provista en el parámetro **Archivo** sea válida y accesible.
- **Error: Celda o rango fuera de formato.**
  - **Solución:** Verifica que la nomenclatura ingresada en el campo **Celda | Rango** respete la sintaxis estándar de Excel (ejemplo: `A1`, `B2:D10`).

##### Video explicativo

[xls read, xls write y mail](https://www.youtube.com/embed/tOsH9S_aLi4?start=122&feature=oembed)