---
title: XlsWrite (GSuite)
description: "##### Descripción General El comando **xlsWrite(GSuite)** pertenece a la categoría de comandos **[RPA GSuite](https://www.stela.ai/wiki-categoria/rpa-gsuite/)**. Su función principal es escribir o actualizar información directamente dentro de una celda específica en una hoja de cálculo almacenada en Google Sheets. Esta funcionalidad es…"
url: "https://www.stela.ai/wiki/xlswrite-gsuite-google-sheet/"
updated: "2026-07-29"
category: Google suite (GSuite)
---

# XlsWrite (GSuite)

##### Descripción General

El comando **xlsWrite(GSuite)** pertenece a la categoría de comandos **[RPA GSuite](https://www.stela.ai/wiki-categoria/rpa-gsuite/)**. Su función principal es escribir o actualizar información directamente dentro de una celda específica en una hoja de cálculo almacenada en Google Sheets.

Esta funcionalidad es esencial para flujos de automatización que gestionan datos en la nube, permitiendo actualizar reportes, registrar estados de procesos, guardar valores calculados o insertar métricas de negocio de forma remota sin necesidad de manipular archivos locales.

##### Ejemplo de Uso Rápido

Imagina un flujo de trabajo que consulta diariamente el valor de la tasa de cambio del dólar (USD) desde una API o sitio financiero. Una vez obtenido el valor, el robot utiliza el comando **xlsWrite(GSuite)** para registrar esa tasa en la celda **B2** de la pestaña "Control_Diario" en la planilla de finanzas compartida de la empresa.

##### Parámetros y Opciones

![XlsWrite (GSuite) Parametros STELA](https://www.stela.ai/wp-content/uploads/2023/04/image-5.png)

- **Archivo (requerido):** Identificador único del archivo Google Sheets (Spreadsheet ID que se encuentra en la URL del documento), por ejemplo `1WadqXjSnw83M9rRhxjTc5CeaMrSsVpGUSjnxajceMvM`.
  - Puedes ingresar el ID directamente, usar una variable o constante que lo contenga, o incluso utilizar el editor extendido para casos más complejos.
- **Celda (requerido):** Coordenada o referencia de la celda donde se escribirá el valor (por ejemplo: `A1`, `B2`, `C10`).
- **Valor (requerido):** Ingresa el contenido que deseas escribir en la celda especificada. Puede ser texto, números o cualquier otro valor admitido por Google Sheets.
- **Hoja (opcional):** Nombre exacto de la pestaña dentro del libro de Google Sheets donde se debe aplicar la escritura (por ejemplo: `Control_Diario` o `Finanzas`). Si se deja vacío, la acción se aplicará en la hoja principal o activa por defecto.

##### Ejemplos de Uso Avanzado

1. **Registro Diario de Cotizaciones Financieras:** El robot extrae la tasa de cambio de divisas al inicio de la jornada laboral y utiliza **xlsWrite(GSuite)** para actualizar la celda correspondiente en el libro contable consolidado de Google Sheets, garantizando que el equipo de finanzas cuente siempre con la cifra oficial actualizada.
2. **Actualización Automática de Inventario:** Puedes combinar **xlsWrite(GSuite)** con otros comandos de STELA para actualizar automáticamente el inventario de tu tienda en línea. Por ejemplo, cada vez que se realice una venta, STELA puede restar la cantidad vendida del stock disponible en tu hoja de cálculo.
3. **Registro de Marcas de Tiempo y Auditoría:** Al finalizar la ejecución de un proceso masivo en la nube, el robot utiliza **xlsWrite(GSuite)** para registrar en la celda de control la hora de finalización del ciclo y el estado del procesamiento ("COMPLETADO" o "ERROR").

##### Errores Comunes y Soluciones

**Error: El archivo de Google Sheets no se encuentra o el ID es incorrecto.**

- *Solución:* Verifica que hayas copiado únicamente la clave alfanumérica (Spreadsheet ID) de la URL del navegador.

**Error: La hoja especificada no existe en el documento.**

- *Solución:* Revisa que el parámetro opcional **hoja** coincida exactamente en nombre, espacios y mayúsculas/minúsculas con la pestaña creada en Google Sheets.

**Error de permisos de acceso o escritura.**

- *Solución:* Asegúrate de que las credenciales de GSuite configuradas en el proyecto de STELA (cuenta de servicio o cuenta OAuth2) tengan otorgados los permisos de edición sobre la hoja de cálculo de destino.

##### Casos de Uso

- Automatización de la entrada de datos en hojas de cálculo.
- Generación automática de informes y dashboards.
- Actualización en tiempo real de inventarios y registros.
- Seguimiento de proyectos y tareas.
- Extracción de datos web, para posterior ingreso en una hoja de calculo.

##### Video ejemplo

[Xls (Read, Write y Fx) GSuites](https://www.youtube.com/embed/4yvXUAa01z4?feature=oembed)