DataFirefly Factuureditor voor PrestaShop

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.

Installatie

1. Klik in Modules > Modulebeheer op Een module uploaden en kies het bestand dfinvoiceeditor.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 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.
• Tekstgrootte van 7 tot 12 pt en vier kleuren: accent (titel, tabelkop, te betalen totaal, sectietitels), tekst, secundaire tekst en tekst op de accentkleur.

Kop en logo

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.

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. Btw-nummer, telefoon en e-mail van de klant zijn optioneel.

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.

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

Totalen

• Btw-specificatie per tarief: grondslag en bedrag per tarief, met producten, verzending, cadeauverpakking en milieubijdrage samen.
• 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.

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

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

Drie regels worden inactief geïnstalleerd: vrijgestelde intracommunautaire levering (artikel 138 van Richtlijn 2006/112/EG, met het btw-nummer van de klant), 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.

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.

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

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.

Creditnota’s houden de oude opmaak

Versie 1.0.0 dekt facturen en pakbonnen. Creditnota’s houden de opmaak van PrestaShop.