Instalación

Esta sección describe los pasos necesarios para descargar, instalar y vincular WillyPOS en tu equipo local (Windows, Linux o macOS). Por favor, sigue estas instrucciones minuciosamente para asegurar una conexión segura con tu infraestructura de datos.

Requisitos Previos

Antes de comenzar el proceso, asegúrate de cumplir con el siguiente requisito:

• Plan Activo: Es estrictamente necesario contar con un plan contratado y vigente con WillyLabs. Si aún no dispones de un plan o necesitas verificar su estado, ponte en contacto con nuestro equipo comercial.

Paso 1: Descarga del Software

La plataforma de WillyPOS se distribuye de manera centralizada a través de nuestra red de entrega de contenido.

1. Abre tu navegador web e ingresa a la siguiente dirección de descarga: https://cdn.willylabs.cl/willypos/downloads
   • Para Windows: https://cdn.willylabs.cl/pos/downloads/windows/latest
   • Para Linux: https://cdn.willylabs.cl/pos/downloads/linux/latest
   • Para macOS: https://cdn.willylabs.cl/pos/downloads/macos/latest
2. El sistema te solicitará autenticación. Ingresa el nombre de usuario y contraseña de tu cuenta root (raíz) provistos al momento de la contratación de tu plan.
3. Selecciona y descarga la versión correspondiente al sistema operativo de tu terminal de cobro (Windows, Linux o macOS).

Flujo de la descarga de WillyPOS

Paso 2: Generación de Credenciales de Acceso

Por motivos de seguridad y soberanía de datos, las claves de comunicación no vienen preconfiguradas en el instalador. Debes generar tu propio par de claves criptográficas desde la consola de administración.

📝 NOTA:
WillyPOS es un software diseñado exclusivamente para efectuar ventas en el local comercial y opera 100% sincronizado con la nube de WillyLabs. En WillyPOS no se configuran productos, catálogos, precios ni accesos de usuarios; toda la gestión se realiza directamente en WillyDashboard a través de sus servicios dedicados: GCP (Gestor de Catálogos de Productos) para la administración de inventario y categorías; IAM (Identity and Access Management) para el control de accesos de cajeros o administradores; y STS (Security Token Service) para la autenticación y conexión segura del terminal con la nube.

1. Ingresa al panel de administración central en: https://dashboard.willylabs.cl
2. Inicia sesión con tus credenciales autorizadas.
3. Dirígete a la sección IAM (Identity and Access Management), entra a gestión de terminales/accesos y selecciona Crear nuevo punto de acceso.
4. Dele un nombre y una descripción, seleccione el local comercial en el cuál estará operativo WillyPOS y haga clic en Registrar.
5. El sistema procesará la solicitud y compilará un archivo con extensión .yaml

   NOTA:
   Para su conveniencia puede seleccionar otro tipo de formato para el archivo de configuración, puede elegir entre yaml, json y xml.

Para información detallada sobre la creación de credenciales de seguridad STS, revisa Cómo crear llaves de seguridad STS en la Guía del Usuario de IAM.

Paso 3: Configuración e Inicialización

Para que el software local pueda comunicarse de forma legítima con los servicios centrales, es necesario enlazar el archivo de credenciales generado.

1. Una vez finalizada la instalación de WillyPOS en tu equipo, localiza la carpeta de configuración de la aplicación (la ruta exacta dependerá de las directrices de tu sistema operativo).
2. Copia el archivo .yaml descargado en el Paso 2 directamente dentro de dicha carpeta de configuración.

¿Por qué es necesario este archivo?

Este archivo contiene los parámetros necesarios para que la aplicación WillyPOS pueda firmar correctamente cada llamada a la API. Gracias a este mecanismo de firma digital, el terminal local establece un canal de comunicación blindado para conectarse de manera nativa con tu nube privada en WillyHUB Data360, permitiendo la descarga inmediata de productos, categorías, precios y la sincronización transparente de tus ventas.

Archivo .yaml de configuración:. El archivo de configuración tendrá un aspecto similar a este:

credentials:
  - account_id: wl-25-willy # ID de cuenta de su cuenta WillyLabs
  - access_key: abdefg...     # El ID único se de la llave para su WillyPOS
  - secret_key: Azb1zz...    # Secreto de la llave de su WillyPOS. Esta clave no debe compartirla con nadie nunca.
config:
   - sync_interval: 10m

{
    "credentials": {
        "account_id": "wl-25-willy",
        "access_key": "abdefg...",
        "secret_key": "Azb1zz..."
    },
    "config": {
         "sync_interval": "10m"
     }
}

<xml>
    <credentials>
        <account_id>wl-25-willy</account_id>
        <access_key>wabdefg...</access_key>
        <secret_key>Azb1zz...</secret_key>
    </credentials>
    <config>
        <sync_interval>10m</sync_interval>
     </config>
</xml>

Recomendación de seguridad para el archivo de configuración

Le recomendamos no usar el archivo de configuración descrgado, en su lugar copie las credenciales como variables de entorno en su dispositivo si sabe cómo o tiene los conocimientos adecuados para hacerlo. En el caso de no contar con dichos conocimientos, es preferible que no lo haga.

# Windows PowerShell
$env:account_id= "wl-25-willy"

# macOS y Linux
export account_id="wl-25-willy"

# El SDK de WillyLabs le ofrece una manera sencilla y efectiva de guradar variables de entorno
import willylabs.helpers as helpers

try:
     helpers.addVenv(key="account_id", value="wl-25-willy")
     print("Guardado")
except WillyLabsCloudExceptions as e:
     print( f"Algo salió mal: {e}" )