Foccuz Integration API
  1. Buk
Foccuz Integration API
  • API externa
    • Comenzando con Foccuz Integration API
    • Autenticación vía API Key
    • Límite de uso (Rate Limiting) y Restricciones de tamaño (Body Size Limiting)
    • Colaboradores con Compensaciones Variables (Usuario/Colaborador)
    • Empresas (Clientes/Cuentas/Compañías)
    • Negocio (Operación, Venta, Cobranza, Acción clave)
    • Actividad (Acción, Productividad, Indicador)
    • Campos personalizados
    • Orden de ejecucción
    • Consideraciones
    • Flujos de ejemplo
    • Manejo de errores
    • v2
      • integration
        • deals
          • /v2/integration/deals
          • /v2/integration/deals
        • activities
          • /v2/integration/activities
          • /v2/integration/activities
        • account
          • /v2/integration/account
          • /v2/integration/account
        • sales-profile
          • /v2/integration/sales-profile
          • /v2/integration/sales-profile
  • Integraciones
    • Buk
      • Conectarse con Buk
  1. Buk

Conectarse con Buk

Guía de Integración con Buk#

Requisitos Previos#

Desde Buk#

Tener una cuenta activa en Buk
Generar una clave API con permisos de lectura y escritura al menos para empleados, inasistencias, licencias y liquidaciones.
Conocer la URL exacta de tu instancia de Buk. Formato de la url: https://tu-empresa.buk.cl/api/v1/chile

Configuración en Foccuz#

Paso 1: Acceder a las Integraciones#

1.
Dentro de Foccuz, ir a Ajustes → Integraciones en la barra lateral.
2.
Buscar la tarjeta de Buk entre las integraciones disponibles.

Paso 2: Iniciar la Configuración#

1.
Hacer clic en el botón "Vincular cuenta" en la tarjeta de Buk.
2.
Se abrirá un modal de configuración con dos campos requeridos.
Hacer clic en el enlace "¿Necesitas más ayuda?" en el mismo modal te redireccionará a esta misma pagina.

Paso 3: Completar la Información de Conexión#

1.
URL de Buk: Ingresar la URL de tu instancia de Buk
Debe tener el formato: https://tu-empresa.buk.cl
La URL debe contener obligatoriamente buk.cl
Mínimo 10 caracteres
2.
Clave API: Ingresar tu clave API de Buk
Mínimo 8 caracteres
Se mostrará como campo de contraseña por seguridad

Paso 4: Validar y Guardar#

1.
Hacer clic en "Guardar" para validar las credenciales.
2.
Foccuz verificará automáticamente la conexión con la API de Buk.
3.
Si las credenciales son correctas, la integración se configurará exitosamente.

Paso 5: Confirmación#

1.
La página se actualizará automáticamente.
2.
La tarjeta de Buk mostrará el estado "Conectado".
3.
Aparecerán nuevas opciones como "Ver" para gestionar la integración.

Solución de Problemas#

Error de Credenciales Inválidas#

Si aparece el mensaje "La API key o la URL son incorrectas":
Verificar que la URL tenga el formato correcto (https://tu-empresa.buk.cl/api/v1/chile)
Confirmar que la clave API esté activa y tenga los permisos necesarios.
Intentar nuevamente con las credenciales corregidas.

Ayuda Adicional#

Si aun no ha generado su clave de API en Buk o no sabe como hacerlo, le recomendamos leer la documentación oficial de Buk haciendo click aquí.
Una vez completada la integración, Foccuz podrá sincronizar la información de empleados desde Buk para usar en los cálculos de comisiones y métricas.
Modificado en 2025-10-24 13:52:57
Anterior
/v2/integration/sales-profile
Built with