> For the complete documentation index, see [llms.txt](https://docs.skyone.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.skyone.cloud/espanol/skyone-studio/integraciones/flujos/modulos-de-herramientas/modulo-xlsx.md).
# Módulo XLSX
### Definición
El módulo de herramientas “**XLSX**”, módulo estándar de **Skyone Studio** para uso en cualquier flujo, fue creado para convertir datos entre los formatos JSON y XLSX (Excel), utilizando archivos en formato Base64.
El módulo “**XLSX**” está compuesto por dos operaciones:
* **Convertir JSON a XLSX**
* **Convertir XLSX a JSON**
***
### Configuración del módulo XLSX
El módulo “**XLSX**” aparece en la opción Herramientas de la edición de un flujo. Al ser agregado a un flujo, ofrece dos operaciones:
* **Convertir JSON a XLSX**: convierte un contenido en JSON a un archivo XLSX, retornando el resultado en Base64.
* **Convertir XLSX a JSON:** convierte un archivo XLSX en Base64 al formato JSON.
***
### Operación Convertir JSON a XLSX
Esta operación le permite convertir un contenido en JSON (como respuestas de APIs, listas de productos, clientes, etc.) al formato XLSX, permitiendo la generación de hojas de cálculo de Excel a partir de datos estructurados.
#### Cómo utilizar
1. Ingrese a su flujo de integración.
2. Seleccione la operación “**Convertir JSON a XLSX**”.
3. Haga clic en **Guardar**.
4. Al editar el módulo, se mostrará el área de configuración de las variables.
***
#### Campos de configuración
**Nombre de la hoja de cálculo**
Informe el nombre que se le asignará a la hoja XLSX generada.
**JSON**
Informe el contenido en formato JSON que debe ser convertido.
Si lo prefiere, haga clic en el signo de más ( + ) para configurar una SMOP o utilizar datos provenientes de otro módulo del flujo (ej: respuesta de API).
**XLSX convertido (Base64)**
Después de hacer clic en el botón **Validar**, se mostrará el archivo XLSX generado en formato Base64.
{% hint style="info" %}
El módulo no ofrece la descarga directa del archivo XLSX. El resultado siempre se genera en Base64.
{% endhint %}
***
#### Uso del Base64 generado
El Base64 retornado puede ser:
* Guardado para uso posterior;
* Utilizado directamente en el retorno de la aplicación;
* Convertido en un archivo físico utilizando:
* **JSONata**
* Transformaciones en el módulo **Transformación de Datos**
* Implementaciones externas que consuman Base64
**Ejemplo de uso en el retorno del flujo:**
* Arrastre el parámetro generado por el módulo XLSX al módulo de **Retorno**.
* Defina un nombre para el campo.
* El Base64 estará disponible como salida de la API.
***
### Operación Convertir XLSX para JSON
Esta operación permite la conversión de un archivo XLSX en Base64 al formato JSON, lo que permite la lectura y manipulación de los datos de las hojas de cálculo dentro del flujo.
#### Cómo utilizar
1. Seleccione la operación “**Convertir XLSX a JSON**”.
2. Haga clic en **Guardar**.
3. Al editar el módulo, se mostrará el área de configuración de las variables.
***
#### Campos de configuración
* **Nombre de la hoja de cálculo:** Informe el nombre de la hoja que se utilizará en la lectura del archivo XLSX.
* **XLSX (Base64):** Informe el contenido del archivo XLSX codificado en Base64. Este campo acepta únicamente Base64, incluyendo archivos generados por el propio módulo XLSX.
* **XLSX convertido a JSON:** Después de hacer clic en **Validar**, el contenido de la hoja de cálculo se mostrará en formato JSON.
***
### Parámetros
Cada operación del módulo XLSX posee un parámetro correspondiente al resultado de la conversión:
* **Convertir JSON para XLSX** → retorna un **Base64 XLSX**
* **Convertir XLSX para JSON** → retorna un **JSON**
Estos parámetros:
* Están disponibles en el lado izquierdo del modal de configuración;
* Pueden ser utilizados en módulos posteriores del flujo;
* Pueden ser manipulados por el módulo **Transformación de Datos** o por SMOPs.
***
### Consideraciones finales
El **módulo XLSX** fue desarrollado para facilitar la conversión entre JSON y Excel, siguiendo el estándar de uso de Base64 adoptado por **Skyone Studio**. Actualmente:
* JSON → XLSX
* XLSX → JSON
Para finalizar la configuración del módulo, haga clic en **Guardar**.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.skyone.cloud/espanol/skyone-studio/integraciones/flujos/modulos-de-herramientas/modulo-xlsx.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.