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.

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

Plataforma Odoo.sh

1. Ve a tu proyecto en 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

Odoo autohospedado

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

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.
3. Guarda la configuración

nota

Asegúrate de usar las credenciales de API correctas según tu entorno (pruebas/producción).

Uso

Gestión de pagos

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

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"

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

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

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

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

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 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.