# Odoo MONEI para Odoo es nuestra integración oficial que te permite procesar pagos, gestionar transacciones y sincronizar tus pedidos de Odoo con los pagos de MONEI. La aplicación ofrece una experiencia fluida para gestionar todas tus operaciones de pago directamente desde tu interfaz de Odoo. ![Panel de la aplicación MONEI para Odoo](/es/assets/images/dashboard-1eac8c4833eec862e587d44d2feaabdd.png) ## Funcionalidades[​](#funcionalidades "Enlace directo al Funcionalidades") * Procesa pagos directamente desde Odoo * Visualiza y gestiona todas tus transacciones de MONEI * Filtra y busca pagos * Realiza acciones sobre los pagos (capturar, cancelar, reembolsar) * Crea nuevos pagos y enlaces de pago * Sincronización manual de pedidos * Seguimiento detallado del estado de los pagos ## Instalación[​](#instalación "Enlace directo al Instalación") * Plataforma Odoo.sh * Odoo autohospedado 1. Ve a tu proyecto en [Odoo.sh](https://odoo.sh) 2. Navega a la pestaña "Repositories" 3. Haz clic en "Add a Repository" y selecciona "Add a Git Repository" 4. Introduce la URL del repositorio: `https://github.com/MONEI/MONEI-Odoo` 5. Selecciona la rama que deseas desplegar 6. Ve a la pestaña "Branches" y activa la rama donde quieres instalar MONEI 7. Espera a que se complete el despliegue (puedes consultar el estado en "Builds") 8. Una vez desplegado, ve a Apps y busca "MONEI" 9. Haz clic en Instalar en el módulo MONEI nota Si no ves el módulo en Apps tras el despliegue: * Activa el modo desarrollador (Ajustes → Ajustes generales → Herramientas de desarrollador → Activar el modo desarrollador) * Ve a Apps → Actualizar lista de aplicaciones (menú en la barra superior) * Busca "MONEI" de nuevo 1. Descarga el módulo 2. Coloca la carpeta `monei` en el directorio de addons de Odoo: * Linux: `/opt/odoo/addons/` o `/usr/lib/python3/dist-packages/odoo/addons/` * Windows: `C:\Program Files\Odoo\server\odoo\addons\` 3. Reinicia tu servidor Odoo 4. Actualiza la lista de aplicaciones en Odoo: * Activa el modo desarrollador * Ve a Apps > Actualizar lista de aplicaciones 5. Busca "MONEI" e instala el módulo ![Instalación de la aplicación MONEI](/es/assets/images/install-c2fc461d9fe5e1d7efba8bb09defa9ad.png) ### 2. Configuración[​](#2-configuración "Enlace directo al 2. Configuración") 1. En Odoo, ve a **Ajustes > Configuración MONEI** 2. Introduce tu clave de API. Puedes encontrar tu clave de API en [MONEI Dashboard → Ajustes → Acceso a la API](https://dashboard.monei.com/settings/api). 3. Guarda la configuración ![Configuración de MONEI en Odoo](/es/assets/images/configuration-3e0603696fbae5ae1bf7cf659ef1f6a9.png) nota Asegúrate de usar las credenciales de API correctas según tu entorno (pruebas/producción). ## Uso[​](#uso "Enlace directo al Uso") ### Gestión de pagos[​](#gestión-de-pagos "Enlace directo al Gestión de pagos") #### Ver pagos[​](#ver-pagos "Enlace directo al Ver pagos") 1. Navega a **MONEI > Pagos** 2. Visualiza todos tus pagos en una lista con información clave: * ID del pago * Importe * Estado * Datos del cliente * Referencia del pedido 3. Usa los filtros para buscar por: * Rango de fechas * Estado del pago * Importe * Información del cliente ![Vista de lista de pagos](/es/assets/images/payments-list-64b5b2560e36e9d7063798d37b98b84f.png) #### Crear un nuevo pago[​](#crear-un-nuevo-pago "Enlace directo al Crear un nuevo pago") 1. Haz clic en "Crear" en la vista de Pagos 2. Rellena los datos del pago: * Importe * Moneda * Información del cliente * Descripción * Referencia del pedido (opcional) 3. Haz clic en "Crear pago" ![Formulario de creación de pago](/es/assets/images/create-dcf80eda23e8d95e67d7dd6e31acae8c.png) #### Acciones sobre pagos[​](#acciones-sobre-pagos "Enlace directo al Acciones sobre pagos") Para cada pago, puedes: * Capturar pagos autorizados * Cancelar pagos pendientes * Emitir reembolsos * Ver información detallada de la transacción ### Integración con pedidos[​](#integración-con-pedidos "Enlace directo al Integración con pedidos") La integración te permite sincronizar manualmente tus pedidos de Odoo con los pagos de MONEI: 1. Ve a **MONEI > Pagos** 2. Haz clic en el botón "Sincronizar pagos" para obtener los últimos pagos de MONEI 3. El sistema: * Actualizará los estados de los pagos existentes * Importará los nuevos pagos * Vinculará los pagos a los pedidos de Odoo correspondientes según la referencia del pedido tip Se recomienda realizar sincronizaciones periódicas para mantener la información de tus pagos actualizada. Considera sincronizar al menos una vez al día. ### Enlaces de pago[​](#enlaces-de-pago "Enlace directo al Enlaces de pago") Para crear un enlace de pago: 1. Ve a **MONEI > Enlaces de pago** 2. Haz clic en "Crear" 3. Configura los datos del pago: * Importe * Moneda * Descripción * Fecha de caducidad (opcional) * Información del cliente (opcional) 4. Haz clic en "Generar enlace" 5. Comparte el enlace generado con tu cliente ![Crear enlace de pago](/es/assets/images/payment-link-0732c19a4446f46c95bcafa8965d6100.png) ### Cómo funciona la sincronización[​](#cómo-funciona-la-sincronización "Enlace directo al Cómo funciona la sincronización") 1. **Sincronización inicial** * Tras configurar tu clave de API, usa el botón Sincronizar para importar pagos * Selecciona un rango de fechas para importar los pagos de ese período * El módulo importará todos los pagos de MONEI dentro de las fechas seleccionadas 2. **Proceso de sincronización** * Ve a MONEI > Pagos * Haz clic en el botón "Sincronizar pagos" * Selecciona las fechas de inicio y fin de la sincronización * El módulo: * Importará los nuevos pagos del período seleccionado * Actualizará la información de los pagos existentes * Mostrará un resumen de los cambios al finalizar 3. **Asociación de pedidos** * Los pagos se vinculan automáticamente a los pedidos de venta usando la referencia del pedido * La referencia del pedido de cada pago se compara con el número de pedido de venta * Visualiza los pagos vinculados directamente desde el formulario del pedido de venta ## Solución de problemas[​](#solución-de-problemas "Enlace directo al Solución de problemas") Si encuentras algún problema: 1. Verifica que tus credenciales de API son correctas 2. Consulta los registros del sistema de Odoo 3. Comprueba que tu instancia de Odoo puede conectarse a la API de MONEI 4. Intenta resincronizar los pagos manualmente 5. Contacta con el [soporte de MONEI](https://support.monei.com) si el problema persiste Problemas frecuentes: * **El botón de sincronización no funciona**: Verifica tus credenciales de API y la conexión a internet * **Los pagos no se vinculan a los pedidos**: Comprueba que las referencias de los pedidos coinciden entre ambos sistemas tip Mantén tu aplicación actualizada a la última versión para disponer de todas las funcionalidades y actualizaciones de seguridad más recientes.