# dfproforma: proformafacturen automatisch aanmaken

> 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…

- Pagina: <https://www.datafirefly.com/nl/documentation/dfproforma/>
- Taal: nl
- Bijgewerkt op: 2026-09-09
- Andere talen: [fr](https://www.datafirefly.com/documentation/dfproforma/index.md), [en](https://www.datafirefly.com/en/documentation/dfproforma/index.md), [es](https://www.datafirefly.com/es/documentation/dfproforma/index.md), [de](https://www.datafirefly.com/de/documentation/dfproforma/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfproforma/index.md), [it](https://www.datafirefly.com/it/documentation/dfproforma/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfproforma/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

## 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.