Giro se conecta a Odoo por su API externa (JSON-RPC) con una clave API de un usuario. Necesita cuatro datos: URL de la instancia, Base de datos, Usuario (email) y API key.

Antes de empezar

Permisos

• Un usuario interno de Odoo con permisos de Contabilidad (por ejemplo Facturación/Contabilidad: Administrador) y, si Giro registrará compras o recepciones, también de Compras e Inventario.
• En Giro, ser dueño o administrador de la empresa.

Plan o edición

• Su plan o edición de Odoo debe permitir la API externa. En Odoo Online eso suele requerir el plan Personalizado; en Odoo.sh o una instalación propia está disponible.
• La instancia debe estar en internet con https (por ejemplo https://miempresa.odoo.com). Giro no se conecta a direcciones locales.

Qué podrá hacer Giro

• Lee: plan contable, diarios, impuestos, contactos, productos, facturas, pagos, órdenes de compra y recepciones.
• Escribe: solo lo que usted aprueba en una tarjeta (por ejemplo facturas de proveedor, pagos, asientos, órdenes de compra o recepciones). Giro no publica ni contabiliza por su cuenta.

Paso a paso

1. Entre a Odoo con el usuario que usará Giro. Use un usuario con los permisos de arriba. La clave API queda ligada a ese usuario.
2. Cree la clave API. Su nombre (arriba a la derecha) → Preferencias → Seguridad de la cuenta → Nueva clave API Abra su perfil y genere una clave nueva. Póngale un nombre como «Giro», confirme su contraseña y copie la clave: Odoo la muestra una sola vez.
3. Copie la URL de la instancia. Es la dirección con la que entra a Odoo, solo hasta el dominio. Por ejemplo https://miempresa.odoo.com (sin /odoo ni /web al final).
4. Anote el nombre de la base de datos. En Odoo Online suele ser la primera parte del dominio (miempresa en miempresa.odoo.com). En Odoo.sh o en un servidor propio, lo tiene el administrador de Odoo.
5. Complete el formulario y pulse «Validar y conectar». Usuario (email) es el correo con el que entra a Odoo, no su nombre. Giro inicia sesión una vez con la clave API para comprobarla y, si Odoo la acepta, guarda la conexión.

Qué pide Giro

URL de la instancia

La dirección de su Odoo con https, solo el dominio.

Base de datos

El nombre de la base de datos de Odoo.

Usuario (email)

El correo con el que ese usuario entra a Odoo.

API key

La clave creada en Preferencias → Seguridad de la cuenta.

Errores comunes

• «Faltan datos: URL, base de datos, usuario y API key son obligatorios» Complete los cuatro campos.
• «La URL de Odoo debe usar https://» Escriba la dirección con https://. Giro no envía la clave API por una conexión sin cifrar.
• «La URL de Odoo debe ser un dominio público» Use la dirección pública de Odoo (por ejemplo https://miempresa.odoo.com), no localhost ni una IP interna.
• «La URL de Odoo no es válida / no debe incluir usuario ni contraseña» Escriba solo la dirección, sin usuario, contraseña ni espacios.
• «Odoo: credenciales inválidas (verifique base de datos, usuario y API key)» Revise que el usuario sea el correo de entrada, que la base de datos sea la correcta y que pegó la clave API (no la contraseña). Si todo está bien, puede que su plan de Odoo no permita la API externa.
• «Odoo HTTP 404» La URL no apunta a la raíz de Odoo. Quite lo que haya después del dominio.
• «Odoo: … database … does not exist» El nombre de la base de datos no existe en esa instancia. Revíselo con el administrador de Odoo.
• «Odoo HTTP 429» Odoo pidió esperar por exceso de peticiones. Espere un minuto y vuelva a intentar.
• «ODOO_TRANSPORT_TIMEOUT» Odoo no respondió a tiempo. Revise que la instancia esté en línea y vuelva a intentar.
• «forbidden» Su usuario de Giro no es dueño ni administrador de esta empresa. Pida al dueño que conecte o que le dé el rol de administrador.

Seguridad

• Giro guarda la credencial cifrada (AES-GCM, con una clave del servidor que no está en la base de datos) y nunca la vuelve a mostrar en pantalla.
• Solo el dueño o un administrador de la empresa en Giro puede conectar o cambiar la conexión.
• Giro pide solo lo necesario para leer y registrar. Nada se escribe sin una tarjeta que usted aprueba.
• Giro usa una clave API, no su contraseña de Odoo. La clave tiene los permisos de su usuario: un usuario con menos permisos limita lo que Giro puede hacer.

Cómo quitarle el acceso a Giro

• En Odoo: Preferencias → Seguridad de la cuenta → borre la clave «Giro». Giro deja de tener acceso al instante.
• En Giro: Mis empresas → Eliminar la empresa borra la conexión guardada.