Los datos de conexión, uno por uno
Para conectar Aski hacen falta cuatro datos del ERP. Tres son siempre los mismos —Base de datos, Usuario / login y API Key— y es donde suele atascarse todo el mundo, porque cada ERP los llama distinto y los guarda en sitio distinto.
Busca abajo la sección de tu ERP. Si tu instalación no sale a internet, esta guía es el complemento de aski.dev/guia-tunel, que explica la parte de red.
Odoo
URL
La misma dirección con la que entras a Odoo desde el navegador, sin nada después del dominio:
https://miempresa.odoo.com (Odoo online / Odoo.sh) https://erp.miempresa.com (instalación propia publicada) http://192.168.1.20:8069 (instalación interna, con túnel)
Si tu Odoo escucha en un puerto distinto del estándar, añádelo. El habitual es 8069.
Base de datos
Odoo puede servir varias bases desde la misma dirección, por eso hay que decir cuál. Dónde verla, por orden de facilidad:
- En la propia URL cuando entras: si ves
?db=miempresao/web?db=miempresa, ese es el nombre. - En Ajustes → Información general, o abajo del todo de esa página, donde Odoo muestra su versión y la base activa.
- Si tu Odoo te muestra un selector de bases al entrar, el nombre es el que eliges en esa lista.
- En una instalación propia, es el nombre que se puso al crearla. Quien administre el servidor lo sabe.
En Odoo online suele coincidir con el subdominio: si entras por
miempresa.odoo.com, la base casi siempre se llama miempresa.
Usuario / login
El correo con el que esa persona entra a Odoo. No el nombre para mostrar, el correo del login. Se ve en Ajustes → Usuarios, columna «Login».
Importante. Cada persona pone el suyo, no uno compartido. Aski consulta con ese usuario, así que verá exactamente lo que esa persona ve en Odoo — ni un registro más. Con un usuario compartido, todos verían lo mismo y se perdería esa garantía.
API Key
No es la contraseña de Odoo: es una clave aparte que Odoo genera, y que se puede revocar sin cambiar la contraseña. Cómo generarla:
- Entra a Odoo con el usuario que va a usar Aski (cada uno genera la suya).
- Arriba a la derecha, pulsa tu nombre → Mi perfil (o «Preferencias»).
- Pestaña Seguridad de la cuenta.
- Botón Nueva clave de API. Te pedirá tu contraseña para confirmar.
- Ponle un nombre que después reconozcas —«Aski»— y elige la caducidad. Si eliges una fecha, tendrás que renovarla ese día.
- Cópiala en ese momento. Odoo la muestra una sola vez; si cierras la ventana hay que generar otra.
En Odoo 14 y 15 la opción está en el mismo sitio pero la pestaña puede llamarse «Seguridad». Si no la ves, tu usuario necesita tener activado el modo desarrollador o permisos suficientes; que lo mire quien administre el sistema.
Importante. Si tu Odoo tiene autenticación en dos pasos, la API Key es obligatoria: la contraseña sola no sirve.
Los permisos que hacen falta
Ninguno especial: los que ya tenga esa persona. Aski solo lee, así que si el usuario puede ver facturas en Odoo, Aski podrá responder sobre facturas; si no puede ver costos, Aski tampoco los verá.
SAP Business One
Aski se conecta al Service Layer, la interfaz que trae Business One para integraciones. Si no está activo, que lo habilite quien lleve el SAP.
URL
La dirección del Service Layer, con puerto y con la parte final:
https://srv-sap:50000/b1s/v1 (interno, con túnel) https://sap.miempresa.com:50000/b1s/v1 (publicado)
El puerto 50000 es el estándar del Service Layer. La parte /b1s/v1 es
obligatoria: sin ella la conexión no funciona.
Si tu Service Layer usa un certificado autofirmado —lo habitual en instalaciones internas—, avísanos al conectar.
Base de datos
Es la Company DB: el nombre técnico de la base de la empresa, no el nombre comercial.
Suele empezar por SBO_:
SBO_MiEmpresa SBO_PROD MIEMPRESA_PROD
Dónde verlo: al entrar a Business One, en la pantalla de selección de empresa, columna «Base de datos». O en el propio cliente, en Ayuda → Acerca de.
Usuario / login
El usuario de Business One, el mismo con el que esa persona entra al cliente de SAP:
manager, jperez, etc.
Importante. Que sea un usuario de solo lectura, o el de esa persona. Aski solo consulta por defecto, pero cuanto menos permisos tenga el usuario, menos hay que confiar en nuestra palabra.
API Key
En Business One no hay claves de API: aquí va la contraseña de ese usuario de SAP. El campo se llama API Key porque es el mismo formulario para los tres ERP.
Se guarda cifrada y no se muestra nunca más, ni en la app ni en el panel de administración.
Query Manager y cubos
El Query Manager no pide nada aparte: Aski lee las consultas guardadas con este mismo usuario y las recalcula con tus datos. Si ese usuario no ve el Query Manager en SAP, Aski tampoco.
Los cubos —las vistas analíticas de SAP HANA— sí hay que publicarlos, porque Business One no expone ninguno de fábrica. Solo existen en Business One sobre HANA:
- En el cliente de Business One, con un superusuario, abre SAP HANA Model Management.
- Marca «Service Layer Expose» en los cubos que quieras consultar desde Aski.
- Reinicia el Service Layer.
Si el usuario de la conexión no es superusuario, necesita además permiso para esas vistas en sus autorizaciones generales. Los cubos propios que armó tu partner se publican igual, pero antes hay que empaquetarlos con la opción para el Service Layer activada. Aski revisa la lista de cubos cada media hora; para ver qué encuentra, pregúntale «¿qué cubos tengo?».
SAP S/4HANA
URL
La base de los servicios OData de tu tenant:
https://mi-tenant.s4hana.ondemand.com/sap/opu/odata/sap https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap
Base de datos
No aplica. En S/4HANA este campo no aparece en el formulario.
Usuario / login
Opcional, y define cómo se autentica. Si lo rellenas, se usa usuario y contraseña contra tu tenant real. Si lo dejas vacío, se usa solo la API Key (el modo del sandbox del API Business Hub).
API Key
La API Key de tu instancia, o la del SAP API Business Hub si estás probando contra el sandbox. En un tenant real, la contraseña del usuario del paso anterior.
Cosas que valen para los tres
Qué pasa con esos datos
- La clave se cifra antes de guardarse, y no se muestra nunca más.
- No aparece en la app, ni en la API, ni en el panel de administración, ni en los registros.
- Aski solo lee por defecto. Escribir requiere activar las acciones con confirmación, que solo existen en los planes altos y nunca corren sin que el usuario las apruebe.
- Cortar el acceso no depende de nosotros: deshabilita ese usuario o revoca la clave en tu ERP y se acabó, al instante.
El detalle completo está en aski.dev/seguridad.
Si la prueba de conexión falla
- «Credenciales inválidas» → revisa el usuario y la clave. En Odoo, comprueba que copiaste la API Key entera; suele ser larga.
- «Base de datos no encontrada» → el nombre no coincide. En Odoo, míralo en la URL al entrar; en Business One, en la pantalla de selección de empresa.
- «No se pudo alcanzar el servidor» → no es cosa de las credenciales, es de red. Si tu ERP no sale a internet, mira aski.dev/guia-tunel.
- Conecta pero responde que no tiene acceso a algo → es correcto: ese usuario no tiene ese permiso en el ERP. Se arregla en el ERP, no aquí.