PS PrestaShop Beginner

DataFirefly Factuureditor voor PrestaShop

Installeer de module, stel logo, kolommen, eigen velden, wettelijke vermeldingen per land, vervaldatum en SEPA-QR-code in en controleer de factuur met het voorbeeld.

Bijgewerkt Moduleversie 1.1.0

Overzicht

De module dfinvoiceeditor vervangt de opmaak van de PDF-facturen van PrestaShop 8 en 9 door uw eigen opmaak, ingesteld in de back-office. Ze wijzigt geen enkel .tpl-bestand en installeert geen override: wanneer PrestaShop een factuur maakt, levert de module een eigen kop, inhoud en voettekst. Schakelt u de module of de hoofdschakelaar uit, dan komt de originele factuur terug.

De instellingen gelden voor elke factuur die PrestaShop maakt: de factuur bij de bestelmails, de factuur die de klant in zijn account downloadt en facturen die afzonderlijk of in bulk vanuit de back-office worden afgedrukt. Optioneel krijgen pakbonnen dezelfde opmaak.

Dezelfde factuur afgedrukt door PrestaShop (links) en door de factuureditor (rechts): logo, verkopersblok, overzicht, btw-specificatie en bankgegevens
PrestaShop-factuur voor en na

Installatie

  1. Klik in Modules > Modulebeheer op Een module uploaden en kies het bestand dfinvoiceeditor-1.1.0.zip.
  2. De module maakt een instellingentabel, de map img/dfinvoiceeditor voor het logo en de pagina Bestellingen > Factuureditor aan.
  3. Open die pagina. De opmaak van de module is vanaf de installatie actief met sobere standaardinstellingen: maak een voorbeeld om hem te zien.

De module werkt met PrestaShop 8.0 tot 9.x, in multistore (instellingen per winkel) en meertalig. Er is geen Composer-afhankelijkheid nodig.

Bijwerken naar versie 1.1.0

Upload dfinvoiceeditor-1.1.0.zip in Modulebeheer en klik op Bijwerken. Instellingen, teksten, eigen velden, regels en het logo blijven ongewijzigd. Versie 1.1.0 verhelpt:

  • Poolse, Tsjechische of Turkse tekens die als „?” werden afgedrukt wanneer de medewerker die de factuur downloadt in een andere taal werkt dan die van de bestelling;
  • de btw-specificatie van een vrijgestelde factuur (btw verlegd, export), die alleen de verzending als grondslag toonde;
  • combinaties in het formaat van PrestaShop 8 en 9, die midden in de haakjes werden afgebroken;
  • de voettekst, die alleen op de laatste pagina stond en bij een bulkexport de voettekst van de vorige factuur herhaalde;
  • het land van de klant en de labels van personalisaties, nu in de taal van de factuur.

De editor

De pagina is verdeeld in secties die in de linkerkolom staan. Onder de lijst markeert een schets van een A4-pagina het deel van de factuur dat u instelt. De balk onderaan toont of er niet-opgeslagen wijzigingen zijn en bevat de knop Opslaan.

Afgedrukte teksten bestaan in elke taal van de winkel. De taalknoppen onder de kop kiezen welke taal in alle meertalige velden wordt getoond.

Voorbeeld en vergelijking

Kies bovenaan de pagina een recente factuur van de winkel en daarna Factuur of Pakbon:

  • Voorbeeld opent de PDF in een nieuw tabblad met de instellingen op het scherm, ook als ze niet zijn opgeslagen. Alleen een pas geüpload logo wacht op het opslaan.
  • Vergelijken met de PrestaShop-factuur opent hetzelfde document in de originele opmaak.

Algemene instellingen

  • Deze opmaak gebruiken voor facturen: de hoofdschakelaar. Uitgeschakeld drukt PrestaShop weer zijn eigen factuur af, zonder dat instellingen verloren gaan.
  • Deze opmaak ook voor pakbonnen gebruiken: zie de sectie Pakbonnen.
  • Taal van de factuur: de taal van de bestelling (aanbevolen) of die van de medewerker die de PDF maakt.
  • Lettertype: automatisch per taal, Helvetica, DejaVu Sans, Times of Courier. DejaVu Sans dekt ook Pools, Grieks en Cyrillisch. Het automatische lettertype volgt de taal van de factuur, ook als de medewerker die haar downloadt in een andere taal werkt.
  • Tekstgrootte van 7 tot 12 pt en vier kleuren: accent (titel, tabelkop, te betalen totaal, sectietitels), tekst, secundaire tekst en tekst op de accentkleur.
PrestaShop-factuureditor, sectie Algemeen: lay-out actief, factuurtaal, automatisch lettertype per taal, tekstgrootte en kleuren
Factuureditor: algemene instellingen

Kies het factuurlogo van de winkel, een apart factuurlogo of geen logo. Het aparte logo accepteert PNG, JPG of GIF tot 2 MB; een PNG van minstens 600 px breed wordt scherp afgedrukt. Stel de breedte in van 10 tot 90 mm en de positie links of rechts. De hoogte is begrensd op 26 mm, zodat de kop nooit over de inhoud valt.

Koptekst en logo: eigen logo voor facturen, breedte en positie van het logo, factuurdatum onder het nummer
Factuurkop en logo

Adressen en overzicht

Het verkopersblok is vrije tekst met variabelen, standaard {shop_name}, {shop_address} en {shop_details} (de gegevens uit Winkelinstellingen > Contact). Factuur- en afleveradres volgen het adresformaat van het land; het afleveradres kan worden verborgen als het gelijk is aan het factuuradres. De module vergelijkt de adressen zoals ze worden afgedrukt (bedrijf, naam, straat, postcode, plaats, land), zonder telefoon, btw-nummer en DNI: een adres dat de klant twee keer heeft opgeslagen, wordt dus ook verborgen. Btw-nummer, telefoon en e-mail van de klant zijn optioneel.

Waar het verkopersblok komt: in de adresregel (standaard) of onder het logo, in de kop. Onder het logo deelt het blok de ongeveer 35 mm die PrestaShop voor de kop reserveert. De module meet de tekst op elke factuur en geeft het logo de resterende hoogte, nooit minder dan 12 mm. Is het blok te lang, dan komt het onder het logo in twee kolommen, daarna kleiner. Er wordt geen regel afgekapt. In het zeldzame geval dat twee kolommen niet volstaan, houdt het logo zijn grootte en wordt het blok direct onder de kop afgedrukt, bovenaan de eerste pagina. Wilt u een groot logo houden, gebruik dan {shop_address_inline}, dat het adres op één regel zet. De tekst onderaan elke pagina is de voettekst van de module, die u apart instelt in de sectie Voettekst.

De overzichtsbalk, een gekleurde band onder de adressen, toont naar keuze bestelreferentie en -datum, betaling, vervaldatum, vervoerder en trackingnummer, plus eigen velden die in de balk zijn geplaatst.

Adressen en overzicht: verkopersblok met bedrijfsnaam, adres, registratie- en btw-nummer, factuur- en afleveradres, overzichtsbalk
Verkopersblok en adressen

Productregels

De tabel bevat de 12 beschikbare kolommen: afbeelding, referentie, naam, EAN-13, leveranciersreferentie, stuksprijs excl. btw, stuksprijs incl. btw, korting, btw-tarief, aantal, totaal excl. btw, totaal incl. btw. Vink per kolom het afdrukken aan, wijzig de titel in elke taal, stel de relatieve breedte en uitlijning in en verander de volgorde met de pijlen. De strook erboven toont de verdeling van de breedtes; ze worden aan de pagina aangepast.

  • Combinaties („Maat: M, Kleur: Blauw”) komen op een tweede, kleinere regel. Beide naamformaten van PrestaShop worden herkend: „T-shirt (Maat: M – Kleur: Blauw)” en „T-shirt – Maat: M – Kleur: Blauw”.
  • Personalisaties van de klant worden onder de productnaam afgedrukt.
  • De productminiatuur meet 6 tot 25 mm.
  • Lijn onder elke regel, volledig raster of geen randen; optioneel afwisselend gearceerde regels.
  • Kolomtitels herhalen zich bovenaan elke pagina van een lange factuur.
Productregels: kolommen van de factuur kiezen, ordenen en breedte instellen (artikelnummer, product, stukprijs, btw, aantal, totaal)
Kolommen van de productregels

Totalen

  • Btw-specificatie per tarief: grondslag en bedrag per tarief, met producten, verzending, cadeauverpakking en milieubijdrage samen. Een factuur zonder btw (btw verlegd, export) toont één regel van 0% over de hele grondslag.
  • Kortingen: de namen van de toegepaste kortingsbonnen en winkelwagenregels staan onder de kortingsregel, zoals op de PrestaShop-factuur.
  • Nulregels verbergen voor korting en cadeauverpakking.
  • Ontvangen betalingen opsommen met methode, bedrag en datum.
  • Inhoud van andere modules: wat andere modules via de hook displayPDFInvoice aan facturen toevoegen, wordt nog steeds afgedrukt, na de totalen, na de productregels of verborgen.

Betaling en vervaldatum

Vervaldatum en openstaand bedrag

De betalingstermijn in dagen na de factuurdatum drukt de vervaldatum af in de overzichtsbalk en vult de variabele {due_date}. Laat 0 staan om geen vervaldatum af te drukken.

Is een factuur gedeeltelijk betaald, dan verschijnen onder het totaal incl. btw de regels Al betaald en Te betalen. Het betaalde bedrag is de som van de betalingen die in PrestaShop aan de factuur gekoppeld zijn. De optionele stempel Betaald wordt onder de totalen afgedrukt zodra de factuur voldaan is.

Bankgegevens en SEPA-QR-code

Kies wanneer het bankblok wordt afgedrukt: nooit, alleen als er een bedrag openstaat, of altijd. Vul rekeninghouder (leeg = winkelnaam), bank, IBAN, BIC en betalingskenmerk in, standaard {invoice_number}. De IBAN wordt met de controlegetallen gecontroleerd: een foute IBAN wordt gemarkeerd en blokkeert het opslaan.

De SEPA-QR-code (EPC069-12-formaat) bevat begunstigde, IBAN, BIC, openstaand bedrag en kenmerk. De klant scant hem met zijn bankapp en de overschrijving is ingevuld. Hij wordt alleen afgedrukt op facturen in euro en alleen als er een bedrag openstaat.

Betaling en vervaldatum: betalingstermijn in dagen, stempel „Betaald”, bankgegevens (IBAN, BIC) en SEPA-QR-code met het te betalen bedrag
Vervaldatum, IBAN en SEPA-QR-code

Eigen velden

Voeg zoveel velden toe als nodig: inkoopordernummer, KvK-nummer van de klant, betalingsvoorwaarden, bericht van de klant. Elk veld heeft:

  • een label en inhoud in elke taal, met vet, cursief en onderstreept;
  • een positie: overzichtsbalk, onder de adressen, onder de productregels, onder de totalen of in de voettekst;
  • de keuze Afdrukken op: facturen, pakbonnen of beide;
  • de optie Verbergen als de variabelen leeg zijn;
  • voorwaarden voor afdrukken (zie verderop).

Het paneel Variabelen voegt een variabele in het laatst bewerkte veld in. De variabelen dekken de winkel (naam, adres, e-mail, telefoon, gegevens), bestelling en factuur (nummer, data, vervaldatum, openstaand bedrag, betaling, vervoerder, tracking, pakbonnummer, valuta) en de klant (naam, bedrijf, e-mail, btw-nummer, SIRET, APE, DNI, telefoonnummers, bericht bij de bestelling).

Eigen velden: betalingsvoorwaarden in de overzichtsbalk alleen voor bedrijven en een tekst onder de totalen, elk met eigen afdrukvoorwaarden
Eigen velden met voorwaarden

Wettelijke vermeldingen per land

Elke regel bevat een tekst per taal en voorwaarden. Alle regels die op de factuur van toepassing zijn, worden in de volgorde van de lijst afgedrukt, in een kader onder de totalen of in de voettekst.

Voorwaarden

  • Bestemming: alle landen, land van de winkel, Europese Unie, EU behalve het land van de winkel, buiten de EU, of een lijst van landen. Klik op een land om het te kiezen of te verwijderen.
  • Klant: alle, met of zonder btw-nummer, bedrijf of particulier.
  • Btw op de factuur: met of zonder btw.

Het referentieland is standaard dat van het adres dat PrestaShop voor de btw-berekening gebruikt; u kunt het factuur- of afleveradres afdwingen.

Voorbeeldregels

Vier regels worden inactief geïnstalleerd: vrijgestelde intracommunautaire levering (artikel 138 van Richtlijn 2006/112/EG, met het btw-nummer van de klant), B2B-diensten in de EU met btw verlegd (artikel 196, toegevoegd in 1.1.0 voor nieuwe installaties en na „Standaardinstellingen herstellen”), export buiten de EU (artikel 146) en Franse B2B-betalingsvoorwaarden (boete en vaste vergoeding van 40 EUR). Laat de tekst door uw boekhouder controleren voordat u ze activeert.

Met DataFirefly VIES B2B drukt die module de vermelding btw verlegd met het VIES-raadplegingsnummer al af op vrijgestelde facturen, in het blok „Inhoud van andere modules”. Laat de EU-voorbeeldregels dan uitgeschakeld, zodat de vermelding niet twee keer verschijnt: de editor toont een herinnering wanneer VIES B2B actief is.

Wettelijke vermeldingen per land: voorbeeldregels voor intracommunautaire levering, btw verlegd op diensten en export, met voorwaarden voor bestemming, klant en btw
Wettelijke vermeldingen per land
B2B-pdf-factuur zonder btw: btw-specificatie 0%, stempel „Betaald”, bankgegevens en vermelding btw verlegd met het VIES-raadplegingsnummer (fictief bedrijf)
B2B-factuur met btw verlegd

Voettekst

De voettekst wordt onderaan elke pagina afgedrukt, standaard {shop_name}, {shop_address_inline}. Houd het bij drie regels: PrestaShop reserveert weinig ruimte voor de voettekst, lange teksten horen in een eigen veld onder de totalen. De vrije wettelijke tekst en voettekst uit Bestellingen > Facturen kunnen worden toegevoegd.

De voettekst, met de wettelijke vermeldingen en eigen velden die erin geplaatst zijn, wordt op elke pagina van de factuur afgedrukt. Bij een bulkexport houdt elke factuur haar eigen voettekst.

Voettekst: wettelijke bedrijfsgegevens onderaan elke pagina, met de juridische teksten van Bestellingen > Facturen
Voettekst van de factuur

Teksten

De sectie Teksten bevat elk woord dat op de factuur staat: titel, nummer, data, adrestitels, totalen, btw-specificatie, vervaldatum, bankgegevens, teksten van de pakbon. Ze zijn vooraf ingevuld in het Nederlands, Engels, Frans, Spaans, Duits, Italiaans, Pools en Portugees, en per taal aan te passen.

Pakbonnen

Schakel Deze opmaak ook voor pakbonnen gebruiken in bij de algemene instellingen. De pakbon neemt logo, kleuren, adressen, overzichtsbalk en productregels over, zonder prijzen: alleen de kolommen afbeelding, referentie, naam, EAN-13, leveranciersreferentie en aantal worden afgedrukt. Totalen, bankgegevens, wettelijke vermeldingen en de wettelijke factuurtekst verschijnen niet. De kop toont pakbonnummer, datum en factuurnummer.

Back-up en overdracht

Instellingen exporteren downloadt een JSON-bestand met alle instellingen van de winkel, teksten inbegrepen. Teksten zijn per taalcode opgeslagen, zodat het bestand in een andere winkel of installatie kan worden geïmporteerd, ook als de taal-ID’s verschillen. Het logo zit er niet bij. Importeren vervangt na bevestiging alle instellingen van de huidige winkel.

Standaardinstellingen herstellen, in de onderste balk, zet alle instellingen en teksten terug en behoudt het geüploade logo.

Problemen oplossen

Het voorbeeld meldt dat de editor de factuur niet kon overnemen

De melding na die zin geeft de oorzaak, die ook in Geavanceerde instellingen > Logs staat. In dat geval maakt PrestaShop zijn originele factuur: geen enkele factuur wordt geblokkeerd.

Een medewerker krijgt de originele factuur

PrestaShop voert de hooks van een module niet uit als het profiel van de ingelogde medewerker het recht Bekijken voor die module mist. Geef het in Geavanceerde instellingen > Team > Rechten > Modules. Facturen die naar klanten gaan of in hun account worden gedownload, zijn niet getroffen.

De voettekst valt over de inhoud

Kort de voettekst in, verplaats lange vermeldingen naar een eigen veld onder de totalen of kies voor de wettelijke vermeldingen de positie „In een kader onder de totalen”. Bij meer dan drie regels zakt het paginanummer onder de ondermarge die PrestaShop voor de voettekst reserveert.

De QR-code verschijnt niet

Controleer of het bankblok aan staat, de IBAN is opgeslagen, de factuur in euro is en er een bedrag openstaat. In de modus „Altijd” toont een voldane factuur de bankgegevens zonder QR-code.

Het afleveradres verschijnt terwijl het gelijk lijkt

De twee adressen verschillen op minstens één afgedrukt gegeven: bedrijf, tweede adresregel, postcode, provincie of spelling van de straat. Hoofdletters, spaties en leestekens worden genegeerd. Open de bestelling in de back-office om beide adressen te vergelijken.

Een instelling lijkt niets te doen in het voorbeeld

Sommige onderdelen worden alleen afgedrukt als de factuur het gegeven bevat: btw-nummer van de klant, trackingnummer, openstaand bedrag op een gedeeltelijk betaalde factuur, stempel Betaald op een voldane factuur, vervaldatum bij een betalingstermijn boven 0 dagen, korting- en verpakkingsregels op nul. Kies bovenaan de editor een factuur met dat gegeven om de instelling te controleren.

Creditnota’s houden de oude opmaak

De module dekt facturen en pakbonnen. Creditnota’s houden de opmaak van PrestaShop.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support