Spedizioni con Poste Italiane: generare la lettera di vettura da Kliveer

Il modulo Spedizioni Poste Italiane genera le lettere di vettura (LdV) di Poste Italiane tramite le API di Poste Delivery Business, senza passare dal portale di Poste. Parti da un ordine, Kliveer precompila mittente, destinatario e colli, e in pochi secondi ottieni il PDF da stampare. Il codice di tracking viene scritto sull'ordine in automatico.

Cosa ti serve prima

• Un contratto Poste Delivery Business con Poste Italiane.
• Le credenziali API di produzione, cioè Client ID e Secret ID, che generi nel portale MyPosteDeliveryBusiness.
• Il codice del centro di costo abilitato sul tuo contratto: Poste lo richiede per ogni lettera di vettura.
• Il modulo attivo e assegnato agli utenti che spediscono. Se ti manca questo passaggio, leggi come attivare un modulo dal marketplace.

Nel menu del gestionale il modulo si chiama Spedizioni Poste e ha tre voci: Nuova LdV, Storico richieste e Impostazioni.

Configurare le impostazioni

1. Apri Spedizioni Poste > Impostazioni.
2. Inserisci Client ID produzione e Secret ID produzione. I valori salvati restano visibili nei campi, così puoi controllarli o copiarli.
3. Compila Centro di costo e, se li hai, Codice contratto e Partner ID.
4. Scegli il Prodotto default, cioè il servizio proposto in ogni nuova lettera di vettura: PosteDelivery Business Express, Standard, Internazionale Express, Internazionale Standard o International Plus.
5. Scegli il Formato default della stampa (A4, 10x11 PDF o ZPL per le stampanti di etichette) e decidi se attivare il Paperless default.
6. Se vuoi, indica un Prefisso nome PDF: viene aggiunto davanti al nome del file della lettera di vettura (lettere, numeri, trattino e underscore).
7. Nel riquadro Mittente default inserisci i dati della tua azienda: ragione sociale, referente, indirizzo, civico, CAP, città, provincia, nazione, email e telefono.
8. Nel riquadro Colli e dati internazionali default imposta il numero di colli, il peso in grammi e le misure in centimetri proposti di solito, più il tipo di destinatario per l'estero: Privato (retailDelivery) o Azienda (businessDelivery).
9. Premi Salva.

Generare una lettera di vettura da un ordine

1. Apri l'elenco dei documenti e, sull'ordine da spedire, apri il menu azioni e scegli LdV Poste. Si apre in una nuova scheda la pagina Genera LdV Poste - Ordine # con il numero dell'ordine.
2. In alto controlla l'etichetta Ambiente: deve indicare PRODUZIONE per una spedizione vera.
3. Verifica il Prodotto, il Formato, l'opzione Paperless e il Centro di costo, già proposti dalle impostazioni. Attivando Paperless il formato passa da solo ad A4.
4. Per le spedizioni in Italia puoi scrivere il Contenuto (facoltativo, massimo 30 caratteri). Per l'estero è obbligatoria la Descrizione contenuto, sempre entro 30 caratteri.
5. Controlla mittente e destinatario. I dati arrivano dall'ordine e puoi correggerli solo per questa lettera di vettura, senza toccare l'anagrafica del cliente.
6. Nel riquadro Colli e dati internazionali inserisci peso in grammi e dimensioni in centimetri di ogni collo. Con Aggiungi collo ne aggiungi altri; ogni collo ha i suoi valori.
7. Premi Genera LdV, rileggi il riepilogo nella finestra Conferma generazione LdV Poste e premi Conferma e genera.

Kliveer invia la richiesta a Poste, salva il PDF della lettera di vettura e scrive il codice di tracking nei dati di trasporto dell'ordine. Se per qualche motivo il tracking non viene riportato sull'ordine, la LdV resta valida e compare un avviso con il numero del log da controllare.

Spedizioni all'estero

Con i prodotti internazionali Poste chiede qualche dato in più, che compili nello stesso riquadro dei colli:

• Content code: la categoria merceologica prevista da Poste. Le voci disponibili dipendono dalla nazione e dal prodotto.
• Receiver type: privato o azienda.
• Codice TARIC, valore dell'articolo (in centesimi) e peso dell'articolo (in grammi), richiesti per i dati doganali.

Kliveer ti propone solo i prodotti che Poste rende disponibili per la nazione del destinatario.

Ristampare e scaricare le lettere di vettura

In Spedizioni Poste > Storico richieste trovi tutte le lettere di vettura generate. L'elenco mostra cliente e numero del documento e ha una Ricerca libera per ritrovarle; per ognuna puoi usare Apri / ristampa oppure Scarica PDF. Dallo stesso elenco il pulsante Nuova LdV ti riporta alla creazione.

Domande frequenti

Aprendo Nuova LdV dal menu non vedo il modulo di compilazione

È normale: la pagina va aperta da un ordine, perché è da lì che arrivano destinatario e colli. Usa la voce LdV Poste nel menu azioni dell'ordine.

Un campo di testo diventa rosso

Hai superato il limite di caratteri previsto dalle API di Poste. Puoi proseguire, ma Poste potrebbe tagliare il testo o rifiutare la lettera di vettura: conviene accorciarlo.

Il modulo prenota anche il ritiro o segue le consegne?

No. Il modulo genera la lettera di vettura, archivia il PDF e riporta il tracking sull'ordine. Il ritiro e la gestione delle giacenze restano sui canali di Poste Italiane.

Spedisco anche con altri corrieri

Nessun problema: ogni corriere ha il suo modulo e parte dallo stesso ordine. Per FedEx leggi la guida spedizioni FedEx con Kliveer.