POS Payment Modifier
Cambie métodos de pago en órdenes POS desde el backend de Odoo
Cambio de Método de Pago
Modifique métodos de pago (efectivo, tarjeta, banco) desde el backend de Odoo.
Múltiples Pagos
Soporte para órdenes con varios métodos de pago simultáneos.
Validación de Sesión
Solo permite cambios cuando la sesión está abierta.
Historial Completo
Registra todos los cambios con fecha, hora y usuario.
Actualización de Facturas
Reversa y crea nuevos asientos. La factura se mantiene posteada.
Interfaz Intuitiva
Wizard fácil de usar con validaciones en tiempo real.
Descripción
POS Payment Modifier permite a los gerentes y usuarios autorizados modificar los métodos de pago de las órdenes POS directamente desde el backend de Odoo, sin necesidad de cancelar y recrear la orden.
¿Cómo Funciona?
Navegue a las Órdenes POS
Acceda a Punto de Venta → Órdenes.
Seleccione la Orden
Abra una orden en estado "Nuevo" o "Pagado". La sesión debe estar abierta.
Click en "Cambiar Pago"
Haga clic en el botón "Cambiar Pago" en el header.
Modifique los Pagos
Cambie métodos/montos. Verifique que la suma coincida con el total.
Actualice Factura (si aplica)
Si la orden está facturada, marque "Actualizar Pago en Factura".
Confirme
Haga clic en "Confirmar" para aplicar los cambios.
Requisitos
| Requisito | Detalle |
|---|---|
| Versión de Odoo | Odoo 19.0 o superior |
| Módulos Dependientes | point_of_sale |
| Permisos Requeridos | Grupo "Point of Sale / User" o "Point of Sale / Manager" |
Restricciones
- No se pueden cambiar pagos en sesiones cerradas
- No se pueden modificar órdenes facturadas sin marcar la opción de actualización
- La suma de los pagos debe ser igual al total de la orden
- Solo usuarios POS Manager o POS User pueden realizar cambios
POS Payment Modifier - Documentación
| Versión: | 19.0.1.0.0 |
|---|---|
| Autor: | Your Company |
| Licencia: | LGPL-3 |
| Categoría: | Point of Sale |
| Dependencias: | point_of_sale |
Tabla de Contenidos
Descripción
POS Payment Modifier es un módulo para Odoo 19 que permite cambiar los métodos de pago en órdenes del Punto de Venta (POS) desde el backend. Este módulo es esencial para negocios que necesitan flexibilidad en la gestión de pagos, permitiendo corregir errores o ajustar los métodos de pago sin necesidad de cancelar y recrear la orden.
Características Principales
- Cambio de método de pago: Permite modificar los métodos de pago de las órdenes POS (efectivo, tarjeta, banco, etc.)
- Múltiples pagos: Soporta órdenes con varios métodos de pago simultáneos
- Validación de sesión: Solo permite cambios cuando la sesión está abierta (estados: "Opening Control" o "In Progress")
- Historial de cambios: Registra todos los cambios realizados con fecha, hora y usuario
- Actualización de facturas: Opción para actualizar los asientos contables en facturas ya generadas
- Interfaz intuitiva: Wizard fácil de usar en el backend con validaciones en tiempo real
Instalación
- Copie la carpeta pos_payment_change en su directorio de addons de Odoo
- Reinicie el servidor de Odoo o actualice la lista de módulos
- Active el modo desarrollador (Ajustes → Activar modo desarrollador)
- Navegue a Aplicaciones y busque "POS Payment Modifier"
- Haga clic en Instalar
Requisitos Previos
- Odoo 19.0 o superior
- Módulo point_of_sale instalado
- Permisos de usuario o gerente de Punto de Venta
Configuración
No se requiere configuración adicional. El módulo funciona automáticamente después de la instalación.
Los siguientes grupos de usuarios tienen acceso a las funcionalidades del módulo:
- Point of Sale / User (point_of_sale.group_pos_user)
- Point of Sale / Manager (point_of_sale.group_pos_manager)
Uso
Paso 2: Seleccionar la Orden
Abra la orden que desea modificar. Tenga en cuenta las siguientes condiciones:
- La orden debe estar en estado "Nuevo" (draft) o "Pagado" (paid)
- La sesión debe estar abierta (no en control de cierre ni cerrada)
- La orden no debe estar cancelada
Paso 3: Iniciar el Cambio de Pago
Haga clic en el botón "Cambiar Pago" ubicado en el header de la vista de formulario de la orden.
Paso 4: Modificar los Pagos
En el wizard podrá realizar las siguientes acciones:
- Modificar método de pago: Cambie el método de pago de cada línea (ej: de efectivo a tarjeta)
- Ajustar montos: Modifique el monto de cada pago individual
- Agregar nuevas líneas: Añada nuevos métodos de pago utilizando el botón "Agregar línea"
- Eliminar líneas: Remueva métodos de pago existentes
Note
La fecha de pago por defecto es la fecha de la orden. Puede modificarla si es necesario.
Paso 5: Validar y Confirmar
- Verifique que la suma de los pagos coincida con el total de la orden
- El campo "Diferencia" debe ser 0 para poder confirmar
- Si la orden está facturada, marque la opción "Actualizar Pago en Factura" si desea actualizar los asientos contables
- Haga clic en "Confirmar" para aplicar los cambios
Paso 6: Verificar el Historial
Después de confirmar, puede verificar el historial de cambios en la pestaña "Payment Change Log" de la orden.
Restricciones Importantes
- No se pueden cambiar pagos en órdenes de sesiones cerradas o en control de cierre
- No se pueden modificar órdenes canceladas
- La suma de los pagos debe ser exactamente igual al total de la orden (tolerancia de 0.01 por redondeo)
- Solo usuarios con permisos de gerente o usuario POS pueden realizar cambios
- Para órdenes facturadas, debe marcar la opción de actualización de factura
Actualización de Facturas
Cuando una orden ya tiene una factura generada y se cambia el método de pago, el módulo ofrece la opción de actualizar los asientos contables:
- Reversión automática: El sistema reversa los movimientos de pago originales
- Creación de nuevos pagos: Genera nuevos asientos con los métodos de pago actualizados
- Reconciliación: Reconcilia automáticamente los nuevos pagos con la factura
- Factura posteada: La factura se mantiene posteada durante todo el proceso
Warning
La actualización de facturas solo funciona si la sesión está abierta. Si la sesión está cerrada, deberá abrir una nueva sesión o reversar la factura manualmente.
Campos Agregados
pos.order
| Campo | Tipo | Descripción |
|---|---|---|
| payment_change_log | Text | Registro histórico de los cambios de método de pago realizados. Cada entrada incluye fecha, hora, usuario y detalles del cambio. |
pos.payment
| Campo | Tipo | Descripción |
|---|---|---|
| original_payment_method_id | Many2one (pos.payment.method) | Método de pago original antes de cualquier modificación. Permite auditar los cambios realizados. |
Modelos del Wizard
pos.payment.change.wizard
Modelo transitorio que gestiona el proceso de cambio de pago.
Campos principales:
- order_id: Orden POS que se está modificando
- session_id: Sesión de la orden (relacionado)
- session_state: Estado de la sesión
- available_payment_method_ids: Métodos de pago disponibles en la sesión
- payment_line_ids: Líneas de pago a modificar/crear
- amount_total: Total de la orden
- new_total_paid: Suma de los pagos en el wizard
- difference: Diferencia entre el total y los pagos
- update_invoice_payment: Checkbox para actualizar factura
pos.payment.change.wizard.line
Líneas individuales de pago en el wizard.
Campos principales:
- wizard_id: Referencia al wizard padre
- payment_id: Pago original (si existe)
- payment_method_id: Método de pago seleccionado
- amount: Monto del pago
- payment_date: Fecha del pago
- original_payment_method_id: Método de pago original
Estructura de Archivos
pos_payment_change/
├── __init__.py
├── __manifest__.py
├── README.md
├── LICENSE
├── doc/
│ └── index.rst
├── images/
│ └── main_screenshot.png
├── static/
│ └── description/
│ ├── icon.png
│ └── index.html
├── models/
│ ├── __init__.py
│ ├── pos_order.py
│ └── pos_payment.py
├── wizard/
│ ├── __init__.py
│ ├── pos_payment_change_wizard.py
│ ├── pos_payment_change_wizard_view.xml
│ └── pos_payment_change_log_view.py
├── views/
│ ├── pos_order_view.xml
│ └── pos_payment_view.xml
└── security/
└── ir.model.access.csv
Seguridad y Permisos
El módulo incluye los siguientes registros de acceso:
| Modelo | Grupo | Lectura | Escritura |
|---|---|---|---|
| pos.payment.change.wizard | POS User/Manager | Sí | Sí |
| pos.payment.change.wizard.line | POS User/Manager | Sí | Sí |
| pos.payment.change.log.view | POS User/Manager | Sí | No |
Solución de Problemas
El botón "Cambiar Pago" no aparece
Causa: El usuario no tiene los permisos necesarios.
Solución: Verifique que el usuario pertenezca al grupo "Point of Sale / User" o "Point of Sale / Manager".
Error: "No se puede cambiar el método de pago porque la sesión está cerrada"
Causa: La sesión del POS está en estado "closed" o "closing_control".
Solución: * Opción 1: Abra una nueva sesión y mueva la orden (si es posible) * Opción 2: Revierta la factura y cierre la sesión correctamente
Error: "La suma de los pagos no coincide con el total de la orden"
Causa: La suma de las líneas de pago no es igual al total de la orden.
Solución: Ajuste los montos de las líneas de pago hasta que la diferencia sea 0.
La factura no se actualiza después del cambio
Causa: No se marcó la opción "Actualizar Pago en Factura".
Solución: Al realizar el cambio, marque el checkbox "Actualizar Pago en Factura" en el wizard.
Historial de Versiones
19.0.1.0.0 (2026)
- Versión inicial para Odoo 19.0
- Cambio de método de pago en órdenes POS
- Soporte para múltiples pagos
- Validación de sesión abierta
- Historial de cambios completo
- Actualización de asientos contables en facturas
- Interfaz de usuario intuitiva
Soporte Técnico
Para soporte técnico, reportes de errores o consultas:
- Email: support@example.com
- Website: https://www.yourcompany.com
Licencia
Este módulo está licenciado bajo LGPL-3 (GNU Lesser General Public License v3).
Para más detalles, consulte el archivo LICENSE incluido en el módulo o visite: https://www.gnu.org/licenses/lgpl-3.0.html
Créditos
- Desarrollador: Your Company
- Categoría: Point of Sale
- Versión de Odoo: 19.0
Note
Este módulo es software de terceros y no está afiliado con Odoo S.A.
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module