Mostrar Detalles Adicionales del Cliente en Recibos de Punto de Venta (POS) en Odoo 17

Este artículo documenta la implementación de una mejora personalizada en Odoo 17 para añadir información detallada del cliente (dirección, teléfono, cédula) en los recibos impresos del Punto de Venta, una funcionalidad no disponible de forma nativa.

Problema

El cliente solicitó la posibilidad de incluir más información del cliente, como número de identificación (cédula), correo electrónico, número de teléfono y detalles adicionales de la dirección, directamente en los recibos generados desde el Punto de Venta (POS). El objetivo era facilitar procesos como la entrega de pedidos, requiriendo un bloque de información del cliente visible en el recibo. Odoo 17, en su configuración estándar, solo muestra el nombre y correo electrónico del cliente en los recibos de POS, sin incluir estos datos adicionales de forma nativa.

Causa Raíz

La funcionalidad de Odoo 17 para el Punto de Venta no incluye de forma nativa la visualización de un bloque detallado con la información completa del cliente (dirección, teléfono, número de identificación) en los recibos impresos. Esto es una limitación de diseño estándar para el formato de recibo predeterminado, que prioriza la concisión.

Solución

Para abordar esta necesidad, se realizó un desarrollo personalizado que extendió la funcionalidad del módulo de Punto de Venta. La solución implementada sigue los siguientes pasos:

1. Se confirmó que la solicitud se refería específicamente a los recibos del Punto de Venta (POS) y no a las facturas de contabilidad, lo cual fue crucial para definir el alcance de la solución.
2. Se realizó un análisis exhaustivo de la funcionalidad nativa de Odoo 17 para los recibos de POS, confirmando que la inclusión de detalles adicionales del cliente (dirección, teléfono, cédula) no está disponible de serie.
3. Se propuso al cliente un desarrollo personalizado y se obtuvo su aprobación para proceder con la implementación a través de horas de soporte.
4. Se desarrolló un módulo personalizado que introduce una nueva opción de configuración en Odoo, accesible desde Punto de Venta -> Configuración -> Ajustes, dentro de la sección Contabilidad, denominada "Detalles del cliente en recibo".
5. Al activar esta casilla, el recibo de POS genera automáticamente un bloque de información adicional del cliente, mostrando:
   • Nombre del cliente
   • Número de identificación (Cédula/NIF)
   • Teléfono o celular
   • Dirección completa (señas, barrio, distrito, cantón, provincia, país, separados por coma)
   Es importante destacar que solo se muestran los campos que estén completos en el registro del contacto del cliente; los campos vacíos son omitidos sin generar errores.
6. La mejora fue desplegada inicialmente en una instancia de demo (https://demodavid.logosoftla.com/) para que el cliente pudiera realizar pruebas exhaustivas y verificar la correcta funcionalidad.
7. Se proporcionaron instrucciones detalladas al cliente sobre cómo activar la opción, verificar los datos del cliente y realizar una venta de prueba en el POS. Se aclaró que los campos de dirección no son obligatorios y el sistema maneja su ausencia de forma elegante.
8. Tras la confirmación del cliente de que la funcionalidad operaba según lo esperado, se procedió con el despliegue final de la mejora en todas las instancias de producción requeridas.

Configuración y Uso

Para activar esta funcionalidad, siga estos pasos:

1. Navegue a Punto de Venta -> Configuración -> Ajustes.
2. En la sección Contabilidad, busque la opción "Detalles del cliente en recibo".
3. Active la casilla y guarde los cambios.
4. Asegúrese de que el cliente asignado a la orden de POS tenga los campos de Cédula (NIF), Teléfono y Dirección completos en su registro de contacto para que aparezcan en el recibo.

Si la opción se desactiva, el recibo volverá a mostrar únicamente el nombre y correo del cliente como lo hacía antes de la implementación de la mejora.