Saturn Studio — Cloudflare

Cloudflare es una plataforma de servicios en la nube que ofrece una variedad de soluciones para mejorar el rendimiento, la seguridad y la confiabilidad de sitios web y aplicaciones. Con este módulo, puede integrar las funcionalidades de Cloudflare en sus flujos de trabajo de Saturn Studio, permitiéndole gestionar sus recursos directamente desde la plataforma.

Cómo obtener las credenciales, click aquí.

Descripción de los comandos

Subir un Certificado (Upload a Certificate)

Sube un certificado a Cloudflare.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Cloudflare necesaria para subir un certificado.	`credential`
ID de Zona (Zone ID)	El ID de la zona donde se subirá el certificado.	`Zone ID`
Contenido del Certificado	El contenido del certificado que se va a subir.	`Certificate Content`
Llave Privada (Private Key)	El contenido de la llave privada asociada al certificado.	`Private Key`
Asignar resultado a variable	Variable donde se almacenará el resultado.	`{var}`

Eliminar un Certificado (Delete a Certificate)

Elimina un certificado de Cloudflare.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Cloudflare necesaria para eliminar un certificado.	`credential`
ID de Zona (Zone ID)	El ID de la zona donde se encuentra el certificado.	`Zone ID`
ID del Certificado	El ID del certificado que se desea eliminar.	`Certificate ID`
Asignar resultado a variable	Variable donde se almacenará el resultado.	`{var}`

Obtener un Certificado (Get a Certificate)

Obtiene la información de un certificado específico de Cloudflare.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Cloudflare necesaria para obtener un certificado.	`credential`
ID de Zona (Zone ID)	El ID de la zona donde se encuentra el certificado.	`Zone ID`
ID del Certificado	El ID del certificado que se desea obtener.	`Certificate ID`
Asignar resultado a variable	Variable donde se almacenará el resultado.	`{var}`

Obtener muchos Certificados (Get Many Certificates)

Obtiene una lista de certificados de Cloudflare.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Cloudflare necesaria para obtener los certificados.	`credential`
ID de Zona (Zone ID)	El ID de la zona donde se encuentran los certificados.	`Zone ID`
Límite (Limit)	El número máximo de certificados a recuperar.	`Limit`
Retornar todos (Return all)	Si se marca, se devolverán todos los certificados de la zona.	`Return all`
Estado (Status)	Selecciona el estado de los certificados que se desean recuperar.	`Status`
Asignar resultado a variable	Variable donde se almacenará el resultado.	`{var}`

Saturn Studio — Credencial Cloudflare

Para gestionar los certificados de sus sitios web mediante Saturn Studio, es necesario configurar una credencial basada en un API Token. Este identificador permite que el robot realice operaciones de lectura y edición en sus zonas de Cloudflare de forma segura.

1. Obtención y Configuración del API Token

El proceso de creación debe realizarse en el portal oficial de Cloudflare siguiendo este orden lógico para asegurar que el robot tenga los accesos necesarios:

Paso 1: Acceso al Portal

En el formulario de credenciales de Saturn Studio, haga clic en el enlace “here” o acceda directamente a su cuenta en el panel de Cloudflare.

Paso 2: Navegación

En la barra de búsqueda superior del panel de Cloudflare, escriba “API Token” y seleccione la opción Account API tokens. Una vez allí, haga clic en el botón azul Create Token.

Paso 3: Selección de Plantilla

Puede utilizar una plantilla de edición de zona o seleccionar “Create Custom Token”. El sistema le asignará un nombre automático (ej. dawn-pine-98da), el cual puede conservar o modificar.

Paso 4: Configuración de Permisos (Scopes)

Este es el paso más importante. Antes de continuar, debe agregar las siguientes políticas de permisos para que los comandos de certificados en Saturn Studio funcionen:

Categoría de Permiso	Permiso Específico	Nivel de Acceso	Comandos Vinculados
Zone	SSL and Certificates	Edit	Upload, Delete, Get, Get Many
Zone	Zone	Read	Listado y lectura de zonas

Paso 5: Restricciones Opcionales

Zone Resources: Seleccione “All zones” o una zona específica si desea limitar el alcance del robot.
TTL (Expiración): Puede definir cuánto tiempo será válido el token.
IP Filtering: Puede restringir el uso del token solo a la dirección IP de su servidor de Saturn Studio.

Paso 6: Finalización y Resguardo

Haga clic en Continue to summary y luego en Create Token.

Copie su token inmediatamente: Cloudflare solo mostrará el secreto alfanumérico una vez. Selecciónelo y guárdelo en un lugar seguro; si cierra esta ventana sin copiarlo, deberá generar uno nuevo.

2. Configuración en Saturn Studio

Una vez que tenga el token (ej: cfat_9FIAmNzOG...), regrese a Saturn Studio para completar la vinculación:

Nombre de la credencial: Asigne un nombre descriptivo (ej: Cloudflare_Certificados).
API Token: Pegue el código obtenido en el paso anterior.
Validación: Haga clic en el botón Check.
- Si los permisos fueron configurados correctamente, el estado cambiará a “Connected” en color azul.
- Verá el mensaje: “Success! Credentials are valid and the request succeeded”.
Guardar: Haga clic en Save credentials.

Saturn Studio — Dropbox

Dropbox es una plataforma de colaboración y almacenamiento en la nube que permite guardar, compartir y sincronizar archivos en múltiples dispositivos.

Cómo obtener las credenciales, click aquí.

Descripción de los comandos

Subir un archivo (Upload a File)

Sube un archivo a Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para subir archivos.	`credential`
Ruta del archivo	Ruta de destino en Dropbox.	`/invoices/2019/invoice_1.pdf`
Archivo local	Variable de archivo para subir cuando “Binary File” está habilitado. Ejemplo `[{"name": "file1.txt", "path_lower": "/file1.txt", "path_display": "/file1.txt", "id": "idfile1", "client_modified": "2020-01-01T00:00:00Z", "server_modified": "2020-01-01T00:00:00Z", "rev": "9535f95cfdb3523000000033ba8ptr5", "size": "1234", "is_downloadable": "true", "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"}]`.	`select file`
Asignar resultado a variable	Variable donde se almacenará el resultado.	`{var}`

Eliminar un archivo (Delete a File)

Elimina un archivo en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para eliminar archivos.	`credential`
ID del archivo	ID del archivo a eliminar en Dropbox.	`File to delete ID`
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo `[{"message": "File deleted successfully", "name": "file1.txt"}]`.	`{var}`

Descargar un archivo (Download a File)

Descarga un archivo de Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para descargar archivos.	`credential`
Ruta del archivo	Ruta del archivo a descargar en Dropbox.	`/invoices/2019/invoice_1.pdf`
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo `[{"filename": "invoice_1.pdf", "id": "p95r13ebe31c88aec9100d4ee579e29d7103177ac4c5784ebf9c397564e54e22", "size": 1234, "provider": "dropbox"}]`.	`{var}`

Mover un archivo (Move a file)

Mueve un archivo en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para mover archivos.	`credential`
Ruta del archivo de origen	Ruta del archivo a mover en Dropbox.	`/invoices/2019/invoice_1.pdf`
Ruta del archivo de destino	Ruta donde se moverá el archivo en Dropbox.	`/invoices/2020/invoice_1.pdf`
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo `["metadata {".tag": "file", "name": "file1.txt", "path_lower": "/folder/file1.txt", "path_display": "/folder/file1.txt", "id": "idfile1", "client_modified": "2020-01-01T00:00:00Z", "server_modified": "2020-01-01T00:00:00Z", "rev": "9535f95cfdb3523000000033ba8ptr5", "size": "1234", "is_downloadable": "true", "content_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"}]`.	`{var}`

Crear una carpeta (Create a Folder)

Crea una carpeta en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para crear carpetas.	`credential`
Nombre de la carpeta	Nombre de la carpeta a crear en Dropbox.	`folder name`
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo `[{"metadata": {"name": "New Folder", "path_lower": "/invoices/2020", "path_display": "/invoices/2020", "id": "id2OCn0d58CrIOOOOOOOOODO"}}]`.	`{var}`

Eliminar una carpeta (Delete a Folder)

Elimina una carpeta en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para eliminar carpetas.	`credential`
ID de la carpeta	ID de la carpeta a eliminar en Dropbox.	`Folder to delete ID`
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo `[{"message": "Folder deleted successfully", "folder_name": "invoices"}]`.	`{var}`

Mover una carpeta (Move a Folder)

Mueve una carpeta en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para mover carpetas.	`credential`
Ruta de la carpeta de origen	Ruta de la carpeta a mover en Dropbox.	`/invoices`
Ruta de la carpeta de destino	Ruta donde se moverá la carpeta en Dropbox.	`/2021/invoices`
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo `["metadata {".tag":"folder", "name": "invoices", "path_lower": "/2021/invoices", "path_display": "/2021/invoices", "id": "id2OCn0d58CrIOOOOOOOOODO"}]`.	`{var}`

Listar una carpeta (List a Folder)

Enumera el contenido de una carpeta en Dropbox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Dropbox necesaria para listar carpetas.	`credential`
Ruta de la carpeta	Ruta de la carpeta a listar en Dropbox.	`/invoices/2020/`
Retornar todas las carpetas	Indica si se deben retornar todas las carpetas o solo los archivos en la carpeta especificada.	`Return all folders`
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo `[{".tag": "folder", "name": "invoices", "path_lower": "/2021/invoices", "path_display": "/2021/invoices", "id": "id2OCn0d58CrIOOOOOOOOODO"}]`.	`{var}`

Saturn Studio — Credencial Dropbox

Para integrar Dropbox con Saturn Studio y permitir que el robot gestione archivos y carpetas, es necesario configurar una credencial basada en un Access Token. Siga estos pasos para registrar su aplicación y generar la clave de acceso con los permisos adecuados.

1. Creación de la Aplicación en Dropbox

El proceso comienza en el portal de desarrolladores de Dropbox para registrar el “puente” de conexión:

Acceso: En el formulario de credenciales de Saturn Studio, haga clic en el enlace “here” para dirigirse a la Consola de Aplicaciones de Dropbox.
Crear App: Haga clic en el botón “Create app”.
Configuración inicial:
- 1. Choose an API: Seleccione Scoped access.
- 2. Choose the type of access: Seleccione Full Dropbox para permitir el acceso a todos los archivos y carpetas necesarios para los comandos del módulo.
- 3. Name your app: Asigne un nombre a su aplicación (ej. Saturn_Integration_Test).
Aceptar Términos: Marque la casilla de aceptación de términos y haga clic en Create app.

2. Configuración de Permisos (Permissions)

Para que los comandos de subir, borrar, descargar y listar funcionen correctamente, debe activar los siguientes permisos en la pestaña Permissions antes de generar el token:

Categoría	Permiso (Scope)	Descripción
Files and folders	`files.metadata.write`	Permite crear carpetas y mover archivos.
Files and folders	`files.metadata.read`	Requerido para listar el contenido de las carpetas.
Files and folders	`files.content.write`	Necesario para subir (Upload) y eliminar archivos.
Files and folders	`files.content.read`	Necesario para descargar (Download) archivos.

Guardar Permisos: Después de marcar los permisos, asegúrese de hacer clic en el botón Submit al final de la página para aplicar los cambios.

3. Generación del Access Token

Una vez configurados los permisos, proceda a generar la clave técnica:

Diríjase a la pestaña Settings de su aplicación en Dropbox.
Desplácese hacia abajo hasta encontrar la sección Generated access token.
Haga clic en el botón Generate.
Copie el código alfanumérico que aparecerá en pantalla.

4. Vinculación en Saturn Studio

Regrese al panel de Saturn Studio para finalizar la configuración:

Credential name: Asigne un nombre para identificar esta conexión (ej. Dropbox_Personal).
Access Token: Pegue el token generado en el paso anterior.
Conexión: Haga clic en el botón azul Connect to Dropbox.
Verificación: Si los permisos y el token son correctos, el botón cambiará a un estado verde con el mensaje “Connected ✓” y aparecerá el aviso: “Success! connected successfully.”.
Finalizar: Haga clic en Save credentials.

Saturn Studio — Credencial Nubox

Para integrar Nubox con Saturn Studio, es fundamental configurar correctamente las credenciales que permiten el acceso a la API de Integraciones. Este proceso asegura que el robot opere en el entorno adecuado (pruebas o producción) con los permisos de partner autorizados.

1. Ambientes y URLs Base (baseUrl)

Para el desarrollo de su automatización, dispondrá de dos ambientes principales. La baseUrl que utilice dependerá de la fase de su proyecto:

Ambiente de Certificación (Pruebas/UAT): Destinado exclusivamente a pruebas y validaciones durante la etapa de desarrollo. Permite realizar operaciones sin afectar datos reales.
- URL: Es entregada por el equipo de soporte al momento de solicitar las credenciales de prueba.
Ambiente Productivo: Entorno para operar con transacciones reales y clientes finales. Se debe utilizar únicamente cuando la integración haya sido completamente probada y certificada en UAT.
- URL: Entregada junto con las credenciales definitivas.

Saturn Studio — Credencial Nubox

Nubox es una plataforma de software basada en la nube que ofrece soluciones de contabilidad, facturación electrónica y gestión empresarial para pequeñas y medianas empresas en América Latina. Para integrar este servicio con Saturn Studio, es necesario configurar las credenciales correspondientes según el ambiente de trabajo (Pruebas o Productivo).

1. Ambientes y URLs Base (baseUrl)

La baseUrl a utilizar dependerá de la fase de su proyecto:

Ambiente de Certificación (Pruebas/UAT): Entorno destinado a validaciones durante el desarrollo donde se opera sin afectar datos reales.
- Disponibilidad: Lunes a viernes, de 11:00 AM GMT a 00:00 AM GMT.
- URL: Entregada por soporte técnico al solicitar las credenciales de prueba.
Ambiente Productivo: Entorno para transacciones reales y clientes finales.
- URL: Entregada una vez habilitada la cuenta productiva.

2. Obtención de Credenciales

Ambiente de Certificación (UAT)

Para obtener estas claves iniciales, siga estos pasos:

Envíe un correo a soporte@nubox.com.
Solicite las credenciales de la API de Integraciones para el ambiente de pruebas (UAT), indicando el nombre de su empresa y un contacto principal.
Recibirá el Token del Partner (Authorization), la API Key de la Empresa Cliente (X-Api-Key) y el Host/BaseUrl.

Ambiente Productivo

Una vez que el equipo de soporte habilite su cuenta y el acceso a la plataforma de Factura y Administración, proceda de la siguiente manera:

Acceso: Ingrese a su cuenta de Factura y Administración, haga clic en el icono del engranaje y entre al módulo de Integraciones & API.
Inicio: Haga clic en el botón “Iniciar” dentro de la sección de API.
Selección de integración: Elija una de las dos opciones disponibles:
- A través de partners: Si un tercero realiza su integración, seleccione “A través de una empresa asociada a Nubox”, elija al partner del listado y presione Generar Credenciales. Su partner podrá visualizar las claves automáticamente.
- Integración independiente: Si usará las credenciales por cuenta propia, seleccione “Directamente con Nubox (por mi cuenta, sin empresa asociada)” y presione Generar Credenciales.
Finalización: Tras el mensaje de éxito, las credenciales a utilizar se mostrarán en pantalla.

3. Configuración en Saturn Studio

Una vez recibida la información, complete el formulario de credenciales en Saturn Studio con los siguientes parámetros:

Parámetro	Descripción	Ejemplo
Base URL	La URL (Host) entregada por soporte para el ambiente correspondiente.	`[https://api.nubox.com/certificacion](https://api.nubox.com/certificacion)`
Token	El Token del Partner que lo identifica como integrador autorizado.	`Token_Secreto_Partner`
API Key	La X-Api-Key de la empresa cliente sobre la cual se realizarán las acciones.	`Clave_Empresa_Cliente`

Validación de conexión: Tras ingresar los datos, debe hacer clic en el botón “Check” para verificar que las claves y la URL son correctas antes de guardar la configuración.

Guia oficial de Nubox https://developers.nubox.com/api-docs

Saturn Studio — Google Books

Google Books es una aplicación de Google que permite el acceso a una biblioteca digital.

Para obtener las credenciales, haz clic aquí.

Descripción de los comandos

Obtener muchos volúmenes (Get Many Volumes)

Obtiene información sobre muchos libros en Google Books.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Google Books necesaria para buscar los libros.	My Google Books credentials
Consulta de búsqueda	Términos de búsqueda para encontrar los libros. Ejemplo: harry potter, intitle:harry potter, inauthor:rowling.	Search query
Límite	Número de libros a obtener.	20
Asignar resultado a variable	Variable donde se almacenará el resultado. Ejemplo [“items” {“id” “ASD123”, “title” “Harry Potter”, “authors” [“J.K. Rowling”], “publishedDate” “2020-01-01”, “publisher” “Bloomsbury”, “pageCount” 500, “categories” [“Fiction”], “language” “en”, “description” “A book about a young wizard.”, “averageRating” 4.5, “thumbnail” “http//[example.com/thumbnail.jpg](https://example.com/thumbnail.jpg)”, “infoLink” “http//[example.com/info](https://example.com/info)”, “previewLink” “http//[example.com/preview](https://example.com/preview)”].	{var}

Obtener un volumen (Get a Volume)

Obtiene información sobre un libro en Google Books.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Google Books necesaria para buscar los libros.	My Google Books credentials
ID del Volumen	Ingrese el ID del volumen.	Volume ID
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Saturn Studio — Credencial Google Books

Para integrar el módulo de Google Books con Saturn Studio, es necesario configurar una credencial de tipo OAuth 2.0 en la consola de Google Cloud. Este procedimiento permite que el robot acceda a la biblioteca digital y recupere información de volúmenes de forma autorizada.

Crear / elegir proyecto y habilitar APIs

Ingresa a Google Cloud Console.
Inicia sesión con tu cuenta de Google.
Crea un nuevo proyecto o selecciona uno existente desde la barra superior.

Habilitación de la API

Antes de configurar las credenciales, debe activar el acceso al servicio:

Diríjase a la biblioteca de APIs en la consola de Google Cloud.
Busque Books API y haga clic en Habilitar.
Este paso es obligatorio para que Google procese las solicitudes de búsqueda del robot.

Configuración de la Pantalla de consentimiento OAuth

Debe definir la identidad de su aplicación para permitir la vinculación con Saturn Studio.

En el menú lateral, entra a:
APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.

Completa los campos solicitados:
- Nombre de la aplicación
- Correo de soporte
- (Opcional) Logo, dominio, enlaces de privacidad y términos.
Elige el tipo de usuario según tu caso:

Tipo de usuario	Descripción	Recomendación
Interno	Solo usuarios de tu organización (requiere dominio Google Workspace).	Úsalo si tu equipo pertenece al mismo dominio.
Externo	Permite acceso a cualquier cuenta de Google (modo de prueba).	Ideal para uso personal o con cuentas @gmail.com.

Nota: en modo Externo (prueba) deberás agregar manualmente a los usuarios de prueba, incluido tu propio correo.
Solo esos usuarios podrán autorizar la app mientras esté en prueba.

Guarda los cambios al finalizar.

Configuración de Permisos (Scopes)

Durante la edición de la pantalla de consentimiento, debe añadir los permisos específicos para operar con la biblioteca digital:

Permiso (URL de Scope)	Función Técnica
`.../auth/books`	Permiso principal para gestionar y buscar en su biblioteca de Google Books.
`.../auth/userinfo.profile`	Acceso a la información básica del perfil del usuario.
`.../auth/userinfo.email`	Permite ver la dirección de correo electrónico asociada.
`openid`	Estándar necesario para la autenticación de identidad.

Creación del ID de cliente de OAuth

Una vez configurada la pantalla de consentimiento, genere los identificadores técnicos:

Vaya a la sección APIs y servicios > Credenciales.
Seleccione Crear credenciales > ID de cliente de OAuth.
Tipo de aplicación: Seleccione Aplicación web.
URIs de redireccionamiento autorizados: Ingrese la URL de su instancia de Saturn Studio (ejemplo: https://studio.rocketbot.com).

Parámetros para Saturn Studio

Copie los siguientes valores generados por Google en el formulario de credenciales de Saturn Studio:

Parámetro	Descripción
Client ID	Identificador público de su aplicación ante los servidores de Google.
Client Secret	Llave privada confidencial necesaria para validar la conexión.

Privacidad del Secreto: El Client Secret solo se muestra una vez al momento de la creación. Asegúrese de guardarlo en un lugar seguro o descargar el archivo JSON inmediatamente.

Saturn Studio — Credencial Google Translate

Para integrar Google Translate (Cloud Translation API) con Saturn Studio, es necesario configurar una credencial de tipo OAuth 2.0. Este procedimiento permite que su robot realice traducciones automáticas de texto de manera segura y autorizada.

Crear / elegir proyecto y habilitar APIs

Ingresa a Google Cloud Console.
Inicia sesión con tu cuenta de Google.
Crea un nuevo proyecto o selecciona uno existente desde la barra superior.

Habilitación de la API

El primer paso es activar el motor de traducción en su proyecto de Google Cloud:

Diríjase a la biblioteca de APIs en la consola de Google Cloud.
Busque Cloud Translation API y haga clic en Habilitar.
Sin esta activación, las solicitudes de traducción serán rechazadas por el servidor.

Configuración de la Pantalla de consentimiento OAuth

En el menú lateral, entra a:
APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.

Completa los campos solicitados:
- Nombre de la aplicación
- Correo de soporte
- (Opcional) Logo, dominio, enlaces de privacidad y términos.
Elige el tipo de usuario según tu caso:

Tipo de usuario	Descripción	Recomendación
Interno	Solo usuarios de tu organización (requiere dominio Google Workspace).	Úsalo si tu equipo pertenece al mismo dominio.
Externo	Permite acceso a cualquier cuenta de Google (modo de prueba).	Ideal para uso personal o con cuentas @gmail.com.

🔸 Nota: en modo Externo (prueba) deberás agregar manualmente a los usuarios de prueba, incluido tu propio correo.
Solo esos usuarios podrán autorizar la app mientras esté en prueba.

Guarda los cambios al finalizar.

Configuración de Permisos (Scopes)

Durante la edición de la pantalla de consentimiento, deberá agregar los permisos específicos para el servicio de traducción:

Permiso (URL de Scope)	Función Técnica
`.../auth/cloud-translation`	Permiso total para enviar textos a traducir y detectar idiomas.
`.../auth/cloud-platform`	Acceso genérico a los servicios de Google Cloud Platform.
`.../auth/userinfo.profile`	Acceso a la información básica del perfil.
`openid`	Necesario para validar la identidad mediante OAuth.

Creación del ID de cliente de OAuth

Una vez configurada la pantalla de consentimiento, genere las llaves de acceso:

Vaya a APIs y servicios > Credenciales.
Haga clic en Crear credenciales > ID de cliente de OAuth.
Tipo de aplicación: Elija Aplicación web.
URIs de redireccionamiento autorizados: Ingrese la URL de su instancia de Saturn Studio (ejemplo: https://studio.rocketbot.com/).

Parámetros para Saturn Studio

Copie y pegue los siguientes valores en el formulario de creación de credenciales dentro de Saturn Studio:

Parámetro	Descripción
Client ID	El identificador único de su aplicación cliente.
Client Secret	La llave secreta que autentica la comunicación entre servidores.

Seguridad de la Llave: El Client Secret es información sensible. No la comparta y asegúrese de copiarla inmediatamente, ya que por seguridad Google podría ocultarla tras cerrar el asistente de creación.

Saturn Studio — Credencial Google BigQuery

Para integrar Google BigQuery con Saturn Studio, es necesario configurar una credencial de tipo OAuth 2.0 en la consola de Google Cloud. Este proceso garantiza que el robot pueda ejecutar consultas e insertar datos de forma segura bajo una autorización controlada.

Crear / elegir proyecto y habilitar APIs

Ingresa a Google Cloud Console.
Inicia sesión con tu cuenta de Google.
Crea un nuevo proyecto o selecciona uno existente desde la barra superior.

Habilitación de la API

Antes de configurar la credencial, el servicio debe estar activo en su proyecto:

Acceda a la biblioteca de APIs en la consola de Google Cloud.
Busque y haga clic en Habilitar para la BigQuery API.

Configuración de la Pantalla de consentimiento OAuth

En el menú lateral, entra a:
APIs y servicios → Pantalla de consentimiento OAuth → Configurar pantalla de consentimiento.

Completa los campos solicitados:
- Nombre de la aplicación
- Correo de soporte
- (Opcional) Logo, dominio, enlaces de privacidad y términos.
Elige el tipo de usuario según tu caso:

Tipo de usuario	Descripción	Recomendación
Interno	Solo usuarios de tu organización (requiere dominio Google Workspace).	Úsalo si tu equipo pertenece al mismo dominio.
Externo	Permite acceso a cualquier cuenta de Google (modo de prueba).	Ideal para uso personal o con cuentas @gmail.com.

🔸 Nota: en modo Externo (prueba) deberás agregar manualmente a los usuarios de prueba, incluido tu propio correo.
Solo esos usuarios podrán autorizar la app mientras esté en prueba.

Guarda los cambios al finalizar.

Configuración de Permisos (Scopes)

Durante la configuración de la pantalla de consentimiento, deberá añadir los permisos específicos que requiere el robot para operar con BigQuery:

Permiso (URL de Scope)	Función Técnica
`.../auth/bigquery`	Permiso principal para ejecutar consultas y gestionar datos.
`.../auth/userinfo.profile`	Permite acceder al perfil básico del usuario.
`.../auth/userinfo.email`	Requerido para ver la dirección de correo asociada.
`openid`	Estándar de identidad para la autenticación OAuth.

Creación del ID de cliente de OAuth

Con la pantalla de consentimiento configurada, proceda a generar los identificadores:

Vaya a APIs y servicios > Credenciales.
Seleccione Crear credenciales > ID de cliente de OAuth.
Tipo de aplicación: Seleccione Aplicación web.
URIs de redireccionamiento autorizados: Ingrese la dirección de su instancia de Saturn Studio (ejemplo: https://studio.rocketbot.com).

Parámetros para Saturn Studio

Al finalizar, copie los siguientes valores en el formulario de credenciales dentro de Saturn Studio:

Parámetro	Descripción
Client ID	Identificador público de su proyecto en la red de Google.
Client Secret	Llave privada confidencial necesaria para validar la conexión.

Privacidad del Secreto: El Client Secret solo se muestra una vez al momento de la creación. Asegúrese de guardarlo en un lugar seguro o descargar el archivo JSON inmediatamente.

Saturn Studio — Nubox

Para obtener las credenciales, haz clic aquí.

Descripción de los comandos

Emitir Documentos de Venta (Issue Sales Documents)

Crea documentos de venta en Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para crear documentos de venta.	credential
Emitir documento	Cuerpo JSON para enviar.	[{…}]
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener una o más Ventas (Get one or more Sales)

Obtiene uno o más documentos de venta de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para obtener documentos de venta.	credential
Fecha de Inicio	Fecha de inicio y fin separada por comas para filtrar documentos de venta por fecha de creación (ej., 2025-01-01,2025-01-31).	start date
Fecha de Fin	Fecha de inicio y fin separada por comas para filtrar documentos de venta por fecha de creación (ej., 2025-01-01,2025-01-31).	end date
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener una Venta Específica (Get a Specific Sale)

Obtiene una venta específica de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para obtener una venta específica.	credential
ID de Venta	El identificador único de la venta a recuperar.	sale id
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener Detalles de Documento de Venta (Get Sales Document Details)

Obtiene los detalles de un documento de venta de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para obtener detalles del documento de venta.	credential
ID de Documento	El identificador único del documento de venta del cual se recuperarán los detalles.	Document id
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Obtener Documentos de Referencia (Get Reference Documents)

Obtiene documentos de referencia de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para obtener documentos de referencia.	credential
ID de Documento	El identificador único del documento de venta del cual se recuperarán los documentos de referencia.	Document id
Incluir No Contabilizables	Indica si se deben incluir documentos de referencia no contabilizables en los resultados.	Include Unaccountable
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Descargar PDF (Download PDF)

Descarga el archivo PDF de un documento de venta de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para descargar archivos PDF.	credential
ID de Documento	ID interno del documento en Nubox.	document id
Plantilla	Formato de la plantilla PDF.
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}

Descargar XML (Download XML)

Descarga el archivo XML de un documento de venta de Nubox.

Parámetros	Descripción	Ejemplo
Credencial	Credencial de Nubox necesaria para descargar archivos XML.	credential
ID de Documento	ID del documento de transacción de Nubox (parámetro de ruta).	document id
Accept	Formato de respuesta. application/xml devuelve XML; application/json devuelve XML en Base64 dentro de un JSON.
Asignar resultado a variable	Variable donde se almacenará el resultado.	{var}