Noleggio Prodotti — Guida completa
Installare, configurare e gestire il noleggio di prodotti: calendario di prenotazione, pannello, planning a linea temporale per unità, numeri di serie, consegna e restituzione, protezione dalle sovraprenotazioni, stagioni, pacchetti, cauzione in riga separata o impronta Stripe, richieste senza pagamento, pack, API REST, feed iCal, webhook ed email di promemoria, per PrestaShop da 1.7.8 a 9.x.
Presentazione
Il modulo Noleggio prodotti (dfproductrental) aggiunge una modalità noleggio attivabile prodotto per prodotto sul vostro negozio PrestaShop, e copre poi tutta la gestione del parco. Sulla scheda di un prodotto noleggiabile, il cliente sceglie le date in un calendario integrato che mostra, giorno per giorno, cosa è disponibile, le unità rimanenti, i giorni completi e i giorni senza consegna né restituzione possibile. Il prezzo si calcola in tempo reale: durata, tariffa giornaliera applicata, risparmio ottenuto con scaglioni o pacchetti, cauzione e totale. La tariffa si calcola al giorno tramite scaglioni decrescenti, una percentuale del prezzo di vendita o coefficienti di durata, modulata da stagioni tariffarie e pacchetti a prezzo fisso. La cauzione vive su una riga dedicata del carrello, rimborsabile con nota di credito, oppure passa all’impronta carta Stripe.
In back-office, un pannello elenca ciò che richiede la vostra attenzione oggi, un planning a linea temporale mostra ogni prenotazione per unità (numero di serie), e prenotazioni, consegna e restituzione, statistiche, richieste senza pagamento, pack sincronizzati, API REST, feed iCal privato, webhook in uscita ed email di promemoria completano il modulo. Le date restano bloccate mentre il cliente paga e ogni sovrapposizione viene rilevata: un’unità non viene mai noleggiata due volte.
Ideale per attrezzature, mobili, materiale per eventi, strumenti, veicoli o utensili: tutto ciò che si noleggia invece di vendersi una volta per tutte. La modalità noleggio si attiva solo sui prodotti che designate, senza modificare il resto del catalogo.

Novità della versione 2.0.0
- Funziona con Hummingbird, il tema predefinito di PrestaShop 9, oltre che con Classic e con i temi personalizzati.
- Basta sovraprenotazioni: le date restano bloccate durante il checkout, una prenotazione presa nel frattempo viene tolta dal carrello con un messaggio prima del pagamento, e un ordine pagato su date non più libere viene segnalato come conflitto (pannello, ordine, planning, email al negozio).
- Carrello protetto: le quantità delle righe di noleggio sono bloccate, l’aggiunta al carrello nativa viene rifiutata sui prodotti noleggiabili, la riga cauzione non può essere eliminata.
- Nuovo blocco di prenotazione: calendario integrato con le unità rimanenti, prezzo in tempo reale con il risparmio ottenuto, pacchetti come pulsanti rapidi, selettore di quantità, modulo di richiesta richiudibile.
- Nuovo back-office: pannello con azioni in un clic, planning a linea temporale per unità con giorni di margine, noleggi in ritardo e conflitti, impostazioni in sei sezioni, statistiche ridisegnate, una scheda Noleggio nella pagina prodotto di PrestaShop.
- Feed iCal privato dei vostri noleggi per Google Calendar, Outlook o Apple Calendar.
- 8 lingue (EN, FR, ES, DE, IT, PL, NL, PT) e 9 modelli di email ridisegnati in ogni lingua.
- Importi più chiari: prezzi mostrati IVA esclusa o inclusa secondo il gruppo del cliente, cauzione mostrata all’importo realmente pagato o garantito, nuova impostazione Aggiungere l’IVA alle cauzioni per prodotto.
- Sicurezza: token su ogni azione lato negozio, limite di richieste per visitatore e per ora, campo anti-bot, blocco attorno alle verifiche di disponibilità, webhook HTTPS, chiave segreta Stripe mai più mostrata.
- Compatibile da PrestaShop 1.7.8 a 9.x e da PHP 7.4 a 8.5.
Compatibilità
- PrestaShop da 1.7.8 a 9.x
- PHP da 7.4 a 8.5
- Temi Hummingbird, Classic e personalizzati
- Negozio singolo e multinegozio
- 8 lingue: EN, FR, ES, DE, IT, PL, NL, PT (interfaccia, calendario ed email)
- Nessuna dipendenza: niente Composer, autoloader PSR-4 manuale, calendario integrato localmente
Installazione e aggiornamento
- In back-office, aprite Moduli > Gestore dei moduli.
- Cliccate Carica un modulo e selezionate il file
dfproductrental.zip. - A installazione avvenuta, cliccate Configura per aprire le impostazioni.
Il modulo crea le sue tabelle, registra i suoi hook e aggiunge un menu Catalogo > Noleggi con sei pagine: Pannello, Planning, Prenotazioni, Prodotti a noleggio, Unità e Statistiche. Una barra di navigazione comune a tutte le pagine del modulo le collega alle impostazioni, mostra il numero di richieste in attesa di risposta e vi avvisa in caso di conflitti di prenotazione.
Aggiornamento da 1.x: caricate lo ZIP 2.0.0 sopra la versione precedente, poi svuotate la cache di PrestaShop. Prenotazioni, unità, configurazioni dei prodotti e impostazioni vengono conservate. Le versioni 1.x aggiungevano l’aliquota IVA del prodotto alle cauzioni per prodotto: questo comportamento viene mantenuto dopo l’aggiornamento affinché i vostri clienti paghino gli stessi importi, e un banner propone di disattivarlo. Un URL di webhook in http:// viene disattivato dall’aggiornamento (HTTPS è obbligatorio).
Pannello
Catalogo > Noleggi > Pannello riunisce a colpo d’occhio ciò che richiede la vostra attenzione:
- Indicatori: unità in noleggio (noleggi in corso), consegne e restituzioni previste oggi, restituzioni in ritardo, occupazione sui prossimi 30 giorni e fatturato del mese (IVA esclusa, noleggi che iniziano nel mese) con la sua variazione.
- Elenchi delle consegne e restituzioni del giorno, delle richieste di prenotazione e dei noleggi in ritardo con azioni in un clic: Consegna, Registra restituzione, Accetta, Rifiuta.
- Conflitti da risolvere: prenotazioni pagate o confermate su date non più disponibili, da spostare o da assegnare a un’altra unità.
- Un grafico di occupazione dei prossimi 30 giorni e i noleggi che iniziano nei prossimi 7 giorni.
Su un negozio nuovo, schermate guidate mostrano i primi passi: aggiungere un prodotto a noleggio, poi attendere le prime prenotazioni.

Impostazioni
La pagina di configurazione (Configura nel Gestore dei moduli, oppure Impostazioni nella navigazione del modulo) è organizzata in sei sezioni. Le griglie (stagioni, date di chiusura, coefficienti) vengono verificate riga per riga al salvataggio, con un messaggio che indica la riga errata.
Regole di prenotazione
- Selezione delle date: un campo periodo (intervallo), due campi di inizio e fine, oppure data di inizio più numero di settimane.
- Scelta delle date: sulla scheda prodotto, oppure solo nel carrello (le date si scelgono allora una sola volta per tutto l’ordine).
- Date globali del carrello e orari di ritiro e riconsegna.
- Addebitare il giorno della restituzione: sì, conteggio di calendario, il giorno della restituzione è un giorno di noleggio (dal 14 al 20 = 7 giorni); no, modello rotazione, la restituzione avviene il giorno successivo al periodo fatturato (dal 14 al 21 = 7 giorni, una settimana va da lunedì a lunedì), e quel giorno resta indisponibile per un’altra consegna.
- Orizzonte del calendario (giorni): fino a quale data futura i clienti possono prenotare (365 per impostazione predefinita).
- Giorni di margine predefiniti: giorni bloccati dopo ogni restituzione per preparare l’articolo, sovrascrivibili per prodotto.
- Scadenza dei carrelli (minuti): oltre questo termine, un carrello non pagato libera le sue date (60 per impostazione predefinita). Durante il checkout, il termine viene rinnovato.
- Giorni di chiusura settimanali (caselle da spuntare) e date di chiusura, una per riga, nel formato AAAA-MM-GG (puntuale) o MM-GG (ogni anno, es. 12-25). Un noleggio può coprire un giorno di chiusura; sono impossibili solo la consegna e la restituzione in quel giorno.
Tariffe
Stagioni tariffarie, griglia dei coefficienti e coefficienti weekend (da sabato a lunedì, da venerdì a lunedì), e la modalità Tutto il catalogo a noleggio con la sua tariffazione (prezzo prodotto al giorno, oppure prezzo prodotto × coefficiente di durata) e le sue richieste senza pagamento.
Cauzione
Modalità di cauzione (per prodotto, globale automatica con una sola cauzione per ordine, oppure disattivata), cauzione predefinita, Addebitare la cauzione, Aggiungere l’IVA alle cauzioni per prodotto (no per impostazione predefinita: la cauzione che inserite è l’importo pagato), moltiplicatore, minimo e arrotondamento della cauzione globale.
Visualizzazione nella pagina prodotto
Posizione del blocco di noleggio (e riposizionamento con JavaScript per i temi che lo richiedono), occultamento del pulsante di aggiunta al carrello nativo, e Mostra le unità rimanenti nel calendario (la dicitura “Ancora N”).
Richieste e notifiche
Propagare i pack sui loro componenti, scadenza delle richieste (ore), richieste per visitatore all’ora (limite anti-spam, 5 per impostazione predefinita), email di promemoria automatiche e il loro anticipo, e Avvisami in caso di conflitti di prenotazione (email al negozio).
Integrazioni
API REST, feed calendario (iCal), webhook in uscita e il loro URL HTTPS, cauzione con impronta carta Stripe con chiave pubblicabile, chiave segreta (mai più mostrata: lasciate il campo vuoto per conservarla), impronta obbligatoria prima dell’uscita e testo di consenso. Token, URL cron, indirizzo iCal e segreto dei webhook sono mostrati in riquadri sotto il modulo.

Configurare un prodotto noleggiabile
Andate in Catalogo > Noleggi > Prodotti a noleggio, poi Aggiungi: prodotto, attivazione, modalità di tariffazione (importi fissi, percentuale del prezzo di vendita o coefficiente), prezzo base giornaliero, cauzione, durata minima e massima, unità disponibili, giorni di margine, richiesta senza pagamento e blocco dello stock da parte delle richieste. Nella pagina prodotto di PrestaShop, una scheda Noleggio riassume stato, tariffa, unità, durate e prossime prenotazioni, con link alla configurazione e al planning.
Scaglioni decrescenti
Ogni scaglione è definito da giorno minimo, giorno massimo e prezzo giornaliero. Il modulo applica lo scaglione il cui intervallo contiene la durata scelta; un giorno massimo a 0 significa illimitato; senza scaglione corrispondente, si applica il prezzo base. Esempio: 39/giorno da 1 a 3 giorni, 32/giorno da 4 a 7 giorni, 26/giorno da 8 giorni. Sulla scheda prodotto, il risparmio rispetto al prezzo base è mostrato nel riepilogo del prezzo.
Pacchetti a prezzo fisso
La zona Pacchetti a prezzo fisso accetta un pacchetto per riga nel formato giorni|prezzo netto|etichetta, per esempio 7|199|Pacchetto settimana. Quando la durata scelta coincide esattamente, questo prezzo tondo sostituisce tutto il calcolo: niente scaglioni, niente coefficienti, niente stagioni. I pacchetti sono proposti come pulsanti rapidi sopra il calendario: un clic seleziona il periodo corrispondente.
Modalità percentuale
Prezzo base giornaliero, cauzione e scaglioni si esprimono come percentuale del prezzo di vendita al netto d’IVA del prodotto. Un prodotto venduto a 1000 con cauzione 10 richiede 100 di cauzione. Gli importi seguono automaticamente i prezzi del catalogo.

Uso lato negozio
Scelta delle date
Il blocco di prenotazione si apre con un’intestazione “da X / giorno”, poi un calendario integrato (due mesi su schermo grande, uno su mobile). Ogni giorno mostra il suo stato: disponibile, “Ancora N” quando restano poche unità, completo (barrato), oppure chiuso per consegna e restituzione. I riquadri “Ritiro” e “Restituzione” guidano la selezione e una legenda spiega i colori. I giorni prenotati includono il margine di ogni prodotto. In modalità settimane, il cliente sceglie una data di inizio e un numero di settimane; la data di restituzione e il totale si calcolano automaticamente.
Prezzo e prenotazione
Il riepilogo del prezzo si aggiorna in tempo reale: durata, tariffa giornaliera applicata, risparmio ottenuto con scaglioni o pacchetti, noleggio, cauzione (rimborsata o solo garantita) e totale. Gli importi sono mostrati IVA esclusa o inclusa secondo il gruppo del cliente. Una riga rassicurante ricorda al cliente che la disponibilità è in tempo reale, che le date restano bloccate durante il pagamento e come funziona la cauzione. Il pulsante di prenotazione aggiunge il noleggio al carrello: il prezzo è iniettato tramite un prezzo specifico legato al carrello, il prezzo di catalogo resta intatto, e la cauzione appare sulla propria riga.

Su mobile
Il blocco si adatta agli schermi piccoli: calendario di un mese, ampie zone di tocco, riepilogo del prezzo sotto il calendario. È stato verificato a 390 px di larghezza, con etichette, focus visibile e annunci in tempo reale per i lettori di schermo.

Carrello
Ogni riga di noleggio mostra le sue date sotto il nome del prodotto. Le quantità delle righe di noleggio sono bloccate: cambiare una quantità significa scegliere nuove date. Un riepilogo del noleggio ricorda per quanto tempo le date restano bloccate, e l’editor delle date globali del carrello (se attivo) permette al cliente di cambiare il periodo di tutto l’ordine. Se le date sono state prese da qualcun altro mentre il carrello era in attesa, la riga viene tolta con un messaggio prima del pagamento.

Conferma d’ordine e account cliente
La conferma d’ordine e il dettaglio dell’ordine nell’account cliente mostrano una tabella con periodi di noleggio, durate, importi, cauzioni e stati. La pagina I miei noleggi dell’account cliente elenca i noleggi sotto forma di schede, con il loro stato e, se necessario, il pulsante Registra la mia carta per l’impronta Stripe.


Cauzione: riga dedicata o impronta Stripe
Cauzione addebitata
Con Addebitare la cauzione attivo, la cauzione appare come riga dedicata del carrello: un prodotto tecnico Cauzione di noleggio, esente IVA, invisibile nel catalogo, porta il totale delle cauzioni dell’ordine. Il prezzo dei prodotti noleggiati contiene solo il noleggio. In fattura, la cauzione è una riga a parte; il suo rimborso alla restituzione del materiale si risolve con una nota di credito su quella riga, dalla pagina dell’ordine. La riga cauzione non può essere eliminata dal carrello. L’importo viene dalla modalità scelta: cauzione per prodotto, o cauzione globale automatica (importo base IVA inclusa moltiplicato, con minimo e arrotondamento).
Un deposito cauzionale di solito non è soggetto a IVA: con Aggiungere l’IVA alle cauzioni per prodotto disattivato (impostazione predefinita su una nuova installazione), la cauzione che inserite è esattamente l’importo pagato dal cliente.
Impronta carta Stripe
Con Addebitare la cauzione disattivato e Cauzione con impronta carta Stripe attivato (chiavi pk_ e sk_ compilate), non si incassa nulla. Dopo l’ordine, il cliente è invitato dalla pagina di conferma a registrare la carta su una pagina sicura basata su Stripe Elements: nessun dato carta passa dal negozio, nessun importo viene addebitato o bloccato. Il modulo verifica che la carta registrata appartenga all’ordine.
In caso di danni riscontrati alla restituzione: aprite la prenotazione, inserite la cauzione trattenuta e il motivo, salvate, poi cliccate Addebita la trattenuta via Stripe. L’importo viene addebitato fuori sessione nella valuta dell’ordine e l’identificativo del pagamento è conservato sulla prenotazione. Un rifiuto bancario (3-D Secure) viene mostrato così com’è; la trattenuta resta allora da incassare in altro modo.
Impronta obbligatoria prima dell’uscita
Questa opzione subordina la consegna del materiale alla registrazione della carta: una prenotazione pagata senza impronta è contrassegnata come impronta in attesa (badge e filtro nelle prenotazioni, indicatore nel pannello) e il pulsante Consegna rifiuta finché la carta non è registrata. Nessun ordine pagato viene mai annullato automaticamente. Il cliente è accompagnato passo dopo passo: pulsante Registra la mia carta nella pagina I miei noleggi, sollecito quotidiano via email con il link sicuro (tramite l’URL cron), e un link che potete copiare dalla scheda prenotazione. Il testo di consenso della pagina impronta può essere sostituito in ogni lingua.
Per un caso concordato con il cliente (B2B, club, garanzia alternativa), l’interruttore Autorizzare l’uscita senza impronta della scheda prenotazione esenta solo quel noleggio.
Perché non una preautorizzazione classica? I circuiti carta fanno scadere le preautorizzazioni dopo 7 giorni: impossibile coprire un noleggio più lungo. La registrazione della carta non scade; è il modello usato dalle piattaforme di noleggio. L’account Stripe usato è indipendente dal modulo di pagamento del negozio.
Unità e numeri di serie
In Catalogo > Noleggi > Unità, create una scheda per ogni esemplare fisico: prodotto, riferimento o numero di serie, stato (disponibile o in manutenzione), attivazione, nota interna. Non appena un prodotto ha almeno un’unità, la sua capacità di noleggio diventa il numero di unità attive e disponibili: mettere un’unità in manutenzione la toglie dallo stock senza toccare la configurazione. Questa capacità vale anche per l’accettazione delle richieste e per l’API.
Su ogni prenotazione, il campo Unità assegnate propone le unità libere nel periodo (margine incluso) più quelle già assegnate. Un’unità presa da un’altra prenotazione viene rifiutata con un messaggio. I riferimenti appaiono nella lista delle prenotazioni, nel planning, nella pagina dell’ordine e nel webhook.
Prenotazioni, consegna e restituzione
Catalogo > Noleggi > Prenotazioni elenca tutte le prenotazioni con prodotto, cliente, ordine, date, unità assegnate, cauzione e stato colorato: richiesta in attesa, in attesa (carrello), confermata, in corso, restituita, rifiutata, annullata, più i badge conflitto e impronta in attesa. Le azioni rapide seguono lo stato:
- Consegna, su una prenotazione confermata: il materiale è consegnato al cliente, il noleggio passa in corso e l’ora viene registrata.
- Registra restituzione, su un noleggio in corso: il materiale è restituito, il noleggio passa a restituita e l’ora viene registrata. Le date si liberano dopo i giorni di margine.
- Accetta e Rifiuta, su una richiesta.

La scheda prenotazione riunisce prodotto, date, quantità, stato e unità assegnate, il verbale di consegna e il verbale di restituzione, e la cauzione trattenuta con il suo motivo, pronta per l’addebito Stripe o per una nota di credito parziale. Al salvataggio, date e stato vengono verificati e un periodo che supera la capacità viene segnalato come conflitto.

Planning
Catalogo > Noleggi > Planning mostra una linea temporale: una riga per prodotto con il carico di ogni giorno (verde, poi rosso quando è completo), e una riga per unità (numero di serie) con le barre delle prenotazioni colorate secondo lo stato: confermata, in corso, richiesta, carrello, in ritardo o conflitto. I giorni di margine sono tratteggiati e i noleggi in ritardo si estendono fino a oggi. Passate dalla vista 2 settimane a mese e 3 mesi, filtrate per prodotto, mostrate o nascondete richieste e carrelli, e cliccate su una barra per aprire la prenotazione. I giorni di chiusura e il giorno corrente sono evidenziati. I link della versione 1.x continuano a funzionare.


Protezione dalle sovraprenotazioni e conflitti
La disponibilità viene verificata sotto un blocco del database, quindi due clienti non possono prendere l’ultima unità nello stesso momento. Mentre il cliente passa dal carrello al checkout, ogni prenotazione viene verificata di nuovo e il suo blocco rinnovato. Se le sue date sono state prese nel frattempo (per esempio dopo la scadenza del carrello), la riga viene tolta con un messaggio prima del pagamento.
Se un ordine viene comunque pagato su date non più disponibili, la prenotazione viene conservata (l’ordine esiste) ma segnalata come conflitto: banner nella navigazione del modulo, elenco nel pannello, barra rossa nel planning, indicazione nella pagina dell’ordine e, se attivata, un’email al negozio. Spostate una delle prenotazioni o assegnate un’altra unità per risolverlo.
Statistiche
Catalogo > Noleggi > Statistiche analizza il periodo che scegliete (ultimi 12 mesi per impostazione predefinita): indicatori, poi per prodotto numero di prenotazioni, giorni noleggiati moltiplicati per la quantità e limitati al periodo, capacità, tasso di occupazione con barra, fatturato del noleggio al netto d’IVA imputato all’inizio del noleggio e cauzioni trattenute, con una riga di totali. Stati considerati: confermata, in corso, restituita.

Pagina dell’ordine in back-office
Nella pagina dell’ordine di PrestaShop, un unico blocco Noleggio mostra ogni prodotto noleggiato con periodo, durata, unità, importi, cauzione e stato (tradotto e colorato), con link alle prenotazioni. Le stesse informazioni appaiono in fattura.

Stagioni tariffarie
La griglia delle stagioni accetta una stagione per riga: inizio|fine|moltiplicatore|etichetta. Due formati di limiti: date complete 2026-06-15|2026-09-15|1.3|Alta stagione (stagione puntuale) o mese-giorno 12-20|01-05|1.5|Festività (ogni anno, cambio d’anno gestito). Ogni giorno di noleggio è fatturato alla tariffa giornaliera moltiplicata per il coefficiente della sua stagione; fuori stagione il coefficiente è 1; in caso di sovrapposizione, vince l’ultima riga. I pacchetti a prezzo fisso ignorano le stagioni: è il senso di un prezzo tondo.
Email e promemoria (cron)
Il modulo include 9 modelli di email nelle 8 lingue, con intestazione, badge di stato, tabella riepilogativa e pulsante d’azione: richiesta ricevuta, richiesta accettata o rifiutata, nuova richiesta per il negozio, promemoria prima dell’inizio, promemoria prima della restituzione, sollecito di ritardo, sollecito di impronta carta e conflitto di prenotazione. Oggetti, date e importi seguono la lingua del destinatario.
I promemoria sono inviati dall’URL cron protetto da token mostrato sotto il modulo delle impostazioni: attivate Email di promemoria automatiche, impostate l’anticipo (1 = il giorno prima) e chiamate l’URL una volta al giorno (attività cron dell’hosting o servizio esterno). Ogni email viene inviata una sola volta per prenotazione. La chiamata cron elimina anche le richieste scadute.


Richiesta di prenotazione senza pagamento
Sui prodotti con l’opzione attiva, il blocco di prenotazione propone un modulo di richiesta richiudibile: il cliente sceglie le date, lascia i suoi dati (compilati automaticamente se ha effettuato l’accesso) e un messaggio, senza passare in cassa. Il negozio riceve un’email e la richiesta appare nelle prenotazioni e nel pannello con lo stato Richiesta in attesa: Accetta riverifica la disponibilità, poi conferma e avvisa il cliente; Rifiuta libera le date e avvisa il cliente. Il blocco dello stock da parte delle richieste si regola per prodotto, una scadenza può annullare le richieste senza risposta, e le richieste sono limitate per visitatore e per ora contro lo spam.

Pack di prodotti
I pack nativi di PrestaShop sono sincronizzati: prenotare un pack blocca la disponibilità di ogni suo componente noleggiabile sullo stesso periodo (quantità del pack incluse), prenotare un componente da solo rende il pack indisponibile, e ogni modifica alla prenotazione del pack si propaga ai suoi componenti. Le prenotazioni dei componenti sono nascoste lato negozio e visibili in back-office con un badge Pack. Un’impostazione disattiva il meccanismo.
API REST
Attivate l’API nella sezione Integrazioni: due token rigenerabili (lettura-scrittura e sola lettura), passati via X-Api-Key o Authorization: Bearer.
GET ping: autenticazione e versione.GET products: prodotti noleggiabili e loro configurazione.GET availability: disponibilità giorno per giorno, unità rimanenti e margine inclusi.GET bookings: prenotazioni, filtrabili perstatus,id_product,from,to,updated_since,external_reference.POST bookings: creazione, idempotente viaexternal_reference; un periodo oltre la capacità restituisce 409.POST bookings&id=N: modifica;DELETE bookings&id=N: annullamento.
Feed calendario (iCal)
Attivate Feed calendario (iCal) nella sezione Integrazioni: un indirizzo privato, mostrato nel riquadro sotto il modulo, pubblica i vostri noleggi confermati e in corso e le richieste in attesa. Iscrivetevi da Google Calendar, Outlook o Apple Calendar per vedere consegne e restituzioni nel vostro calendario abituale. L’indirizzo può essere rigenerato in qualsiasi momento; quello precedente smette allora di funzionare.
Webhook in uscita
Attivate i webhook e indicate l’URL HTTPS del vostro software: a ogni evento riceve un POST JSON con la prenotazione completa (date, quantità, prezzo, stato, cliente, unità assegnate, orari di consegna e restituzione, trattenuta). Due header accompagnano ogni chiamata: X-DfRental-Event (nome dell’evento) e X-DfRental-Signature (HMAC-SHA256 del corpo con il segreto mostrato nel riquadro dedicato, rigenerabile). Eventi: booking.requested, booking.confirmed, booking.declined, booking.cancelled, booking.active, booking.returned, più booking.created e booking.updated per l’API. L’invio è best effort con timeout breve: un ricevitore fuori uso non blocca mai il negozio.
Webhook e API si completano: i webhook notificano il vostro software in tempo reale, l’API con updated_since permette di recuperare il ritardo dopo un’indisponibilità del ricevitore.
FAQ e risoluzione dei problemi
Il prezzo di noleggio modifica il prezzo del mio prodotto?
No. Il prezzo è iniettato tramite un prezzo specifico legato al carrello in corso, e la cauzione vive sulla propria riga. Il prezzo di catalogo non cambia.
Due clienti possono prenotare l’ultima unità nello stesso momento?
No. La disponibilità viene verificata sotto un blocco, le date restano bloccate durante il checkout e vengono verificate di nuovo prima del pagamento. Se un ordine viene comunque pagato su date non più libere (per esempio dopo un pagamento molto lungo), la prenotazione è segnalata come conflitto nel pannello e nel planning, e venite avvisati via email.
Il calendario non appare sulla scheda prodotto
Verificate che il prodotto sia configurato e attivo in Prodotti a noleggio. Svuotate poi la cache di PrestaShop (Parametri avanzati > Prestazioni). Se il vostro tema sposta la zona di acquisto, attivate Riposizionare il blocco con JavaScript o scegliete un’altra posizione del blocco nella sezione Visualizzazione nella pagina prodotto.
Il cliente non può modificare la quantità nel carrello
È voluto: la quantità di una riga di noleggio è la quantità prenotata per quelle date. Per noleggiare più unità, il cliente sceglie la quantità nel blocco di prenotazione, che verifica la disponibilità.
La cauzione è soggetta a IVA?
Per impostazione predefinita no: la cauzione che inserite è l’importo pagato. Dopo un aggiornamento da 1.x, l’IVA resta aggiunta per mantenere gli stessi importi; disattivate Aggiungere l’IVA alle cauzioni per prodotto nella sezione Cauzione se non la volete.
La modalità settimane restituisce di domenica, voglio da lunedì a lunedì
Disattivate Addebitare il giorno della restituzione: una settimana va allora da lunedì a lunedì, 7 giorni fatturati, con la restituzione il giorno successivo al periodo fatturato. Quel giorno resta indisponibile per un’altra consegna.
Il cliente non ha registrato la sua impronta Stripe
Il link è proposto sulla pagina di conferma dell’ordine e un pulsante Registra la mia carta appare nella pagina I miei noleggi. Con l’opzione Impronta obbligatoria prima dell’uscita, il cliente riceve un sollecito quotidiano via email e il pulsante Consegna resta bloccato. Il link può anche essere copiato dalla scheda prenotazione.
L’addebito Stripe viene rifiutato
La banca del cliente può rifiutare un addebito fuori sessione (3-D Secure). Il messaggio di Stripe è mostrato così com’è in back-office. La trattenuta resta allora da incassare per un altro canale; la prenotazione conserva importo e motivo.
La capacità del mio prodotto non segue più la quantità configurata
È il comportamento atteso non appena esiste un’unità per quel prodotto: la capacità diventa il numero di unità attive e disponibili. Eliminate le unità per tornare alla quantità configurata.
Una richiesta accettata crea un ordine?
No. L’accettazione conferma la prenotazione e blocca le date, senza creare un ordine PrestaShop. Incassate il pagamento con il canale che preferite e seguite il noleggio dalle prenotazioni.
Le email di promemoria non partono
Verificate che l’interruttore delle email di promemoria sia attivo e che l’URL cron venga chiamato ogni giorno: risponde in JSON con il numero di email inviate. Ogni email è inviata una sola volta per prenotazione, solo per le prenotazioni collegate a un ordine.
Il mio webhook non riceve più nulla dopo l’aggiornamento
La versione 2.0.0 richiede un URL HTTPS. Un indirizzo http:// viene disattivato dall’aggiornamento: inserite un indirizzo HTTPS e riattivate i webhook.
L’API risponde 401
Verificate che l’API sia attivata e che il token inviato corrisponda a quello mostrato. Dopo una rigenerazione, aggiornate le vostre integrazioni. Il token di sola lettura è accettato solo sugli endpoint GET (403 altrimenti).
Quali versioni di PrestaShop sono supportate?
PrestaShop da 1.7.8 a 9.x, con PHP da 7.4 a 8.5, in negozio singolo e multinegozio, con i temi Hummingbird e Classic e con i temi personalizzati.