Convalida degli indirizzi in Sendcloud

Scopo: In questo articolo spieghiamo cos’è la convalida degli indirizzi, perché è importante e i diversi modi in cui puoi controllare gli indirizzi dei tuoi clienti in Sendcloud, direttamente dal pannello, tramite le API Shipments o attraverso plugin di terze parti.

Cos’è la convalida degli indirizzi?

La convalida degli indirizzi verifica se un indirizzo di spedizione esiste nei database ufficiali degli indirizzi. Questo aiuta a garantire che i pacchi vengano consegnati correttamente e riduce le consegne non riuscite, i resi e i supplementi applicati dal corriere.

Quando viene controllato un indirizzo?

In Sendcloud, la convalida degli indirizzi viene eseguita automaticamente ogni volta che un indirizzo viene caricato o creato. Questo può avvenire in tre punti del pannello:

• Ordini in entrata: visualizza a colpo d’occhio lo stato di convalida di ogni ordine nella nuova colonna Controllo indirizzo.
• Pack & Go (prossimamente): i feedback di convalida in Pack & Go saranno presto disponibili.
• Modulo nuova spedizione: visualizza i feedback di convalida mentre crei manualmente una spedizione.

La convalida viene eseguita in background e non blocca il tuo flusso di lavoro. Puoi comunque creare un’etichetta anche se un indirizzo viene contrassegnato come non valido, quindi utilizza il risultato della convalida come indicazione, non come una restrizione rigida.

Cosa succede quando un indirizzo viene convalidato?

Ogni indirizzo riceve uno dei vari stati in base al risultato. Vedrai questi stati nella vista Ordini in entrata e all’interno della modifica degli ordini. Le sezioni seguenti spiegano cosa significa ciascun stato e cosa fare.

La colonna Controllo indirizzo in Ordini in entrata

Nella vista Ordini in entrata, troverai una nuova colonna Controllo indirizzo che mostra lo stato di convalida di ogni ordine.

Di seguito sono mostrati tutti gli stati che possono avere un indirizzo. Clicca su uno di essi per vederne il significato.

Risolvere un indirizzo non valido

Quando un ordine è contrassegnato come Non valido, clicca su Risolvi nella colonna Controllo indirizzo per aprire il modale Controllo indirizzo. Al suo interno vedrai due schede affiancate:

• Originale: l’indirizzo che hai inserito, con i campi che sembrano errati evidenziati con un’icona di avviso.
• Consigliato: l’indirizzo corretto, basato su dati postali ufficiali, con i campi corretti evidenziati in verde.

Se la prima raccomandazione non è corretta, puoi sceglierne un’altra dal menu a discesa Indirizzi trovati nella parte superiore del modale.

Per finalizzare:

• Clicca su "Applica consigliato" per aggiornare l’ordine con l’indirizzo suggerito.
• Clicca su "Mantieni originale" se preferisci lasciare l’indirizzo così come è stato inserito.

Controllo indirizzo nell’editor degli ordini

Quando apri un ordine per modificarlo, lo stato di convalida viene mostrato anche appena sopra i campi dell’indirizzo nella sezione Cliente. Il messaggio che vedi dipende dal risultato della convalida e dal fatto che tu abbia modificato o meno l’indirizzo da quando l’ordine è stato caricato. Consulta gli esempi seguenti per vedere ogni caso.

Indirizzo verificato L’indirizzo è stato convalidato correttamente. Non è richiesta alcuna azione. 

❮❯

Altri modi per convalidare gli indirizzi

Oltre alla funzionalità integrata nel pannello, puoi anche convalidare gli indirizzi prima nel tuo flusso di lavoro, nel momento in cui un cliente inserisce il proprio indirizzo nel tuo negozio online. Questo avviene tramite strumenti di terze parti che sono indipendenti da Sendcloud e vengono eseguiti sulla tua piattaforma e-commerce.

Utilizzare uno di questi strumenti oltre alla convalida integrata di Sendcloud ti offre un “doppio controllo”: uno al checkout, evitando errori di battitura all’origine, e uno prima di creare l’etichetta, intercettando eventuali errori passati inosservati.

Perché convalidare gli indirizzi?

• Meno consegne non riuscite. Rilevare un errore di battitura prima di creare l’etichetta significa che il pacco arriverà davvero al tuo cliente, senza resi, rispedizioni o supplementi del corriere.
• Costi di spedizione più bassi. Molti corrieri applicano supplementi per indirizzi errati. Convalidarli in anticipo riduce questi costi.
• Maggiore soddisfazione del cliente. I clienti ricevono i loro pacchi puntualmente, all’indirizzo corretto, senza email di follow-up né ritardi.
• Checkout più rapido, con plugin di checkout. Molti plugin offrono il completamento automatico del codice postale e del numero civico, così i clienti non devono digitare via e città complete. (Nota: il completamento automatico non fa parte della convalida integrata di Sendcloud né dell’API Shipments).

Opzioni di terze parti

Se desideri convalidare gli indirizzi durante il checkout o utilizzare un database di convalida diverso da quello di Sendcloud, ci sono due tipi di strumenti di terze parti da considerare: plugin, installati nel tuo negozio online, e API, chiamate dal tuo codice.

Non possiamo raccomandare uno strumento specifico perché l’opzione migliore dipende dal tuo sistema e-commerce, dai Paesi verso cui spedisci e dal tuo budget. Ti invitiamo a fare le tue ricerche prima di scegliere.

Convalidare gli indirizzi tramite l’API di Sendcloud

Se crei spedizioni tramite l’API Shipments di Sendcloud invece che dal pannello, puoi abilitare lo stesso motore di convalida utilizzato dalla funzionalità integrata del pannello. La logica di convalida, la copertura per Paese e le limitazioni sono identiche; cambia solo il modo in cui interagisci con essa.

Per abilitare la convalida, includi il seguente parametro nella tua richiesta di spedizione:

"validation_methods": ["here"]

Se l’indirizzo non può essere trovato nel nostro database, l’API restituisce un messaggio di errore: "Address doesn't exist". Se viene trovato un indirizzo consigliato, questo verrà utilizzato al posto dell’indirizzo originale condiviso nella richiesta. Per maggiori dettagli, consulta la documentazione dell’API Shipments.

Utilizzo dell’API di Convalida degli Indirizzi

Quando si utilizza l’API di Convalida degli Indirizzi con "validation_methods": ["here"], il comportamento corrisponde a ciò che vedi nel pannello. La risposta dell’API restituisce un elenco di indirizzi corrispondenti, con uno contrassegnato come "recommended": true. Questo indica l’indirizzo che riteniamo abbia la maggiore probabilità di essere consegnato correttamente.

Se tutti gli indirizzi restituiti hanno "recommended": false, significa che non è stato possibile identificare alcun indirizzo con sufficiente sicurezza per garantire una consegna riuscita.

L’API di Convalida degli Indirizzi può essere utilizzata anche per convalidare indirizzi solo rispetto ai limiti del corriere. Per farlo, ometti semplicemente il parametro "validation_methods": ["here"] dalla tua richiesta.

In questo caso, un indirizzo può comunque essere contrassegnato come "recommended": true se rispetta le restrizioni del corriere, anche se non è confermato come un indirizzo reale consegnabile.

Quando viene incluso "validation_methods": ["here"], vengono applicate sia la convalida degli indirizzi reali sia le verifiche dei limiti del corriere.

{
    "label_details": {
        "mime_type": "application/pdf",
        "dpi": 72
    },
    "validation_methods": ["here"],
    "to_address": {
        "name": "John Doe",
        "company_name": "Sendcloud",
        "address_line_1": "Whitehall",
        "house_number": "54",
        "postal_code": "5611CR",
        "city": "Amsterdam",
        "country_code": "NL",
        "phone_number": "+393895422999",
        "email": "john.doe@sendcloud.com"
    },
    "from_address": {
        "name": "Marie Doe",
        "company_name": "Sendcloud",
        "address_line_1": "Stadhuisplein 10",
        "address_line_2": "2e verdieping",
        "house_number": "10",
        "postal_code": "5611 EM",
        "city": "Eindhoven",
        "country_code": "NL",
        "phone_number": "+31612345678",
        "email": "marie.doe@sendcloud.com",
        "po_box": "PO Box 478"
    },
    "ship_with": {
        "type": "shipping_option_code",
        "properties": {
            "shipping_option_code": "postnl:standard",
            "contract_id": 517
        }
    },
    "order_number": "1234567890",
    "total_order_price": {
        "currency": "EUR",
        "value": "11.11"
    },
    "parcels": [
        {
            "dimensions": {
                "length": "5.00",
                "width": "15.00",
                "height": "20.00",
                "unit": "cm"
            },
            "additional_insured_price": {
                "value": "50",
                "currency": "EUR"
            },
            "weight": {
                "value": "1.320",
                "unit": "kg"
            },
            "parcel_items": [
                {
                    "item_id": "5552",
                    "description": "T-Shirt XL",
                    "quantity": 1,
                    "weight": {
                        "value": 0.3,
                        "unit": "kg"
                    },
                    "price": {
                        "value": 12.65,
                        "currency": "EUR"
                    },
                    "hs_code": "620520",
                    "origin_country": "NL",
                    "sku": "TS1234",
                    "product_id": "19284",
                    "mid_code": "NLOZR92MEL",
                    "material_content": "100% Cotton",
                    "intended_use": "Personal use",
                    "properties": {
                        "size": "XL",
                        "color": "green"
                    }
                },
                {
                    "item_id": "98712",
                    "description": "Sneakers 42",
                    "quantity": 1,
                    "weight": {
                        "value": 1.02,
                        "unit": "kg"
                    },
                    "price": {
                        "value": 12.65,
                        "currency": "EUR"
                    },
                    "hs_code": "620520",
                    "origin_country": "US",
                    "sku": "TS1234",
                    "product_id": "19284",
                    "mid_code": "US1234567",
                    "material_content": "100% Cotton",
                    "intended_use": "Personal use",
                    "properties": {
                        "size": 42,
                        "color": "black"
                    }
                }
            ]
        }
    ]
}