dfproforma: proformafacturen automatisch aanmaken
Maak in PrestaShop 8 automatisch PDF-proformafacturen aan op basis van de besteltoestand, met verzending per e-mail, downloaden door de klant en volledig beheer in de backoffice.
Overzicht
dfproforma automatiseert het aanmaken van proformafacturen in PrestaShop 8. Zodra een bestelling een ingestelde status bereikt, maakt de module een aangepaste PDF aan (logo, nummering, meertalige voettekst) en stelt hij die voor de klant beschikbaar in zijn accountzone. Handmatig aanmaken vanaf de bestelfiche blijft altijd mogelijk.
Installatie
- Ga in de PrestaShop-backoffice naar Modules > Modulebeheer.
- Klik op Een module uploaden en kies het bestand
dfproforma.zip. - Klik op Installeren. De SQL-tabellen worden automatisch aangemaakt.
- De module verschijnt in de lijst onder de naam Proforma Invoice Generator.
Algemene configuratie
De configuratie bereikt u via Modules > Modulebeheer > dfproforma > Configureren.
Statussen die de generatie starten
Vink de besteltoestanden aan die de automatische generatie van de proforma moeten uitlokken. Zodra een bestelling in een van die toestanden komt, wordt de PDF aangemaakt en op de server bewaard.
Logo op de PDF
Upload een eigen logo voor de proforma’s (aanvaarde formaten: PNG, JPG). Laat u dit veld leeg, dan wordt het logo van de winkel gebruikt.
Bijlage bij e-mails
Schakel de optie De proforma aan de bevestigingsmails hechten in zodat de PDF automatisch aan de bestelmails wordt toegevoegd (order_conf, bankwire, cheque, payment).
Nummering van de proforma’s
De nummering is per geïnstalleerde taal in te stellen. Per taal:
- Voorvoegsel: tekst vóór het nummer (bijvoorbeeld
PROFORMAofPRO). - Startnummer: het gehele getal waarmee de teller begint (bijvoorbeeld
1of1000). - Aantal cijfers: de lengte van de teller met voorloopnullen (bijvoorbeeld
6geeft000001).
Voorbeeld: voorvoegsel PROFORMA, start 1 en 6 cijfers geeft als eerste proformanummer PROFORMA-000001.
proforma_number + id_shop waarborgt de uniciteit zonder dubbels tussen winkels.
Voettekst van de PDF
Voer de voettekst voor elke actieve taal in. Die tekst verschijnt onder aan elke proforma in de bijbehorende taal.
Handmatig aanmaken in de backoffice
Op elke bestelfiche verschijnt in het zijpaneel een kaart Proformafactuur:
- Bestaat er al een proforma, dan staat er een rechtstreekse downloadlink naar de PDF.
- Bestaat er nog geen proforma, dan verschijnt een knop De proforma aanmaken om die meteen te maken, ongeacht de status van de bestelling.
Downloaden door de klant
De klant vindt zijn proforma’s in zijn accountzone:
- Detailpagina van de bestelling: een knop De proforma downloaden verschijnt meteen onder de bestelgegevens.
- Bestelhistoriek: de proformalinks worden via JavaScript ingevoegd zonder extra AJAX-verzoek (toegevoegd in v1.0.2).
De toegang is beveiligd met de beveiligde sleutel van de bestelling (secure_key): een klant kan alleen zijn eigen proforma’s downloaden.
Opbouw van de PDF
Elke gegenereerde proforma bevat:
- Het proformanummer (volgens de ingestelde nummering)
- De aanmaakdatum
- Het logo van de winkel (of het eigen logo)
- De gegevens van de winkel en van de koper
- De producttabel met aantallen en stukprijzen exclusief en inclusief btw
- De totalen (exclusief btw, btw, inclusief btw, verzendkosten)
- De eigen voettekst in de taal van de bestelling
Multistore
dfproforma werkt van nature samen met de multistoremodus van PrestaShop 8:
- De configuratie (statussen, logo, nummering, voettekst) staat los per winkel.
- De PDF-bestanden komen in een aparte map per winkel.
- De nummering is uniek per combinatie van nummer en winkel.
Verwijderen
Bij het verwijderen worden de SQL-tabel df_proforma en alle configuratiesleutels met het voorvoegsel DFPROFORMA_ gewist. De al aangemaakte PDF-bestanden blijven op de server staan.
Changelog
- v1.0.2: integratie in de bestelhistoriek via de hook
actionFrontControllerSetMedia, met weergave van de links zonder extra AJAX. - v1.0.1: kleine stabiliteitscorrecties.
- v1.0.0: eerste versie met generatie op basis van de status, aanpasbare PDF, e-mailbijlage en downloaden door de klant.