L'attuale selettore di armadietti GeoWidget di InPost, l'API REST ShipX e le tre dimensioni A/B/C degli armadietti indicate sotto sono corrette; considera il dato sul volume dei pacchi come indicativo e la finestra di ritiro di 48 ore come un valore predefinito frequente, da verificare rispetto al tuo contratto.

Se vendi in Polonia e nella procedura di acquisto offri solo la consegna a domicilio tramite corriere, stai perdendo ordini a favore dei negozi che non lo fanno. I clienti polacchi non considerano l'armadietto per pacchi una soluzione di ripiego: per la maggior parte di loro è l'opzione predefinita, e una procedura di acquisto senza InPost Paczkomaty comunica l'idea di un negozio straniero che non si è nemmeno preso la briga di localizzarsi. Questa guida riguarda una cosa precisa: attivare in PrestaShop una vera consegna InPost Paczkomaty funzionante, il widget di selezione dell'armadietto, il collegamento al corriere, la logica delle dimensioni e il flusso delle etichette, per come si comporta davvero dietro le quinte, non una guida generica su come "aggiungere un corriere".

Per la meccanica più ampia che sta sopra qualsiasi singolo corriere, zone, fasce di peso, moduli corriere in generale, parti dalla nostra guida completa alla configurazione delle spedizioni in PrestaShop e dalla guida passo passo alla configurazione dei moduli corriere. Questo articolo presuppone che tu conosca già quel livello e va dritto a ciò che rende InPost diverso.

Perché i Paczkomaty sono indispensabili per il mercato polacco

Un armadietto automatizzato per pacchi all'aperto con uno scomparto aperto, illuminato di arancione all'interno, che rivela un pacco di cartone pronto per il ritiro
Gli armadietti per pacchi permettono agli acquirenti di ritirare gli ordini secondo i propri tempi: in Polonia sono il metodo di consegna che gli acquirenti si aspettano per primo.

I Paczkomaty (singolare: paczkomat) sono gli armadietti automatici per pacchi di InPost: decine di migliaia in tutta la Polonia, nei parcheggi dei supermercati, presso le stazioni di servizio, nei cortili residenziali. Il cliente riceve un SMS e un'email quando il pacco arriva, raggiunge un armadietto che di solito è a pochi minuti di distanza, scansiona un codice QR o digita un codice di ritiro e uno scomparto si apre. Niente attese in casa per il corriere, niente portineria, disponibilità anche alle 23 di domenica.

InPost dichiara di aver gestito in Polonia ben oltre 900 milioni di pacchi in un anno recente e che una larga maggioranza degli acquirenti online polacchi ha usato un paczkomat. Considera i numeri esatti come indicativi: ciò che conta per il tuo negozio è il comportamento che li spiega. Gli acquirenti polacchi si aspettano l'opzione armadietto nell'elenco dei corrieri e spesso la scelgono per prima. Che cosa significa, quindi, per il tuo negozio PrestaShop? Se InPost non c'è, oppure c'è ma la mappa degli armadietti non funziona con il tuo tema, il cliente non ti scrive un'email: chiude semplicemente la scheda. Con questo corriere, la partita si gioca tutta nel rendere la selezione naturale e senza attriti.

Tre modi per integrare InPost con PrestaShop

Esiste più di una strada per portare InPost in un negozio PrestaShop, e quella giusta dipende dai volumi e da quanto altro spedisci.

SoluzioneChe cos'èImpegnoIdeale quando…
Modulo ufficiale InPostIl modulo PrestaShop di InPost: selettore di locker GeoWidget, generazione etichette, sincronizzazione degli statiBasso, installa & inserisci le credenziali APIInPost è il tuo principale o unico corriere polacco; vuoi che sia il fornitore a mantenere la compatibilità con widget/API.
Modulo spedizioni multi-corriereUn modulo corriere più ampio che elenca InPost accanto a DHL/DPD/GLS sotto un'unica interfaccia per etichette e tracciamentoBasso-medioSpedisci già con diversi corrieri e vuoi un unico flusso di lavoro nel pannello di amministrazione, accettando che possa arrivare in ritardo sulle modifiche dell'API InPost.
Integrazione diretta con l'API ShipXCodice personalizzato basato sull'API REST ShipX di InPostAlto, tempo di sviluppoVolumi molto elevati con logiche di evasione su misura che nessun modulo pronto all'uso riesce a modellare.

La maggior parte dei negozi dovrebbe iniziare dal modulo ufficiale. Se InPost è uno dei vari corrieri che usi, guarda come si inseriscono gli altri: integrazione di DHL, DPD e UPS e spedizioni GLS multi-paese. Il modello dei punti di ritiro usato da InPost esiste anche in Francia: se spedisci anche lì, l'articolo gemello è la consegna presso punti di ritiro Mondial Relay.

Prerequisiti prima di installare qualsiasi cosa

Il modulo è la parte semplice; l'account è ciò che spesso crea problemi. Prima di toccare PrestaShop ti servono:

  • Un account business InPost nel Manager Panel (manager.paczkomaty.pl), qui vengono gestiti spedizioni, tariffe e saldo.
  • Credenziali API: un ID organizzazione e un token di accesso generati all'interno del Manager Panel. Genera un token dedicato per il negozio invece di riutilizzarne uno personale, così potrai revocarlo senza compromettere tutto il resto.
  • Un contratto InPost negoziato (per le tue tariffe) oppure il sistema di saldo prepagato che finanzia la generazione delle etichette.

Collegare il corriere a PrestaShop

Installa il modulo nel modo consueto, Moduli → Gestione moduli → Carica un modulo, quindi apri la sua configurazione. La configurazione di InPost ha alcune parti mobili che non esistono per un corriere tradizionale, e sistemarle bene fin dall'inizio evita molti ticket di assistenza del tipo "perché la spedizione è gratis / sbagliata / assente" in seguito.

Credenziali API e ambiente

Incolla l'ID organizzazione e il token di accesso dal Manager Panel. La maggior parte dei moduli espone un interruttore sandbox vs produzione: fai il primo test dall'inizio alla fine (inserisci un ordine, genera un'etichetta) in sandbox, così non consumi saldo prepagato reale su pacchi fittizi. Passa alla produzione solo quando una vera etichetta viene generata correttamente.

L'oggetto corriere

Il modulo registra un corriere PrestaShop (l'oggetto standard Carrier che vedresti in Spedizione → Corrieri). Dagli un nome che i clienti polacchi riconoscano all'istante, "Paczkomat InPost" o "InPost Paczkomaty", e una dicitura sui tempi di consegna in polacco, ad esempio "1–2 dni robocze", perché quell'etichetta viene mostrata tale e quale nella fase di selezione del corriere. Impostalo per servire la zona Polonia (e qualsiasi altro paese in cui hai abilitato gli armadietti) e definisci le fasce di peso/prezzo esattamente come faresti per qualsiasi corriere: questa meccanica di base non cambia ed è trattata nella guida alla configurazione.

Logica delle dimensioni degli armadietti: il vincolo specifico degli armadietti

Un corriere accetta quasi qualsiasi scatola; uno scomparto di armadietto no. Gli armadietti InPost sono disponibili in tre dimensioni: A (circa 8×38×64 cm), B (circa 19×38×64 cm) e C (circa 41×38×64 cm). Nulla di più grande di uno scomparto C può essere consegnato a un paczkomat. Quindi una parte essenziale della corretta configurazione di InPost è decidere cosa succede quando un carrello non può fisicamente entrare:

  • Imposta una dimensione predefinita del pacco sensata, coerente con il tuo prodotto tipico.
  • Se vendi articoli ingombranti, limita il corriere InPost in modo che non appaia per carrelli fuori misura: altrimenti un cliente sceglie un armadietto, tu non puoi rispettare la scelta e finisci per rimborsare o rispedire. PrestaShop ti consente di vincolare un corriere per prodotto (restrizioni corriere nella scheda Spedizione del prodotto) o per fascia di peso; usa il criterio che rispecchia meglio il tuo catalogo.
  • Configura eventualmente l'assicurazione: InPost offre una copertura fino a un massimale per pacco, impostato nelle opzioni di spedizione.

Il widget di selezione dell'armadietto: la parte che si rompe davvero

Tutto ciò che sta sopra è impianto tecnico. La parte che i clienti toccano, e quella che più spesso fallisce in silenzio, è il selettore dell'armadietto. L'attuale widget di InPost (il GeoWidget) è una mappa JavaScript incorporata nella procedura di acquisto: geolocalizzazione per trovare gli armadietti vicini, ricerca per indirizzo/città/CAP, filtri per disponibilità e dimensione, compatibilità mobile. Il modulo si aggancia alla fase di selezione del corriere di PrestaShop e, quando il cliente sceglie InPost, mostra un pulsante "Wybierz paczkomat / Scegli armadietto" che apre la mappa. L'ID dell'armadietto scelto viene poi salvato sull'ordine, così l'etichetta punta alla macchina corretta.

Poiché è JavaScript di terze parti iniettato nel tuo tema, è proprio il punto in cui emergono i conflitti con il tema. Le modalità di errore ricorrenti, nell'ordine in cui le vediamo, sono queste:

SintomoCausa abitualeDove guardare
Il pulsante del widget non fa nulla / la mappa non si apre maiConflitto JavaScript, molto spesso uno scontro tra versioni di jQuery o un'intestazione Content-Security-Policy che blocca la CDN di InPostConsole del browser; intestazioni CSP/sicurezza del tuo tema; un altro modulo che carica una seconda jQuery
La mappa si apre ma i riquadri sono vuotiChiave API della mappa mancante o scaduta (nelle build più vecchie del widget); alcune versioni del GeoWidget servono i propri riquadri e non richiedono chiaveVersione del widget; campo della chiave mappa nel modulo
L'armadietto viene scelto ma non salvato nell'ordineL'hook che acquisisce l'ID dell'armadietto selezionato non viene eseguito su una procedura di acquisto personalizzataOverride della procedura di acquisto del tema; hook di visualizzazione del modulo nella procedura di acquisto
Il selettore è assente o inutilizzabile su mobileIl popup non è ottimizzato per mobile in una build più vecchia del moduloAggiorna il modulo; testa il popup reale su un telefono

Il punto non è "aspettati che si rompa": è che questo widget deve essere testato sul tuo tema specifico, su un desktop reale e su un dispositivo mobile reale, prima del lancio. Ogni tema PrestaShop renderizza la fase di consegna in modo leggermente diverso, e un selettore di armadietti che funziona sul tema predefinito può comunque fallire su uno personalizzato. Questo è il test con il maggior valore di tutta l'integrazione.

Etichette e spedizione

Quando arriva un ordine con InPost selezionato, generi l'etichetta di spedizione dall'ordine. Il modulo aggiunge un pulsante nella pagina di dettaglio dell'ordine nel pannello di amministrazione: lo clicchi, il modulo chiama l'API di InPost, crea la spedizione e restituisce un PDF. Le etichette InPost sono dimensionate per adesivi termici A6 (105×148 mm), ma si stampano bene anche su A4 con ridimensionamento. Per qualsiasi volume significativo, genera le etichette in massa: seleziona più ordini e produci un unico PDF combinato, dall'elenco ordini del modulo o dal Manager Panel, perché cliccare un ordine alla volta non regge una settimana intensa.

Tracciamento e finestra di ritiro di 48 ore

InPost invia autonomamente notifiche SMS ed email, e la maggior parte dei clienti polacchi traccia i pacchi nell'app mobile InPost, quindi non devi costruire tu le notifiche. Alcuni moduli possono anche riportare lo stato in PrestaShop e mostrarlo nella pagina dell'ordine, anche se di solito richiede configurazione (webhook o cron) e varia in base alla versione del modulo: verificalo nel modulo che hai effettivamente installato. Lo stato che richiede una risposta operativa è la scadenza del ritiro dall'armadietto: un pacco resta nell'armadietto per una finestra limitata (comunemente circa 48 ore) e poi viene restituito al mittente. Assicurati che il tuo team abbia un percorso definito per un pacco restituito perché non ritirato, rispedizione, rimborso o contatto con il cliente, invece di scoprirlo settimane dopo. Per mostrare ai clienti link di tracciamento e notifiche di spedizione su tutti i tuoi corrieri, vedi numeri di tracciamento e notifiche di consegna, e per impostare finestre di arrivo oneste sul lato prodotto/procedura di acquisto, date di consegna stimate.

Prezzi e posizionamento di InPost

Come definire il prezzo dell'opzione armadietto è una scelta strategica, non di configurazione, e merita una trattazione dedicata invece di un paragrafo affrettato qui. Il punto specifico sul corriere da ricordare è questo: poiché la consegna in armadietto salta l'ultimo miglio, costa meno da gestire rispetto al corriere a domicilio. Questo ti dà margine per rendere InPost più economico o gratuito prima dei corrieri a domicilio, ma tieni presente che la soglia di spedizione gratuita integrata in Spedizione → Preferenze di PrestaShop è globale, non per corriere. Quindi la spedizione gratuita specifica per InPost significa azzerare le fasce di prezzo di quel corriere, usare una regola carrello limitata al corriere InPost, lasciare che se ne occupi il modulo spedizioni, oppure posizionarlo per primo così è l'opzione che i clienti notano subito. Per i veri criteri decisionali dietro quei numeri, vedi spedizione gratuita vs tariffa fissa vs calcolata, quando la spedizione gratuita ha senso (e quando erode il margine) e la strategia di spedizione per piccoli negozi.

InPost oltre la Polonia

InPost ha esteso la sua rete di armadietti nel Regno Unito, in Francia, in Italia e in Spagna. Se il tuo negozio PrestaShop spedisce oltre confine, il modello di integrazione è lo stesso, stessa API ShipX, stesso modello di widget, cambiano solo il paese di destinazione e la rete di armadietti. Abilita i paesi aggiuntivi nelle zone del corriere e verifica che il widget mostri gli armadietti in quei mercati. Non sostituirà dall'oggi al domani il principale corriere locale di un paese, ma è una valida opzione di punto di ritiro da offrire accanto a esso.

Gli errori che costano di più

  • Offrire gli armadietti per articoli che non ci entrano. Lo scomparto C si ferma a circa 41×38×64 cm. Se vendi mobili o qualsiasi articolo ingombrante, devi limitare il corriere InPost per quei prodotti, altrimenti ti ritroverai a gestire manualmente ordini impossibili.
  • Non testare mai il widget sul tuo tema reale e su un telefono reale. È il guasto più comune nel giorno del lancio, ed è completamente evitabile.
  • Nessun processo per i pacchi non ritirati. La finestra di ritiro è breve; prepara la gestione di resi e rispedizioni prima che il problema arrivi, non dopo.
  • Ordini del weekend lasciati fermi. Parte dell'attrattiva dell'armadietto è il ritiro 24 ore su 24. Se generi le etichette solo nei giorni feriali, smorzi il vantaggio di rapidità per cui i clienti hanno scelto InPost.

Dove si inserisce nel resto della tua configurazione spedizioni

InPost Paczkomaty non è un'aggiunta facoltativa per il mercato polacco: è il minimo indispensabile. Configura correttamente il corriere, la logica delle dimensioni e soprattutto il widget degli armadietti, e rimuovi il segnale più evidente di "questo negozio non è davvero polacco" nella procedura di acquisto. Il punto in cui possiamo aiutarti è il livello intorno: in mypresta.rocks sviluppiamo moduli PrestaShop pensati per rendere più semplice controllare dal pannello di amministrazione la gestione dei corrieri, le regole di spedizione e il comportamento della procedura di acquisto, direttamente, senza intermediari, con demo live per vedere esattamente come si comporta un modulo prima che tocchi il tuo negozio. Se gestisci più punti di ritiro e spedizione accanto a InPost, la gestione multi-magazzino in PrestaShop copre le spedizioni da più sedi, e la guida alla configurazione dei moduli corriere è la base su cui poggia tutto il resto.

Domande frequenti

Mi serve un account business InPost prima di installare il modulo?

Sì. Il modulo è la parte semplice; l'account è ciò che spesso crea problemi. Crea un account business InPost nel Manager Panel (manager.paczkomaty.pl), genera lì un ID organizzazione e un token di accesso dedicati al negozio, e predisponi un contratto negoziato oppure il saldo prepagato che finanzia la generazione delle etichette. Genera un token limitato a questo negozio invece di riutilizzarne uno personale, così potrai revocarlo in seguito senza compromettere tutto il resto.

Quali dimensioni di pacco entrano in un armadietto InPost?

Gli armadietti hanno tre dimensioni: A (circa 8×38×64 cm), B (circa 19×38×64 cm) e C (circa 41×38×64 cm). Nulla di più grande di uno scomparto C può andare in un paczkomat. Quindi, se vendi articoli ingombranti, limita il corriere InPost in modo che non appaia per carrelli fuori misura, per prodotto (restrizioni corriere nella scheda Spedizione del prodotto) o per fascia di peso, altrimenti un cliente sceglie un armadietto che fisicamente non puoi rispettare e ti ritrovi a rimborsare o rispedire manualmente.

Il pulsante della mappa degli armadietti non fa nulla quando viene cliccato: che cosa non va?

Il GeoWidget è JavaScript di terze parti iniettato nel tuo tema, quindi un pulsante morto è quasi sempre un conflitto JavaScript: molto spesso una seconda jQuery caricata da un altro modulo oppure un'intestazione Content-Security-Policy che blocca la CDN di InPost. Controlla prima la console del browser, poi le intestazioni CSP/sicurezza del tema, quindi eventuali moduli che caricano una propria jQuery. Questo è il test con il maggior valore di tutta l'integrazione: verifica il widget sul tuo tema reale, su desktop reale e su mobile reale, prima del lancio.

Posso offrire la spedizione gratuita con InPost come funziona la soglia di spedizione gratuita di PrestaShop?

Non direttamente: la soglia di spedizione gratuita di Spedizione → Preferenze in PrestaShop è globale, non per corriere. Per rendere gratuito solo InPost, azzeri le fasce di prezzo di quel corriere, usi una regola carrello limitata al corriere InPost oppure lasci che se ne occupi il modulo spedizioni. Poiché la consegna in armadietto salta l'ultimo miglio, costa meno da gestire rispetto a un corriere a domicilio, quindi è un corriere sensato da rendere gratuito prima o da mostrare per primo: sappi solo che l'interruttore della spedizione gratuita non lo farà da solo per singolo corriere.

Che cosa succede se un cliente non ritira il pacco in tempo?

Un pacco resta nell'armadietto per una finestra limitata, comunemente circa 48 ore, anche se devi verificarla rispetto al tuo contratto, e poi viene restituito al mittente. InPost gestisce autonomamente le notifiche SMS/email, quindi non devi crearle tu, ma ti serve un percorso definito per un pacco non ritirato: rispedizione, rimborso o contatto con il cliente. Prepara questa gestione prima del lancio invece di scoprire pacchi restituiti settimane dopo.

InPost funziona fuori dalla Polonia?

Sì. InPost ha esteso la sua rete di armadietti nel Regno Unito, in Francia, in Italia e in Spagna. Il modello di integrazione è lo stesso (stessa API ShipX, stesso modello di widget); cambiano solo il paese di destinazione e la rete di armadietti. Abilita i paesi aggiuntivi nelle zone del corriere e verifica che il widget mostri gli armadietti in quei mercati. Non rimpiazzerà dall'oggi al domani il principale corriere locale di un paese, ma è una valida opzione di punto di ritiro da offrire accanto a esso.

David Miller

David Miller

Fondatore, mypresta.rocks
Informazioni sull’autore

David Miller è uno specialista PrestaShop con oltre dieci anni di esperienza sul campo e fondatore di mypresta.rocks, uno studio di sviluppo con sede a Tychy, in Polonia. Progetta e mantiene un catalogo di 159 moduli PrestaShop, tra cui 21 suite « Revolution » dedicate a SEO, checkout, sicurezza, performance, marketing, ricerca, supporto e gestione del magazzino, che ogni giorno migliorano negozi reali, testati su PrestaShop 1.7.8, 8.x e 9.x. Si occupa inoltre della gestione di negozi in produzione, perciò il suo lavoro si misura sulle vendite reali, non sulle demo. La sua esperienza abbraccia l'intero e-commerce, performance, sicurezza, SEO e marketing, e va oltre PrestaShop, fino a WooCommerce, Shopify e sistemi su misura. Sul blog scrive del lato tecnico di PrestaShop: cosa fa davvero la piattaforma, cosa si rompe in produzione e quali soluzioni reggono nel tempo.

Condividi questo articolo:

Commenti

Ancora nessun commento. Sii il primo!

Ti è piaciuto questo articolo?

Ricevi i nostri ultimi consigli, guide e aggiornamenti dei moduli nella tua casella di posta.

Puoi annullare l'iscrizione in qualsiasi momento. Trovi i nostri contatti nelle note legali.

Caricamento...
Torna su