KontavyxKontavyx
← Volver a Kontavyx

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

  1. 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. 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. 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 tipo kontavyx-integracion.
  4. 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. 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.
    Listo — Kontavyx queda conectado a tu Siigo Nube.

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.