Wo WooCommerce Beginner

Proforma-facturen PDF voor WooCommerce: documentatie

Installeer, configureer en gebruik DataFirefly Proforma-facturen 2.0 voor WooCommerce: ontwerpen en live voorbeeld, bedrijfs- en bankgegevens, nummering, klantknoppen, e-mails, bestellingen en bijwerken vanaf 1.x.

Bijgewerkt Moduleversie 2.0.0

Overzicht

DataFirefly Proforma-facturen maakt professionele proforma-facturen als PDF voor uw WooCommerce-bestellingen en winkelwagens. U maakt ze met één klik aan vanuit elke bestelling, voegt ze toe aan WooCommerce-e-mails of laat uw klanten ze downloaden vanuit de winkelwagen, hun account of de bestelbevestigingspagina.

Een proforma-factuur toont wat de klant gaat betalen voordat de bestelling is betaald: zo kan een klant vooraf per bankoverschrijving betalen, een aankoop laten goedkeuren door een inkoopafdeling of douanedocumenten voorbereiden.

Een proforma-factuur is geen btw-factuur. Het document vermeldt dat standaard; blijf uw definitieve facturen gewoon uitgeven zoals u gewend bent.

Systeemvereisten en installatie

Systeemvereisten

  • WordPress 6.4 of hoger (getest tot en met 7.1)
  • WooCommerce 8.2 of hoger (getest tot en met 11.2), met of zonder HPOS
  • PHP 7.4 tot en met 8.5 met de extensies dom en mbstring (bij vrijwel elke hostingprovider aanwezig). GD wordt gebruikt om transparante logo’s af te vlakken.

De PDF-engine (Dompdf) is inbegrepen: u hoeft verder niets te installeren.

Installatie

  1. Ga naar Plugins > Nieuwe plugin > Plugin uploaden, kies het bestand df-proforma-woo-2.0.0.zip en klik op Nu installeren.
  2. Activeer de plugin. WooCommerce moet actief zijn.
  3. Open WooCommerce > Proforma.

Installatiehandleiding en overzicht

Het tabblad Overzicht begint met een handleiding in vier stappen: vul uw bedrijfsgegevens in, voeg uw logo toe en kies een ontwerp, kies waar klanten het document krijgen en open een test-PDF. Elke stap wordt automatisch afgevinkt zodra deze is voltooid.

Daarna toont het overzicht het aantal uitgegeven proforma’s (in totaal en deze maand), het volgende nummer, waar klanten het document kunnen downloaden, de e-mails waarbij het wordt gevoegd, de laatste proforma’s met een link naar hun PDF en de status van het systeem.

DataFirefly Proforma-facturen – Dashboard van de proforma-facturen: startgids, uitgegeven documenten, volgend nummer en laatste proforma’s
Dashboard van de proforma-facturen: startgids, uitgegeven documenten, volgend nummer en laatste proforma’s

Document: ontwerp en live voorbeeld

Het tabblad Document bepaalt hoe de PDF eruitziet. Het live voorbeeld naast de instellingen gebruikt hetzelfde sjabloon en dezelfde lettertypen als de PDF en verandert terwijl u typt, nog voordat u opslaat. Kies boven het voorbeeld voorbeeldgegevens of een van uw 12 laatste bestellingen; Openen als PDF toont het echte bestand. Het voorbeeld geeft nooit een nummer uit.

DataFirefly Proforma-facturen – Documentinstellingen met live voorbeeld van de proforma-factuur
Documentinstellingen met live voorbeeld van de proforma-factuur

Ontwerp

  • Sjabloon: Modern, Klassiek, Minimalistisch of Opvallend.
  • Merkkleur: kies een van de voorgestelde kleuren of uw eigen kleur. Tekst op deze kleur wordt automatisch wit of zwart, zodat hij leesbaar blijft.
  • Lettertype: schreefloos of met schreef. Papierformaat: A4 of US Letter.
  • Logo: gekozen uit de mediabibliotheek, in drie formaten. Zonder logo wordt in plaats daarvan uw bedrijfsnaam getoond.
DataFirefly Proforma-facturen – Vier ontwerpen van de proforma-factuur: Modern, Klassiek, Minimalistisch en Opvallend
Vier ontwerpen van de proforma-factuur: Modern, Klassiek, Minimalistisch en Opvallend
DataFirefly Proforma-facturen – Ontwerp Opvallend met de merkkleur en het logo in het live voorbeeld
Ontwerp Opvallend met de merkkleur en het logo in het live voorbeeld

Producten en bedragen

  • Prijzen op het document: excl. btw (gebruikelijk voor zakelijke klanten, met de btw aan het einde opgeteld) of incl. btw. Regels en totalen gebruiken altijd dezelfde weergave.
  • Optionele kolommen en blokken: kolom artikelnummer, productafbeeldingen, kolom btw-tarief, btw-overzicht per tarief, verzendadres (indien anders), betaalmethode, opmerking van de klant.

Teksten en wettelijke vermeldingen

  • Documenttitel: laat dit veld leeg om “Proforma-factuur” te gebruiken in de taal van elke klant.
  • Geldig (dagen): bij 0 wordt de datum “Geldig tot” verborgen.
  • Inleiding, Voorwaarden en Voettekst (getoond onderaan elke pagina, boven uw bedrijfsgegevens).
  • Vermelden dat het document geen btw-factuur is: aanbevolen.

In de teksten kunt u de plaatshouders {customer_name}, {order_number}, {proforma_number}, {valid_until} en {site_title} gebruiken.

Bedrijfs- en bankgegevens

Het tabblad Bedrijf vult het afzenderblok van het document. Winkeladres van WooCommerce gebruiken neemt het adres van uw winkel met één klik over.

  • Bedrijfsnaam, adres, postcode, plaats, land, telefoon, e-mail en website.
  • Registratienummers en wettelijke vermeldingen: btw-nummer, registratienummer met de lokale benaming (bijvoorbeeld SIRET, Handelsregister, KvK, NIP, CIF, Codice fiscale) en overige vermeldingen, één per regel.
  • Bankgegevens: rekeninghouder, bank, IBAN en BIC / SWIFT, getoond op elk document wanneer de optie is ingeschakeld. Zonder eigen gegevens worden de rekeningen van de WooCommerce-betaalmethode “Directe bankoverschrijving” gebruikt.
DataFirefly Proforma-facturen – Bedrijfsgegevens, btw-nummer, KvK-nummer en bankgegevens voor de proforma
Bedrijfsgegevens, btw-nummer, KvK-nummer en bankgegevens voor de proforma

Nummering

Het tabblad Nummering toont het volgende nummer terwijl u de instellingen wijzigt.

  • Nummer gebaseerd op: een eigen reeks (aanbevolen: opeenvolgende nummers zonder gaten, in de volgorde waarin documenten worden uitgegeven, ook wanneer twee documenten tegelijk worden uitgegeven) of het bestelnummer.
  • Voorvoegsel en Achtervoegsel: klik op een tag om {Y} (jaar), {y} (jaar in twee cijfers), {m} (maand), {d} (dag) of {order_number} in te voegen.
  • Cijfers, Teller opnieuw starten (elk jaar of nooit) en Volgende tellerwaarde (wijzig deze alleen als u een bestaande reeks voortzet).

Een nummer wordt uitgegeven de eerste keer dat het document van een bestelling wordt geopend, gedownload, aan een e-mail wordt toegevoegd of wordt verstuurd. Het wordt bij de bestelling opgeslagen en verandert nooit.

DataFirefly Proforma-facturen – Nummering van de proforma’s: eigen reeks of bestelnummer, voorvoegsel met jaar, jaarlijkse herstart
Nummering van de proforma’s: eigen reeks of bestelnummer, voorvoegsel met jaar, jaarlijkse herstart

Klanten en e-mails

In het tabblad Klanten & e-mails kiest u waar uw klanten het document krijgen. Deze knoppen staan uit totdat u ze inschakelt.

  • Knop in Mijn account > Bestellingen (bestellingenoverzicht en bestelpagina) en Knop op de bestelbevestigingspagina, voor de bestelstatussen die u kiest. Winkelmanagers kunnen het document altijd openen vanuit de bestelling.
  • Winkelwagen: voeg een knop “Proforma-factuur downloaden” toe aan de winkelwagen, kies de tekst ervan, stel hem beschikbaar voor alle bezoekers of alleen voor ingelogde klanten en vraag om de naam, het bedrijf en het adres voor op het document.
  • E-mails: voeg de PDF toe aan de WooCommerce-e-mails die u kiest (standaard “Bestelling in de wacht”, gebruikt voor bankoverschrijvingen) en schakel de e-mail “Proforma-factuur” in. E-mail bewerken opent deze in WooCommerce > Instellingen > E-mails, waar u het onderwerp, de kop en de tekst wijzigt.
DataFirefly Proforma-facturen – Knoppen voor klanten in Mijn account, op de orderbevestiging en in de winkelwagen, en e-mailbijlagen
Knoppen voor klanten in Mijn account, op de orderbevestiging en in de winkelwagen, en e-mailbijlagen

Het PDF-document

Elk document wordt gemaakt op basis van de actuele bestelling en komt er dus altijd mee overeen:

  • afzender- en klantblok, met de naam van het land en de adresnotatie van het land;
  • nummer, uitgiftedatum, geldigheidsdatum, bestelnummer en betaalmethode;
  • productregels met hun opties (bijvoorbeeld Kleur: Rood), artikelnummer, afbeelding en btw-tarief wanneer deze kolommen zijn ingeschakeld;
  • subtotaal, kortingen met kortingscodes, verzending, extra kosten, totaal excl. btw, één regel per btw-tarief, totaal, terugbetalingen en saldo, in de valuta van de bestelling;
  • btw-overzicht per tarief, bankgegevens, voorwaarden, voettekst en paginanummers.

Lange bestellingen lopen door over meerdere pagina’s, met een herhaalde tabelkop en de voettekst op elke pagina. De lettertypen ondersteunen het Latijnse, Griekse en Cyrillische alfabet.

DataFirefly Proforma-facturen – Proforma-factuur als pdf met twee btw-tarieven, btw-overzicht en bankgegevens
Proforma-factuur als pdf met twee btw-tarieven, btw-overzicht en bankgegevens

Werken met bestellingen

Vak Proforma-factuur

Elke bestelling heeft een vak Proforma-factuur met het nummer en de datums en de knoppen PDF bekijken, Downloaden, Proforma-factuur naar de klant versturen en Op vandaag dateren, waarmee de geldigheidsperiode opnieuw begint. Het vak geeft ook aan of de klant het document kan downloaden, en zo niet, waarom.

DataFirefly Proforma-facturen – Vak Proforma-factuur van een WooCommerce-bestelling: bekijken, downloaden en naar de klant sturen
Vak Proforma-factuur van een WooCommerce-bestelling: bekijken, downloaden en naar de klant sturen

Bestellingenoverzicht

De kolom Proforma toont het nummer van elke bestelling (klik erop om de PDF te openen) of Aanmaken. Er worden twee bulkacties toegevoegd: Proforma’s downloaden (PDF), die tot 50 bestellingen in één PDF-bestand bundelt, en Proforma’s per e-mail versturen. Een melding bevestigt elke actie.

DataFirefly Proforma-facturen – WooCommerce-bestellijst met de kolom Proforma en de bulkdownload
WooCommerce-bestellijst met de kolom Proforma en de bulkdownload

Proforma vanuit de winkelwagen

Met de winkelwagenknop ingeschakeld kunnen klanten een proforma krijgen voordat ze bestellen, in de klassieke winkelwagen en in het Winkelwagen-blok. Een kort formulier vraagt om de naam, het bedrijf, het adres, het land, het btw-nummer en het e-mailadres voor op het document, vooraf ingevuld voor ingelogde klanten; er wordt niets in hun account opgeslagen. De PDF wordt gedownload zonder dat de klant de winkelwagen verlaat.

Winkelwagendocumenten krijgen een referentie die met C begint en gebruiken uw nummering niet. Om misbruik te voorkomen kan een bezoeker per 10 minuten 10 winkelwagendocumenten aanmaken.

Wilt u de knop ergens anders plaatsen, gebruik dan het blok Proforma-knop (tekst, stijl en uitlijning) of de shortcode [df_proforma_cart_button].

DataFirefly Proforma-facturen – Proforma vanuit de winkelwagen: formulier met naam, bedrijf, adres en btw-nummer vóór het downloaden van de pdf
Proforma vanuit de winkelwagen: formulier met naam, bedrijf, adres en btw-nummer vóór het downloaden van de pdf

Mijn account en bestelbevestiging

Voor de statussen die u hebt gekozen, vindt de klant een downloadknop in Mijn account > Bestellingen en op de bestelbevestigingspagina, met klassieke thema’s en blokthema’s. Links vereisen de geheime bestelsleutel en geregistreerde klanten moeten ingelogd zijn.

DataFirefly Proforma-facturen – Bestelpagina in Mijn account met het downloadvak van de proforma-factuur
Bestelpagina in Mijn account met het downloadvak van de proforma-factuur

Gereedschap, talen en privacy

Het tabblad Gereedschap bevat:

  • Taal van de documenten: de taal van de klant (accounttaal, WPML of Polylang) of de taal van de site.
  • Privacy: documenten worden op aanvraag gegenereerd en niet op de server opgeslagen; e-mailbijlagen zijn tijdelijke bestanden in een privémap, die direct na verzending worden verwijderd; geen cookies en geen externe verzoeken. Een voorgestelde tekst voor uw privacybeleid wordt toegevoegd aan de handleiding voor het privacybeleid van WordPress.
  • Bestanden van versie 1: verwijder de PDF-bestanden die versie 1 heeft achtergelaten.
  • Systeem: PDF-engine, PHP-extensies, privémap en lettertypen, met Tijdelijke bestanden verwijderen en De installatiehandleiding opnieuw tonen.
  • Wanneer de plugin wordt verwijderd: kies Instellingen behouden om de instellingen te bewaren nadat de plugin is verwijderd. Proformanummers blijven in uw bestellingen staan en de tellers worden altijd bewaard, zodat een nieuwe installatie nooit een nummer twee keer uitgeeft.

De plugin is vertaald in het Engels, Frans, Spaans, Duits, Portugees (Portugal), Italiaans, Pools en Nederlands.

Bijwerken vanaf versie 1.x

Installeer versie 2.0.0 over versie 1.x heen (Plugins > Nieuwe plugin > Plugin uploaden, daarna Huidige vervangen door geüploade). Bij de eerste keer laden:

  • blijven de bedrijfsgegevens, het logo, de kleur, de geldigheid en de e-mailinstellingen behouden;
  • is de nummering identiek: dezelfde teller, hetzelfde voorvoegsel, en de nummers die al aan bestellingen zijn toegekend blijven behouden;
  • worden de PDF-bestanden van versie 1, die via hun adres te openen waren, naar een privémap verplaatst; u kunt ze verwijderen in Gereedschap;
  • blijven de nieuwe klantknoppen uitgeschakeld totdat u ze inschakelt, en legt een melding uit wat er nieuw is.

TCPDF wordt niet meer gebruikt: u kunt een eventuele TCPDF-kopie die u voor versie 1 had geïnstalleerd verwijderen.

Voor ontwikkelaars

Sjabloon

Kopieer templates/document.php naar yourtheme/df-proforma-woo/document.php om de opmaak te wijzigen.

Hooks

  • dfpw_order_data (array $doc, WC_Order $order) en dfpw_cart_data (array $doc, WC_Cart $cart, array $buyer): gegevens van een document.
  • dfpw_proforma_number (string $number, WC_Order $order): nieuw nummer.
  • dfpw_document_css, dfpw_template_file, dfpw_document_locale.
  • dfpw_customer_can_download, dfpw_cart_allowed, dfpw_cart_rate_limit, dfpw_attach_to_email, dfpw_customer_vat_number.
  • dfpw_capability (instellingen, standaard manage_woocommerce) en dfpw_order_capability (documenten van bestellingen, standaard edit_shop_orders).
  • Acties: dfpw_number_issued, dfpw_pdf_generated, dfpw_cart_document_created.

WP-CLI

  • wp dfpw status
  • wp dfpw generate <order>... [--output=<file>] of wp dfpw generate 0 --sample
  • wp dfpw next-number [<value>]
  • wp dfpw cleanup

Probleemoplossing

De PDF wordt niet aangemaakt

Open Proforma > Gereedschap > Systeem of Gereedschap > Sitediagnose: de PHP-extensies dom en mbstring moeten aanwezig zijn en de privémap moet schrijfbaar zijn.

De klant ziet de downloadknop niet

Controleer of de knop is ingeschakeld in Klanten & e-mails en of de bestelstatus een van de gekozen statussen is. Het vak Proforma-factuur van de bestelling legt uit waarom de klant het document niet kan downloaden.

Sommige tekens ontbreken

De lettertypen ondersteunen het Latijnse, Griekse en Cyrillische alfabet. Chinees, Japans, Koreaans, Arabisch en Hebreeuws worden niet ondersteund.

De bedragen komen niet overeen met de bestelling

Het document geeft altijd de actuele bestelling weer. Hebt u de bestelling gewijzigd nadat u de proforma had verstuurd, open het document dan opnieuw of verstuur het opnieuw.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support