Monedero TakePOS

El módulo da un saldo prepago a cada tercero. No lleva una contabilidad aparte: se apoya en el crédito disponible de Dolibarr, el que el núcleo ya utiliza para los anticipos y los abonos.

La recarga

Se hace desde la pestaña «Monedero» de la ficha del tercero o de la ficha del miembro: importe, forma de pago, cuenta bancaria, nota. El módulo encadena entonces, en una sola transacción:

1. una factura de depósito (factura de anticipo) de una línea, al 0 % de IVA, validada;
2. el pago de esa factura, ingresado en el banco si el módulo Bancos y Caja está activo;
3. la clasificación de la factura como pagada;
4. su conversión en crédito disponible del cliente.

Si un paso falla, no se registra nada en la base de datos. La misma pestaña muestra el saldo disponible y el historial de recargas y compras.

En la ficha del miembro, la pestaña muestra el monedero del tercero vinculado al miembro. Un miembro que no está vinculado a ningún tercero no tiene monedero: la pestaña lo indica.

En caja

En la pantalla de pago de TakePOS, aparece un botón «Monedero (saldo)» cuando el cliente del ticket tiene saldo y el ticket no está pagado.

• El navegador no envía ningún importe. El servidor aplica como máximo lo que queda por pagar, y como máximo el saldo.
• Los créditos más antiguos se usan primero. Un crédito mayor que lo necesario se divide en dos: la parte usada y el resto, que sigue disponible.
• Si el saldo cubre el ticket, este se valida y se paga sin ningún otro pago.
• Si no, la pantalla muestra lo que queda por pagar, en efectivo, con tarjeta o con cheque.
• El enlace «Anular» devuelve el saldo.

El crédito se aplica como un pago, no como un descuento: el ticket conserva sus líneas y su IVA, sin línea negativa.

Solo se usan los créditos procedentes de una recarga. Los abonos y anticipos ordinarios del cliente no se tocan nunca.

El saldo está protegido

Si un ticket en borrador al que se ha aplicado el monedero se modifica (línea añadida, modificada o eliminada), se elimina o cambia de cliente, el importe aplicado se devuelve al monedero. Basta con volver a pulsar el botón.

Esta precaución cubre una carencia del núcleo: cuando se elimina una factura, Dolibarr no libera los créditos que se le aplicaron como pago.

Según la versión de Dolibarr

De la 19 a la 22, la pantalla de pago de TakePOS no muestra los botones añadidos por los módulos. En esas versiones, el módulo muestra él mismo su botón.

El IVA

Una recarga se registra al 0 % de IVA: el IVA se devenga en el momento de la compra, en el ticket. Es el tratamiento de un bono polivalente, válido si sus productos tienen tipos de IVA diferentes.

Si todos sus productos tienen el mismo tipo (por ejemplo, solo alimentación al 5,5 %), el saldo es un bono univalente: el IVA se devenga desde la recarga. Desde la versión 1.1.0, active entonces la opción «IVA en la recarga» en la configuración del módulo: la recarga lleva el IVA a ese tipo, y en caja el saldo se aplica como una línea de anticipo del ticket, al mismo tipo, de modo que el IVA solo se cuenta una vez (doctrina fiscal francesa BOI-TVA-CHAMP-10-10-40-50). No aplica si su entidad no está sujeta al IVA. En caso de duda, consulte a su asesor contable.

En la pantalla de pago de TakePOS, para un ticket de 107,60 € con IVA, el botón «Porte-monnaie (51,60 €)» (monedero) aparece debajo del teclado numérico, junto a las formas de pago «Espèce», «Chèque» y «Carte bancaire» (efectivo, cheque, tarjeta).

Tras un clic, el saldo no cubre todo el ticket: se aplican 51,60 €, y la pantalla muestra «Reste à payer: 56,00 €» (queda por pagar), que se abona con otra forma de pago. El botón ha desaparecido, porque el saldo está agotado. Debajo de los botones, la línea «Porte-monnaie appliqué : 51,60 €» (monedero aplicado) lleva el enlace «Annuler» (anular).

La pestaña «Porte-monnaie» (monedero) de la ficha de un miembro, en Dolibarr 24.0.1: saldo disponible de 51,60 €, tercero vinculado, formulario de recarga (importe, forma de pago, cuenta bancaria, nota) y, después, el historial: dos recargas de 50,00 € y 20,00 €, dos compras de 12,00 € y 6,40 €. Cada línea remite a su factura.

La página de configuración del módulo está reservada a los administradores. Empieza con un recordatorio del tratamiento del IVA.

• Tres permisos propios, no concedidos por defecto: «Ver los saldos de los monederos» abre la pestaña, «Recargar un monedero» muestra el formulario de recarga, «Pagar con el monedero en caja» muestra el botón en TakePOS.
• El permiso de Dolibarr, además: para pagar en caja, el usuario también debe tener el permiso de crear facturas.
• La pestaña respeta los permisos sobre los terceros: solo se abre en un tercero al que el usuario tiene acceso.
• La caja también: el botón solo se muestra, y el saldo solo se aplica, en el ticket de un cliente al que el usuario tiene acceso (sin el permiso de ver todos los terceros: los clientes de los que es comercial asignado); si no, la solicitud se rechaza.
• El importe lo calcula el servidor. El navegador solo pide aplicar o anular; el servidor aplica como máximo lo que queda por pagar y como máximo el saldo.
• Solicitudes protegidas: la aplicación y la anulación solo aceptan solicitudes POST con el token anti-CSRF de Dolibarr. Se rechazan en un abono, una factura de depósito o una factura ya pagada.
• Transacciones: una recarga o una aplicación del saldo que falla a mitad se anula por completo.
• Liberación automática del saldo cuando un ticket en borrador cambia o desaparece.

• La carpeta del módulo, dolixportemonnaie, para colocar en htdocs/custom/ o para instalar desde el zip.
• Cuatro idiomas: francés (fr_FR), inglés (en_US), alemán (de_DE) y español (es_ES).
• Un historial de versiones (ChangeLog.md) en la carpeta del módulo; sin README.
• Licencia GPL v3 o posterior, código fuente completo y legible.

• Se añade una tabla: llx_dolixpm_recharge. Guarda una línea por recarga: tercero, factura de depósito, importe, fecha, usuario, nota, entidad. El saldo no se almacena en ella: es la suma de los créditos disponibles de Dolibarr procedentes de esas facturas de depósito.
• Lo que se escribe en cada recarga, mediante las clases del núcleo: una factura de depósito, su pago, el movimiento bancario si el módulo Bancos y Caja está activo, y un crédito disponible del cliente. Al validarla, Dolibarr genera el PDF de la factura de depósito, como para cualquier factura.
• Lo que se escribe en caja: el crédito usado se vincula al ticket, como un pago. El módulo no añade ninguna línea al ticket.
• No se modifica ningún archivo de Dolibarr. Ninguna conexión saliente.
• Al desactivarlo, la pestaña y el botón de caja desaparecen. Las facturas de depósito, los pagos y los créditos permanecen: son datos de su base, y los saldos no consumidos siguen siendo créditos disponibles del cliente en Dolibarr. La tabla llx_dolixpm_recharge y los ajustes del módulo no se eliminan.