2.3.5. Gestione degli ordini#
Naturalmente uno degli obiettivi principali di questo modulo è consentire effettivamente i pagamenti in Dolibarr utilizzando Taler. Per farlo normalmente in qualsiasi ERP, è necessario creare un qualche tipo di fattura/ordine, a seconda dell’ERP e della sua logica interna, ma alla fine tutto ruota attorno a questa logica.
Come sempre, va osservato che tutti gli screenshot qui presentati servono solo a mostrare come funziona la sincronizzazione degli ordini/pagamenti nel modulo Talerbarr; tuttavia vengono comunque mostrate alcune schermate di Dolibarr e Taler. Per le guide precise, consulta i rispettivi tutorial originali, come la documentazione Dolibarr Sales Orders e il tutorial sugli ordini Taler.
2.3.5.1. Panoramica del ciclo di vita dell’ordine#
Per il ciclo di vita completo dell’ordine lato Taler, puoi consultare il tutorial sugli ordini Taler.
Ai fini di questo tutorial sul modulo, il ciclo di vita semplificato è:
Created (Unpaid) -> Paid -|- Settled -> Done
|
|- Refunded -> Done
Questo tutorial si concentra sulla parte Created -> Paid del flusso. I rimborsi e il regolamento tramite bonifico sono trattati in Gestione dei rimborsi e Gestire i bonifici bancari.
Un ordine può naturalmente rimanere non pagato. In tal caso, il comportamento esatto dipende dalla modalità di sincronizzazione selezionata:
Se l’ordine proviene da Dolibarr, il venditore può ricreare il flusso di pagamento Taler dopo la scadenza del pagamento, se necessario.
Se l’ordine proviene da Taler e la modalità è sync on order created, l’ordine non pagato sarà visibile in Dolibarr perché è già stato importato al momento della creazione.
Se l’ordine proviene da Taler e la modalità è sync on order paid, non apparirà in Dolibarr finché il pagamento non sarà stato completato.
Per i rimborsi, il venditore che lavora con la sincronizzazione da Dolibarr potrebbe dover utilizzare altri percorsi di gestione dei rimborsi se la scadenza per il rimborso lato Taler è già trascorsa.
In tutti i casi, l’idea di base è semplice: il venditore crea l’ordine sul sistema scelto, e le informazioni di pagamento vengono poi trasmesse nel flusso ERP di Dolibarr.
2.3.5.2. Creare ordini sul lato Taler#
Quando Taler è il punto di ingresso dell’ordine, sono disponibili due tempistiche di sincronizzazione:
Sync when order is created L’ordine appare in Dolibarr immediatamente dopo essere stato creato sul lato Taler.
Sync when order is paid L’ordine appare in Dolibarr solo dopo che il cliente ha pagato.
Il secondo modo è utile quando solo gli acquisti completati devono creare record nell’ERP. Questo mantiene minimo il flusso documentale ed evita di riempire l’ERP con sessioni/ordini clienti temporanei o abbandonati. Se un ordine è stato pagato con successo in Taler, è quindi un buon candidato per comparire nei flussi finanziari e degli ordini di Dolibarr.
2.3.5.3. Ordini da Dolibarr#
Quando Dolibarr è la fonte di verità, il flusso di lavoro rimane vicino al processo standard degli ordini di Dolibarr. La differenza principale è che il metodo di pagamento deve essere Taler, in modo che TalerBarr possa creare l’ordine corrispondente sul lato Taler e tracciarne il ciclo di vita del pagamento.
Nel flusso standard di creazione degli ordini di Dolibarr, crea l’ordine e assicurati che il metodo di pagamento selezionato sia Taler.
Creazione di un ordine in Dolibarr con Taler selezionato come metodo di pagamento.#
Dopo che l’ordine è stato creato, compilato con i prodotti e convalidato, TalerBarr invia la richiesta al backend Taler e crea lì l’ordine Taler corrispondente con gli stessi dettagli.
Ordine Dolibarr dopo la creazione e la convalida.#
Il passaggio operativo successivo consiste nel condividere il link di pagamento con il cliente. Puoi trovare l’URL di stato Taler nelle note dell’ordine. Tale URL contiene il codice QR e la pagina di pagamento che il cliente può utilizzare per completare il pagamento con un portafoglio Taler.
Schermata di pagamento del portafoglio Taler.#
Una volta che il cliente ha pagato, puoi tornare all’ordine Dolibarr e controllare gli oggetti correlati. A questo punto, la fattura è già contrassegnata come pagata.
Ordine Dolibarr con la fattura pagata visibile negli oggetti correlati.#
Se apri la fattura, puoi verificare che il pagamento sia stato registrato correttamente e regolato sul conto previsto.
Fattura Dolibarr pagata creata dal flusso di pagamento Taler.#
In pratica, questo significa che condividere il link di pagamento è l’unico nuovo compito dell’operatore in questa modalità. Il resto del lavoro di contabilità e collegamento dei documenti viene gestito automaticamente da TalerBarr.
2.3.5.4. Ordini da Taler alla creazione dell’ordine#
Questa modalità è utile quando desideri che Dolibarr veda gli ordini originati da Taler non appena vengono creati, anche prima che siano pagati. È l’opposto della modalità più selettiva Sync when order is paid descritta nella sezione successiva.
Iniziamo creando l’ordine sul lato di Taler Merchant.
Creazione di un ordine in Taler SPAA.#
Dopo averlo salvato, i dettagli dell’ordine diventano disponibili sul lato Taler.
Ordine appena creato in Taler SPAA.#
Poiché la modalità di sincronizzazione è when order is created, l’ordine ora appare immediatamente in Dolibarr.
Elenco degli ordini Dolibarr con l’ordine Taler appena importato.#
Da lì, il venditore può condividere il codice QR o il link di pagamento Taler con il cliente e lasciare che il cliente paghi con un portafoglio Taler.
Codice QR di pagamento Taler aperto con l’app del portafoglio Taler.#
L’app del portafoglio Taler mostra all’utente la conferma del pagamento.#
Dopo che il pagamento è stato effettuato dal cliente, puoi controllare lo stato del pagamento tramite Taler, oppure tornare a Dolibarr e verificare che siano comparsi gli oggetti relativi al pagamento.
Ordine Dolibarr con gli oggetti collegati relativi al pagamento.#
Se apri la fattura collegata, puoi confermare che la transazione è stata completamente registrata e regolata utilizzando il flusso contabile previsto.
Dettagli della fattura dopo il pagamento dell’ordine creato da Taler.#
Questa modalità è quindi utile quando l’ERP deve riflettere immediatamente i nuovi ordini Taler, anche prima che il cliente abbia completato il pagamento.
2.3.5.5. Ordini da Taler al pagamento dell’ordine#
Questa è la modalità più interessante quando il venditore desidera che gli ordini compaiano nell’ERP solo dopo essere stati effettivamente pagati. È particolarmente utile per configurazioni di vendita automatica, chioschi, distributori di caffè o simili, in cui possono iniziare molte sessioni cliente, ma solo gli acquisti completati devono diventare oggetti ERP.
Prima di creare un nuovo ordine, è utile osservare lo stato attuale sia in Dolibarr sia in TalerBarr. Nell’esempio seguente, l’elenco degli ordini di Dolibarr e l’elenco degli ordini di TalerBarr contengono già diversi oggetti sincronizzati in precedenza.
Elenco degli ordini Dolibarr prima della creazione del nuovo ordine Taler.#
Elenco degli ordini TalerBarr prima del pagamento del nuovo ordine Taler.#
Ora l’ordine viene creato sul lato Taler. Le due immagini successive mostrano il flusso di creazione in Taler SPAA.
Creazione dell’ordine in Taler SPAA.#
Ordine appena creato sul lato Taler.#
A questo punto, l’ordine è stato creato ma non ancora pagato. Poiché la configurazione è Sync when order is paid, l’ordine non appare ancora nell’elenco degli ordini di Dolibarr.
Elenco degli ordini Dolibarr che mostra come l’ordine Taler non pagato non sia ancora stato importato.#
Tuttavia, TalerBarr rileva già l’esistenza di un nuovo ordine sul lato Taler e ne tiene traccia nelle proprie tabelle del modulo. In questa fase non sono ancora presenti oggetti Dolibarr collegati, come ordine, fattura, pagamento, rimborso o bonifico bancario.
Elenco degli ordini TalerBarr con l’ordine rilevato ma non pagato.#
Se apri la scheda ordine TalerBarr corrispondente, puoi vedere che finora sono disponibili solo le informazioni generali dell’ordine.
Scheda ordine TalerBarr prima del pagamento, con solo le informazioni generali registrate.#
Il passaggio successivo consiste nel pagare l’ordine con un portafoglio Taler.
Pagamento dell’ordine con un portafoglio Taler.#
Dopo il pagamento, anche Taler SPAA mostra che l’ordine è stato pagato.
Taler SPAA che mostra l’ordine come pagato.#
Ora, tornando a Dolibarr, il nuovo ordine appare nell’elenco degli ordini di Dolibarr.
Elenco degli ordini Dolibarr dopo il pagamento dell’ordine Taler.#
Anche la tabella degli ordini TalerBarr viene aggiornata. A differenza dello stato non pagato, il modulo può ora mostrare gli oggetti aziendali collegati creati sul lato Dolibarr.
Elenco degli ordini TalerBarr dopo il pagamento, che ora mostra gli oggetti collegati.#
Se apri di nuovo la scheda ordine TalerBarr, puoi vedere lo stato aggiornato dell’oggetto e degli elementi collegati.
Scheda ordine TalerBarr dopo il pagamento con gli oggetti Dolibarr collegati.#
A questo punto, il modulo collega l’ordine lato Taler con i corrispondenti oggetti aziendali di Dolibarr, come l’ordine di vendita, la fattura e il pagamento. Questo è il principale vantaggio della modalità Sync when order is paid: solo gli acquisti completati diventano parte del flusso degli ordini dell’ERP.
2.3.5.6. Passaggio successivo#
Una volta che un ordine pagato funziona end-to-end, prosegui con Gestione dei rimborsi per testare la gestione degli storni e con Gestire i bonifici bancari per rivedere il flusso di regolamento.