MBI TakePos Restaurant

🍽️ Benefits

• More professional receipt handling
• Stronger internal control and security
• Full legal and accounting traceability
• Adapted to real-world restaurant workflows

⚙️ Key Features

• Send orders to the kitchen and bar from a dedicated popup in TakePos.
• Configurable buttons with custom labels printed on kitchen receipts.
• Manage covers directly in TakePos with a dedicated button.
• Record covers as an invoice line item using a configurable product, making them visible on invoices.
• Track covers in POS checkouts with display per invoice, total covers on each report, and a total covers column in the checkout list.
• Route order receipts to the correct printers based on configured product categories.
• Configure multiple printer rules per terminal, model, and routing by category.
• Enhanced traceability through the logging of product and invoice deletion actions in TakePos, with controls tailored to the restaurant industry and tamper-proof logs.

✅ Compatibility

• Module version: auto
• Publisher/Licence: MB Informatique / GPL-v3
• User interface language: English, French
• Help/Support: MB Informatique
• Prerequisites:
• Dolibarr min version: 22.0.x

🔧 Installation

1. Copy the module into `/htdocs/custom/`
2. Go to Home > Setup > Modules/Applications
3. Activate MBI TakePos Restaurant

🛠 Updates

Version 2.8.1 (2026-08-13)

• Fixed: the company logo is now scaled down to the paper width before being sent to the receipt printer. A logo exported for the web or for a PDF is commonly 1800 dots wide, while an 80 mm printer prints 576: the printer received a raster three times wider than its head, lost sync, and rendered the rest of the stream — image and commands alike — as characters. The receipt came out unreadable and endless, with no error raised anywhere, since the image was perfectly valid and merely too large. The maximum width is configurable through MBI_TAKEPOS_LOGO_MAX_WIDTH, 576 by default.
• Fixed: the logo can be printed again on PHP 8. The bundled ESC/POS library rejects every image with "Failed to load image" because it checks is_resource() on what imagecreatefrompng() returns, and since PHP 8 that is a GdImage object rather than a resource. The logo therefore never printed on those installations, and the exception took the whole receipt down with it.
• Fixed: a template tag that fails no longer destroys the receipt. The exception used to escape the loop, leaving the ESC/POS stream unterminated and close() never called: the printer received an incomplete stream, with no cut, and the cashier got no message. Each tag is now isolated — the failure is logged and reported, and printing carries on. A receipt missing one line beats an unreadable one.
• Fixed: an unknown tag whose value is null no longer raises a TypeError on PHP 8.

Version 2.8 (2026-08-10)

• ⚠️ Action required: disable and re-enable the module after updating.

• New: "Separate payment" button on the payment screen; tick the products a customer is paying for and the amount is filled in automatically.
• New: products already settled appear greyed out on subsequent payments, preventing them from being charged twice.
• New: printing of the settled products details from the separate payment window.
• New: places without covers entry (bar counter, brasserie): the covers window no longer opens automatically on them.
• New: each point-of-sale invoice now keeps the room and the table it was served on, so sales can be analysed by room and by table.
• New: room names are configurable in the module setup (Dolibarr only knows floor numbers); when MBI Resa is enabled, the names it defines prevail.
• Improved: translations completed in the fourteen languages shipped with the module.
• Changed: the "Gift Voucher" button is now named "Deposit", which is what it does — it applies a deposit already taken to the sale in progress, as all its other labels already said. Its icon changes accordingly. This frees the gift voucher name and icon for the MBI Bon Cadeau module, which adds its own button to the same screen; keeping both identical made the two functions indistinguishable.
• Fixed: on a tablet, the on-screen keyboard no longer pops up each time a product is added to the order.

Version 2.7 (2026-08-05)

• ⚠️ Action required: disable and re-enable the module after updating.

• New: the point-of-sale journal is now signed and chained (HMAC-SHA-256). Any modification or deletion of a row made directly in the database becomes detectable.
• New: 'Check integrity' button in the history screen, reporting the first faulty record.
• New: 'Archive the period' button producing a frozen, timestamped CSV file in an open format, capped at one year as the reference framework requires.
• New: standalone verifier shipped with the module (build/verify_archive.php). It checks an archive without Dolibarr, without the module and without any database, so an auditor can confirm by themselves, with no secret, that the file has not been altered.
• The module's journal no longer depends on Dolibarr's 'Unalterable log' module: it stays probative even if that one is missing or defective.
• Records predating this version are not signed retroactively, deliberately: a point-of-sale journal is not rewritten. They are reported as such during the check.

Version 2.6 (2026-08-05)

• ⚠️ Action required: disable and re-enable the module after updating so the changes in this version are taken into account.

• ⚠️ Dolibarr's 'Unalterable log' (blockedlog) module must now be enabled: it is what gives point-of-sale operations their evidential value. A warning is shown if it is not.
• Fixed: a reprinted receipt again carries the 'DUPLICATA' marking, on every printing path including direct receipt-printer output.
• Fixed: a receipt issued before payment carries the provisional marking. It previously appeared only on draft orders: a validated but unpaid invoice printed with no marking at all.
• Fixed: on a partial-payment receipt, cash change is no longer counted as a payment. The receipt could show an amount higher than what was actually collected.
• Fixed: the deletion reason is now recorded whatever the user's language. It was lost outside the French interface.
• Fixed: receipt printing is actually journalised; the recording did not work.
• New: the reason is also requested when deleting a whole ticket, not only a single line.
• New: the 'Free of charge' action appears as such in the history instead of being indistinguishable from an ordinary change.
• New: printing date and time, and business identification, printed on receipts.
• New: the setup screen reports an incomplete database or events not declared to the unalterable log.
• Improved: faster history, completed filters, and flagging of rows modified outside the application.
• Documentation: new CONFORMITE-FR.md file describing what the module does and does not cover under French point-of-sale regulations.

Version 2.5 (2026-07-27)

• Fixed: the covers entry window no longer reappears when selecting a table that already has an order in progress.

Version 2.4 - 06/18/2026:

• Fixed: the global "delete line" interceptor (action=deleteline) is now strictly scoped to the TakePOS invoice screen. It no longer blocks native Dolibarr line deletion (orders, invoices, proposals…) nor line deletion in other modules; the TakePOS deletion-reason popup keeps working exactly as before.
• Trigger: read request parameters through Dolibarr's GETPOST()/GETPOSTINT() instead of raw $_REQUEST, and store the history creation date with dol_now()/idate() instead of the SQL CURRENT_DATE function (Dolibarr coding rules).
• Security/multi-company: the kitchen AJAX endpoints (ajax_kitchen_lines.php, ajax_kitchen_print.php) now verify that the invoice belongs to the current entity before exposing/operating on its lines.
• Clarified the "Prevent deletion of draft customer invoices" permission label to make explicit that granting it restricts (rather than allows) deletion.
• i18n: the payment-popup "Offered" button label and the kitchen-button default placeholder are now translatable; completed the German, Spanish and Italian locales with the two previously missing keys.
• Minor fixes: undefined $morehtmlright warning on the History page, module logo picto resolution (img/logo.png), and the trigger version label.

Version 2.3 - 06/12/2026:

• Added a "Covers" column to the customer invoice list, showing the number of covers per invoice (computed from the configured covers product lines), with the total number of covers displayed in the list footer (Total row). In the invoice list this column is sortable and filterable (the search field supports operators such as >=, <=, >, <).
• Added a free "Comment" field to the "Send order" (kitchen/bar) popup; the comment entered is printed on the kitchen/bar ticket below the order lines.
• Added a per-line comment field in the "Send order" popup (shown inline between the product name and its status); each line comment is printed in bold below its product line on the kitchen/bar ticket.
• The "Covers" column (sortable, with total) now also appears in the TakePOS "History" invoice list (poslist context).

Version 2.2 - 06/04/2026:

• Applying a deposit reduces the remaining amount due on the TakePOS invoice and consumes/links the deposit credit exactly like Dolibarr's native "Available discounts/credits" feature (the discount line and link remain visible on the paid invoice).
• Added a new "Gift Voucher" button in the TakePOS payment popup, matching the payment mode buttons, to apply a deposit invoice (facture d'acompte) to the current sale. It opens a popup listing every available deposit credit across all customers (source invoice reference, customer name and amount) with an "Apply" button — the cashier picks which deposit to apply, since TakePOS does not let one choose the paying customer.
• Added a configurable option to show or hide the "Gift Voucher" button in the payment popup.
• Added a configuration option (in the "Covers product" settings section) to show or hide the "Covers" column in both the customer invoice list and the cash control list.
• Added a new "Covers" column to the POS operation history log (table `llx_mbi_takepos_historique`). The number of covers is automatically calculated from invoice lines linked to the configured covers product (`MBI_COVERS_PRODUCT_ID`) and stored at each action. The column is sortable and filterable in the history list page.

Version 2.1 - 05/13/2026:

• Added a configurable option to automatically open the covers popup right after a table is selected in the TakePOS floor plan (set in the "Covers product" settings section). The manual "Covers" button still works in all cases.
• Fixed the covers popup not always opening after table selection: the floor plan click is now intercepted reliably regardless of load timing.
• Fixed keyboard entry in the covers popup, which was blocked by the floor plan overlay capturing focus.
• Improved the covers popup for touch screens with a larger input field and large "−"/"+" stepper buttons.
• Added a new "Divide" (÷) button in the TakePOS payment popup, matching the payment mode buttons, to quickly split the remaining amount due (per-person amount). It opens a popup with an editable field and "−"/"+" stepper, pre-filled with the number of covers. The default divisor automatically decreases by one after each partial payment (covers minus the payments already registered), so each remaining guest is offered an equal share.
• Added a configurable option to show or hide the "Divide" button in the payment popup.

Version 2.0 - 04/23/2026:

• Added a new "Send Order" feature in TakePOS with a dedicated popup to dispatch automatic lines to the correct printer(s) based on configured categories.
• Added product line selection before printing (Suite / On Hold) and a visual status on lines to quickly identify already sent items.
• Added a new multi-entry printer setup (terminal, printer, template, categories).
• Added edit and delete actions for printer entries directly from setup.
• Added configurable buttons for the TakePOS "Send Order" popup, with custom labels printed on kitchen tickets.
• Added TakePOS covers management with a modal opened after table selection and a dedicated "Covers" action button.
• Added covers display in the TakePOS order header and on kitchen order tickets.
• Added a configurable covers product to save the number of covers directly as a TakePOS invoice line.
• Added covers indicators to POS cash control screens, with covers per invoice and total covers on the cash control report, plus a total covers column on the cash control list.
• Externalized the recent UI strings to language files and added translations for all locales already present in the module.

Version 1.2 - 01/21/2026:

• Added the reference for advance payments to the list of credit reductions to be chosen in a third-party invoice.
• Adjustment of the alignment of the quantity columns, including tax costs and removal of the tax-exclusive column in the printing of the simplified receipt ticket.
• Correction of the display of the transaction log table for operations performed with TakePos.

Version 1.1 - 01/07/2026:

• Added a new tab to the setting page displaying the list of payment transaction history from the point of sale.
• Added a permission preventing the user from deleting draft customer invoices.

Initial version 1.0 - 10/15/2025:

• Simplification of printed receipt tickets.
• Generation of a complete menu, ready for printing.
• Storage in the database of all payment operations performed on invoices from the point of sale.
• Enhanced security for deleting payment lines (provisional invoice) with required reason prompt.
• Logging of deleted customer invoice lines (all statuses) into tamper-proof logs.

📄 End-user License Agreement

The MBI TakePos Restaurant module is edited by MB Informatique SARL (SIRET: 83434236200029), whose head office is located at 120 rue de l'île Napoléon 68170 Rixheim FRANCE - Tel. : 03 67 262 242.

This End-user License Agreement legally frame the use of the services of the MBI TakePos Restaurant module. MB Informatique SARL declines all responsibility for any viruses that may infect the User's computer equipment after use or access to this module.

The total guarantee of data security, integrity and confidentiality, whatever it is, is not guaranteed by MB Informatique SARL. MB Informatique SARL cannot be held responsible for its use outside the legal framework.

This contract is valid for an indefinite period. The beginning of the use of the module's services marks the application of the contract with regard to the User.

👨 💻 Publisher

MBI Breadcrumb is a custom Dolibarr module developed by MB Informatique.

It was designed for organizations that want smoother navigation in Dolibarr, easier access to recently visited items, and a better overall user experience in environments with many modules and management screens.

Publisher: MB Informatique
Contact: <info@mb-informatique.fr>
Website: https://www.mb-informatique.fr