Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payana.la/llms.txt

Use this file to discover all available pages before exploring further.

Guía paso a paso para obtener las credenciales necesarias para conectar Payana con tu instancia de Odoo 19 u Odoo.sh. Los mismos datos sirven para ambas plataformas.

​
1. Obtener la URL de la instancia

La URL es la dirección base de tu Odoo (sin barra final).
Tipo de instanciaEjemplo de URL
Odoo.com (SaaS)https://tuempresa.odoo.com
Odoo.sh (producción)https://tu-proyecto.odoo.com o la URL que te asigna Odoo.sh
Odoo.sh (staging/desarrollo)https://tu-proyecto-12345.dev.odoo.com (o similar)
Self-hostedhttps://odoo.tudominio.com
  1. Abre tu Odoo en el navegador e inicia sesión.
  2. Copia la URL de la barra de direcciones hasta el dominio (no incluyas /web, /web/login ni parámetros).
  3. No dejes una barra final: usa https://tuempresa.odoo.com, no https://tuempresa.odoo.com/.
En Odoo.sh, la URL exacta aparece en el panel del proyecto (pestaña de la rama: producción, staging, etc.). Usa la URL del entorno que quieras conectar a Payana.

​
2. Obtener el User ID

El User ID es el identificador numérico del usuario con el que Payana se conectará a la API (por ejemplo 2 para el usuario administrador).
  1. Ve a Ajustes (engranaje) > Usuarios y empresas > Usuarios (o Settings > Users & Companies > Users).
  2. Haz clic en el usuario que usará la integración (recomendado: un usuario dedicado o el administrador).
  3. Mira la barra de direcciones del navegador: verás algo como ...?model=res.users&id=2 o ...#id=2&model=res.users.
  4. El número que aparece en id= es el User ID (ej. 2, 5). Anótalo.
Es buena práctica crear un usuario dedicado para la integración (ej. [email protected]) en lugar de usar una cuenta personal. Así evitas revocar acceso si esa persona deja la empresa.

​
3. Crear y copiar la API Key

La API Key sustituye a la contraseña para las llamadas a la API. Solo se muestra una vez al crearla.
  1. Haz clic en tu avatar (esquina superior derecha) y abre Preferencias (o My Profile / Preferences).
  2. Ve a la pestaña Seguridad de la cuenta (o Account Security).
  3. En la sección Claves API (o API Keys), haz clic en Nueva clave API (New API Key).
  4. Escribe una descripción (ej. Integración Payana) y haz clic en Generar (Generate).
  5. Copia de inmediato la clave que se muestra y guárdala en un lugar seguro.
La API Key solo se muestra una vez. Si la cierras o la pierdes, tendrás que crear una nueva clave; la anterior no se puede recuperar.

​
4. Nombre de base de datos (db_name) — si aplica

En muchas instancias Odoo.com y Odoo.sh con una sola base de datos, el db_name no es necesario y Payana puede omitirlo. En instalaciones self-hosted o con varias bases de datos suele ser obligatorio.
Escenario¿Necesitas db_name?Dónde verlo
Odoo.com / Odoo.sh (una sola base)A menudo no—
Odoo.sh (si te lo pide la integración)SíPanel del proyecto en Odoo.sh; suele coincidir con el nombre del proyecto o la URL
Self-hostedSíPantalla de login (selector de base de datos) o en la URL (parámetro ?db=nombre)
Si tu pantalla de login no muestra selector de base de datos, normalmente puedes dejar db_name vacío o indicar a Payana que no lo uses.

​
5. Resumen de valores para compartir con Payana

CampoDónde obtenerlo
urlURL base de la instancia (sin /web ni barra final). Ej.: https://tuempresa.odoo.com
api_keyPreferencias > Seguridad de la cuenta > Nueva clave API (copiar al generarla)
user_idAjustes > Usuarios > [usuario] → número en la URL (id=X)
db_nameSolo si aplica: panel Odoo.sh, selector de BD en login o parámetro db= en la URL. Si no hay varias BD, puede dejarse vacío.
Comparte estos valores por un canal seguro

​
6. Lista de verificación

  • Tienes la URL de la instancia (sin barra final).
  • Tienes el User ID del usuario que usará la integración.
  • Has creado una API Key y la has copiado y guardado.
  • Sabes si necesitas db_name (self-hosted o varias BD) o puedes dejarlo vacío.
  • Has compartido de forma segura los valores (url, api_key, user_id y db_name si aplica) con Payana.
  • Conexión validada con una solicitud de prueba (sección 7).

​
7. Validar la conexión (Opcional)

Una vez que tengas las credenciales, haz una llamada de prueba para confirmar que la API Key y el User ID funcionan correctamente.

​
Con Postman (recomendado)

1

Crear una solicitud GET

Usa la siguiente URL, reemplazando TU_INSTANCIA por tu dominio y TU_USER_ID por el número obtenido en el paso 2:
https://TU_INSTANCIA.odoo.com/api/res.users/TU_USER_ID?fields=name,login
Ejemplo: https://miempresa.odoo.com/api/res.users/2?fields=name,login
2

Configurar autenticación

En la pestaña Authorization:
CampoValor
TypeBearer Token
TokenTu API Key
3

Enviar la solicitud

Haz clic en Send.

​
Respuesta esperada

Una respuesta 200 OK con los datos del usuario confirma que la API Key y el User ID son válidos:
{
  "id": 2,
  "name": "Administrador",
  "login": "admin"
}

​
Errores comunes

CódigoSignificadoQué revisar
401API Key inválida o expiradaVerifica que copiaste la clave completa y que no ha sido eliminada en Preferencias > Seguridad de la cuenta.
403Acceso denegadoEl usuario no tiene permisos para leer su propio registro. Confirma que el usuario está activo.
404URL o User ID incorrectosRevisa que la URL base sea correcta (sin /web) y que el User ID exista en esa instancia.
Copia el siguiente comando, reemplaza los tres valores al inicio y pégalo en una terminal (macOS, Linux o Windows con WSL/Git Bash):
# ── Credenciales (reemplaza estos valores) ──
ODOO_URL="https://tuempresa.odoo.com"
API_KEY="TU_API_KEY"
USER_ID="2"

# ── Ejecutar solicitud ──
curl -s -X GET "${ODOO_URL}/api/res.users/${USER_ID}?fields=name,login" \
  -H "Authorization: Bearer ${API_KEY}" \
  -H "Content-Type: application/json" | python3 -m json.tool
Una respuesta con "id", "name" y "login" confirma que las credenciales son correctas.