cialinux/dolibarr-saft ? reverse-engineered prompt

Build me a Dolibarr module for SAF T Portugal that lets me upload a SAF T XML file, validate it, and preview the invoices before importing anything. I want it to read the file, show how many documents it contains, flag errors or missing data, and tell me which invoices are already in Dolibarr so I can avoid duplicates.

It should import invoices one by one or in bulk, and if a customer does not exist yet, create it automatically from the data in the XML, including name, tax number, address, country, postal code, and city. For every imported invoice, save the important traceability details in the notes, like the SAF T origin, import date, official invoice number, hash, source ID, original document date, and any exception tax information.

If part of the heavy validation logic needs to talk to an external SAF T validation API, wire it up cleanly and make it easy to configure. Please keep the interface simple inside Dolibarr and look up current docs online if you need to.