PS PrestaShop Beginner

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.

Bijgewerkt Moduleversie 1.0.2

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.

Belangrijkste toepassing: B2B-situaties waarin de klant een proforma nodig heeft voordat hij zijn betaling bevestigt of intern een uitgave laat goedkeuren.

Installatie

  1. Ga in de PrestaShop-backoffice naar Modules > Modulebeheer.
  2. Klik op Een module uploaden en kies het bestand dfproforma.zip.
  3. Klik op Installeren. De SQL-tabellen worden automatisch aangemaakt.
  4. De module verschijnt in de lijst onder de naam Proforma Invoice Generator.
Compatibiliteit: PrestaShop 8.0 tot 8.x, PHP 7.4 tot 8.3, multistore.

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.

Aanbeveling: kies de status Betaling aanvaard voor standaardstromen, of In afwachting van betaling voor B2B-situaties, waar de proforma aan de betaling voorafgaat.

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 PROFORMA of PRO).
  • Startnummer: het gehele getal waarmee de teller begint (bijvoorbeeld 1 of 1000).
  • Aantal cijfers: de lengte van de teller met voorloopnullen (bijvoorbeeld 6 geeft 000001).

Voorbeeld: voorvoegsel PROFORMA, start 1 en 6 cijfers geeft als eerste proformanummer PROFORMA-000001.

In multistore is de nummering per winkel gescheiden: de samengestelde sleutel 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.
Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support