Generar las credenciales API es un proceso que permite obtener los datos necesarios para autenticar y conectar aplicaciones externas con Siigo Nube a través de la Interfaz de Programación de Aplicaciones (API). Este procedimiento es fundamental para habilitar integraciones seguras y controladas, ya que define las credenciales que identifican y autorizan el acceso a los servicios disponibles.
Se utiliza al iniciar o actualizar una integración, y resulta clave para garantizar una comunicación confiable entre los sistemas y la correcta automatización de los procesos en la operación diaria.
A continuación, sigue estos pasos:
1. Accede mediante una de las siguientes rutas:
- Dirígete al ícono de Configuración
, selecciona Alianzas e integraciones y en la sección Configuraciones e integraciones, haz clic en la opción Credenciales de integración a plataformas digitales (Siigo API).
- Ve al módulo de Alianzas y presiona el botón Mi credencial API
.
Importante: las credenciales solo pueden ser generadas por usuarios con rol de administrador.
2. Digita los datos de contacto de la persona que desarrollará la integración, como nombre, correo electrónico y teléfono, para mantenerla actualizada sobre noticias, cambios o mejoras.
3. Haz clic en el botón Añadir aplicación 
para registrar las aplicaciones que vas a integrar con Siigo Nube y completa los siguientes datos:
- Tipo de aplicación: selecciona el escenario de integración que vas a configurar:
- Ecommerce
- POS
- CRM / Cartera
- Pasarela de pagos
- Inventarios / Logística
- Auditoría contable
- Facturación electrónica
- Analítica de datos / BI
- Gestión de compras / Gastos
- Desarrollo propio
Importante: si eliges la opción «Desarrollo propio», se habilitará el campo «Subcategoría» para que indiques el objetivo de la integración, por ejemplo: - Gestión de inventarios
- Gestión de clientes
- Facturación de ventas
- Registro y gestión de compras
- Registro de ingresos y egresos
- Registro de otros movimientos contables
- Reportes financieros y contables
- Nombre de la aplicación: diligencia el nombre de la aplicación que vas a integrar. Te aparecerá un listado de aplicaciones reconocidas basado en las integraciones de todos los usuarios.
Si la aplicación que deseas integrar no está en dicho listado, puedes seleccionar + Crear nombre de aplicación y el sistema habilitará una ventana donde ingresarás el nombre y presionarás Guardar cambios 
.
Al crear un nuevo nombre de aplicación, el sistema utilizará un servicio de Inteligencia Artificial (IA) para:
- Comparar el nombre ingresado con el catálogo de aplicaciones conocidas: si la similitud es mayor al 80%, se asigna automáticamente el Partner-Id correspondiente.
- Detectar entradas inválidas como: 12345, prueba, nada, app interna, sandbox, entre otros.
- Si el dato es clasificado como inválido: se bloqueará la generación del Partner-Id y solicitará ingresar un nombre real de aplicación.
- Si el dato es clasificado como válido: se creará la aplicación y se asignará el Partner-Id correspondiente, se añadirá al listado de aplicaciones reconocidas y se generarán las credenciales para el uso de Siigo API.
Importante:
- Podrás registrar un máximo 5 aplicaciones.
- El Partner-Id asignado es el que se debe enviar en el header “Partner-Id” en todos los requests enviados a Siigo API.
4. Una vez completes los datos, selecciona el botón Guardar cambios y visualizarás las credenciales.
Podrás cambiar los datos de contacto y desde la opción Restablecer credenciales, generar un nuevo Access Key para autenticarte, pero no podrás modificar el usuario API.
Importante: a partir del 31 de mayo, Siigo API solo aceptará Partner-Id que estén asociados a aplicaciones registradas.
¡Bien hecho! Ahora ya sabes cómo generar las credenciales API en tu Siigo Nube.
