Abahfir: module takepos digital invoice

2026-09-29T14:23:09Z

module takepos digital invoice

New page

<div style="width:100%;font-family:Arial,sans-serif;font-size:16px;line-height:1.6;color:#222;"><div style="width:100%;">
<h1>TakePOS Digital Invoice</h1>
<p><strong>Summary:</strong> Lets a buyer of a TakePOS sale request an electronic invoice by scanning a QR code on the receipt.<br><strong>Module version:</strong> 1.0.0<br><strong>Declared compatibility:</strong> Dolibarr 23.0 or later, PHP 7.2 or later<br><strong>Last documentation review:</strong> 2026-09-29</p>
<p><strong>Demo video:</strong></p>
<youtube width="560" height="315">PaenAajCX0E</youtube>
<p><strong>Demo site:</strong> [https://01consulting.eu/demo/htdocs/ Open the demo site]</p>
<p><strong>Publisher website:</strong> [https://01consulting.eu/ 01Consulting]</p>
<p>This guide covers installation, settings, receipt QR codes, the customer workflow, request tracking, EInvoicing integration, permissions, and troubleshooting.</p>

<h2>1. Purpose and scope</h2>
<p>TakePOS sales are often recorded against the generic third party assigned to a terminal. This module gives the buyer of a paid sale a way to provide company details, confirm an email address, and request the electronic invoice for that existing sale.</p>
<p>The module identifies or creates a customer third party, links the TakePOS invoice to it, prepares the electronic invoice with EInvoicing, sends it to the approved platform configured there, then emails the requester the official readable PDF retrieved from that platform.</p>
<p>The public workflow is intended for French companies with an active 14-digit SIRET. It does not create a new commercial invoice; it operates on the already-paid TakePOS invoice. Individuals and foreign companies are not supported.</p>

<h2>2. End-to-end workflow</h2>
<ol><li>When a TakePOS invoice is validated, the module creates a random 64-character identifier and stores it in the invoice <code>hash</code> extrafield.</li><li>The receipt prints or displays a QR code that opens the public form for that invoice.</li><li>The buyer submits company details and a SIRET. The module checks the fields, email domain, and available official register data.</li><li>The module sends a confirmation link to the submitted email address. Processing does not start until the link is opened.</li><li>After confirmation, the module reuses the matching third party or creates one, then links the paid invoice to it.</li><li>EInvoicing generates the electronic document using the configured protocol and sends it to the approved platform.</li><li>The module retrieves the platform’s official readable PDF and emails it to the requester.</li></ol>
<p>Errors are recorded on the request. An authorized user can retry processing. If the invoice has already been transmitted, the existing platform flow is reused to retrieve the PDF; the invoice is not sent a second time.</p>

<h2>3. Requirements and compatibility</h2>
<ul><li><strong>Dolibarr:</strong> the module descriptor declares Dolibarr 23.0 or later; the module was prepared for Dolibarr 23.0.3.</li><li><strong>PHP:</strong> minimum declared version is 7.2.</li><li><strong>Dolibarr modules:</strong> Invoices, TakePOS, and EInvoicing must be enabled.</li><li><strong>EInvoicing:</strong> configure an approved platform, satisfy its prerequisites, and select the CII or Factur-X protocol.</li><li><strong>Email:</strong> outbound email from Dolibarr must be configured.</li><li><strong>Server connectivity:</strong> the server must be able to reach the Company Search API, DNS, and, if enabled, the Verifalia API over HTTPS.</li><li><strong>Customer access:</strong> the public Dolibarr URL must be reachable from the phone scanning the receipt.</li><li><strong>TakePOS terminal:</strong> each relevant point of sale must have a default generic third party, used to determine whether the buyer is still anonymous.</li></ul>

<h2>4. Installation, activation, and updates</h2>
<h3>4.1. Install and activate</h3>
<ol><li>Copy the <code>takeposdigitalinvoice</code> directory to <code>htdocs/custom</code>.</li><li>In Dolibarr, open <strong>Home > Setup > Modules/Applications</strong>.</li><li>Enable <strong>TakePOS Digital Invoice</strong>. First check that Invoices, TakePOS, and EInvoicing are installed and enabled.</li><li>Open the module configuration and set the <strong>General</strong> and <strong>Email</strong> tabs.</li><li>Grant the required read and process permissions to the relevant users.</li><li>Add the QR tag to the browser receipt template and/or ESC/POS template used by the terminal.</li><li>Make a test sale and verify the QR code, public form, email confirmation, and request tracking.</li></ol>
<p>Activation loads the request table, adds the invoice <code>hash</code> extrafield (varchar, 64 characters), declares the tracking menu and invoice tab, registers permissions, and declares the retention scheduled task. An activation migration also handles the former CII tracking columns and, where possible, fills in the format from documents already generated.</p>
<h3>4.2. Update</h3>
<p>Back up the database and Dolibarr documents before updating. Replace the module files with the new version, then reactivate the module if its menu or tab declaration has changed. Activation runs the migrations declared by the module. Afterward, check the configuration page, request menu, and a TakePOS invoice tab.</p>
<h3>4.3. Disable or uninstall</h3>
<p>The effects on tables, the extrafield, and documents depend on the operation selected in Dolibarr. Back up data before uninstalling and review the consequences shown by Dolibarr. The public workflow does not operate while the module is disabled.</p>

<h2>5. Permissions, menus, and screens</h2>
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Permission or screen</th><th style="padding:8px;border:1px solid #dee2e6;">Purpose</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Read requests</td><td style="padding:8px;border:1px solid #dee2e6;">Opens the request list and tracking tab on a TakePOS invoice. Dolibarr permission to view the invoice is also required.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Process requests</td><td style="padding:8px;border:1px solid #dee2e6;">Allows Retry and Cancel actions in the list and invoice tab.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Administer requests</td><td style="padding:8px;border:1px solid #dee2e6;">Permission declared in the module descriptor. Configuration pages also require Dolibarr administrator status.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Configuration</td><td style="padding:8px;border:1px solid #dee2e6;">Available to Dolibarr administrators from the module settings; includes General, Email, and About tabs.</td></tr></table>
<p>The <strong>Billing/Payments > TakePOS Digital Invoice</strong> menu is shown to users with read permission. The invoice tab is shown only on invoices originating from TakePOS and to users with the same permission.</p>

<h2>6. General settings</h2>
<p>Open the module settings and select the <strong>General</strong> tab. The defaults below are defined by the configuration page; Dolibarr may retain a value already stored for the entity.</p>
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Setting</th><th style="padding:8px;border:1px solid #dee2e6;">Default</th><th style="padding:8px;border:1px solid #dee2e6;">Effect</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Public link lifetime</td><td style="padding:8px;border:1px solid #dee2e6;">30 days</td><td style="padding:8px;border:1px solid #dee2e6;">Period from invoice validation; minimum one day.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Maximum attempts</td><td style="padding:8px;border:1px solid #dee2e6;">5</td><td style="padding:8px;border:1px solid #dee2e6;">Limits submissions for the same invoice and hashed IP address.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Rate-limit window</td><td style="padding:8px;border:1px solid #dee2e6;">15 minutes</td><td style="padding:8px;border:1px solid #dee2e6;">Time window applied to the attempt counter.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Completed request retention</td><td style="padding:8px;border:1px solid #dee2e6;">365 days</td><td style="padding:8px;border:1px solid #dee2e6;">The scheduled cleanup can delete completed requests after this period.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Error request retention</td><td style="padding:8px;border:1px solid #dee2e6;">90 days</td><td style="padding:8px;border:1px solid #dee2e6;">The scheduled cleanup can delete requests in error after this period.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Privacy policy URL</td><td style="padding:8px;border:1px solid #dee2e6;">Empty</td><td style="padding:8px;border:1px solid #dee2e6;">Optional link displayed below the public form when configured.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">QR code message</td><td style="padding:8px;border:1px solid #dee2e6;">“Scan this QR code to request your electronic invoice.”</td><td style="padding:8px;border:1px solid #dee2e6;">Text printed or displayed with the QR code; an empty message falls back to the translated text.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Public form URL</td><td style="padding:8px;border:1px solid #dee2e6;">Computed</td><td style="padding:8px;border:1px solid #dee2e6;">Read-only value; verify it from outside the server.</td></tr></table>

<h2>7. Email and PDF settings</h2>
<p>In the <strong>Email</strong> tab, configure the following:</p>
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Setting</th><th style="padding:8px;border:1px solid #dee2e6;">Initial value</th><th style="padding:8px;border:1px solid #dee2e6;">Description</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Confirmation token lifetime</td><td style="padding:8px;border:1px solid #dee2e6;">24 hours</td><td style="padding:8px;border:1px solid #dee2e6;">The link is single-use and expires at its stored expiry time.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Resend delay</td><td style="padding:8px;border:1px solid #dee2e6;">2 minutes</td><td style="padding:8px;border:1px solid #dee2e6;">Minimum delay before requesting another email for the invoice.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Sender name</td><td style="padding:8px;border:1px solid #dee2e6;">Empty</td><td style="padding:8px;border:1px solid #dee2e6;">Optional name used with Dolibarr’s general sender address.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Verifalia verification</td><td style="padding:8px;border:1px solid #dee2e6;">Disabled</td><td style="padding:8px;border:1px solid #dee2e6;">Optional external deliverability check; requires API username and password.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Verifalia timeout</td><td style="padding:8px;border:1px solid #dee2e6;">20 seconds</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 5–30 seconds per call.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">PDF retrieval attempts</td><td style="padding:8px;border:1px solid #dee2e6;">4</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 1–6 checks of the same platform flow.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Delay between attempts</td><td style="padding:8px;border:1px solid #dee2e6;">2 seconds</td><td style="padding:8px;border:1px solid #dee2e6;">Allowed range: 1–5 seconds; no new transmission is made.</td></tr></table>
<p>The sender address comes from <code>MAIN_MAIL_EMAIL_FROM</code> in Dolibarr’s general email configuration. The module sender name is used for confirmation and PDF emails. If Verifalia is enabled without credentials, or its service rejects the request, submission is blocked with an appropriate error.</p>

<h2>8. Add the QR code to receipts</h2>
<h3>8.1. Browser receipt</h3>
<ol><li>Open the TakePOS setup and edit the relevant browser receipt template.</li><li>Insert the <code>__DOL_FAC_NUM__</code> tag once where the QR code should appear.</li><li>Save the template and print a receipt for a newly validated TakePOS invoice.</li></ol>
<p>On a browser receipt, the substitution displays a QR image produced by Dolibarr’s TCPDF engine, with the configured message. The module loads the invoice extrafields before performing the substitution.</p>
<h3>8.2. ESC/POS printer</h3>
<ol><li>In the RAW/Text printer setup, open the receipt template.</li><li>Add <code>{dol_fac_num}</code> once.</li><li>Select this template for the terminal and run a print check.</li></ol>
<p>The module documents this tag in the ESC/POS template help and replaces it with the native QR instruction <code>{dol_print_qrcode}</code> followed by the public URL. The ESC/POS replacements also recognize <code>{DOL_FAC_NUM}</code> and <code>{__DOL_FAC_NUM__}</code>. The QR message is sent as ESC/POS text after the code.</p>
<p>The module also prepares the substitutions <code>__DOL_FAC_NUM_URL__</code>, <code>dol_fac_num</code>, and <code>__dol_fac_num__</code>. If a valid hash is unavailable, substitutions are empty; while printing ESC/POS, the module tries to create the hash. If it fails, the tag is removed from the printout and an error is written to the Dolibarr log.</p>
<p>Do not add the tag in two locations in the same template. After enabling the module, verify a newly validated invoice: the hash is created by the TakePOS invoice validation trigger. Older receipts are not reprinted automatically.</p>

<h2>9. Public form and requested data</h2>
<p>The public page looks up the invoice using its hash. It requires the invoice to originate from TakePOS, the link to be within its lifetime, the invoice to be paid/closed, and the invoice still to be linked to the terminal’s default generic third party.</p>
<p>The public summary displays the seller, sale date, total including tax, terminal, and invoice reference masked except for its last four characters. It does not display sale lines, payment information, third-party identity, or the full invoice reference.</p>
<p>The form asks for:</p>
<ul><li>company name;</li><li>address and optional additional address;</li><li>postal code and town;</li><li>14-digit SIRET;</li><li>email address.</li></ul>
<p>The country is set to France in third-party processing; the form does not offer a country selector. The privacy policy link appears only when configured.</p>

<h2>10. Company and email checks</h2>
<h3>10.1. SIRET check</h3>
<p>The module queries the public Company Search API at <code>https://recherche-entreprises.api.gouv.fr/search?q=</code> using the submitted SIRET. It requires 14 digits, finds the matching establishment, and checks that its administrative status is active. It also compares the company name with the official data after normalizing accents, case, and separators, then compares the postal code and town (case and accents are normalized for the town).</p>
<p><strong>Current check limitation:</strong> the submitted street address is stored and may be used to create the third party, but the code does not compare it with the address returned by the API. Consistency checks cover the name, postal code, and town, not the street. A missing, closed, or invalid SIRET, or a mismatch in these checked fields, blocks submission. Network, DNS, TLS, timeout, unreadable-response, and service rate-limit errors produce specific or generic errors and do not create a third party.</p>
<h3>10.2. Email address check</h3>
<p>The module checks the email format, then uses DNS to check that the domain has an MX record. If Verifalia is enabled, its API is also called: addresses classified as undeliverable or disposable are rejected; deliverable, risky, and unknown results are accepted by this check. A service failure or credentials/credit error blocks submission when the option is enabled.</p>
<p>Email confirmation is still required even when Verifalia is disabled or returns an accepted result. The random token sent to the customer is stored hashed in the database, expires according to the configured duration, and can be used once. Resending is subject to the configured minimum delay.</p>

<h2>11. Confirmation and invoice processing</h2>
<ol><li>After a valid submission, the request is stored in the tracking table as <strong>Pending confirmation</strong>. A confirmation link is sent to the submitted address.</li><li>The customer opens the link before it expires. The token is consumed and the request changes to <strong>Ready</strong>.</li><li>Processing reloads the invoice and confirms it originates from TakePOS and is paid/closed. An atomic lock prevents the same request from being processed concurrently.</li><li>The module searches for a third party by exact SIRET, then by SIREN (the first nine digits), preferring an exact SIRET match. If none exists, it creates a French customer third party and lets Dolibarr assign the customer code.</li><li>The TakePOS invoice is linked to this third party. Generation or sending through EInvoicing is refused while the invoice is still linked to the terminal’s default third party.</li><li>The module checks that EInvoicing is enabled, its prerequisites are met, and its configured protocol is CII or Factur-X. It marks only this invoice as ready for EInvoicing generation.</li><li>EInvoicing generates a document for the selected protocol. For Factur-X, the Dolibarr source PDF is generated before requesting the hybrid Factur-X document. For CII, the protocol produces an XML file.</li><li>The provider configured in EInvoicing transmits the invoice to the approved platform. The module records the generation, transmission, and format steps.</li><li>The module queries the platform flow for its <strong>ReadableView</strong> resource, which must be a readable PDF. It makes the configured number of attempts if the view is not ready yet.</li><li>The official readable PDF is saved in the invoice document directory and emailed to the customer as an attachment.</li><li>After the email is sent successfully, the request changes to <strong>Completed</strong>.</li></ol>
<p>With CII, the XML file is used for transmission and the customer receives the platform’s official readable PDF. With Factur-X, the hybrid document is generated and transmitted, while the customer attachment remains the readable PDF retrieved from the platform. This module does not email the standard Dolibarr PDF to the customer.</p>

<h2>12. Request statuses</h2>
<table border="1" style="width:100%;border-collapse:collapse;border-color:#dee2e6;text-align:left;"><tr><th style="padding:8px;border:1px solid #dee2e6;">Status</th><th style="padding:8px;border:1px solid #dee2e6;">Meaning</th><th style="padding:8px;border:1px solid #dee2e6;">Next step</th></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Pending confirmation</td><td style="padding:8px;border:1px solid #dee2e6;">The request is stored, but its email address has not been confirmed.</td><td style="padding:8px;border:1px solid #dee2e6;">The customer must open the link before it expires.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Ready</td><td style="padding:8px;border:1px solid #dee2e6;">Email is confirmed and processing can start.</td><td style="padding:8px;border:1px solid #dee2e6;">Automatic processing or the Retry action.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Processing</td><td style="padding:8px;border:1px solid #dee2e6;">The request is reserved for processing.</td><td style="padding:8px;border:1px solid #dee2e6;">Wait for processing to finish and check detailed status.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Error</td><td style="padding:8px;border:1px solid #dee2e6;">A step failed; its error code and step are retained.</td><td style="padding:8px;border:1px solid #dee2e6;">Fix the cause and retry if email was confirmed.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Completed</td><td style="padding:8px;border:1px solid #dee2e6;">Transmission and PDF email both succeeded.</td><td style="padding:8px;border:1px solid #dee2e6;">The public link reports that the request has already been processed.</td></tr><tr><td style="padding:8px;border:1px solid #dee2e6;">Canceled</td><td style="padding:8px;border:1px solid #dee2e6;">The public link can no longer be used.</td><td style="padding:8px;border:1px solid #dee2e6;">No standard retry is offered.</td></tr></table>
<p>The table also stores separate indicators for email confirmation, SIRET validation, third-party linking, EInvoicing generation, platform transmission, PDF email, protocol used, error step, and creation, modification, completion, or cancellation dates.</p>

<h2>13. Track and manage requests</h2>
<h3>13.1. Request list</h3>
<p>Open <strong>Billing/Payments > TakePOS Digital Invoice</strong>. The list shows the invoice, third party when known, SIRET, email address, status, last error code, and creation date. Columns can be sorted and results are paginated. Filters include invoice reference, third party, SIRET, email, and status. Invoice and third-party references open their Dolibarr records.</p>
<h3>13.2. Invoice tab</h3>
<p>On a TakePOS invoice, open the <strong>TakePOS Digital Invoice</strong> tab. It shows status, creation and modification dates, email confirmation, requester email, SIRET, protocol, generation/transmission/PDF email status, and, on failure, the step and error message. A download button is available when a readable PDF is present.</p>
<h3>13.3. Retry</h3>
<p>Retry is offered for a request whose email has been confirmed and whose status is Ready or Error. Processing resumes and uses the recorded indicators and platform flow. If transmission already succeeded, retry does not send a second invoice; it attempts to retrieve the PDF and complete delivery to the customer.</p>
<h3>13.4. Cancel</h3>
<p>Cancel asks for confirmation, invalidates the public link, and marks the request canceled unless it is already completed or canceled. The TakePOS invoice cancellation trigger also cancels a non-completed request. The request remains available for tracking until it is purged.</p>

<h2>14. EInvoicing configuration and sending conditions</h2>
<p>TakePOS Digital Invoice does not replace EInvoicing or configure the approved platform. Configure the EInvoicing module separately: select the platform, credentials, and protocol. This version’s workflow accepts only the <code>CII</code> and <code>FACTURX</code> protocol values.</p>
<p>An anonymous TakePOS customer cannot receive an electronic invoice while the invoice remains linked to the terminal’s generic third party. The module checks this explicitly, including in the hook that intercepts direct EInvoicing generate or send actions on a TakePOS invoice. Identifying the customer makes only that invoice eligible; it does not change the global TakePOS invoice eligibility setting.</p>
<p>If the EInvoicing protocol is changed after transmission, the module blocks using a different format for that request and asks for the format associated with the already-submitted flow to be restored. This avoids an inconsistent or duplicate transmission.</p>

<h2>15. Stored data, files, and privacy</h2>
<ul><li><strong>Invoice extrafield:</strong> <code>hash</code>, a random 64-character public identifier. Do not publish it separately or edit it manually.</li><li><strong>Request table:</strong> entity, invoice, optional third party, SIRET, company name, address, postal code, town, email, hashed IP fingerprint, hashed token and expiry, counters, statuses, errors, and timestamps.</li><li><strong>Documents:</strong> the EInvoicing electronic file and the platform’s readable PDF are stored with the invoice documents.</li><li><strong>Public summary:</strong> limited sale-identification details; invoice lines, payments, and third-party identity are not exposed before identification.</li><li><strong>Logs:</strong> the dedicated log is <code>DOL_DATA_ROOT/takeposdigitalinvoice/module.log</code>. Technical error details may also be present in Dolibarr logs. Review and redact logs before sharing them.</li></ul>
<p>The retention task is scheduled daily. It deletes completed requests according to completion date and error requests according to modification date. This cleanup method does not delete pending, ready, processing, or canceled requests. The task that purges requests does not delete invoice documents.</p>

<h2>16. Triggers, hooks, and substitutions</h2>
<ul><li><strong><code>BILL_VALIDATE</code>:</strong> for a validated TakePOS invoice, the trigger ensures the public hash exists and creates it if missing.</li><li><strong><code>BILL_CANCEL</code>:</strong> for a canceled TakePOS invoice, the trigger cancels its non-completed request.</li><li><strong>Browser receipt:</strong> the hook loads invoice extrafields before TakePOS substitutions are processed.</li><li><strong>ESC/POS templates:</strong> the hook adds the QR tag description to template help and substitutes the tag in the text sent to the printer.</li><li><strong>EInvoicing actions:</strong> a hook blocks direct generation or sending for a TakePOS invoice that remains linked to the default third party.</li><li><strong>Substitutions:</strong> the module provides <code>__DOL_FAC_NUM__</code>, <code>__DOL_FAC_NUM_URL__</code>, <code>dol_fac_num</code>, and <code>__dol_fac_num__</code> for a TakePOS invoice with a valid hash.</li><li><strong>Scheduled task:</strong> periodically purges completed or error requests after their configured retention periods.</li></ul>

<h2>17. Troubleshooting</h2>
<h3>The QR code is missing from the browser receipt</h3><p>Check that the module is enabled, the invoice comes from TakePOS, the template contains <code>__DOL_FAC_NUM__</code>, and the invoice was validated after activation. Check that the tag is not repeated. Browser substitution requires the hash to be loaded in the invoice extrafields.</p>
<h3>The QR code is missing from the ESC/POS printout</h3><p>Check the active RAW/Text template, the exact recognized tag, and that the template does not already send an equivalent tag. If the hash could not be stored, check Dolibarr logs and database/write permissions.</p>
<h3>The public link is rejected</h3><p>The hash must be valid; the invoice must originate from TakePOS, be closed/paid, and remain linked to the terminal’s generic third party. The link expires based on the validation date and configured duration. A completed request is reported as already processed; a canceled request cannot be used.</p>
<h3>SIRET verification fails</h3><p>Check the 14 digits, establishment status, company name, postal code, and town. A mismatch in these values or an unavailable API blocks the request. Current code does not compare the submitted street with the API address.</p>
<h3>No confirmation email arrives</h3><p>Check the address, domain and MX record, Dolibarr outbound email setup, and spam folder. If Verifalia is enabled, check the credentials, configured timeout, and service authentication or credit errors.</p>
<h3>Confirmation succeeded but processing failed</h3><p>Check the latest error and failed step in the list or invoice tab. Verify the third-party link, EInvoicing activation and setup, CII/Factur-X protocol, and access to Dolibarr documents. Then use Retry if the user has process permission.</p>
<h3>Transmission succeeded but the PDF is not ready</h3><p>The platform may create its readable view asynchronously. Retry later; the module checks the existing flow and does not transmit the invoice again.</p>
<h3>The download button is unavailable</h3><p>The button is enabled when the saved readable PDF is available, or when the invoice tab can use an accessible EInvoicing PDF as a fallback.</p>

<h2>18. Limitations and operational precautions</h2>
<ul><li>The current public workflow is for French companies with an active SIRET; it does not support individuals or foreign companies.</li><li>Establishment consistency checks cover company name, postal code, and town; current code does not compare the street address with official data.</li><li>The module retains one request per invoice. Do not create concurrent requests for the same invoice.</li><li>Do not manually remove or edit the hash, tokens, or processing indicators in the database.</li><li>Do not change the EInvoicing protocol during a request that has already been transmitted without restoring the format of its existing flow.</li><li>Do not edit the invoice’s third party while it is being processed.</li><li>Cleanup removes completed and error request history after the configured retention periods; retain any needed tracking information before then.</li></ul>

<h2>19. Support</h2>
<p>For help or to report a problem, contact [mailto:contact@01consulting.eu contact@01consulting.eu]. Include the module and Dolibarr versions, receipt type, workflow step, request status, error code, and approximate time. Redact SIRET, email addresses, tokens, platform credentials, invoice details, and any other confidential information from screenshots and log extracts.</p>

</div></div>
[[fr:TakePOS_Digital_Invoice_FR]]

← Older revision		Revision as of 14:31, 29 September 2026
Line 114:		Line 114:

	</div></div>		</div></div>
	[[fr:~~TakePOS_Digital_Invoice_FR~~]]		[[fr:Facture_numérique_pour_TakePOS]]

TakePOS Digital Invoice - Revision history

Abahfir at 14:31, 29 September 2026

Abahfir: module takepos digital invoice