Factur-X: volledige gids (PrestaShop 8 en 9)

Deze gids behandelt de installatie, de configuratie en het gebruik van DataFirefly Factur-X (dffacturx) 2.0.0 voor PrestaShop 8 en 9. De module zet de standaardfacturen en -creditnota’s van PrestaShop om in elektronische Factur-X-facturen: een leesbare en afdrukbare PDF/A-3 die de XML CII van de norm EN 16931 bevat. Elk document wordt gecontroleerd zodra het is gegenereerd en krijgt een eigen conformiteitsrapport.

Overzicht

Een Factur-X-factuur is één bestand. Uw klant opent een gewone PDF; zijn boekhoudsoftware of zijn platform leest de ingesloten XML. De module:

• rendert de standaardfactuur en -creditnota van PrestaShop als PDF/A-3b, met uw sjabloon en de modules die de factuur aanpassen, en sluit er factur-x.xml in in;
• bouwt de XML op uit de bedragen van de factuur, in het gekozen profiel: MINIMUM, BASIC WL, BASIC, EN 16931 of EXTENDED;
• voegt de gegevens en vermeldingen van de Franse hervorming 2026/2027 toe, in de XML en op de PDF;
• controleert elk document en toont een conformiteitsrapport;
• stelt de documenten beschikbaar in het klantaccount en in de e-mails, en bereidt ZIP-exports voor (PDF, CII, UBL 2.1, batch voor een erkend platform).

Vereisten

• PrestaShop 8.0 tot 9.x (getest op 9.1.5 en 8.2.1, thema’s Classic en Hummingbird).
• PHP 7.4 minimaal, 8.1 of hoger aanbevolen.
• PHP-extensies dom, libxml en zlib; zip voor de ZIP-exports.
• Geen externe afhankelijkheden: geen Composer, geen Java. TCPDF is die van PrestaShop.

Installatie en update

1. Open in de back-office Modules > Modulebeheer en klik op Een module uploaden.
2. Upload het bestand dffacturx-2.0.0.zip.
3. Open Bestellingen > Factur-X. Zolang de configuratie niet is voltooid, biedt het dashboard de configuratie-assistent aan.

Bij de installatie worden de bedrijfsnaam, het adres, het telefoonnummer en het e-mailadres overgenomen uit de winkelgegevens, en worden de betaalwijzecodes gedetecteerd voor de geïnstalleerde betaalmodules.

Update vanaf 1.0.0: installeer de zip van 2.0.0 over de bestaande versie heen. Uw instellingen blijven behouden, de documententabel wordt aangemaakt en de oude map generated/ wordt afgesloten voor webtoegang (er worden geen bestanden verwijderd). Was uw SIREN (het Franse ondernemingsnummer) al ingevuld, dan wordt de assistent als voltooid beschouwd; open de stappen toch om de nieuwe instellingen te controleren.

Configuratie-assistent

De assistent staat onder Bestellingen > Factur-X > Instellingen. Hij telt vijf stappen; elk veld wordt bij het opslaan gecontroleerd. In een multistore-installatie gebeurt de configuratie per winkel.

1. Bedrijf

• Bedrijfsnaam, rechtsvorm, maatschappelijk kapitaal en RCS (Frans handelsregister): overgenomen in de wettelijke notitie van de XML.
• SIREN (9 cijfers, het Franse ondernemingsnummer) en SIRET (14 cijfers, het nummer van de vestiging): het controlecijfer wordt gecontroleerd. Het SIREN wordt doorgegeven met de schema-identificatie 0002, het SIRET met 0009.
• Intracommunautair btw-nummer: de FR-sleutel wordt gecontroleerd en het nummer wordt voorgesteld op basis van het SIREN.
• Elektronisch factuuradres (adresboek van de hervorming): standaard het SIREN.
• Adres, contactpersoon, telefoon en e-mail.

2. Profiel

Het profiel bepaalt de inhoud van de XML:

• EN 16931 (aanbevolen): de volledige basis van de Europese norm.
• EXTENDED: aanvullende gegevens, vrijstellingsredenen herhaald op de regels.
• BASIC: factuurregels, zonder contactpersoon en zonder afronding.
• MINIMUM en BASIC WL: zonder regels. Zij vormen geen volledige factuur in de zin van de hervorming; de assistent geeft dat aan.

De optie Factuurnummer aanvaard door de Franse regels verwijdert uit het elektronische nummer de tekens die de Franse regels weigeren (bijvoorbeeld #). De facturen worden niet hernummerd: de PDF vermeldt dan het elektronische nummer.

3. Btw

De module kent automatisch een btw-categorie toe aan elke regel:

• S: positief tarief;
• G: export buiten de Europese Unie (of O voor een factuur voor diensten);
• K: intracommunautaire levering van goederen aan een klant met btw-nummer; AE voor diensten (btw verlegd);
• E: vrijstelling, met de reden VATEX-FR-FRANCHISE als u onder de btw-vrijstelling voor kleine ondernemers valt (franchise en base).

Voor een situatie die eigen is aan uw activiteit koppelt u een categorie en een VATEX-code aan een belastingregel. De standaardteksten voor de vrijstellingsredenen zijn Franse wetteksten en kunnen worden aangepast.

4. Betaling

• IBAN en BIC: verplicht bij betaling per overschrijving; de IBAN wordt gecontroleerd.
• Betalingstermijn: dient om de vervaldatum van onbetaalde facturen te berekenen.
• Vermeldingen: boetes bij laattijdige betaling (PMD), forfaitaire invorderingsvergoeding van 40 € (PMT), korting voor vroegtijdige betaling (AAB).
• Keuze voor betaling van de btw op basis van facturering (TVA sur les débits), als u daarvoor hebt gekozen.
• Betaalwijzecode per betaalmodule (UNTDID 4461): automatisch gedetecteerd, aanpasbaar.

Voor een factuur die al is betaald, vermeldt de XML het betaalde bedrag, een te betalen bedrag van nul en de betaaldatum.

5. Verspreiding

• Automatisch genereren: bij elke nieuwe factuur en elke nieuwe creditnota wordt een document aangemaakt.
• Standaardfacturen in Factur-X (PrestaShop 9): de factuur- en creditnota-PDF’s van de back-office, het klantaccount en de e-mails worden Factur-X. Bulkexports van meerdere facturen blijven PDF/A-3 zonder XML, en de leveringsbonnen veranderen niet.
• Factur-X in de e-mails: de factuur die als bijlage bij de PrestaShop-e-mails wordt gevoegd, wordt vervangen door de Factur-X-versie.
• Download in het klantaccount: blok in het besteldetail en pagina “Mijn elektronische facturen”.
• Nieuwe vermeldingen op de PDF-factuur: soort handeling, SIREN van de klant, vrijstellingsredenen, oorspronkelijke factuur van een creditnota.

Dashboard

Het dashboard telt de documenten die gegenereerd, conform, met waarschuwingen, met fouten, nog niet gegenereerd en geëxporteerd zijn. De knop Ontbrekende documenten genereren verwerkt de facturen en creditnota’s in batches, met een voortgangsbalk. U vindt er ook de recentste documenten, een indicator voor de gereedheid voor de hervorming en het tijdpad.

Documenten en exports

De pagina Documenten toont de facturen en creditnota’s met hun profiel, hun btw-categorieën en hun status. U kunt zoeken op nummer of op klant, filteren op conformiteit, type, periode of exportstatus, en daarna documenten selecteren om:

• een ZIP te downloaden van Factur-X-PDF’s, van CII-XML of van UBL 2.1-XML;
• een batch voor een erkend platform voor te bereiden: de PDF’s, een bestand index.csv en een bestand SHA256SUMS. De documenten worden gemarkeerd als geëxporteerd; het versturen naar het platform doet u zelf;
• documenten opnieuw te genereren, bijvoorbeeld na een correctie in de instellingen.

Conformiteitsrapport

Elk document heeft een eigen rapport. De controles zijn ingedeeld in fouten, waarschuwingen en informatie, met de code van de betrokken regel (BR-…, BR-FR-…). Het rapport toont de regels, de btw-uitsplitsing en de totalen BT-106 tot BT-115, vergeleken met het totaal van de PrestaShop-factuur.

De ingesloten XML wordt in kleur getoond en kan worden gekopieerd.

De ingebouwde controle verifieert het XSD-schema Factur-X 1.09.2 van het profiel, de belangrijkste regels van EN 16931 (totalen, uitsplitsing, categorieën, betaling) en de Franse controles. Een document met fouten wordt nooit aan de klant aangeboden en nooit in de standaard-PDF opgenomen.

Paneel op de bestelpagina

Op elke bestelling toont het Factur-X-paneel de facturen en creditnota’s met hun status en de knoppen PDF, CII, UBL en rapport. Is de bestelling na het genereren gewijzigd, dan stelt een melding voor om het document opnieuw te genereren.

De PDF/A-3-factuur

De PDF is uw standaard PrestaShop-factuur, gerenderd als PDF/A-3b, met de ingesloten XML en de XMP-metadata van Factur-X. De relevante vermeldingen van de hervorming worden onderaan de factuur toegevoegd via de PDF-hooks van PrestaShop, zonder uw sjablonen te wijzigen. Is de module DataFirefly Invoice Editor actief, dan blijft de opmaak daarvan behouden.

Klantaccount en e-mails

Wanneer de factuur zichtbaar is voor de klant (dezelfde regel als in PrestaShop: een bestelstatus met factuur), downloadt hij ze in Factur-X vanuit het detail van zijn bestelling of vanaf de pagina Mijn elektronische facturen, samen met de XML. De module controleert of het document bij de ingelogde klant hoort.

Valideren vóór de ingebruikname

Genereer enkele facturen die representatief zijn voor uw activiteit (meerdere btw-tarieven, korting, zakelijke klant, buitenlandse klant, creditnota) en controleer ze daarna met de officiële validators:

• de validatiedienst van de FNFE-MPE of Mustang, voor de XML en de Franse regels;
• veraPDF, voor de PDF/A-3-conformiteit.

De knop CII in het bestelpaneel downloadt alleen de XML, wat handig is tijdens deze fase.

Hervorming 2026/2027: wat de module doet

In Frankrijk moeten alle btw-plichtige ondernemingen vanaf 1 september 2026 elektronische facturen kunnen ontvangen. Het uitreiken wordt op die datum verplicht voor grote ondernemingen en middelgrote ondernemingen (ETI), en vanaf 1 september 2027 voor kmo’s en micro-ondernemingen.

• Aanmaken en controleren van Factur-X-facturen met de gegevens van de hervorming: dat is de rol van de module. Er is geen certificering nodig.
• Versturen van de facturen en de e-reporting: dat is de rol van het erkende platform (PA) dat u kiest. De module bereidt de bestanden en de exportbatch voor; hij verstuurt niets.

De hulppagina Hervorming 2026/2027 van de module toont het tijdpad, de profielen, de validators en een FAQ.

Problemen oplossen

Een document bevat fouten

Open het rapport: elke fout vermeldt de regel en het betrokken gegeven. De meest voorkomende oorzaken zijn een ontbrekend SIREN of btw-nummer, een ontbrekende IBAN bij betaling per overschrijving, of een onvolledig klantadres. Corrigeer de instelling of het gegeven en genereer het document daarna opnieuw.

Waarschuwing over de milieubijdrage

Wanneer de ecotaksfunctie in PrestaShop is uitgeschakeld, blijft de milieubijdrage (éco-participation) in de prijs van de regels staan, maar niet in de totalen van de bestelling. De XML volgt het werkelijk gefactureerde totaal en het rapport meldt dit. Controleer uw ecotaksinstellingen en de bijbehorende belastingregel.

De factuur verschijnt niet in het klantaccount

De klant ziet zijn facturen wanneer de bestelstatus de factuur toestaat, zoals in PrestaShop. Controleer ook de optie Download in het klantaccount in de stap Verspreiding, en of het document geen fouten bevat.

De ZIP-exports zijn niet beschikbaar

De PHP-extensie zip is niet ingeschakeld op de server. Losse downloads blijven beschikbaar.

Het logo ontbreekt op de factuur

PrestaShop laadt het logo van de factuur via de URL van de winkel. Kan de server zijn eigen URL niet bereiken, dan ontbreekt het logo ook op de standaardfacturen; het probleem ligt dan bij de serverconfiguratie, niet bij de module.

Changelog

2.0.0 (2 november 2026)

• XML CII herschreven: namespaces, schemavolgorde en inhoud eigen aan elk profiel.
• Standaardfactuur en -creditnota van PrestaShop gerenderd als PDF/A-3b, XMP-metadata gecorrigeerd.
• Bedragen overgenomen van de PrestaShop-factuur: kortingen per tarief, verzending, verpakking, milieubijdrage, afrondingen.
• Btw-categorieën S, Z, E, AE, K, G, O met vrijstellingsredenen; creditnota’s (type 381); facturen in vreemde valuta.
• Gegevens en vermeldingen van de Franse hervorming in de XML en op de PDF.
• Ingebouwde controle en conformiteitsrapport per document.
• Nieuwe back-office: dashboard, documenten, assistent, hulp bij de hervorming, bestelpaneel.
• ZIP-exports in PDF, CII en UBL 2.1; batch voor een erkend platform.
• Klantaccount gecorrigeerd, Factur-X in de e-mails, standaardfacturen in Factur-X op PrestaShop 9.
• Beveiliging: geen bestanden meer in een openbare map, geen factuur zonder PrestaShop-nummer.
• Vertalingen FR, EN, ES, DE, IT, PL, NL, PT; update vanaf 1.0.0 met behoud van de instellingen.

1.0.0 (4 juni 2026)

• Eerste versie: genereren van Factur-X-facturen (PDF/A-3 + XML CII), profielen BASIC, EN 16931 en EXTENDED, downloaden vanaf de bestelling, massaal genereren, link in het klantaccount.