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