2.3.5. Bestellingen beheren#
Een van de belangrijkste doelen van deze module is natuurlijk om betalingen in Dolibarr met Taler daadwerkelijk mogelijk te maken. Om dit normaal gesproken in elk ERP te doen, moet er een soort factuur/order worden aangemaakt, afhankelijk van het ERP en de interne logica ervan, maar uiteindelijk draait alles om deze logica.
Zoals altijd geldt de opmerking dat alle screenshots hier alleen worden getoond om te laten zien hoe de synchronisatie van orders/betalingen werkt in de Talerbarr-module, maar we tonen toch enkele schermen van Dolibarr en Taler. Raadpleeg voor de precieze handleidingen hun originele tutorials, zoals de documentatie van Dolibarr Sales Orders en de Taler-ordertutorial.
2.3.5.1. Overzicht van de levenscyclus van een order#
Voor de volledige levenscyclus van orders aan de Taler-kant kunt u de Taler-ordertutorial raadplegen.
Voor de doeleinden van deze moduletutorial is de vereenvoudigde levenscyclus:
Created (Unpaid) -> Paid -|- Settled -> Done
|
|- Refunded -> Done
Deze tutorial richt zich op het gedeelte Created -> Paid van de flow. Terugbetalingen en afwikkeling per overschrijving worden behandeld in Terugbetalingen beheren en Overschrijvingen beheren.
Een order kan natuurlijk onbetaald blijven. In dat geval hangt het exacte gedrag af van de geselecteerde synchronisatiemodus:
Als de order afkomstig is van Dolibarr, kan de verkoper indien nodig de Taler-betalingsflow opnieuw aanmaken na de betalingstime-out.
Als de order afkomstig is van Taler en de modus is sync on order created, is de onbetaalde order zichtbaar in Dolibarr, omdat deze al bij het aanmaken werd geïmporteerd.
Als de order afkomstig is van Taler en de modus is sync on order paid, verschijnt deze pas in Dolibarr nadat de betaling is voltooid.
Voor terugbetalingen moet de verkoper die werkt met synchronisatie vanuit Dolibarr mogelijk andere paden voor de afhandeling van terugbetalingen gebruiken als de terugbetalingstermijn aan de Taler-kant al is verstreken.
In alle gevallen is het kernidee eenvoudig: de verkoper maakt de order aan op het gekozen systeem, en de betalingsinformatie wordt vervolgens doorgegeven aan de Dolibarr-ERP-flow.
2.3.5.2. Orders aanmaken aan de Taler-kant#
Wanneer Taler het invoerpunt van de order is, zijn er twee synchronisatietimings beschikbaar:
Sync when order is created De order verschijnt in Dolibarr onmiddellijk nadat deze aan de Taler-kant is aangemaakt.
Sync when order is paid De order verschijnt pas in Dolibarr nadat de klant heeft betaald.
De tweede modus is nuttig wanneer alleen voltooide aankopen ERP-records moeten aanmaken. Dit houdt de documentflow minimaal en voorkomt dat het ERP wordt gevuld met tijdelijke of verlaten klantsessies/orders. Als een order succesvol is betaald in Taler, is deze een goede kandidaat om te verschijnen in de financiële en orderflows van Dolibarr.
2.3.5.3. Orders vanuit Dolibarr#
Wanneer Dolibarr de bron van waarheid is, blijft de workflow dicht bij het standaard Dolibarr-orderproces. Het belangrijkste verschil is dat de betaalmethode Taler moet zijn, zodat TalerBarr de bijbehorende order aan de Taler-kant kan aanmaken en de betalingslevenscyclus ervan kan volgen.
Maak in de standaard Dolibarr-orderaanmaakflow de order aan en zorg ervoor dat de geselecteerde betaalmethode Taler is.
Een order aanmaken in Dolibarr met Taler geselecteerd als betaalmethode.#
Nadat de order is aangemaakt, gevuld met producten en gevalideerd, stuurt TalerBarr het verzoek naar de Taler-backend en maakt daar de bijbehorende Taler-order aan met dezelfde gegevens.
Dolibarr-order na aanmaak en validatie.#
De volgende operationele stap is het delen van de betaallink met de klant. U vindt de Taler-status-URL in de ordernotities. Die URL bevat de QR-code en betaalpagina die de klant kan gebruiken om de betaling met een Taler-portemonnee te voltooien.
Een Taler portemonnee instantie#
Zodra de klant heeft betaald, kunt u terugkeren naar de Dolibarr-order en de gerelateerde objecten controleren. Op dit punt is de factuur al gemarkeerd als betaald.
Dolibarr-order met de betaalde factuur zichtbaar in de gerelateerde objecten.#
Als u de factuur opent, kunt u controleren of de betaling correct is geregistreerd en verrekend op de verwachte rekening.
Betaalde Dolibarr-factuur, aangemaakt vanuit de Taler-betalingsflow.#
In de praktijk betekent dit dat het delen van de betaallink de enige nieuwe taak voor de operator is in deze modus. Het overige boekhoud- en documentkoppelingswerk wordt automatisch afgehandeld door TalerBarr.
2.3.5.4. Orders vanuit Taler bij het aanmaken van de order#
Deze modus is nuttig wanneer u wilt dat Dolibarr orders afkomstig van Taler ziet zodra ze zijn aangemaakt, zelfs voordat ze zijn betaald. Het is het tegenovergestelde van de meer selectieve modus Sync when order is paid, die in het volgende onderdeel wordt beschreven.
We beginnen met het aanmaken van de order aan de kant van de Taler-verkoper.
Een order aanmaken in Taler SPAA.#
Na het opslaan ervan worden de orderdetails beschikbaar aan de Taler-kant.
Nieuw aangemaakte order in Taler SPAA.#
Omdat de synchronisatiemodus when order is created is, verschijnt de order nu onmiddellijk in Dolibarr.
Dolibarr-orderlijst met de nieuw geïmporteerde Taler-order.#
Van daaruit kan de verkoper de QR-code of Taler-betaallink met de klant delen en de klant laten betalen met een Taler-portemonnee.
Taler-betaal-QR-code geopend met de Taler-portemonnee-app.#
De Taler-portemonnee-app toont de gebruiker de bevestiging van de betaling.#
Nadat de betaling door de klant is gedaan, kunt u de betalingsstatus via Taler controleren, of terugkeren naar Dolibarr en controleren of de betalingsgerelateerde objecten zijn verschenen.
Dolibarr-order met de gekoppelde betalingsgerelateerde objecten.#
Als u de gekoppelde factuur opent, kunt u bevestigen dat de transactie volledig is geregistreerd en verrekend via de verwachte rekeningflow.
Factuurdetails na betaling van de door Taler aangemaakte order.#
Deze modus is daarom nuttig wanneer het ERP nieuwe Taler-orders onmiddellijk moet weergeven, zelfs voordat de klant de betaling heeft voltooid.
2.3.5.5. Orders vanuit Taler bij betaling van de order#
Dit is de interessantste modus wanneer de verkoper wil dat orders pas in het ERP verschijnen nadat ze daadwerkelijk zijn betaald. Dit is vooral nuttig voor verkoopautomaten, kiosken, koffiemachines of vergelijkbare opstellingen waarbij veel klantsessies kunnen starten, maar alleen voltooide aankopen ERP-objecten moeten worden.
Voordat u een nieuwe order aanmaakt, is het nuttig om de huidige status in zowel Dolibarr als TalerBarr te bekijken. In het volgende voorbeeld bevatten de Dolibarr-orderlijst en de TalerBarr-orderlijst al een aantal eerder gesynchroniseerde objecten.
Dolibarr-orderlijst vóór het aanmaken van de nieuwe Taler-order.#
TalerBarr-orderlijst vóór betaling van de nieuwe Taler-order.#
Nu wordt de order aangemaakt aan de Taler-kant. De volgende twee afbeeldingen tonen de aanmaakflow in Taler SPAA.
De order aanmaken in Taler SPAA.#
Nieuw aangemaakte order aan de Taler-kant.#
Op dit punt is de order aangemaakt maar nog niet betaald. Omdat de configuratie Sync when order is paid is, verschijnt de order nog niet in de Dolibarr-orderlijst.
Dolibarr-orderlijst die laat zien dat de onbetaalde Taler-order nog niet is geïmporteerd.#
TalerBarr detecteert echter al dat er een nieuwe order aan de Taler-kant bestaat en houdt deze bij in de eigen moduletabellen. In dit stadium zijn er nog geen gekoppelde Dolibarr-objecten zoals order, factuur, betaling, terugbetaling of overschrijving.
TalerBarr-orderlijst met de gedetecteerde maar onbetaalde order.#
Als u de bijbehorende TalerBarr-orderkaart opent, ziet u dat tot nu toe alleen de algemene orderinformatie beschikbaar is.
TalerBarr-orderkaart vóór betaling, met alleen de algemene informatie vastgelegd.#
De volgende stap is het betalen van de order met een Taler-portemonnee.
De order betalen met een Taler-portemonnee.#
Na betaling toont Taler SPAA ook dat de order is betaald.
Taler SPAA toont de order als betaald.#
Als u nu terugkeert naar Dolibarr, verschijnt de nieuwe order in de Dolibarr-orderlijst.
Dolibarr-orderlijst nadat de Taler-order is betaald.#
De TalerBarr-orderstabel wordt ook bijgewerkt. In tegenstelling tot de onbetaalde status kan de module nu gekoppelde bedrijfsobjecten tonen die aan de Dolibarr-kant zijn aangemaakt.
TalerBarr-orderlijst na betaling, nu met gekoppelde objecten.#
Als u de TalerBarr-orderkaart opnieuw opent, ziet u de bijgewerkte status van het object en de gekoppelde elementen.
TalerBarr-orderkaart na betaling met de gekoppelde Dolibarr-objecten.#
In dit stadium koppelt de module de order aan de Taler-kant aan de bijbehorende Dolibarr-bedrijfsobjecten, zoals de verkooporder, factuur en betaling. Dit is het belangrijkste voordeel van de modus Sync when order is paid: alleen voltooide aankopen worden onderdeel van de ERP-orderflow.
2.3.5.6. Volgende stap#
Zodra een betaalde order end-to-end werkt, gaat u verder met Terugbetalingen beheren om de afhandeling van terugboekingen te testen en met Overschrijvingen beheren om de afwikkelingsflow te bekijken.