Processing / Odoo 19 Repositorio

Guía de instalación

De Odoo limpio a tu primera factura de prueba.

Instala AI Processing, conecta el servicio que prefieras y comprueba el resultado con una factura conocida antes de abrir el correo real.

Empezar instalación

01 · Requisitos

Prepara el terreno.

02 · Instalación

Seis pasos. Una prueba controlada.

Si Odoo está gestionado por otra persona, comparte esta página con ella y continúa desde el paso 4 cuando el módulo ya aparezca instalado.

  1. 01

    Obtén el módulo

    Descarga el repositorio y localiza addons/ai_processing. Si utilizas el despliegue completo del proyecto, esa carpeta ya está incluida.

    Abrir repositorio
  2. 02

    Añádelo a Odoo

    Coloca la carpeta ai_processing dentro de una ruta de complementos de Odoo. El servidor necesita también las librerías de lectura de PDF y cifrado declaradas por el módulo. 

    python3 -m pip install requests pypdf pypdfium2 cryptography

    En Docker, Coolify o un servicio gestionado, añade estas dependencias a la imagen; no las instales manualmente en cada reinicio.

  3. 03

    Instala AI Processing

    Reinicia Odoo, actualiza la lista de aplicaciones y busca AI Processing. Pulsa Activar. El módulo instala sus menús, permisos y tareas de procesamiento.

    Aplicaciones → Actualizar lista → AI Processing → Activar

  4. 04

    Conecta tu servicio

    Entra en la configuración guiada, elige OpenAI, OpenRouter, Ollama o tu servidor, y añade la clave de forma segura. Después, lee los modelos y selecciona una opción principal y otra de respaldo.

    Contabilidad → AI Processing → Configuración

    Evita el error más común

    En “nombre de variable de entorno” escribe algo como OLLAMA_API_KEY, nunca la clave completa. Si quieres pegar la clave, utiliza el campo protegido destinado a ella.

  5. 05

    Decide qué puede entrar

    Indica los dominios remitentes aceptados, el máximo de correos por minuto y cuántos adjuntos puede llevar cada mensaje. Configura también el dominio de alias de Odoo para obtener la dirección de entrada.

    Empieza con un dominio propio y un volumen bajo. Amplíalo cuando el equipo haya validado el recorrido.

  6. 06

    Haz una prueba conocida

    Envía una factura ya comprobada. Revisa que aparezcan el correo, el PDF correcto, el proveedor, los conceptos y el total. Aplica la propuesta al borrador solo cuando coincida con el documento.

    • El proveedor coincide por NIF o VAT.
    • Los conceptos permanecen separados.
    • Base, impuestos y total cuadran.
    • Los logotipos y firmas quedan ignorados.
    • La factura continúa en borrador.

03 · Después

Actualizar sin perder el control.

  1. Haz copia de la base de datos y del filestore.
  2. Actualiza el código del módulo desde el repositorio.
  3. Actualiza ai_processing en una ventana de mantenimiento.
  4. Repite la factura de prueba antes de reabrir la entrada de correo.

Las claves siguen fuera de Git y los borradores existentes permanecen sujetos a revisión humana.

04 · Ayuda rápida

Si algo no aparece, empieza aquí.

No encuentro el módulo

Comprueba la ruta de complementos, reinicia Odoo y actualiza la lista de aplicaciones.

La clave parece inválida

Distingue entre el nombre de la variable y la clave. El nombre solo admite mayúsculas, números y guiones bajos.

No aparecen modelos

Guarda primero el servicio y la credencial. Después pulsa “Leer modelos” y elige uno capaz de leer documentos.

El alias no tiene dirección

Configura el dominio de alias y el correo entrante estándar de Odoo antes de enviar la primera factura.

¿Preparado?

Instala. Prueba. Revisa.

Volver al producto