Een PrestaShop-bestelling bewerken met DataFirefly Order Editor

Overzicht

DataFirefly Order Editor voegt een editor toe aan de pagina van elke bestelling in de back-office, direct onder het blok Producten. Daarmee bewerkt u een gevalideerde bestelling zoals een winkelwagen: producten toevoegen of verwijderen, een combinatie wisselen, een aantal of prijs corrigeren, het adres of de vervoerder wijzigen, een korting verwijderen of toevoegen. Elke wijziging wordt herberekend door de winkelwagen-engine van PrestaShop, en de factuur wordt naar keuze geannuleerd met een creditnota en opnieuw uitgegeven, of bijgewerkt.

De module werkt op PrestaShop 8.0 tot 9.x en is vertaald in het Nederlands, Engels, Frans, Spaans, Duits, Italiaans, Pools en Portugees.

Installatie

1. Klik in Modules > Modulebeheer op Een module uploaden en sleep het bestand dforderedit-1.0.0.zip erin.
2. Bij de installatie kent de module haar rechten toe aan de profielen die al bestellingen mogen wijzigen (bijvoorbeeld SuperAdmin, Verkoper, Logistiek medewerker).
3. Open een bestelling: het blok Bestellingseditor verschijnt onder het blok Producten.

Configuratie

De configuratiepagina van de module biedt vijf instellingen:

• Bestelstatussen waarin bewerken is toegestaan: de editor wordt alleen aangeboden voor bestellingen in deze statussen. Geannuleerd, Terugbetaald en Betalingsfout zijn standaard uitgesloten.
• Standaardverwerking van de factuur: creditnota en nieuwe factuur (aanbevolen), of bijwerken van de bestaande factuur met hetzelfde nummer. De keuze kan bij elke wijziging worden aangepast.
• Verwijderde aantallen standaard terugzetten in voorraad.
• Klant standaard per e-mail informeren.
• Na elke bewerking een privénotitie aan de bestelling toevoegen.

Een bestelling bewerken

De editor openen

Klik op de bestelpagina op Deze bestelling bewerken. Zolang u niets bevestigt, blijft de bestelling onaangeroerd: de knop Herstellen annuleert alle lopende wijzigingen, en de browser waarschuwt u als u de pagina verlaat met wijzigingen die niet zijn toegepast.

Producten

• Product toevoegen: typ een naam, referentie, EAN of ID in de zoekbalk (meerdere woorden, in elke volgorde). Met de pijltjestoetsen en Enter kiest u via het toetsenbord. Voor een product met combinaties kiest u de combinatie in de lijst die verschijnt.
• Combinatie wisselen: de lijst toont de voorraad van elke combinatie. De prijs van de nieuwe combinatie wordt overgenomen en blijft aanpasbaar.
• Aantal of prijs corrigeren: de door de klant betaalde prijs blijft standaard behouden. De link Catalogusprijs toepassen neemt de huidige prijs voor deze klant over (groep, specifieke prijzen, staffelkortingen).
• Invoer excl. of incl. btw: de schakelaar boven de tabel kiest de invoermodus. Standaard volgt die de prijsweergave van de klantengroep. Een prijs ingevoerd incl. btw wordt omgerekend naar excl. btw, de referentie van de bestelling.
• Regel verwijderen: het prullenbakpictogram streept de regel door, het pijlpictogram herstelt hem.

Adressen

Kies een ander adres van de klant in de lijst, of klik op De velden van dit adres bewerken om een straat of postcode te corrigeren. Een bewerkt adres wordt opgeslagen als nieuw adres dat alleen aan deze bestelling gekoppeld is: eerdere bestellingen en het adresboek van de klant veranderen niet. Als het land wijzigt, wordt de btw van de producten en de verzending herberekend.

Kortingen

Vink een korting uit om die uit de bestelling te verwijderen. Via de zoekbalk voegt u een bestaande winkelwagenregel toe op naam of code. De link Vrije korting toevoegen maakt een korting aan als bedrag incl. btw of als percentage met een omschrijving naar keuze, zonder de catalogus van winkelwagenregels. Deze korting wordt opgeslagen als een uitgeschakelde winkelwagenregel, voorbehouden aan de klant en al gebruikt: ze kan niet opnieuw in de winkelwagen worden gebruikt.

Verzending

De lijst toont alleen de vervoerders die de bewerkte winkelwagen op het gekozen adres kunnen leveren, met prijs en levertijd. Voor de verzendkosten zijn er drie modi:

• Verzendkosten van de bestelling behouden: het bedrag excl. btw blijft, de btw volgt het adres als het van land wisselt.
• Herberekenen met de gekozen vervoerder: verplicht bij een andere vervoerder.
• Verzendkosten vastleggen (incl. btw).

Opties

• Bestelstatus na de bewerking: de status wijzigt via de native geschiedenis van PrestaShop, met de gebruikelijke e-mails.
• Verwijderde aantallen terugzetten in voorraad.
• Het overzicht van de gewijzigde bestelling naar de klant sturen, in zijn taal.
• Factuur: creditnota en nieuwe factuur, of bijwerken van de bestaande factuur.
• Interne notitie, opgeslagen in de bewerkingsgeschiedenis.

Nieuwe totalen en bevestiging

Kort na elke wijziging toont de balk onderaan het scherm het totaal incl. btw voor en na, het verschil, en wat de klant nog moet betalen of het te veel betaalde bedrag dat terugbetaald moet worden. De link Details opent de vergelijking per regel (aantallen, prijzen, btw-tarieven), de kortingen, de adressen en alle totalen. Waarschuwingen verschijnen erboven: onvoldoende voorraad, een winkelwagenregel waarvan het minimum niet meer gehaald wordt, een vervoerder die niet meer levert.

Klik op Wijzigingen toepassen: de bevestiging somt de gewijzigde regels op, de kortingen, de wissel van vervoerder, de documenten die worden aangemaakt en de nieuwe status. Klik op Bevestigen en toepassen, de pagina laadt opnieuw met de bijgewerkte bestelling.

Factuur en creditnota

Modus creditnota en nieuwe factuur (standaard)

1. De factuur-PDF wordt onveranderd gearchiveerd, vóór elke schrijfactie.
2. Een creditnota annuleert de factuur voor het volledige bedrag. Ook haar PDF wordt gearchiveerd.
3. Er wordt een nieuwe factuur uitgegeven met het volgende nummer. Regels, kortingen, vervoerder en betalingen worden eraan gekoppeld.

De downloadlink van de geannuleerde factuur geeft in de back-office en in het klantaccount altijd de originele PDF terug. De geannuleerde factuur wordt niet meer aangeboden in het formulier om een betaling toe te voegen.

Bijwerkmodus

De bedragen van de bestaande factuur worden bijgewerkt en ze behoudt haar nummer, zoals PrestaShop dat native doet. De PDF van vóór de wijziging wordt toch gearchiveerd. Een bestelling met meerdere facturen gaat altijd via de modus creditnota en nieuwe factuur.

Betalingen en terugbetalingen

De al ontvangen betaling blijft bij de bestelling. Is het nieuwe totaal hoger, dan toont PrestaShop het openstaande bedrag zoals bij elke gedeeltelijke betaling. Is het lager, dan verschijnt het te veel betaalde bedrag in de editor en gebeurt de terugbetaling via uw betaalprovider.

Wanneer een bestelling later naar een betaalde status gaat, voegt PrestaShop normaal een betaling toe voor elke factuur die niet volledig betaald is. De module voorkomt deze schijnbetaling op facturen die met een creditnota geannuleerd zijn.

Voorraad

De voorraad wordt aangepast op basis van het verschil. Een aantal van 2 naar 3 verbruikt één stuk, een verwijderde regel zet haar aantal terug in voorraad als de optie is aangevinkt, een gewisselde combinatie geeft de oude terug en verbruikt de nieuwe. Gereserveerde aantallen worden aan het einde herberekend.

Vergrendelde regels

• Terugbetaalde of geretourneerde regel: niet te wijzigen of te verwijderen, zodat bestaande creditnota’s kloppen. De andere regels van de bestelling blijven bewerkbaar.
• Gepersonaliseerde regel (tekst, bestand van de klant): kan worden verwijderd maar niet gewijzigd. De tekst van de personalisatie staat onder de regel en de bestanden van de klant worden nooit aangeraakt.
• Uit de catalogus verwijderd product: de regel kan alleen worden verwijderd.

Geschiedenis en traceerbaarheid

De geschiedenis onder de editor somt elke bewerking op: datum, medewerker, gewijzigde regels, kortingen, adressen, vervoerder en status, totaal voor en na, interne notitie en links naar de gearchiveerde PDF’s. Een privénotitie vat de wijziging bovendien samen in de berichten van de bestelling.

Bij het verwijderen van de module blijven de geschiedenis en de gearchiveerde PDF’s bewaard, zodat geannuleerde facturen herkenbaar blijven als de module opnieuw wordt geïnstalleerd.

Voor ontwikkelaars

• actionOrderEdited: native PrestaShop-hook, na elke bewerking aangeroepen met order.
• actionDfOrderEditAfter: aangeroepen met order, id_dforderedit_log, changes (regels, kortingen, adressen, vervoerder, totalen) en id_order_slips.

De herberekening gebruikt een tijdelijke winkelwagen die nooit aan een bestelling gekoppeld wordt en aan het einde verwijderd wordt. Het voorbeeld wordt berekend in een transactie die wordt teruggedraaid.

Problemen oplossen

De editor verschijnt niet bij de bestelling

Controleer of de status van de bestelling tot de bewerkbare statussen in de configuratie behoort, en of het profiel van de medewerker bestellingen mag wijzigen en de module mag zien.

De vervoerder kan de nieuwe winkelwagen niet leveren

Gewicht, bedrag of zone vallen buiten de klassen van de vervoerder. Kies een andere vervoerder in de lijst of leg de verzendkosten handmatig vast.

De prijs van een regel kon niet exact worden vastgelegd

Een catalogusregel (bijvoorbeeld een groepskorting) werkt bovenop de ingevoerde prijs. Controleer de prijs in de details voordat u bevestigt.

Bestelling uit een winkelwagen met meerdere vervoerders

Wanneer een winkelwagen in meerdere bestellingen is opgesplitst, worden de winkelwagenregels alleen voor de bewerkte bestelling herberekend. Een waarschuwing in het voorbeeld herinnert daaraan.