Spedizione bloccata su Poste Delivery Business o Crono? Analisi tecnica dell'errore "maxDimTot", tabelle dimensionali aggiornate e come automatizzare la correzione per non fermare il magazzino.
Immagina la scena: è il picco del Black Friday o un lunedì mattina particolarmente intenso. Il tuo team sta evadendo decine di ordini al minuto. Tutto scorre liscio finché, improvvisamente, la stampante termica si ferma.
Sullo schermo del tuo gestionale spedizioni appare un messaggio di errore criptico, scritto in "lingua sviluppatore":
Errore API Poste: Dati non conformi: maxDimTot
Non c'è scritto "Pacco troppo lungo". Non c'è scritto "Peso eccessivo". C'è solo quella stringa di codice. Il risultato? L'etichetta non esce, il pacco viene messo da parte e il flusso di lavoro si blocca. Per un e-commerce manager, questi intoppi tecnici non sono solo fastidi, sono costi operativi.
In questa guida definitiva, decodificheremo la logica algoritmica di Poste Italiane (inclusi i servizi Crono e Poste Delivery Business) per spiegarti esattamente perché questo errore appare e, soprattutto, come risolverlo in modo definitivo senza dover misurare ogni scatola col righello.
Per risolvere il problema, dobbiamo capire cosa sta "pensando" il server di Poste Italiane.
La stringa maxDimTot è un'abbreviazione per Maximum Dimension Total (Totale Dimensioni Massime). Quando il tuo software (che sia ShippyPro, Qapla', Magento o un'integrazione diretta) invia i dati dell'ordine a Poste, il sistema effettua un controllo matematico istantaneo.
L'algoritmo somma i tre lati del tuo pacco:
Se il risultato di questa somma supera, anche di un solo centimetro, la soglia prevista dal contratto che stai cercando di usare (es. "Standard"), l'API rifiuta la richiesta e restituisce maxDimTot. Non è un bug del software, è un blocco contrattuale.
L'errore nasce quasi sempre dal tentativo di far passare un pacco "Voluminoso" attraverso una tariffa "Standard". Ecco le soglie esatte per i servizi Poste Delivery Business (ex Crono) aggiornate al 2026.
È la tariffa base, quella più economica e usata per il 90% degli e-commerce. Se non selezioni nulla di specifico, il sistema usa questa.
L'errore classico:
Hai una scatola lunga e stretta, ad esempio 80 x 40 x 40 cm.
Risultato: Errore maxDimTot perché 160 > 150.
Questa è la fascia immediatamente successiva. Costa leggermente di più, ma sblocca limiti superiori.
Se vendi mobili smontati, sci o attrezzature ingombranti, devi attivare questa fascia.
Qui i limiti non sono contrattuali, ma fisici. Il pacco deve entrare nello sportello di metallo del locker.
maxDimTot è inevitabile e non bypassabile. Devi cambiare indirizzo.Quando l'errore appare, hai tre strade. Scegli quella giusta per evitare penali.
A volte la colpa è della fretta.
Le misure sono giuste, ma superano i 150 cm di somma.
Cosa NON fare: Non "barare" modificando le misure a 149 cm. I laser scanner negli hub di Poste Italiane (come quello di Bologna o Piacenza) rilevano le dimensioni reali al millimetro.
Cosa fare: Cambia il "Codice Servizio" nella tua piattaforma di spedizione. Deseleziona "Standard" e seleziona "Voluminoso" (o Bulky). L'etichetta verrà stampata subito.
Se l'errore appare su una spedizione estera (es. Crono International), il problema è spesso il Peso Volumetrico.
L'errore maxDimTot è una perdita di tempo se gestito manualmente ordine per ordine. La strategia vincente per un e-commerce scalabile è l'automazione.
Se utilizzi un software di spedizione professionale (come ShippyPro), puoi impostare una "Regola di Spedizione" che ragiona al posto tuo:
Esempio di Regola Automatica:
"SE (Lunghezza + Larghezza + Altezza) è maggiore di 150 cm"
- OPPURE
"SE il Peso è maggiore di 30 kg"
ALLORA:
"Assegna automaticamente il servizio: Poste Delivery Business Voluminoso"
Con questa configurazione, il sistema analizza l'ordine prima che tu provi a stampare l'etichetta, seleziona già il servizio corretto e previene l'errore. Il magazziniere non vedrà mai il messaggio "Dati non conformi", vedrà solo l'etichetta pronta.
Ufficialmente, no. I sistemi di smistamento automatizzati sono precisi. Tuttavia, per pochi millimetri, spesso il pacco passa, ma è un rischio che ti assumi. Se superi di 5-10 cm, il blocco è quasi certo.
Verifica di non aver selezionato un servizio accessorio incompatibile. Ad esempio, alcune opzioni come "Consegna al Piano" o "Su Appuntamento" potrebbero avere restrizioni dimensionali specifiche a seconda della zona servita. Oppure, stai spedendo a un Locker con un pacco che supera i 36x37x56 cm.
No. Ogni scatola deve avere la sua etichetta di tracciamento (Master/Child). Se dividi la merce in due scatole, devi creare una spedizione "Multicollo". Il sistema genererà due etichette diverse e sommerà i pesi, ma verificherà le dimensioni di ogni singolo collo separatamente, aiutandoti a rientrare nei limiti maxDimTot per singolo pezzo.