--- title: Comando ReadJSON description: "##### **Descripción General** El comando `readJSON` pertenece a la categoría de comandos Comandos **RPA.**Es útil  para extraer información valiosa desde archivos JSON, mediante la especificación de una ruta por niveles (notación de puntos): - **¿Qué es un archivo JSON?** Es…" url: "https://www.stela.ai/wiki/comando-read-json/" updated: "2026-07-09" category: Comandos RPA --- # Comando ReadJSON ##### **Descripción General** El comando `readJSON` pertenece a la categoría de comandos Comandos **RPA.**Es útil  para extraer información valiosa desde archivos JSON, mediante la especificación de una ruta por niveles (notación de puntos): - **¿Qué es un archivo JSON?** Es una forma común de organizar datos en internet y en muchas aplicaciones. - **¿Cómo funciona el comando?** Tú le dices a STELA qué archivo JSON leer y qué parte de la información te interesa. - **¿Qué obtienes?** STELA toma el dato que pediste y lo guarda en una **variable** para que puedas usarlo en tu automatización. ##### Ejemplo de Uso Rápido Imagina que tienes un archivo JSON llamado `configuracion.json` con la siguiente información: JSON ![Json ejemplo 1](https://www.stela.ai/wp-content/uploads/2023/09/image-12.png) Imagina que quieres saber cuál es el idioma predeterminado. Con el comando **ReadJSON**, puedes : 1. **Seleccionar el archivo JSON**: Indicarle a STELA que el archivo que quieres leer es `configuracion.json` 2. **Especificar el campo**: Decirle que buscas la información que está dentro del campo llamado `"idioma_predeterminado"`. 3. **Asignar a una variable**: Nombrar una variable, por ejemplo, `idioma`, donde STELA guardará el valor encontrado ("es"). Después de ejecutar el comando, la variable `idioma` contendrá el texto "es", Ahora puedes usar esa información en tu flujo de trabajo, como mostrar mensajes o configurar tu aplicación en el idioma correcto. ##### Parámetros y Opciones El comando `ReadJSON` necesita que le indiques algunos detalles para poder trabajar correctamente: - **Archivo JSON** **(Obligatorio)**: Aquí debes especificar la ruta completa del archivo JSON que quieres leer. Por ejemplo: `/ruta/al/archivo/datos.json` o `C:archivosconfiguracion.json`. - **Campo** **(Obligatorio)**: En este parámetro, defines la "dirección" exacta de la información que buscas dentro del archivo JSON. Por ejemplo: `idioma_predeterminado`. - **Variable** **(Obligatorio)**: Aquí escribes el nombre de la variable donde STELA guardará el valor que encuentre en el archivo JSON. Por ejemplo `fecha_pedido` ![Parámetros ReadJson STELA](https://www.stela.ai/wp-content/uploads/2023/09/image-7.webp) **IMPORTANTE:** Al trabajar con niveles jerárquicos o elementos anidados dentro de un arreglo, el parámetro `campo` se configura mediante la **notación de puntos**. Bajo este formato, utilizas un punto (`.`) como separador para recorrer ordenadamente cada subnivel de la estructura JSON hasta localizar el valor exacto. Por ejemplo: ![Json ejemplo 2](https://www.stela.ai/wp-content/uploads/2023/09/image-17.png) Para obtener la fecha de la orden (Nivel 2 de anidamiento): Valor del parámetro **campo:** `orden.fecha` Resultado obtenido: "09/07/2026" ##### Ejemplos de Uso Avanzado **Extracción de datos de una API:** Imagina que tu robot se conecta a una API y recibe la información en formato JSON. Si quieres el precio de una acción, puedes: - Usar el comando `ReadJSON` para tomar la respuesta de la API. - Especificar el campo donde se encuentra el precio (por ejemplo, `precio`). - Guardar ese valor en una nueva **variable** para usarlo en reportes o para tomar decisiones. **Procesamiento de logs en formato JSON:** Si tus aplicaciones guardan registros de actividad en archivos JSON, puedes usar `ReadJSON` para analizar estos logs de manera automatizada. Por ejemplo, podrías extraer todos los mensajes de error que tengan un campo `"nivel"` con el valor `"error"` dentro de un array de eventos en el archivo JSON. **Aplanamiento automático de subestructuras completas:** Si necesitas extraer todos los datos de un bloque sin especificar campo por campo, puedes apuntar a un nodo intermedio. Por ejemplo, si el JSON contiene: ![Json ejemplo 3 STELA](https://www.stela.ai/wp-content/uploads/2023/09/image-18.png) y ejecutas readJSON, configurando el parámetro "Campo": `pedido`, STELA creará de forma automática las variables derivadas: id (con el valor 105) y estado (con el valor "Procesado"). ##### Errores Comunes y Soluciones - **Archivo no encontrado:** Si la ruta que especificaste en el parámetro "Archivo JSON" no existe o no es correcta, STELA no podrá encontrar el archivo y mostrará un error. - **Solución**: Asegúrate de que la ruta del archivo sea exactamente la correcta y que el archivo exista en esa ubicación. - **Campo no encontrado:** Si el "Campo" que especificaste no existe en la estructura del archivo JSON, el comando no podrá extraer ningún valor y la variable se quedará vacía o tendrá un valor nulo, dependiendo de la configuración de STELA. - **Solución**: Revisa cuidadosamente la estructura de tu archivo JSON y asegúrate de que el camino del campo que estás buscando sea el correcto. Verifica la ortografía exacta de los niveles del JSON. Recuerda que la búsqueda distingue entre mayúsculas y minúsculas (ejemplo: `cliente.nombre` es diferente de `cliente.Nombre`) - **Error de formato JSON:** Si el archivo que intentas leer no tiene un formato JSON válido, STELA mostrará un error al intentar analizarlo. - **Solución**: Verifica que tu archivo JSON esté bien formado, que no falten comas, que las llaves `{}` y corchetes `[]` estén correctamente cerrados y que todas las propiedades utilicen comillas dobles (`""`) según el estándar del formato. ##### Casos de Uso - **Automatización de tareas repetitivas** que involucran la lectura de archivos de configuración para diferentes aplicaciones o procesos. - **Captura de datos visuales** o información relevante de resultados de otras herramientas o servicios que entregan su información en formato JSON. - **Integración de datos** entre diferentes sistemas o aplicaciones que utilizan JSON como formato de intercambio. - **Personalización de flujos de trabajo** dinámicamente leyendo opciones o parámetros desde un archivo JSON. - **Procesamiento básico de información** extraída de APIs sin necesidad de conocimientos de programación.