Guía de configuración
Cómo crear tus credenciales API de Siigo Nube
Kontavyx necesita un Access Key de Siigo Nube para enviar tus facturas DIAN directamente al software. Esta guía te lleva en 5 pasos desde cero.
⚠️ Antes de empezar
- Necesitas una cuenta Siigo Nube activa (no funciona con Siigo Contador Plus ni versiones escritorio).
- Debes ingresar con el usuario administrador de la cuenta — sólo él puede generar credenciales API.
- El Access Key te lo muestran una sola vez. Cópialo apenas aparezca.
- 1
Ingresa a Siigo Nube con tu usuario administrador
Ve a siigonube.siigo.com y entra con el email y contraseña del administrador. Si eres contador trabajando con una empresa cliente, pídele acceso administrador temporal o que haga este proceso junto a ti. - 2
Abre el panel de configuración API
En Siigo Nube, haz clic en tu avatar (arriba a la derecha) → Configuración → Integraciones → API. Si no ves la opción "API", tu plan no la incluye — contacta a Siigo para activarla (está incluida en la mayoría de planes Nube). - 3
Crea un usuario de tipo API
Dentro del panel API, haz clic en "Crear usuario API". En el tipo de usuario, selecciona "API Partner" (es el que permite crear facturas de compra, proveedores y consultar el catálogo de impuestos — lo que Kontavyx necesita). Ponle un nombre descriptivo tipokontavyx-integracion. - 4
Guarda el Access Key apenas aparezca
Siigo te muestra el Access Key en pantalla una sola vez. Cópialo completo (incluyendo guiones y mayúsculas/minúsculas) y pégalo en un bloc de notas temporal. Si lo cierras sin copiar, tendrás que regenerarlo.Email API: kontavyx-integracion@tuempresa.com
Access Key: a1b2c3d4-5e6f-7890-abcd-ef1234567890 - 5
Pégalo en el wizard de Kontavyx
Al abrir Kontavyx por primera vez aparecerá el asistente. En el paso "Agrega tu empresa":- Nombre: como quieras identificar la empresa en Kontavyx (ej. "Ferretería López").
- Email Siigo: el email del usuario API que creaste en el paso 3.
- Access Key: el string que copiaste en el paso 4.
Problemas frecuentes
- "Your Siigo Nube product is in read-only mode"
- Tu cuenta Siigo está en modo lectura (trial vencido, pago pendiente o bloqueo administrativo). Contacta a Siigo para reactivarla — Kontavyx no puede crear nada hasta que se libere.
- "No veo la opción API en Configuración"
- El plan que tienes no incluye la integración API. Llama a Siigo y pide activarla — suele estar en Siigo Nube Premium y superiores.
- "Perdí el Access Key"
- Vuelve al panel API, elimina el usuario API anterior y crea uno nuevo. El Access Key sólo se muestra una vez en el momento de la creación.
- "Invalid credentials" al probar en Kontavyx
- Verifica que el email sea el del usuario API (no tu email de login personal) y que el Access Key no tenga espacios al inicio o al final. Siigo distingue mayúsculas.
¿Sigues atascado? Escríbenos en el formulario de contacto y te ayudamos.